Technical data
System Dump Analyzer
DEFINE
/TERMINATE
/NOTERMINATE
Causes the key definition to include termination of the command, which causes
SDA to execute the command when the defined key is pressed. Therefore, you do
not have to press the Return key after you press the defined key if you specify the
/TERMINATE qualifier.
Description
The DEFINE command causes SDA to evaluate an expression and then assign
its value to a symbol. Both the DEFINE and EVALUATE commands perform
computations in order to evaluate expressions. DEFINE adds symbols to the SDA
symbol table but does not display the results of the computation. EVALUATE
displays the results of the computation but does not add symbols to the SDA
symbol table.
The DEFINE/KEY command associates an SDA command with the specified key,
in accordance with any specified qualifiers.
If the symbol or key is already defined, SDA replaces the old definition with the
new one. Symbols and keys remain defined until you exit SDA.
Examples
1.
SDA> DEFINE BEGIN = 80058E00
SDA> DEFINE END = 80058E60
SDA> EXAMINE BEGIN:END
In this example, DEFINE defines two addresses, called BEGIN and END.
These symbols serve as reference points in memory, defining a range of
memory locations that the EXAMINE command can inspect.
2.
SDA> DEFINE NEXT = @PC
SDA> EXAMINE/INSTRUCTION NEXT
NEXT: MOVL @00(R6),R0
Symbol NEXT defines the address contained in the program counter so that
you can use the symbol in an EXAMINE/INSTRUCTION command.
3.
SDA> DEFINE VEC SCH$GL_PCBVEC
SDA> EXAMINE VEC
VEC: 80B7D31C ".O.."
After the value of global symbol SCH$GL_PCBVEC has been assigned to
the symbol VEC, VEC is used to examine the memory location or value
represented by the global symbol.
4.
SDA> DEFINE COUNT = 7
SDA> DEFINE RESULT = COUNT * COUNT
SDA> EVALUATE RESULT
Hex = 00000031 Decimal = 49 PR$_SBIS
RESULT
The first DEFINE command assigns the value 7 to symbol COUNT. The
second DEFINE command defines RESULT to be the result of the evaluation
of an arithmetic expression using the symbol COUNT. Evaluation of RESULT
shows that system symbol PR$_SBIS has an equivalent value.
SDA–49