Establishes the current key state.

                                   NOTE

       This command is not available in the VSI DECwindows Motif for
       OpenVMS user interface to the debugger.

    Format

      SET KEY

1  –  Qualifiers

1.1    /LOG

       /LOG (default)
       /NOLOG

    Controls whether a message is displayed indicating that the key
    state has been set. The /LOG qualifier displays the message. The
    /NOLOG qualifier suppresses the message.

1.2    /STATE

       /STATE[=state-name]
       /NOSTATE (default)

    Specifies a key state to be established as the current state.
    You can specify a predefined key state, such as GOLD, or
    a user-defined state. A state name can be any appropriate
    alphanumeric string. The /NOSTATE qualifier leaves the current
    state unchanged.

2  –  Description

    Keypad mode must be enabled (SET MODE KEYPAD) before you can use
    this command. Keypad mode is enabled by default.

    By default, the current key state is the DEFAULT state. When
    you define function keys, you can use the DEFINE/KEY /IF_STATE
    command to assign a specific state name to the key definition.
    If that state is not set when you press the key, the definition
    is not processed. The SET KEY/STATE command enables you to change
    the current state to the appropriate state.

    You can also change the current state by pressing a key
    that causes a state change (a key that was defined with
    DEFINE/KEY/LOCK_STATE/SET_STATE).

    Related commands:

       DELETE/KEY
       DEFINE/KEY
       SHOW KEY

3  –  Example

  DBG> SET KEY/STATE=PROG3

      This command changes the key state to the PROG3 state. You
      can now use the key definitions that are associated with this
      state.