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

Format:

	DEFINE/KEY key-name string [/qualifiers]

See also SHOW KEY and DELETE/KEY.

2 Parameters
The command has the following mandatory parameters.

key-name

	Specifies the name of the key that you are defining.

string

	Specifies the character string to be processed when you press
	the specified key. Enclose the string in double quotes to
	preserve spaces and lower case characters.

2 Command qualifiers
The command has the following qualifiers:

 /ECHO   /IF_STATE   /LOCK_STATE   /SET_STATE   /TERMINATE

2 /ECHO
 /ECHO
 /NOECHO

	Specifies whether the command line is echoed to the screen
	when you press the defined key.

	The default is /ECHO.

2 /IF_STATE
 /IF_STATE=(state,...)
 /NOIF_STATE

	Specifies a list of states, at least one of which must be set
	for the specified key definition to work.

2 /LOCK_STATE
 /LOCK_STATE
 /NOLOCK_STATE

	Specifies that the state set by the /SET_STATE qualifier
	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 definable key that you
	press or the next read-terminating character that you type.

2 /SET_STATE
 /SET_STATE=state
 /NOSET_STATE

	Specifies that the named state is set when the specified 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.

2 /TERMINATE
 /TERMINATE
 /NOTERMINATE

	Specifies whether the string executes when you press the
	specified key.

	The default is /NOTERMINATE, which means that you can press
	other keys before the command string is processed.

2 Default key definitions for CTF
The default key definitions for CTF are as follows:

   Key                CTF Function
   ---                ------------

   HELP               HELP
   PF2                HELP KEYPAD DEFAULT
   PF3                SHOW KEY/ALL
   KP0                NEXT
   KP2                START
   KP3                STOP
   KP4                ANALYZE/DATA=ASCII/NOSELECT/NODISPLAY/NOTRUNCATE
   KP6                ANALYZE/DISP=ALL/WIDTH=132
   KP7                ANALYZE/DATA=ASCII
   KP8                ANALYZE/DATA=HEXADECIMAL
   KP9                ANALYZE/DATA=OCTAL
   MINUS              ANALYZE/DATA=DECIMAL
   COMMA              ANALYZE/TRUNCATE
   PERIOD             BACK
   NEXT_SCREEN        NEXT
   PREV_SCREEN        BACK
   CTRL/L             CLEAR
   CTRL/W             REFRESH
   GOLD COMMA         ANALYZE/NOTRUNCATE
   GOLD KP0           ANALYZE/SCROLL
   GOLD KP2           START/LIVE
   GOLD KP6           ANALYZE/NODISPLAY
   GOLD NEXT_SCREEN   ANALYZE/SCROLL

2 Examples
CTF> DEFINE/KEY KP2 "START/LIVE/NOCOLLECT/TERMINATE"

	Causes KP2 to start live snapshot tracing.


CTF> DEFINE/KEY KP2/IF_STATE="GOLD" "START/NOCOLLECT/TERMINATE"

	Causes GOLD KP2 to start detached snapshot tracing.