HLASM Toolkit Feature Interactive Debug Facility User's Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


DUMP

HLASM Toolkit Feature Interactive Debug Facility User's Guide
GC26-8709-07

Displays a storage dump.
Read syntax diagramSkip visual syntax diagram
>>-DUMP--+--------+--+---------+-------------------------------><
         '-window-'  '-address-'   

window
A Dump window. Selected by a Window Specification or by placing the cursor in the window. If omitted and the cursor is not in a Dump window, uses the first Dump window.
address
The storage location at which the storage dump begins.

If an address is supplied on the command line, or an address can be determined from the cursor position, a storage dump of the indicated memory area is shown.

If no address is supplied, and an address cannot be determined from the cursor position, a storage dump listing is displayed, beginning at the first instruction which previously appeared on the dump display.

If the DUMP function is invoked when no Dump windows are open, one is opened.

If the DUMP function is invoked when a Dump window is open, but no address is specified, the window is closed.

If the DUMP function is invoked when a Dump window is open, and an address is specified, the starting address of the storage displayed in the window is changed.

IDF provides two DUMP modes, symbolic and unformatted, toggled by the DUMPMODE command.

The symbolic dump shows the names of storage areas along with the contents of each named area. The unformatted dump shows the traditional storage dump.

The storage dump shown by the DUMP command is presented in the current dump format. Toggle the dump format with the DUMPMODE command.

By positioning the cursor in a hexadecimal field displayed on the screen before pressing DUMP, you can make that field the first one displayed.

If the cursor is positioned in the first field displayed, and that field is a fullword and in AMODE24, the low-order 24 bits of the contents of that word specify the first location to DUMP. If in AMODE31, the low-order 31 bits are used instead. If in AMODE64, the contents of that word and the next word are used as the first location to dump.

Using this feature, it is easy to follow a linked list. Just place the cursor in the fullword that represents the link word, and repeatedly press the DUMP key.

Return codes

0
Operation successful
5
Syntax or other error in expression
6
Specified address exceeds the current virtual memory size

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014