VMS Help DTM, DEFINE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   Use DEFINE/KEY to define a key to execute a command string.

   Format

     DEFINE/KEY  key-name "command-string" [/qualifier...]

1 - /KEY

   Use DEFINE/KEY to define a key to execute a command string.

   Format

     DEFINE/KEY  key-name "command-string" [/qualifier...]

 1.1 - Restrictions

   o  Key definitions apply only to terminal environments.

   o  Keys defined with the DEFINE/KEY command at the Digital Test
      Manager command level can only be used at the Digital Test Manager
      command level and are not effective during test recording or
      in the REVIEW subsystem.  A separate DEFINE/KEY command may be
      used within the REVIEW subsystem to define keys within that
      environment.

 1.2 - Command Qualifiers

 1. 2.1 - /ECHO

   /ECHO (D)
   /NOECHO

   Specifies whether the command is displayed on your screen after
   you press the defined key. You cannot specify both the /NOECHO
   qualifier and the /NOTERMINATE qualifier.

 1. 2.2 - /IF_STATE

   /IF_STATE=(state-name,...)
   /NOIF_STATE

   Specifies a list of states, any one of which must be set to enable
   the specified key definition. The default is the current state.
   Digital Test Manager defines the two state names as DTM and GOLD_DTM.
   The /NOIF_STATE qualifier selects the current state.

 1. 2.3 - /LOCK_STATE

   /LOCK_STATE
   /NOLOCK_STATE (D)

   Specifies the state specified with the /SET_STATE qualifier until
   you use the /SET_STATE qualifier again to change it.

 1. 2.4 - /SET_STATE

   /SET_STATE=state-name
   /NOSET_STATE

   Associates a state with the key you are defining. The default
   is the current state. Digital Test Manager defines the two state
   names as DTM and GOLD_DTM. You cannot define a key specifying
   both the /SET_STATE qualifier and the /TERMINATE qualifier.
   The /NOSET_STATE qualifier selects the current state.

 1. 2.5 - /TERMINATE

   /TERMINATE
   /NOTERMINATE (D)

   Determines whether the specified command string executes when you
   press the defined key. When you use the /NOTERMINATE qualifier,
   you must press the RETURN key to execute a command. You cannot
   specify both the /SET_STATE qualifier and the /TERMINATE qualifier
   or the /NOECHO qualifier with the /NOTERMINATE qualifier.

 1.3 - Examples

   1.  DTM> DEFINE/KEY KP5 "SET LIBRARY DUA0:[USER01.LIB_A]"/TERMINATE
       DTM>

   If you subsequently press keypad 5, the following text is
   displayed:

       DTM> SET LIBRARY DUA0:[USER01.LIB_A]
       %DTM-S-LIBIS, Digital Test Manager library is DUA0:[USER01.LIB_A]
       DTM>

   2.  DTM> DEFINE/KEY KP5 /IF_STATE=GOLD_DTM -
       _DTM> "SET LIBRARY DUA0:[USER01.LIB_B]"/TERMINATE
       DTM>

   This example defines GOLD keypad 5 to set the default Digital Test
   Manager library to a different library than the one in the
   previous example. If you subsequently press GOLD Keypad 5, the
   following text is displayed:

       DTM> SET LIBRARY DUA0:[USER01.LIB_B]
       %DTM-S-LIBIS, Digital Test Manager library is DUA0:[USER01.LIB_B]
       DTM>