VMS Help DTM, REVIEW, Review Subsystem, DEFINE, /KEY  *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 - Restrictions

   o  Key definitions apply only to terminal environments.

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

2 - Command Qualifiers

 2.1 - /ECHO

   /ECHO (D)
   /NOECHO

   Specifies whether the command is displayed on your screen after
   you press the defined key. You cannot define a key by specifying
   both /NOECHO and /NOTERMINATE.

 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 states REVIEW and GOLD_REVIEW.
   The /NOIF_STATE qualifier selects the current state.

 2.3 - /LOCK_STATE

   /LOCK_STATE
   /NOLOCK_STATE (D)

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

 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. A state name can be any alphanumeric string.
   Digital Test Manager defines the two states REVIEW and GOLD_REVIEW.
   You cannot define a key specifying both /SET_STATE and /TERMINATE.
   The /NOSET_STATE qualifier selects the current state.

 2.5 - /TERMINATE

   /TERMINATE
   /NOTERMINATE (D)

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

3 - Example

   DTM_REVIEW> DEFINE/KEY KP1/IF_STATE=REVIEW/TERMINATE-
   _DTM_REVIEW> "NEXT/SUCCESSFUL"
   DTM_REVIEW> DEFINE/KEY KP1/IF_STATE=GOLD_REVIEW/TERMINATE-
   _DTM_REVIEW> "BACK/SUCCESSFUL"
   DTM_REVIEW>

   This example defines two keys on the Review subsystem keypad.
   When you press the keypad 1 key, you move forward to the next
   result description for a successful test. When you press the
   GOLD key followed by the keypad 1 key, you move backward to the
   previous result description for a successful test.