OS/2 Shareware BBS: 11 Util/11-Util.zip/jumpkey.zip/jumpkey.hlp

OS/2 Help File | 1996-05-22 | 59KB | 616 lines

ΓòÉΓòÉΓòÉ 1. JumpKey/2 General Help ΓòÉΓòÉΓòÉ

Use these HELP panels to find out how to use JumpKey/2.

General Help is available for the following items:

     Overview
     Command Line
     Menu Help


ΓòÉΓòÉΓòÉ 2. Overview ΓòÉΓòÉΓòÉ

JumpKey/2 allows you to set up key combinations that will jump directly to a
specific OS/2 Window. You can configure up to 32 JumpKey/2 sessions to jump to
as well as up to 32 sessions that will be toggled in a ring.

You can configure the keys that will initiate each jump, as well as the titles
that are jumped-to. Almost every key can be defined to make a jump.

There is only one default key assignment:

shift-ctrl-0 = Make JumpKey Visible

If this is the first time you have started JumpKey/2, Configure will be
automatically selected from the Options menu to set up session titles and keys.
Double click HERE for more details on the Configuration panel.

JumpKey/2 can be hidden while it operates or you can leave it as an icon, or a
displayed window.

Any items that you configure can be saved for the next time you start
JumpKey/2.

Note:  You CANNOT jump FROM a FULL-SCREEN session, such as a Full-Screen
Command Prompt, or Full-Screen DOS. You ARE permitted to jump TO one of these
sessions.


ΓòÉΓòÉΓòÉ 3. Command Line ΓòÉΓòÉΓòÉ

You can start JumpKey/2 with the command:

  start JumpKey [options]
or you can place the command line options as parameters in the settings
notebook for the program object.

The options that can be specified are:

 Option    Action
 /h
           Makes JumpKey/2 hide. It will still operate, but you will not be
           able to see it, and there will not be an entry in the Window List.
           If you want to see the window again, you can either:
               Start JumpKey/2 again.  This will not start another copy of the
                program.  It will make the first copy visible again.
               Use the shift-ctrl-0  key to make the JumpKey/2 program
                visible.  Use the Configure menu item to set up another key
                combination to perform this action.
               Double-click on the object in the folder where you started
                JumpKey/2.
 /n
           Starts JumpKey/2 as an icon.
 /d
           Uses all program defaults.  This will cause JumpKey/2 to discard any
           options you have previously saved.
 The '/' is optional. For example, to specify ALL the options, use the command:

    start JumpKey /hnd
 The options can be in ANY order.

 Note:  Make sure that the following DLLs

    hotdll32.dll
    jumpres.dll
 are located somewhere in the LIBPATH. If it is NOT, you will receive the
 message:

    The system cannot find the file HOTDLL32.
 from OS/2.


ΓòÉΓòÉΓòÉ 4. Menu Help ΓòÉΓòÉΓòÉ

The main menu can be selected by clicking on the menu items, or pressing the
Alt key and an underlined letter on the menu.

     Actions
     Options
     Help


ΓòÉΓòÉΓòÉ 4.1. Actions ΓòÉΓòÉΓòÉ

The Actions menu contains the following item:

     Hide


ΓòÉΓòÉΓòÉ 4.1.1. Hide ΓòÉΓòÉΓòÉ

This menu item will make the JumpKey/2 program invisible.  It will continue to
operate, but you will not see the program on the Desktop, as an Icon, or in the
Window List.  To make the program visible again you can:

     Start JumpKey/2 again.  This will not start another copy of the program.
      It will make the first copy visible again.
     Use the shift-ctrl-0  key to make the JumpKey/2 program visible.  Use the
      Configure menu item to set up another key combination to perform this
      action.
     Double-click on the object in the folder where you started JumpKey/2.

 You can invoke this function with the keyboard by pressing Alt+F11.


ΓòÉΓòÉΓòÉ 4.2. Options ΓòÉΓòÉΓòÉ

This options menu has three menu items:

     Configure
     View keys


ΓòÉΓòÉΓòÉ 4.2.1. Configure ΓòÉΓòÉΓòÉ

This menu item will initiate the JumpKey/2 configuration Panel. On this panel
you can set up:

     The keys to be used for JumpKey/2.
     The names of the sessions that will be jumped to.
 Double click HERE for more details on the Configuration panel.


ΓòÉΓòÉΓòÉ 4.2.2. View keys ΓòÉΓòÉΓòÉ

This menu item will let you see the keys that you currently have configured.
The list includes:

     The names of the keys that are associated with a jump session.
     The names of the sessions that will be jumped to.

 Double click HERE for more details on the defined keys panel.


ΓòÉΓòÉΓòÉ 4.3. Help Menu Help ΓòÉΓòÉΓòÉ

The Help menu lets you find out more information about the program.


ΓòÉΓòÉΓòÉ 4.3.1. Help for Help Index ΓòÉΓòÉΓòÉ

This menu item displays the Help Index.


ΓòÉΓòÉΓòÉ 4.3.2. Help for General Help ΓòÉΓòÉΓòÉ

This menu item will start the help system at the first JumpKey/2 help panel.


ΓòÉΓòÉΓòÉ 4.3.3. Help for Keys ΓòÉΓòÉΓòÉ

This menu item tells you keys that JumpKey/2 uses on its main panel.


ΓòÉΓòÉΓòÉ 4.3.4. Help for Help ΓòÉΓòÉΓòÉ

This menu item tells you how to use the OS/2 help system.


ΓòÉΓòÉΓòÉ 4.3.5. Product Information ΓòÉΓòÉΓòÉ

The Product Information Panel contains the Copyright and program version.


ΓòÉΓòÉΓòÉ <hidden> JumpKey/2 Configuration ΓòÉΓòÉΓòÉ

This dialog panel lets you set up the keys to be used for JumpKey/2 as well as
the titles used for the session names.

More detail is available for:

     Defining a Key
     Shift Key Settings
     Key Names
     Definitions
     Session Title Edit
     Maximize Session
     Exact Match
     Toggle Session List
     Toggle Session Edit
     Skip Minimized
     Toggle through like-named sessions
     Do not jump to hidden windows
     OK
     Cancel


ΓòÉΓòÉΓòÉ <hidden> Defining a Key ΓòÉΓòÉΓòÉ

To define a key, follow these steps:

   1. Select the key you want to define from the Key Names list, or select a
      shift key setting and then select a key from the displayed keyboard by
      pressing a key with the mouse.

      The current definition for this key will be displayed in the Definition
      list.

   2. Select a new definition in the Definition list.

   3. Move the cursor to the Session Title Edit box and type in a session title
      or select one from the session title pulldown list. The pulldown list has
      everything currently in the Window List.

   4. Click on the Maximize Session check box if you would like this session to
      maximize when you jump to it.

   5. Click on the Exact Match check box if you have sessions with similar
      names, and you want to jump only if there is an exact title match.

   6. The list of sessions for the Toggle function will display all the active
      3270 sessions. You can change this list by modifying the order of the
      items, or adding or deleting items from the list. Double click HERE for
      more details on Toggle sessions.

 When you have finished defining ALL your keys, press the OK button.

 If you want to discard your changes to the defined keys, press the Cancel
 button.


ΓòÉΓòÉΓòÉ <hidden> Keys Help ΓòÉΓòÉΓòÉ

Alt-F11 performs the JumpKey/2 hide function from the JumpKey/2 main window.

See your OS/2 reference for more information on standard key usage.

For help setting up keys for JumpKey/2, click HERE.


ΓòÉΓòÉΓòÉ <hidden> Shift Key Settings ΓòÉΓòÉΓòÉ

If you are using the displayed keyboard to select a key, you can set the shift
state by selecting from one of the five buttons below the keyboard:

     No Shift Keys
     Shift Pressed
     Ctrl Pressed
     Alt Pressed
     Shift+Ctrl Pressed

 Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> No Shift Keys ΓòÉΓòÉΓòÉ

When this radio button is selected, the key generated by pressing a key button
will not be combined with a shift key.


ΓòÉΓòÉΓòÉ <hidden> Shift Pressed ΓòÉΓòÉΓòÉ

When this radio button is selected, the key generated by pressing a key button
will be combined with either the left or right shift key.


ΓòÉΓòÉΓòÉ <hidden> Alt Pressed ΓòÉΓòÉΓòÉ

When this radio button is selected, the key generated by pressing a key button
will be combined with either the left or right Alt key.


ΓòÉΓòÉΓòÉ <hidden> Ctrl Pressed ΓòÉΓòÉΓòÉ

When this radio button is selected, the key generated by pressing a key button
will be combined with either the left or right Ctrl key.


ΓòÉΓòÉΓòÉ <hidden> Shift+Ctrl Pressed ΓòÉΓòÉΓòÉ

When this radio button is selected, the key generated by pressing a key button
must be combined with either the left or right Shift key and either the left or
right Ctrl key.


ΓòÉΓòÉΓòÉ <hidden> Key Names ΓòÉΓòÉΓòÉ

This list is an alphabetical list of the keys available for redefinition. You
can either select an entry on this list, or press a button in the displayed
keyboard above this list.

If the key is not present on an old PC keyboard, the name will have -enh
appended to the end of the key name. For example, the home key on the center of
a Model 70 keyboard is known as home-enh, while the home key on the numeric
keypad is simply home.

The keys may also have a prefix of:

 alt-
           indicates holding either ALT key and pressing the key.
 ctrl-
           indicates holding either CTRL key and pressing the key.
 shift-
           indicates holding either SHIFT key and pressing the key.
 shift-ctrl-
           indicates holding either SHIFT key AND holding either CTRL key while
           pressing the key.

 Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Definition List ΓòÉΓòÉΓòÉ

The following definitions are available:

 Name      Action
 No Action
           JumpKey/2 takes no action for the key. It is passed on to the Active
           OS/2 application.
 Make JumpKey/2 Visible
           will make JumpKey/2 visible again if it is hidden.  If JumpKey/2 is
           already visible, this key will bring JumpKey/2 to the foreground.
 Toggle Forward
           this will have one of two actions, depending on the Active OS/2
           application.
             1. If the Active OS/2 application is  NOT one of the configured
                Toggle Sessions, JumpKey/2 will jump to the FIRST Toggle
                Session.

             2. If the Active OS/2 application IS one of the Toggle Sessions,
                JumpKey/2 will jump to the NEXT Toggle Session. When this item
           is selected, you cannot select the Session Title Edit box.
 Toggle Backward
           this will have one of two actions, depending on the Active OS/2
           application.
             1. If the Active OS/2 application is NOT one of the configured
                Toggle Sessions, JumpKey/2 will jump to the FIRST Toggle
                Session.

             2. If the Active OS/2 application IS one of the Toggle Sessions,
                JumpKey/2 will jump to the PREVIOUS Toggle Session. When this
           item is selected, you cannot select the Session Title Edit box.
 Toggle Minimize
           this will minimize all Toggle sessions that are configured in the
           Toggle Session Title List. When this item is selected, you cannot
           select the Maximize Session, or the Session Title Edit box. Windows
           that support the hide function, instead of minimize, will be hidden
           instead.
 Toggle Maximize
           this will maximize all Toggle sessions that are configured in the
           Toggle Session Title List. When this item is selected, you cannot
           select the Maximize Session, or the Session Title Edit box.
 Toggle Restore
           this will restore all Toggle sessions that are configured in the
           Toggle Session Title List. When this item is selected, you cannot
           select the Maximize Session, or the Session Title Edit box.
 Minimize All
           this will minimize all running programs. Windows that support the
           hide function, instead of minimize, will be hidden instead.
 Maximize All
           this will maximize all running programs.
 Restore All
           this will restore all running programs.
 Lockup System
           this will invoke the built-in lockup function of the OS/2 desktop.
 Shutdown System
           this will invoke OS/2 shutdown procedure.
 <toggle session name>
           Each of these will jump to the specified OS/2 session.  When
           configured, the name of this session will be displayed in definition
           list and in the the Session Title Edit box above this list, where it
           can be changed.

           The term 'not defined xx'  (where xx is a number from 1 to 32) will
           be displayed for each entry in the list until a session name has
           been entered for the item.

 Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Session Title Edit ΓòÉΓòÉΓòÉ

This is a combination box where you can either type the name of the session to
be jumped-to for the session number displayed in the Definition List, or you
can pull down the list of sessions as displayed in the Window List. If you
click on the arrow to the right of this box, a list of all the currently
running sessions will be displayed. Select the session with the keyboard or
mouse.

The item can be any part of a title in the Window List. Remember that the first
match for this title will be the session that is jumped-to.

The search is NOT case-sensitive, but any blanks or punctuation must be
included just as displayed in the Window List.

Note:  You cannot select or type into this field unless a jump session title is
selected in the Definition List.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Maximize Session ΓòÉΓòÉΓòÉ

This check box should be selected if you would like the session whose name is
displayed in the Session Title Edit box to become maximized when JumpKey/2
switches to it.

Some applications will fill the entire screen when maximized. Others will
change shape, but still not fill the entire screen.

This option will cause the application to enlarge itself to its largest size.

Note:  You cannot select this check box unless Toggle Forward, Toggle Backward
or a jump session title is selected in the Definition List.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Exact Match ΓòÉΓòÉΓòÉ

This check box should be selected if you would like to jump to the session
whose name is displayed in the Session Title Edit box only if it is an EXACT
match for a Window List entry.

You may have applications with similar names, or names that are extensions of a
name, for example:

    Command Window
    Command Window:2

If you defined a Session Title called Command Window, and you want to make sure
JumpKey/2 always jumps to the first of the two task list entries above, you
would need to select Exact Match.

Note:  You cannot select this check box unless a Toggle function or a jump
session title is selected in the Definition List.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Toggle Session Title List ΓòÉΓòÉΓòÉ

This is a list box that contains the names of your 3270 sessions. These
applications will be accessed by the keys defined as Toggle Minimize, Toggle
Forward or Toggle Backward in the Definition List. The Toggle Forward and
Toggle Backward keys will have one of three actions, depending on the Active
OS/2 application.

   1. If the Active OS/2 application is NOT one of the toggle sessions,
      JumpKey/2 will jump to the FIRST toggle session.

   2. If the Active OS/2 application IS one of the toggle sessions, Toggle
      Forward will jump to the NEXT toggle session; Toggle Backward will jump
      to the PREVIOUS toggle session.

   3. If Skip Minimized has been selected, JumpKey/2 will not switch to
      Minimized sessions. Instead, the next or previous restored or maximized
      session will be switched-to.

 If you have not started, or you do not have the Communications Manager, this
 list will be empty. To make this list correct, start the Communications
 Manager before configuring JumpKey/2.

 To change an item in the list, use the cursor or the mouse to select an item,
 then edit the item as displayed in the Toggle Session Title Edit box, located
 just above the list, or select one from the Toggle Session Title Edit pulldown
 list. The terms 'not defined xx' will be displayed in the Toggle Session Title
 List (where xx is a number from 1 to 32) until an entry has been made for this
 item.

 Note:  You cannot select this list unless toggle Minimize, Toggle Forward or
 Toggle Backward is selected in the Definition List.

 Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Toggle Session Title Edit ΓòÉΓòÉΓòÉ

This is a combination box where you can either type the name of the session to
be jumped-to for the toggle function, or you can pull down the current list of
Communications Manager sessions. If you click on the arrow to the right of this
box, a list of all the currently running Communications Manager sessions will
be displayed. Select the session with the keyboard or mouse.

Simply type over any values displayed in this box, or select from the pull down
list. Then Click on OK to accept the change.

To delete an item from the Toggle list,  simple blank-out or delete all the
characters in the item, then select another item in the list. The list will be
adjusted for the now empty entry. The entry will be changed to read:

Note:  You cannot select or type into this field unless toggle Minimize, Toggle
Forward or Toggle Backward is selected in the Definition List.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Skip Minimized ΓòÉΓòÉΓòÉ

This check box should be selected if you would like JumpKey/2 to bypass Toggle
Sessions that are minimized.

When this option is selected, the keys defined as the toggle Forward and Toggle
Backward will jump to the next or previous restored or maximized session
defined in the Toggle Session Title List. If NONE of the defined sessions are
restored or maximized, JumpKey/2 will jump to the first session.

Note:  You cannot select this check box unless toggle Minimize, Toggle Forward
or Toggle Backward is selected in the Definition List.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Toggle Through Like-Named Sessions ΓòÉΓòÉΓòÉ

This check box affects all sessions except the toggle sessions. If selected
JumpKey/2 will loop through all sessions that match the session title.

For example, let us assume that you used the LaunchPad to start several
sessions that have a title of "OS/2 Window". Let us also assume that you have
another session called "Command Window".

Use the JumpKey/2 settings to configure the key ctrl-1 to jump to a session
titled "WINDOW" and do not select exact match.

If Toggle Through Like-Named Sessions is ON, each time you pressed ctrl-1,
JumpKey/2 would in turn toggle to each of the sessions titled "OS/2 Window",
and then also toggle to the session titled "Command Window".

If Toggle Through Like-Named Sessions is OFF, each time you pressed ctrl-1,
JumpKey/2 would jump only to the first session it found. This could be one of
the "OS/2 Window" sessions or the session titled "Command Window".

Use the JumpKey/2 settings to configure the key ctrl-1 to jump to a session
titled "OS/2 WINDOW" and DO select exact match.

If Toggle Through Like-Named Sessions is ON, each time you pressed ctrl-1,
JumpKey/2 would in turn toggle to each of the sessions titled "OS/2 Window",
but would not toggle to the session titled "Command Window".

If Toggle Through Like-Named Sessions is OFF, each time you pressed ctrl-1,
JumpKey/2 would jump only to the first session titled "OS/2 Window" that it
found.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Do Not Jump To Hidden Windows ΓòÉΓòÉΓòÉ

This check box affects all sessions except the toggle sessions. If selected
JumpKey/2 will not jump to windows which are hidden from view in the Window
List. If you have trouble jumping to a session, try turning this option OFF.

Double click HERE for more details on defining a key.


ΓòÉΓòÉΓòÉ <hidden> Defined Keys Panel ΓòÉΓòÉΓòÉ

This dialog panel lets you view the keys that are currently defined. The list
that is provided contains two columns:

     The names of the defined keys.
     The definition for the keys.

 If you double-click on a list item, JumpKey/2 will try to switch to that
 session. If you have chosen a toggle or system function, a warning tone will
 sound.

 At the bottom of this panel are buttons to select:

     Close - removes this dialog panel.
     Print - sends the displayed list to the printer defined as LPT1. You will
      hear a confirmation tone when the list has been sent to the printer.


ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ

Pressing the OK button accepts any changes on this panel and removes the panel.
Settings are saved in JUMPKEY.INI in the \OS2 directory on your boot drive.


ΓòÉΓòÉΓòÉ <hidden> CANCEL ΓòÉΓòÉΓòÉ

Pressing the CANCEL button discards any changes on this panel and removes the
panel. If changes have been made, you will be asked to confirm before
discarding the changes.


ΓòÉΓòÉΓòÉ <hidden> Print ΓòÉΓòÉΓòÉ

Pressing the PRINT button sends the displayed list to the printer defined as
LPT1. You will hear a confirmation tone when the output has been sent to the
printer.


ΓòÉΓòÉΓòÉ <hidden> No Help for this Panel ΓòÉΓòÉΓòÉ

There is no Help for this Panel. Double click  HERE for extended help.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Press Ctrl-Esc, or click the right mouse button on the Desktop Background. The
displayed list contains all active OS/2 applications.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

This is the OS/2 application that has a highlighted border and is receiving all
keyboard input.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

An entry in the JumpKey/2 Toggle Session Title list.