EQUATE
The EQUATE (EQU) service facilitates the use of expressions by permitting you to assign a symbolic name to represent an expression.
The EQUATE service also provides the ability to display, redefine, and delete symbol definitions. The symbol name must begin with an alphabetic or national character ($, #, or @) that can be followed by up to eight alphanumeric and national characters (the symbol name can be a maximum of nine characters).
Syntax
The parameters are defined as follows:
Parameter | Description |
|---|---|
symbol | symbol to be defined or displayed The symbol must begin with @ and can be followed by one-to-eight alphanumeric characters. |
LIST | displays the definition of the symbol, if previously defined (default) |
definition | expression that defines the symbol This expression can begin with either a previously defined symbol (including the one being defined) or a hexadecimal address, optionally followed by offset values (+ or -) or indirection indicators (%, ?, !, >) or both. For example, the start of the CVT prefix can be defined as 10%-100. |
length | ( optional ) defines the length attribute for the symbol The value is assumed to be in hexadecimal unless followed by the letter N. For example, to specify a value of 64, enter 40 or 64N. If this parameter is omitted and the definition begins with a previously defined symbolic name, the length attribute of that symbol is used. Otherwise, a value of 64N is used. |
asi | address space instance; see Identifying-address-spaces for more information If this parameter is omitted, the address space attribute associated with the expression will be used if previously defined; otherwise, the job instance token for your address space will be used. |
DELETE | deletes the symbol |
Examples
To display the definition of symbol @JSCB, type
EQUATE,@JSCB
To define symbol @A as symbol @JSCB + DC? and give it a length of 64 bytes, type
EQUATE,@a,@JSCB+DC?,64N
To delete symbol @A, type
EQUATE,@A,DELETE