home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / jumpkey.zip / jumpkey.inf (.txt) < prev    next >
OS/2 Help File  |  1996-06-15  |  99KB  |  830 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Overview ΓòÉΓòÉΓòÉ
  3.  
  4. JumpKey/2 2.3.0 allows you to set up key combinations that will jump directly 
  5. to a specific OS/2 Window.  You can configure up to 32 JumpKey/2 sessions to 
  6. jump to as well as up to 32 sessions that will be toggled in a ring. 
  7.  
  8. You can configure the keys that will initiate each jump, as well as the titles 
  9. that are jumped-to. Almost every key can be defined to make a jump. 
  10.  
  11. There is only one default key assignment: 
  12.  
  13. shift-ctrl-0 = Make JumpKey Visible 
  14.  
  15. If this is the first time you have started JumpKey/2, Configure will be 
  16. automatically selected from the Options menu to set up session titles and keys. 
  17.  
  18. JumpKey/2 can be hidden while it operates or you can leave it as an icon, or a 
  19. displayed window. 
  20.  
  21. Any items that you configure can be saved for the next time you start 
  22. JumpKey/2. 
  23.  
  24. Note:  You CANNOT jump FROM a FULL-SCREEN session, such as a Full-Screen 
  25. Command Prompt, or DOS. You ARE permitted to jump TO one of these sessions. 
  26.  
  27.  
  28. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  29.  
  30. There are two installation methods depending on whether you have received the 
  31. program from a network as a ZIP file (such as Compuserve(tm)) or you have 
  32. received an installation diskette.  Use the procedure that applies to the media 
  33. you have received. 
  34.  
  35.      From a ZIP file 
  36.  
  37.      From a Diskette or CDROM 
  38.  
  39.  
  40. ΓòÉΓòÉΓòÉ 2.1. Installation from a ZIP File ΓòÉΓòÉΓòÉ
  41.  
  42. To unpack the network file, Info-ZIP's UNZIP is required. This program is 
  43. available for both DOS and for OS/2. Check with the network where you obtained 
  44. JumpKey/2 for details on obtaining Info-ZIP's UNZIP. 
  45.  
  46. To install JumpKey/2: 
  47.  
  48.    1. Create a temporary subdirectory with the commands: 
  49.  
  50.                     c:
  51.                     cd c:\
  52.                     md TEMP
  53.                     cd TEMP
  54.  
  55.       Note:  The TEMP directory is a suggested name. Any directory name can be 
  56.       used, or you can unpack in an existing directory. 
  57.  
  58.    2. You will be sent JMP230.ZIP. Move this file to the C:\TEMP directory. 
  59.  
  60.    3. Unpack the files with the command: 
  61.  
  62.                     UNZIP JMP230.ZIP
  63.  
  64.    4. Start the install program with the command: 
  65.  
  66.                     INSTALL
  67.  
  68.    5. The INSTALL program will prompt you for the installation location for 
  69.       JumpKey/2.  There is contextual help for all the installation choices. 
  70.  
  71.       A folder for JumpKey will be created, with an entry for the JumpKey 
  72.       program, and to view the INF, README and LICENSE files. 
  73.  
  74.    6. Make sure that "Update CONFIG.SYS" is selected. 
  75.  
  76.    7. Select one and only one keyboard. 
  77.  
  78.    8. If you want to start JumpKey from a command line, and you did not select 
  79.       "Update CONFIG,SYS", you must make sure that the target directory is 
  80.       located in the PATH, LIBPATH and HELP environment variables. 
  81.  
  82.    9. You can modify the program object for JumpKey that is created with 
  83.       parameters from the command line options 
  84.  
  85.   10. Delete the files that were created in the TEMP directory. The easiest way 
  86.       will be to drop the TEMP directory into the OS/2 SHREDDER from a DRIVES 
  87.       object. 
  88.  
  89.  
  90. ΓòÉΓòÉΓòÉ 2.2. Installation from a Diskette or CDROM ΓòÉΓòÉΓòÉ
  91.  
  92. The JumpKey/2 diskette or CDROM will have all the required files in a 
  93. ready-to-install form.  Use the following steps to install them on your 
  94. machine. 
  95.  
  96.    1. From diskette, start the install program with the command: 
  97.  
  98.                     A:\INSTALL
  99.       where A is the diskette drive you are installing from. 
  100.  
  101.    2. From CDROM, start the install program with the command: 
  102.  
  103.                     D:\path\INSTALL
  104.       where D is the CDROM drive letter, and path is the location on CDROM you 
  105.       are installing from. 
  106.  
  107.    3. The INSTALL program will display the README file for this version of 
  108.       JumpKey/2.  There is contextual help for all the installation choices. 
  109.  
  110.       A folder for JumpKey will be created, with an entry for the JumpKey 
  111.       program, and to view the INF, README and LICENSE files. 
  112.  
  113.    4. Make sure that "Update CONFIG.SYS" is selected. 
  114.  
  115.    5. Select one and only one keyboard. 
  116.  
  117.    6. If you want to start JumpKey from a command line, and you did not select 
  118.       "Update CONFIG,SYS", you must make sure that the target directory is 
  119.       located in the PATH, LIBPATH and HELP environment variables. 
  120.  
  121.    7. You can modify the program object for JumpKey that is created with 
  122.       parameters from the command line options 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 3. Command Line ΓòÉΓòÉΓòÉ
  126.  
  127. If you have installed JumpKey/2 in a directory in both the PATH and the 
  128. LIBPATH, you can start JumpKey/2 with the command: 
  129.  
  130.         start JUMPKEY [options]
  131. or you can place the command line options as parameters in the settings 
  132. notebook for the program object. 
  133.  
  134. The options that can be specified are: 
  135.  
  136.  Option    Action 
  137.  /h 
  138.            Makes JumpKey/2 hide. It will still operate, but you will not be 
  139.            able to see it, and there will not be an entry in the Window List. 
  140.            If you want to see the window again, you can either: 
  141.                Start JumpKey/2 again. This will not start another copy of the 
  142.                 program. It will make the first copy visible again. 
  143.                Use the shift-ctrl-0  key to make the JumpKey/2 program 
  144.                 visible.  Use the Configure menu item to change the default key 
  145.                 for this function to another key sequence. set up another key 
  146.                 combination to perform this action. 
  147.                Double-click on the object in the folder where you started 
  148.                 JumpKey/2. 
  149.  /n 
  150.            Starts JumpKey/2 as an icon. 
  151.  /d 
  152.            Uses all program defaults. This will cause JumpKey/2 to discard any 
  153.            options you have previously saved. Use this option only if you want 
  154.            to discard all your settings. 
  155.  The '/' is optional. For example, to specify ALL the options, use the command: 
  156.  
  157.           start JUMPKEY /hnd
  158.  The options can be in ANY order. 
  159.  
  160.  Note:  Make sure that the following DLLs 
  161.  
  162.           hotdll32.dll
  163.           jumpres.dll
  164.  are located somewhere in the LIBPATH. If it is NOT, you will receive the 
  165.  message: 
  166.  
  167.           The system cannot find the file HOTDLL32.
  168.  from OS/2. 
  169.  
  170.  Note:  You can also add these options to the JumpKey/2 program object in the 
  171.  JumpKey/2 folder. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 4. Main Menu ΓòÉΓòÉΓòÉ
  175.  
  176. The main menu can be selected by clicking on the menu items, or pressing the 
  177. Alt key and an underlined letter on the menu. 
  178.  
  179.      Actions 
  180.  
  181.      Options 
  182.  
  183.      Help 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 4.1. Actions Menu ΓòÉΓòÉΓòÉ
  187.  
  188. The Actions menu contains a single item: 
  189.  
  190.      Hide 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 4.1.1. Hide ΓòÉΓòÉΓòÉ
  194.  
  195. This menu item will make the JumpKey/2 program invisible. It will continue to 
  196. operate, but you will not see the program either on the Desktop, as an Icon, or 
  197. in the Window List.  To make the program visible again you can: 
  198.  
  199.      Start JumpKey/2 again. This will not start another copy of the program. 
  200.       It will make the first copy visible again. 
  201.      Use the shift-ctrl-0  key to make the JumpKey/2 program visible.  Use the 
  202.       Configure menu item to set up another key combination to perform this 
  203.       action. 
  204.      Double-click on the object in the folder where you started JumpKey/2. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 4.2. Options Menu ΓòÉΓòÉΓòÉ
  208.  
  209. This menu has two menu items: 
  210.  
  211.      Configure 
  212.  
  213.      View keys 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 4.2.1. Configure ΓòÉΓòÉΓòÉ
  217.  
  218. This menu item will initiate the JumpKey/2 configuration Panel. 
  219.  
  220. This dialog panel lets you set up the keys to be used for JumpKey/2 as well as 
  221. the titles used for the session names. 
  222.  
  223. To define a key, follow these steps: 
  224.  
  225.    1. Select the key you want to define from the Key Names list, or 
  226.  
  227.       select a shift key setting and then select a key from the displayed 
  228.       keyboard by pressing a key with the mouse. 
  229.  
  230.       The current definition for this key will be displayed in the Definition 
  231.       list. 
  232.  
  233.    2. Select a new definition in the Definition list. 
  234.  
  235.    3. Move the cursor to the Session Title Edit box and type in a session title 
  236.       or select one from the session title pulldown list. The pulldown list has 
  237.       everything currently in the Window List. 
  238.  
  239.    4. Click on the Maximize Session check box if you would like this session to 
  240.       maximize when you jump to it. 
  241.  
  242.    5. Click on the Exact Match check box if you have sessions with similar 
  243.       names, and you want to jump only if there is an exact title match. 
  244.  
  245.    6. The list of sessions for the Toggle function will display all the active 
  246.       3270 sessions. You can change this list by modifying the order of the 
  247.       items, or adding or deleting items from the list. 
  248.  
  249.  When you have finished defining ALL your keys, press the OK button. 
  250.  
  251.  If you want to discard your changes to the defined keys, press the Cancel 
  252.  button. 
  253.  
  254.  
  255. ΓòÉΓòÉΓòÉ 4.2.2. Key Names List ΓòÉΓòÉΓòÉ
  256.  
  257. This list is an alphabetical list of the keys available for redefinition. You 
  258. can either select an entry on this list, or press a button in the displayed 
  259. keyboard above this list. 
  260.  
  261. If the key is not present on an old PC keyboard, the name will have -enh 
  262. appended to the end of the key name. For example, the home key on the center of 
  263. a Model 70 keyboard is known as home-enh, while the home key on the numeric 
  264. keypad is simply home. 
  265.  
  266. The keys may also have a prefix of: 
  267.  
  268.  alt- 
  269.            indicates holding either ALT key and pressing the key. 
  270.  ctrl- 
  271.            indicates holding either CTRL key and pressing the key. 
  272.  shift- 
  273.            indicates holding either SHIFT key and pressing the key. 
  274.  shift-ctrl- 
  275.            indicates holding either SHIFT key AND holding either CTRL key while 
  276.            pressing the key. 
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ 4.2.3. Definition List ΓòÉΓòÉΓòÉ
  280.  
  281. The following definitions are available: 
  282.  
  283.  Name      Action 
  284.  No Action 
  285.            JumpKey/2 takes no action for the key. It is passed on to the Active 
  286.            OS/2 application. 
  287.  Make JumpKey/2 Visible 
  288.            will make JumpKey/2 visible again if it is hidden.  If JumpKey/2 is 
  289.            already visible, this key will have no effect. 
  290.  Toggle Forward 
  291.            this will have one of two actions, depending on the Active OS/2 
  292.            application. 
  293.              1. If the Active OS/2 application is NOT one of the toggle 
  294.                 sessions, JumpKey/2 will jump to the FIRST toggle session. 
  295.  
  296.              2. If the Active OS/2 application IS one of the toggle sessions, 
  297.                 JumpKey/2 will jump to the NEXT toggle session. When this item 
  298.            is selected, you cannot select the Session Title Edit box. 
  299.  Toggle Backward 
  300.            this will have one of two actions, depending on the Active OS/2 
  301.            application. 
  302.              1. If the Active OS/2 application is NOT one of the toggle 
  303.                 sessions, JumpKey/2 will jump to the FIRST toggle session. 
  304.  
  305.              2. If the Active OS/2 application IS one of the toggle sessions, 
  306.                 JumpKey/2 will jump to the PREVIOUS toggle session. When this 
  307.            item is selected, you cannot select the Session Title Edit box. 
  308.  Toggle Minimize 
  309.            this will minimize all Toggle sessions that are configured in the 
  310.            Toggle Session Title List. When this item is selected, you cannot 
  311.            select the Maximize Session checkbox or the Session Title Edit box. 
  312.  Toggle Maximize 
  313.            this will maximize all Toggle sessions that are configured in the 
  314.            Toggle Session Title List. When this item is selected, you cannot 
  315.            select the Maximize Session checkbox or the Session Title Edit box. 
  316.  Toggle Restore 
  317.            this will restore all Toggle sessions that are configured in the 
  318.            Toggle Session Title List. When this item is selected, you cannot 
  319.            select the Maximize Session checkbox, or the Session Title Edit box. 
  320.  Minimize All 
  321.            this will minimize all running programs. 
  322.  Maximize All 
  323.            this will maximize all running programs. 
  324.  Restore All 
  325.            this will restore all running programs. 
  326.  Lockup System 
  327.            this will invoke the OS/2 desktop lockup 
  328.  Shutdown System 
  329.            this will initiate OS/2 shutdown. 
  330.  
  331.            Note:  You will NOT be asked to confirm this operation. 
  332.  <jump session name> 
  333.            Each of these will jump to the specified OS/2 session.  When 
  334.            configured, the name of this session will be displayed in definition 
  335.            list and in the the Session Title Edit box above this list, where it 
  336.            can be changed. 
  337.  
  338.            The term 'not defined xx'  (where xx is a number from 1 to 32) will 
  339.            be displayed for each entry in the list until a session name has 
  340.            been entered for the item. 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 4.2.4. Session Title Edit Box ΓòÉΓòÉΓòÉ
  344.  
  345. This is a combination box where you can either type the name of the session to 
  346. be jumped-to for the session number displayed in the Definition List, or you 
  347. can pull down the list of sessions as displayed in the Window list.  If you 
  348. click on the arrow to the right of this box, a list of all the currently 
  349. running sessions will be displayed.  Select the session with the keyboard or 
  350. mouse. 
  351.  
  352. The item can be any part of a title in the Window List. Remember that the first 
  353. match for this title will be the session that is jumped-to. 
  354.  
  355. The search is NOT case-sensitive, but any blanks or punctuation must be 
  356. included just as displayed in the Window List. 
  357.  
  358. Note:  You cannot select or type into this field unless jump session is 
  359. selected in the Definition List. 
  360.  
  361.  
  362. ΓòÉΓòÉΓòÉ 4.2.5. Maximize Session Checkbox ΓòÉΓòÉΓòÉ
  363.  
  364. This check box should be selected if you would like the session whose name is 
  365. displayed in the Session Title Edit box to become maximized when JumpKey/2 
  366. switches to it. 
  367.  
  368. Some applications will fill the entire screen when maximized. Others will 
  369. change shape, but still not fill the entire screen. 
  370.  
  371. This option will cause the application to enlarge itself to it's largest size. 
  372.  
  373. Note:  You cannot select this check box unless Toggle Forward, Toggle Backward 
  374. or a jump session title is selected in the Definition List. 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 4.2.6. Exact Match Checkbox ΓòÉΓòÉΓòÉ
  378.  
  379. This check box should be selected if you would like to jump to the session 
  380. whose name is displayed in the Session Title Edit box only if it is an EXACT 
  381. match for a Window List entry. 
  382.  
  383. You may have applications with similar names, or names that are extensions of a 
  384. name, for example: 
  385.  
  386.     Command Window
  387.     Command Window:2
  388.  
  389. If you defined a Session Title called Command Window, and you want to make sure 
  390. JumpKey/2 always jumps to the first of the two Window List entries above, you 
  391. would need to select Exact Match. 
  392.  
  393. Note:  You cannot select this check box unless Toggle Forward, Toggle Backward 
  394. or a jump session title is selected in the Definition List. 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ 4.2.7. Toggle Session Title List ΓòÉΓòÉΓòÉ
  398.  
  399. This is a list box that contains the names of your 3270 sessions. These 
  400. applications will be accessed by the key defined as Toggle Minimize, Toggle 
  401. Forward or Toggle Backward in the Definition List. The Toggle Forward and 
  402. Toggle Backward keys will have one of three actions, depending on the Active 
  403. OS/2 application. 
  404.  
  405.    1. If the Active OS/2 application is NOT one of the toggle sessions, 
  406.       JumpKey/2 will jump to the FIRST toggle session. 
  407.  
  408.    2. If the Active OS/2 application IS one of the toggle sessions, Toggle 
  409.       Forward will jump to the NEXT toggle session; Toggle Backward will jump 
  410.       to the PREVIOUS toggle session. 
  411.  
  412.    3. If Skip Minimized has been selected, JumpKey/2 will not switch to 
  413.       Minimized sessions. Instead, the next or previous restored or maximized 
  414.       session will be switched-to. 
  415.  
  416.  If you have not started, or you do not have the Communications Manager, this 
  417.  list will be empty. To make this list correct, start the Communications 
  418.  Manager before configuring JumpKey/2. 
  419.  
  420.  To change an item in the list, use the cursor or the mouse to select an item, 
  421.  then edit the item as displayed in the Toggle Session Title Edit  box, located 
  422.  just above the list, or select one from the Toggle Session Title Edit pulldown 
  423.  list. The terms 'not defined xx' will be displayed in the Toggle Session Title 
  424.  List (where xx is a number from 1 to 32) until an entry has been made for this 
  425.  item. 
  426.  
  427.  Note:  You cannot select this list unless toggle Minimize, Toggle Forward or 
  428.  Toggle Backward is selected in the Definition List. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 4.2.8. Toggle Session Title Edit Box ΓòÉΓòÉΓòÉ
  432.  
  433. This is a combination box where you can either type the name of the session to 
  434. be jumped-to for the toggle function, or you can pull down the current list of 
  435. Communications Manager sessions. If you click on the arrow to the right of this 
  436. box, a list of all the currently running Communications Manager sessions will 
  437. be displayed. Select the session with the keyboard or mouse. 
  438.  
  439. Simply type over any values displayed in this box, or select from the pull down 
  440. list. Then Click on OK to accept the change. 
  441.  
  442. To delete an item from the Toggle list,  simple blank-out or delete all the 
  443. characters in the item, then select another item in the list. The list will be 
  444. adjusted for the now empty entry. 
  445.  
  446. Note:  You cannot select or type into this field unless toggle Minimize, Toggle 
  447. Forward or Toggle Backward is selected in the Definition List. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ 4.2.9. Skip Minimized Checkbox ΓòÉΓòÉΓòÉ
  451.  
  452. This check box should be selected if you would like JumpKey/2 to bypass Toggle 
  453. Sessions that are minimized. 
  454.  
  455. When this option is selected, the keys defined as the toggle Forward and Toggle 
  456. Backward will jump to the next or previous restored or maximized session 
  457. defined in the Toggle Session Title List. If NONE of the defined sessions are 
  458. restored or maximized, JumpKey/2 will jump to the first session. 
  459.  
  460. Note:  You cannot select this check box unless toggle Minimize, Toggle Forward 
  461. or toggle Backward is selected in the Definition List. 
  462.  
  463.  
  464. ΓòÉΓòÉΓòÉ 4.2.10. Toggle Through Like-Named Sessions Checkbox ΓòÉΓòÉΓòÉ
  465.  
  466. This check box affects all sessions except the toggle sessions. If selected 
  467. JumpKey/2 will loop through all sessions that match the session title. 
  468.  
  469. For example, let us assume that you used the LaunchPad to start several 
  470. sessions that have a title of "OS/2 Window". Let us also assume that you have 
  471. another session called "Command Window". 
  472.  
  473. Use the JumpKey/2 settings to configure the key ctrl-1 to jump to a session 
  474. titled "WINDOW" and do not select exact match. 
  475.  
  476. If Toggle Through Like-Named Sessions is ON, each time you pressed ctrl-1, 
  477. JumpKey/2 would in turn toggle to each of the sessions titled "OS/2 Window", 
  478. and then also toggle to the session titled "Command Window". 
  479.  
  480. If Toggle Through Like-Named Sessions is OFF, each time you pressed ctrl-1, 
  481. JumpKey/2 would jump only to the first session it found. This could be one of 
  482. the "OS/2 Window" sessions or the session titled "Command Window". 
  483.  
  484. Use the JumpKey/2 settings to configure the key ctrl-1 to jump to a session 
  485. titled "OS/2 WINDOW" and DO select exact match. 
  486.  
  487. If Toggle Through Like-Named Sessions is ON, each time you pressed ctrl-1, 
  488. JumpKey/2 would in turn toggle to each of the sessions titled "OS/2 Window", 
  489. but would not toggle to the session titled "Command Window". 
  490.  
  491. If Toggle Through Like-Named Sessions is OFF, each time you pressed ctrl-1, 
  492. JumpKey/2 would jump only to the first session titled "OS/2 Window" that it 
  493. found. 
  494.  
  495.  
  496. ΓòÉΓòÉΓòÉ 4.2.11. Do Not Jump To Hidden Windows Checkbox ΓòÉΓòÉΓòÉ
  497.  
  498. This check box affects all sessions except the toggle sessions. If selected 
  499. JumpKey/2 will not jump to windows which are hidden from view in the Window 
  500. List. If you have trouble jumping to a session, try turning this option OFF. 
  501.  
  502.  
  503. ΓòÉΓòÉΓòÉ 4.2.12. OK Button ΓòÉΓòÉΓòÉ
  504.  
  505. Pressing the button accepts any changes on this panel and removes the Configure 
  506. panel. 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ 4.2.13. Cancel Button ΓòÉΓòÉΓòÉ
  510.  
  511. Pressing the button discards any changes on this panel and removes the 
  512. Configure panel. If changes have been made, you will be asked to confirm before 
  513. discarding the changes. 
  514.  
  515.  
  516. ΓòÉΓòÉΓòÉ 4.2.14. Defined Keys Panel ΓòÉΓòÉΓòÉ
  517.  
  518. This dialog panel lets you view the keys that are currently defined. The list 
  519. that is provided contains two columns: 
  520.  
  521.      The names of the defined keys. 
  522.  
  523.      The definition for the keys. 
  524.  
  525.  If you double-click on a list item, JumpKey/2 will try to switch to that 
  526.  session. If you have chosen a toggle or system function, a warning tone will 
  527.  sound. 
  528.  
  529.  At the bottom of this panel are buttons to select: 
  530.  
  531.      Close - removes this dialog panel. 
  532.  
  533.      Print - sends the displayed list to the printer defined as LPT1. You will 
  534.       hear a confirmation tone when the list has been sent to the printer. 
  535.  
  536.  
  537. ΓòÉΓòÉΓòÉ 4.3. Help Menu ΓòÉΓòÉΓòÉ
  538.  
  539. The Help menu lets you find out more information about the program. 
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 4.3.1. Help Index ΓòÉΓòÉΓòÉ
  543.  
  544. This menu item displays the Help Index. 
  545.  
  546.  
  547. ΓòÉΓòÉΓòÉ 4.3.2. General Help ΓòÉΓòÉΓòÉ
  548.  
  549. This menu item will start the help system at the first JumpKey/2 help panel. 
  550.  
  551.  
  552. ΓòÉΓòÉΓòÉ 4.3.3. Keys Help ΓòÉΓòÉΓòÉ
  553.  
  554. Alt-F11 performs the JumpKey/2 hide function from the JumpKey/2 main window. 
  555.  
  556. See your OS/2 reference for more information on standard key usage. 
  557.  
  558.  
  559. ΓòÉΓòÉΓòÉ 4.3.4. Help for Help ΓòÉΓòÉΓòÉ
  560.  
  561. This menu item tells you how to use the OS/2 help system. 
  562.  
  563.  
  564. ΓòÉΓòÉΓòÉ 4.3.5. Product Information ΓòÉΓòÉΓòÉ
  565.  
  566. The Product Information Panel contains the Copyright and program version. 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 5. Command-Line INI Tool JumpINI ΓòÉΓòÉΓòÉ
  570.  
  571. JumpINI is used to modify a JUMPKEY .INI file from the OS/2 command line. 
  572. JumpKey 2.2.1 or 2.3.0 must already be installed. 
  573.  
  574. Correct Usage: 
  575.  
  576.   JUMPINI keyname|togglexx|@textfile session|function [/option...]
  577.  
  578.  
  579. ΓòÉΓòÉΓòÉ 5.1. Setting A Single Key ΓòÉΓòÉΓòÉ
  580.  
  581. To set a single key, use the command in the form: 
  582.  
  583.   JUMPINI keyname function|session [/option...]
  584.  
  585. For example: 
  586.  
  587.   JUMPINI ctrl-1 workframe
  588.  
  589. Options can also be used: 
  590.  
  591.   JUMPINI ctrl-1 workframe /max /partial
  592. See the section below on OPTIONS for details, 
  593.  
  594. If the session title has embedded blanks, enclose the title in double quotes: 
  595.  
  596.   JUMPINI ctrl-1 "IBM workframe/2"
  597.  
  598. If you want to assign a function to a key, use one of the function names: 
  599.  
  600.   JUMPINI ctrl-1 hotview
  601. The functions available are: 
  602.  
  603.  nothing        No Action (this clears a key definition) 
  604.  hotview        Make JumpKey/2 Visible 
  605.  togfor         Toggle Forward 
  606.  togback        Toggle Backward 
  607.  togmin         Toggle Minimize 
  608.  togmax         Toggle Maximize 
  609.  togres         Toggle Restore 
  610.  minall         Minimize All 
  611.  maxall         Maximize All 
  612.  resall         Restore All 
  613.  lockup         Lockup System 
  614.  shutdown       Shutdown System 
  615.  
  616.  To see a list of all the available keynames, issue the command: 
  617.  
  618.     JUMPINI /k
  619.  
  620.  The list of keynames is part of JumpKey, and may vary according to the 
  621.  language and keyboard selected. 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ 5.2. Setting Toggle Session Names ΓòÉΓòÉΓòÉ
  625.  
  626. You can specify the session names for the toggle function by specifying each 
  627. session name. For example: 
  628.  
  629.   JUMPINI toggle01 "- A -"
  630.   JUMPINI toggle02 "- B -"
  631.   JUMPINI toggle03 "Dos Window"
  632.  
  633. Note:  Please do not leave empty names in the list. For example, if you only 
  634. set names 01 02 and 04, the toggle function will never access toggle04. The 
  635. ring ends at the first undefined entry. 
  636.  
  637. The names available are: 
  638.  
  639.       toggle01 
  640.       toggle09 
  641.       toggle17 
  642.       toggle25 
  643.       toggle02 
  644.       toggle10 
  645.       toggle18 
  646.       toggle26 
  647.       toggle03 
  648.       toggle11 
  649.       toggle19 
  650.       toggle27 
  651.       toggle04 
  652.       toggle12 
  653.       toggle20 
  654.       toggle28 
  655.       toggle05 
  656.       toggle13 
  657.       toggle21 
  658.       toggle29 
  659.       toggle06 
  660.       toggle14 
  661.       toggle22 
  662.       toggle30 
  663.       toggle07 
  664.       toggle15 
  665.       toggle23 
  666.       toggle31 
  667.       toggle08 
  668.       toggle16 
  669.       toggle24 
  670.       toggle32 
  671.  All the toggle sessions share a single "exact match" flag and "maximize" flag. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 5.3. Using An Input File ΓòÉΓòÉΓòÉ
  675.  
  676. Instead of calling JUMPINI several times to define keys, you can use a text 
  677. file as input to JUMPINI. Precede the filename with an '@' sign. For example: 
  678.  
  679.   JUMPINI @ini.jmp
  680. Do not place a blank between the '@' and the filename. Options 
  681.  
  682.   /F /D /W /K and /Q
  683. must still be placed on the command line. Other options are not valid on the 
  684. command line when using input from a file. Instead, put these options in the 
  685. file itself (see example below). 
  686.  
  687. File ini.jmp could contain (as it does in the shipped example): 
  688.  
  689. ctrl-1 hotview
  690. ctrl-2 nothing
  691. @ini2.jmp
  692. ctrl-3 workframe /exact /max
  693. ctrl-8 "workframe of my life" /exact /max
  694. /skipmin
  695. toggle01 "- A"
  696. toggle02 "- B"
  697. toggle03 "- C"
  698. toggle04 HTERMPM
  699.  
  700. In this example, there is an embedded file "ini2.jmp" that also contains: 
  701.  
  702. ctrl-4 hotview
  703. ctrl-5 nothing
  704. ctrl-6 workframe /exact /max
  705.  
  706. If you embed a file in itself the program will fail (there is no checking for 
  707. this) with a SYS3175. 
  708.  
  709.  
  710. ΓòÉΓòÉΓòÉ 5.4. Options ΓòÉΓòÉΓòÉ
  711.  
  712. Options are NOT case sensitive, and can be placed anywhere on the command line 
  713. and many can be placed in an input file. Only the first letter of each option 
  714. is required. 
  715.  
  716.  /F<inifile> 
  717.            Where <inifile> is the ini file to modify.  If omitted, 
  718.            /OS2/JUMPKEY.INI on your OS2 boot disk is the default. Do not leave 
  719.            a blank after the 'F'.  i.e.: 
  720.  
  721.                           JUMPINI /Ftest.ini ctrl-1 JumpKey
  722.            This option cannot be used in an input file. 
  723.  /Exact | /Partial 
  724.            Specifies how to match a session name. If "partial" is set (the 
  725.            default) a session name of "Window" would match: 
  726.  
  727.                             "Dos Window"
  728.                             "OS/2 Window"
  729.                             "Win-OS/2 Window"
  730.            If exact is set, only a session titled "Window" would match. i.e.: 
  731.  
  732.                           JUMPINI /Partial ctrl-1 Window
  733.                           JUMPINI /exact   ctrl-2 "Dos Window"
  734.            Do not use this option on the command line if an input file is used. 
  735.  /Max | /Nomax 
  736.            Specifies to maximize or do not maximize on switch. i.e.: 
  737.  
  738.                           JUMPINI /Max ctrl-1 Window
  739.            Do not use this option on the command line if an input file is used. 
  740.            This option can be turned off by using: 
  741.  
  742.                           JUMPINI /Nomax ctrl-1 Window
  743.            or 
  744.  
  745.                           JUMPINI /Max- ctrl-1 Window
  746.  
  747.  /Skip | /All 
  748.            This is used to skip minimized or jump to all toggle sessions. This 
  749.            option can be placed either on the command line or in an input file. 
  750.            i.e.: 
  751.  
  752.                           JUMPINI /Skip
  753.            This option can be turned off by using: 
  754.  
  755.                           JUMPINI /All
  756.            or 
  757.  
  758.                           JUMPINI /Skip-
  759.  
  760.  /Loop | /One 
  761.            Specify this option to toggle through sessions with matching names, 
  762.            or only jump to the first session name found. This option can be 
  763.            placed either on the command line or in an input file. i.e.: 
  764.  
  765.                           JUMPINI /Loop
  766.            This option can be turned off by using: 
  767.  
  768.                           JUMPINI /One
  769.            or 
  770.  
  771.                           JUMPINI /Loop-
  772.  
  773.  /Hidden | /Jumpall 
  774.            Specify this option to skip hidden sessions, or jump to all, even if 
  775.            they are hidden. This option can be placed either on the command 
  776.            line or in an input file. i.e.: 
  777.  
  778.                           JUMPINI /Hidden
  779.            This option can be turned off by using: 
  780.  
  781.                           JUMPINI /Jumpall
  782.            or 
  783.  
  784.                           JUMPINI /Hidden-
  785.  
  786.  /Display 
  787.            Is used to display the current settings. i.e.: 
  788.  
  789.                           JUMPINI /D
  790.            This option should only be used on the command line. The output 
  791.            format is compatible as input to JUMPINI, so you can redirect output 
  792.            to a file:   JUMPINI /D >j.out You can then edit the file and use it 
  793.            as an input file:   JUMPINI @j.out 
  794.  /Words 
  795.            to display the function and toggle keywords. This option should only 
  796.            be used on the command line. 
  797.  /Keys 
  798.            to display the key names. This option should only be used on the 
  799.            command line. 
  800.  /Quiet 
  801.            to suppress informational messages. This option should only be used 
  802.            on the command line. 
  803.  
  804.  
  805. ΓòÉΓòÉΓòÉ 6. Support ΓòÉΓòÉΓòÉ
  806.  
  807. JumpKey 2.3.0 is provided as Employee Written Software by IBM. Support is 
  808. available on a best-effort basis by contacting the author, Thomas E. Link, at 
  809. 70105.1071@compuserve.com. IBM Internal users can post questions to the JUMPKEY 
  810. forum on OS2TOOLS. 
  811.  
  812. If you have a TCP/IP connection and you have the WebExplorer installed, you can 
  813. send mail directly to 70105.1071@compuserve.com. 
  814.  
  815.  
  816. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  817.  
  818. Press Ctrl-Esc, or click both mouse buttons together on the Desktop Background. 
  819. The displayed list contains all active OS/2 applications. 
  820.  
  821.  
  822. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  823.  
  824. This is the OS/2 application that has a highlighted border and is receiving all 
  825. keyboard input. 
  826.  
  827.  
  828. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  829.  
  830. An entry in the JumpKey/2 Toggle Session Titles list.