Personal Communications for Windows, Version 5.7 CM Mouse Support User’s Guide and Reference Personal Communications for Windows, Version 5.7 CM Mouse Support User’s Guide and Reference Note Before using this information and the product it supports, be sure to read the general information under Appendix D, “Notices”, on page 145. Fifth Edition (September 2003) This edition applies to Version 5.7 of IBM Personal Communications for Windows (program number: 5639–I70) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 1991, 2003. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ..............vii LINE................42 PLACE ................44 Tables ...............ix SET.................44 TITLE................44 About This Book...........xi Chapter 7. Button Definitions .....47 How To Use This Book ..........xi Control and Substitution Word Table ......47 Icons................xi The Basics of a Button Definition .......47 Where to Find More Information .......xi CM Mouse Control Words .........48 Personal Communications Library ......xi {beep} ...............48 {clipcut}{clipcuttextonly}........48 Chapter 1. Installing CM Mouse ....1 {clip copy} {clip copy textonly} .......48 {clip copyappend} ...........49 Chapter 2. Starting CM Mouse .....3 {clip from <r1> <c1> <r2> <c2>} ......49 Optional Command Line Parameters ......3 {clip to <r> <c>} ............49 Examples ...............5 {clip paste} .............49 Environment (SET) Variables .........6 {clip place} .............50 {clip cancel} .............50 Chapter 3. Configuring CM Mouse . 7 {clip clear} ..............50 {clip undo} .............50 Chapter 4. Using CM Mouse ......9 {clip unmark}.............50 {dde <function> <parameters>}.......50 Writing CM Mouse Scripts..........9 {editmmm} .............51 Using Pop-up Menus ...........10 {hostwait n} .............51 Pop-up System Menus..........11 {if <condition> {then}script1{else}script2} . 52 Using the Keyboard with Pop-up Menus . 12 {lockon}{lockoff}...........53 The CM Mouse Control Panel ........13 {mmenu} ..............53 The Host System Menu ..........16 {mrowcol x y} ............54 Clipboard Functions ...........17 {null}...............54 CM Mouse Screen Map Facility........18 {pause n} ..............54 DisplayingtheScreenMap........18 {pfkey} ...............54 UsingtheScreenMap..........19 {pfkey first} .............55 {pfkeylast}.............55 Chapter 5. CM Mouse BDF Script Files 23 {pfkeyrev} {pfkeyrev first} {pfkeyrev last} . 55 Button Definition File General Syntax .....24 {printscreen LPTx} ...........55 Button Definition File Structure........25 {printscreen Fname} {printscreen Fname The Primary BDF Script .........25 APPEND} ..............55 Default Button Definitions for SCREEN {quit}...............55 Statements..............27 {rowcol x y} .............55 Button Definition File Statements .......27 {seek} ...............56 AREA Statement............27 {unseek} ..............56 BUTTON Statement ..........28 {search FOR ’string’ AT r1 c1 r2 c2 WAIT n NOT DEFINE/ENDDEFINE Statements ......29 ASIS NOQUIT} ............56 DOIF/ENDIF Statements .........30 {seekelse} ..............57 DRAG Statement ...........31 {seekcol x} ..............57 DROP Statement............32 {seekrow x} .............58 INCLUDE Statement ..........32 {set Name Value} ...........58 MAP Statement ............33 {switchto <session>|*|next|prev } .....58 SCREEN Statement ...........35 {sys <cmd> <parms>} ..........58 SET Statement ............37 {win <session>|*|prev|next MIN| MAX| RESTORE| HIDE| SHOW| ACTIVATE| Chapter 6. CM Mouse Menu Files . 39 DEACTIVATE} ............59 BAR.................39 {xfer..}...............60 COLORS ...............40 {?<text>}..............60 DOIF/ENDIF..............41 {map} ...............61 © Copyright IBM Corp. 1991, 2003 iii {sysmenu} ..............61 Automatic Name Mapping .........94 CM Mouse Substitution Words ........61 &{break} ..............61 Chapter 10. CM Mouse Variables . 97 &{charsrcl}or{&charsrcl} .......62 Setting the Value of a Variable ........97 &{editor}..............62 Setting the Value of a Variable in a Button &{env VarName} ...........62 Definition ..............97 &{hcol} or {&hcol} ...........62 Setting the Value of a Variable in a BDF or MMM &{hrow}or{&hrow}..........62 File................98 &{hour} &{min} &{sec}..........62 Variable Substitutions (Using the Value of a &{month} &{day} &{year}.........62 Variable)...............99 &{math ’val1’ +|-|/|* ’val2’} .......63 RulesofVariables............99 &{mmm} ..............63 Predefined System Variables ........100 &{mrow}or{&mrow}..........63 Debugging Hints ............100 &{mcol} or {&mcol}...........63 &{num} or {&num} ...........63 Chapter 11. CM Mouse Utility &{num first} or {&num first}........64 &{num last} or {&num last} ........64 Programs .............101 &{num at <row> <col>} or {&num at <row> The CM Mouse Menu Editor ........101 <col>} ...............64 Menu Title .............102 &{popup <menuname>} or {&popup Menu Item Text ...........102 <menuname>} ............64 Menu Item Script ...........102 &{rows} ..............65 Menu Item Color ...........102 &{cols}...............66 Delete Menu Item ...........102 &{sid}or{&sid}............66 Insert Menu Item ...........103 &{srow} &{scol} or {&srow} {&scol} .....66 Default Menu Colors ..........103 &{str <function> <parms>} ........66 Default Bounce Bar Position .......103 &{var Name} or {&var Name} .......67 Menu Placement ...........103 &{word delimit|include ’<chars>’} or {&word} 67 SetVariableValues..........103 &{word first} or {&word first} .......68 Exit and Save Menu ..........103 &{word last} or {&word last} .......68 Exit Without Saving ..........103 &{word at <row> <col>} or {&word at <row> The CM Mouse Button Simulator.......103 <col>} ...............68 PMButtonSimulator..........103 &{?<Qtext>|<Atext>} or {&?<Qtext>|<Atext>} 68 Command-Line Button Simulator......104 &{rexx PgmSource} or {&rexx PgmSource} . 70 Presubstitutions and Runtime Substitutions. 71 Chapter 12. Button Usage Standards 105 CM Mouse Host Control Words .......73 Left Button Usage ............105 Right Button Usage ...........105 Chapter 8. CM Mouse/REXX Interface 75 Left+Right Button Usage .........106 Typical Uses for the REXX Interface ......75 Right+Left Button Usage .........106 Inline and External REXX Programs ......76 Middle Button Usage...........106 Syntax ................77 CM Mouse Substitutions in REXX Programs . 79 Chapter 13. Sample Button Definitions Debugging REXX Programs .........80 and Menus ............107 REXX External Functions ..........81 Host Application Examples.........108 CmmSearch .............81 PROFS/OfficeVision Examples ......108 CmmGetScreen ............81 RDRLIST Example...........118 CmmInfo ..............82 ISPF Example ............119 CmmExec ..............83 TextEditors.............120 CmmConnect.............84 CmmPopup .............85 Chapter 14. Tips and Techniques . 123 CmmPrompt .............85 Nesting Pop-up Menus ..........123 CmmGet ..............86 Synchronizing Input with the Host ......123 CmmPut ..............86 Screen Size Independence .........124 Cursor Positioning ...........126 Chapter 9. Drag/Drop Features ....89 Performance Tips ............129 OS/2 versus Windows Drag/Drop ......89 Common Problems ...........130 How CM Mouse Drag/Drop Works ......89 DRAG Statements ............90 Chapter 15. Cross-Platform DROP Statements ............91 Compatibility ...........131 The XFER Keyword ...........91 iv CM Mouse Support User’s Guide and Reference Chapter 16. CM Mouse Limitations 133 Appendix C. MMM File Syntax String Lengths .............133 Diagrams .............143 Program Limitations ...........133 Miscellaneous Limitations .........134 Appendix D. Notices ........145 Trademarks ..............146 Appendix A. CM Mouse Keyword Reference .............135 Index ...............147 Appendix B. BDF File Syntax Diagrams .............141 Contents v vi CM Mouse Support User’s Guide and Reference Figures 1. Configuration Dialog..........7 12. Map Buttons Window .........22 2. Sample Pop-up Menu .........11 13. General Structure of a Button Definition File 25 3. Pop-up System Menu .........11 14. CM Mouse Menu Editor ........102 4. CM Mouse Control Panel ........13 15. Sample OfficeVision Main Menu .....109 5. Options Menu ...........14 16. Sample Hot Spot Definition .......110 6. Pop-up Menu Colors Panel .......15 17. Sample Hot Spot Expansion.......111 7. Host System Menu (OS/2 and Windows) 17 18. Sample OV Calendar Screen ......116 8.SelectingtheScreenMapOption.....18 19. Sample VM RDRLIST Application Menu 118 9. Selecting a Host Session ........19 20. Sample ISPF Main Menu........120 10. Screen Map Windows .........19 21. Sample Host RDRLIST Screen ......125 11. Map Trace Window ..........21 © Copyright IBM Corp. 1991, 2003 vii viii CM Mouse Support User’s Guide and Reference Tables 1. CM Mouse Start-Up Variables ......100 4.ProgramLimitations.........133 2. Cross-Platform Compatibility ......131 5. CM Mouse Keyword Reference .....135 3. Alternate CM Mouse String Lengths ....133 © Copyright IBM Corp. 1991, 2003 ix x CM Mouse Support User’s Guide and Reference About This Book This book is for users of IBM® Personal Communications for Windows®, Version 5.7. How To Use This Book In this book, Windows refers to Windows 95, Windows 98,