Technical data

DEFINE/KEY

The DEFINE/KEY command associates a string with a particular key on your

keyboard.

Format

DEFINE/KEY key-name string [/qualiﬁers]

Parameters

key-name

Speciﬁes the name of the key that you are deﬁning. See Table 3–2 for a list of the

keys that CTF deﬁnes.

string

Speciﬁes the character string to be processed when you press the speciﬁed key.

Enclose the string in double quotes to preserve spaces and lower case characters.

Qualiﬁers

/ECHO

/NOECHO

Speciﬁes whether the command line is echoed to the screen when you press the

deﬁned key. The default is /ECHO.

/IF_STATE=(state,...)

/NOIF_STATE

Speciﬁes a list of states, at least one of which must be set for the speciﬁed key

deﬁnition to work.

/LOCK_STATE

/NOLOCK_STATE

Speciﬁes that the state set by the /SET_STATE qualiﬁer remains in effect until a

DEFINE/KEY/NOSET_STATE command is issued to unset the state. The default

is /NOLOCK_STATE, meaning that the effect of /SET_STATE lasts only until the

next deﬁnable key that you press or the next read-terminating character that you

type.

/SET_STATE=state

/NOSET_STATE

Speciﬁes that the named state is set when the speciﬁed key is pressed. The state

name can be any alphanumeric string. The default is /NOSET_STATE, meaning

that the current locked state is unset when the key is pressed.

See the description of the DCL command DEFINE/KEY in your VMS

documentation for more information about key states.

/TERMINATE

/NOTERMINATE

Speciﬁes whether the string executes when you press the speciﬁed key. The

default is /NOTERMINATE, which means that you can press other keys before

the command string is processed.

4–10 CTF Commands