DUMP (displaying and altering data)

The DUMP command displays a scrollable dump of memory. Some parameters of the DUMP command cause the CICSPlex® SM system-level debugging transaction, CODB, to be invoked.

If you alter the displayed memory, you must enter UPDATE (or press PF11) to record the change. If you alter memory but do not enter UPDATE, a message is displayed to remind you to enter UPDATE.

Notes:

If you issue the DUMP command without parameters, the CODB main menu is displayed.
For CICSPlex SM components, CODB displays the first transaction running under that component, which is its first OPB. You can use the NEXT and PREV PF keys to display multiple transactions. You can also use the LIST TASK command to display all of the stacks and methods in all of the CICSPlex SM tasks, and then select specific stacks, methods, or OPBs to display.

Command format

The format of the DUMP command is:

DUMP [parameters…]

Parameters

/resname: Displays the queue, EPTR, storage, or cache list allocated to the specified resource.
@method: Calls CODB with the entry point of the specified CICSPlex SM method.
hexadecimaladdress: Assumes the hexadecimal value is an address and enters CODB with ALET=0 and the address specified.
hexadecimalALET hexadecimaloffset: Displays the address of the specified ALET (first hexadecimal value) at the specified offset (second hexadecimal value).
hexadecimaladdress [length]: Displays the storage starting at the specified address. The amount of storage displayed is determined by the length parameter. Length is assumed to be a decimal value, unless a X'length' value is specified.
CACHE cachetoken: Displays the data identified by the specified cache-list token. The token is entered as two 8-byte hexadecimal character strings. To display the previous record, use PF4; to display the next record, use PF5; to display a specific record, enter REC n, where n is the record number.
CLIST token: Calls CODB with the specified token. The token is entered as two 8-byte hexadecimal character strings.
EIB compid: Displays the address of the CICS® information block for the first transaction running under the specified component.
EIS compid: Displays the address of the CICS storage block for the first transaction running under the specified component.
MODB compid: Displays the address of the MODB for the specified component.
MODD: Displays the address of the MODD.
MOEB compid: Displays the address of the MOEB for the specified component.
OPB compid: Displays the address of the first OPB for the specified component.
QUE token: Displays the data identified by the specified token. The token is entered as two 8-byte hexadecimal character strings.
STAKEND compid: Displays the address of the last stack for the first transaction running under the specified component.
STAKSTRT compid: Displays the address of the initial stack for the first transaction running under the specified component.
XLWA: Displays the CICSPlex SM kernel linkage work area.

Example DUMP XLWA display

Figure 1 shows an example XLWA display.

Figure 1. An example DUMP XLWA display

COMMAND==> XLWA       COMP ID==>      ADDR==>           ALET==> 00000000     
MSG==>                                                                       
0012D0A8  00000000  08006EC5  E8E4D5E7  D2D5D3C3  E6C1C1C2  ..>EYUNXKNLCWAAB 
0012D0B8  00000010  0D000200  00000000  00000000  00000000  ................ 
0012D0C8  00000020  8001608B  0000000E  0000EE00  11F20000  ..-..........2.. 
0012D0D8  00000030  0012D168  0000DE5C  113E8000  00000546  ..J....*........ 
0012D0E8  00000040  116D4468  00040000  11F2EE00  00100000  ._.......2...... 
0012D0F8  00000050  11F2EE00  FFFFFF6A  00000000  00000000  .2.....|........ 
0012D108  00000060  00000000  D2D3D7C2  116D8EB0  116DB328  ....KLPB._..._.. 
0012D118  00000070  116D7728  00CA812C  00000000  00000000  ._....a......... 
0012D128  00000080  00000000  00000000  00000000  00346EC5  ..............>E 
0012D138  00000090  E8E4E7C5  C5E8E4D9  E7C5D3E2  01030000  YUXEEYURXELS.... 
0012D148  000000A0  00CC4008  0E1B9CE8  00CA8118  00CA812C  .. ....Y..a...a. 
0012D158  000000B0  00F69A00  009C9520  0000011C  00000001  .6....n......... 
0012D168  000000C0  00000000  11F20000  11F21100  11F22200  .....2...2...2.. 
0012D178  000000D0  11F23300  11F24400  11F25500  11F26600  .2...2...2...2.. 
0012D188  000000E0  11F27700  11F28800  11F2AA00  11F29900  .2...2h..2...2r. 
0012D198  000000F0  11F2BB00  11F2CC00  00000000  00000000  .2...2.......... 
0012D1A8  00000100  11F2DD00  00000000  00000000  00000000  .2.............. 
0012D1B8  00000110  00000000  00000000  00000000  00000000  ................ 
0012D1C8  00000120  00000000  00000000  00000000  00000000  ................