Equate a name with a variable, expression, or command

You can then use that name alone or within another expression. If you use it within another expression, the value of the name is determined before the expression is evaluated. These names stay active until a debug session ends or a name is removed.

To equate a name with a variable, expression or debug command, type the following on the debug command line:

EQUATE shorthand-name definition

shorthand-name is the name that you want to equate with a variable, expression, or debug command, and definition is the variable, expression, or debug command that you are equating with the name.

For example, to define a shorthand name called DC that displays the contents of a variable called &COUNTER, type the following on the debug command line:

EQUATE DC EVAL &COUNTER

Now, each time DC is typed on the debug command line, the command EVAL &COUNTER is performed.

The maximum number of characters that can be typed in an EQUATE command is 144. If a definition is not supplied and a previous EQUATE command defined the name, the previous definition is removed. If the name was not previously defined, an error message is shown.

To see the names that have been defined with the EQUATE debug command for a debug session, type the following on the debug command line:

DISPLAY EQUATE

A list of the active names is shown on the Evaluate Expression display.