The DEFINE/ADDRESS command assigns a symbolic name to an
address expression in a program. You can define a symbol for a
nonsymbolic program location or for a symbolic program location
having a long path-name prefix. You can then refer to that
program location with the symbolic name. The /ADDRESS qualifier
is the default.
The DEFINE/COMMAND command enables you to define abbreviations
for debugger commands or even define new commands, either from
the debugger command level or from command procedures.
The DEFINE/VALUE command enables you to assign a symbolic name to
a value (or the result of evaluating a language expression).
The DEFINE/LOCAL command confines symbol definitions to command
procedures. By default, defined symbols are global (visible
outside the command procedure).
To enter several DEFINE commands with the same qualifier, first
use the SET DEFINE command to establish a new default qualifier
(for example, SET DEFINE COMMAND makes subsequent DEFINE commands
behave like DEFINE/COMMAND). You can override the current default
qualifier for a single DEFINE command by specifying another
qualifier.
In symbol translation, the debugger searches symbols you define
during the debugging session first. So if you define a symbol
that already exists in your program, the debugger translates the
symbol according to its defined definition, unless you specify a
path-name prefix.
If a symbol is redefined, the previous definition is canceled,
even if you used different qualifiers with the DEFINE command.
Definitions created with the DEFINE/ADDRESS and DEFINE/VALUE
commands are available only when the image in whose context
they were created is the current image. If you use the SET IMAGE
command to establish a new current image, these definitions are
temporarily unavailable. However, definitions created with the
DEFINE/COMMAND and DEFINE/KEY commands are always available for
all images.
Use the SHOW SYMBOL/DEFINED command to determine the equivalence
value of a symbol.
Use the DELETE command to cancel a symbol definition.
Related commands:
DECLARE
DELETE
SET IMAGE
SHOW DEFINE
SHOW SYMBOL/DEFINED