Dump Viewer Commands › EQUATE

EQUATE

Defines a symbol to represent a virtual storage address or any other numeric value. For more information, see Using Symbols in the chapter Advanced Technique.

Abbreviation

EQ

Syntax

EQUATE symbol address {length|USE mapname}  

Where:

symbol

Specifies a one to eight character symbol name beginning with a letter (a to z) and containing any alphanumeric characters including the national symbols @, #, and $.

address

Specifies the virtual storage location to be equated with a symbol.

Note: See the description of the DUMP command in this appendix for more information about address specification.

length

Specifies the length of the area to be equated with a symbol.

Mapname

Specifies the name of a loaded map that is used to Auto-Map the specified address.

Examples:

• To equate the symbol X with the storage location currently being displayed:

  EQUATE X *
  

• To equate the symbol LTCB with the length of the map being used for Task Control Blocks:

  EQUATE LTCB  L'TCBFIX
  

• To equate the symbol EP with the start of the program last in control before the dump, using an arbitrary length of 4096 bytes:

  EQUATE EP R13?+4?+10? 4K