DUMP

Displays the contents of virtual storage from the selected dump.

Abbreviation: D
Syntax

DUMP address

Where:

address: Specifies the virtual storage location to be dumped, address can include a symbol and can specify an indirect address. Enter address using the following syntax. The base variable is required; the prefix, suffix and offset variables are optional:

[prefix]base[suffix][+|-offset[suffix]…]

A symbol can be used as part or all of the address operand. The symbol is automatically replaced by its assigned value during address resolution. For more information, see Using Symbols in the chapter "Advanced Techniques." The built-in symbols are as follows:

PSW: The PSW at the time the dump was captured.
CURRTCB: The address of the TCB at the time the dump was captured.
R0 to R15: The general purpose registers at the time the dump was captured.

Valid values for prefix are:

@: Treats the address as a 31-bit indirect address.
%: Treats the address as a 24-bit indirect address.

Valid values for base are:

*: Current location reference. Valid only when the Command is entered from a DUMP, MAP, or DISASSEM display. The asterisk (*) is replaced by the starting address of the current display.
hex value: A one- to eight-digit hexadecimal address.
decimal value: A one to 10 decimal digit followed by a decimal point.
symbol: A symbol previously defined by an EQUATE command or one of the predefined symbols.

Valid values for suffix are:

?: Treats the address as a 31-bit indirect address.
%: Treats the address as a 24-bit indirect address.

Valid values for offset are:

hex value: A one to eight digit hexadecimal address.
decimal value: A one to ten decimal digit followed by a decimal point.
L'symbol: The length of a previously defined symbol.
L'map: The length of a previously loaded map.
L'map label: The length of a previously loaded label within a loaded map.
nnnnnnnnK: Any number of kilobytes (KB). The value nnnnnnnn is multiplied by 1024 for kilobytes.
nnnnnnnnP: Any number of pages (P). The value nnnnnnnn is multiplied by 4096 for pages.
nnnnnnnnM: Any number of megabytes (MB). The value nnnnnnnn is multiplied by 1048576 for megabytes.
map.label: The offset of a label defined within a loaded map (that is, psa.psaaold).
symbol: The value of a symbol previously defined by an EQUATE command or the value of a predefined symbol.
Indirect Addresses: An indirect address identifies the address of an address. Suffix characters used to specify indirect address references are processed as they are encountered from left to right. Prefix characters used to specify indirect address references are processed once after the remainder of the address parameter has been completely resolved.

Examples:

From an existing dump display, to display the previous x'100' bytes of virtual storage:
```
DUMP *-100
```
To convert a MAP or DISASSEM display to DUMP format:
```
DUMP *
```
To display in dump format the contents of the virtual storage pointed to by general register 1 using the predefined symbol R1:
```
DUMP R1
```
To display in dump format the contents of the virtual storage pointed to by the first full word located at the address in general register 1, enter one of the following:
```
DUMP R1?+0?
DUMP R1??
```
To display in dump format the contents of the current TCB, enter one of the following:
```
DUMP CURRTCB
DUMP PSA.PSATOLD%
```

Tell Technical Publications how we can improve this information