DUMP

The DUMP (DUM) service displays the contents of storage in hexadecimal and character formats.

Syntax

The parameters are defined as follows:

Parameter	Description
expression	see Expressions
length	(optional) length, in bytes, of the storage area to be dumped The length can be an expression that evaluates to a decimal value in the range of 1-16,384. If you do not specify a length value, the value implied by the address expression will be used. If no length is implied by the address expression, the default is 40 hexadecimal (64 decimal). See Expressions for more information. All values are assumed to be hexadecimal unless you append N to the value to indicate a decimal. For example, 64N equals 40.
asi	address space instance; see Identifying-address-spaces for more information When omitted, the address space attribute of the expression is used as the target address space. If no address space attribute is associated with the expression, your address space will be used as the target address space.
LIST	displays the predefined and user-defined symbols, along with their respective definitions, that can be used with DUMP (see EQUATE for information about defining symbols)

Note

The length and address space instance are shown as the second and third parameters in the syntax diagram. However, you can specify them in either order.

Examples

To display the beginning of the CVT, type either one of the following:

Example 1

DUM,10?

          [1]               [2]                                [3]
AMTC1ZI 00000000_00FCC610 KEY= 0    BMVDWP4 (ASID 0125)
                                   [4]
AMTC12I 00FCC610 00000218 00FEA8A4 00FCC58C 00FCCBF8 *......yu..E....8*
AMTC12I 00FCC620 00000000 00FF6364 00FF20DE 00FE2B40 *............... *
AMTC12I 00FCC630 00FE2974 018B3CF0 813560A8 00FE3678 *.......0a.-y....*
AMTC12I 00FCC640 00F00C88 00FE9040 0105038F 00FC5310 *.0.h... ........*

Example 2

DUM,CVT

           [1]               [2]                               [3]
AMTC1ZI 00000000_00FCC610 KEY= 0    BMVDWP4 (ASID 0125)
AMTC12I 00FCC610 00000218 00FEA8A4 00FCC58C 00FCCBF8 *......yu..E....8*
                                   [4]
AMTC12I 00FCC620 00000000 00FF6364 00FF20DE 00FE2B40 *............... *
AMTC12I 00FCC630 00FE2974 018B3CF0 813560A8 00FE3678 *.......0a.-y....*
AMTC12I 00FCC640 00F00C88 00FE9040 0105038F 00FC5310 *.0.h... ........*
AMTC12I 00FCC650 00E5F000 00FF8B08 00FEA8C8 00000000 *.V0.......yH....*
AMTC12I 00FCC660 0A0307FE 00FCC594 00FC9840 00000000 *......Em..q ....*
AMTC12I 00FCC670 40C3E5E3 00FC54A8 00FE4B0A 00FE4B2A * CVT...y........*
AMTC12I 00FCC680 00F395E8 9BFCD3B0 00000000 00FE05B0 *.3nY..L.........*
AMTC12I 00FCC690 00000000 8140B1A8 00FEA778 018C5BD8 *....a .y..x...$Q*
AMTC12I 00FCC6A0 856F4000 00FC5310 00FEE728 00B8D6A8 *e? .......X...Oy*
AMTC12I 00FCC6B0 00000000 7FFFFFFF 00000000 00000000 *................*
AMTC12I 00FCC6C0 00FCCC20 0000A320 00FE8BF0 00FCC5C8 *......t....0..EH*
AMTC12I 00FCC6D0 00FC4DF8 80F9E1B0 00FC9748 00000000 *..(8.9....p.....*
AMTC12I 00FCC6E0 00000000 0A0D0A06 00000000 00FCC0D0 *................*
AMTC12I 00FCC6F0 01391D40 024D6F44 00FE1FC8 00FCA2D0 *... .(?....H..s.*
AMTC12I 00FCC700 00000000 00000000 00F3CEC0 00FCCB60 *.........3.....-*

Legend:

display address
virtual storage key (first digit); a P following this digit indicates that the storage is fetch-protected; the remaining three bits are always zero
character representation of hexadecimal dump
sixteen-byte hexadecimal dump per line

Example 3

When you type DUMP without any operands, you see a list of all of the user-created symbols (by way of the EQUATE service) or the symbols created on behalf of the user (by the MEMSCAN, OLIST, and TCB services). For example, type

DUMP

AMTC1HI USER DEFINED SYMBOLS ARE:
AMTC1GI MOBJ0001 00000200_00000000
AMTC1GI MOBJ0002 00000001_00000000
AMTC1GI MOBJ0003 00000001_08200000
AMTC1GI @TCB001   7FD968
AMTC1GI @TCB001   7CAD90
AMTCIGI @TCB003   7CA930
AMTC1FI @TCB004   7BCE88
AMTC1GI @TCB005   7CA5F0
AMTC1GI @TCB006   7EE6B0
AMTC1GI @TCB007   7EEA40
AMTC1G1 @TCB008   7EE468
AMTC1GI @TCB009   7EE150

To display the symbols that can be used with the DUMP service, type

DUMP LIST

AMTC1HI USER DEFINED DUMP SERVICE LABELS ARE:
AMTC1GI @PWVT     00008C88
AMTC1GI @AVT      00009000
AMTCIGI @BBCT     @AVT+58?
AMTC1FI PREDEFINED DUMP SERVICE Control BLOCK LABELS ARE:
AMTC1GI @ACB      10%+100?+14?+18?
AMTC1GI @AMCBS    10%+100?
AMTC1GI @ASCB     224%
AMTC1G1 @ASMVT    10%+2C0?
AMTC1G1 @JSTCB    224%+6C%+8%+7C%

Example 4

You can use a combination of predefined symbols and indirection indicators to display the CDEs for the job pack area (JPA) for an address space. For example, to locate the beginning of the chain and display the first CDE for address space JES2, type

DUMP,JSTCB+2C?,20,JES2

AMTC1ZI 00000000_005C1850 KEY= 0 JES2 (ASID 001A)
AMTC12I 005C1850 005D1120 00000000 C9C5C6C3 D5C1D4E2 *.)......IEFCNAMS*
AMTC12I 005C1860 8022A9E8 005D0868 000210FC 31224000 *..zY.)........ .*

The +2c? in the command displays the 31-bit address located at +2C from the beginning of the area.

To display the next CDE in the chain, type

DUMP,*?,20*

AMTC1ZI 00000000_005D1120 KEY= 0 JES2 (ASID 001A)
AMTC12I 005D1120 005FF008 00000000 C9C5C6E5 C8F14040 *..0.....IEFVH1 *
AMTC12I 005D1130 970E2F48 005FC2A8 000210FC 31224000 *p.....By...... .*

The first asterisk in the command represents the beginning of the area previously displayed, and the second asterisk indicates that the target address space is the same as in the previous command.

To display the next CDE in the chain, simply repeat the previous command by entering an asterisk; for example, type

AMTC1ZI 00000000_005FF008 KEY= 0    JES2     (ASID 001A)
AMTC12I 005FF008                     005FF150 00000000          *..1&....*
AMTC12I 005FF010 C9C5C1E5 D4F7F0F2 97030900 005FF0F0 *IEAVM702p.....00*
AMTC12I 005FF020 000110FC 31224000                     *...... .        *

You can repeat this command until all CDEs in the chain have been displayed.

Example 5

To evaluate an expression and display the storage at the resulting address, type

DU,MOBJ0009+740!,100

AMTC1XI MOBJ0009+90F0                Size= 4095M, Guard= 1M
AMTC1ZI 00000001_001090F8 KEY= 0    DHO2DBM1 (ASID 009E)
AMTC12I 001090F8                     00F20030 00000000          *.2......*
AMTC12I 00109100 00000000 01000000 00000001 22903000 *................*
AMTC12I 00109110 00000000 00000000 00000000 143B8FE4 *...............U*
AMTC12I 00109120 BCE2BF0E AF590A68 C6C2D3D2 0F87E570 *.S......FBLK.gV.*
AMTC12I 00109130 00000001 00109000 00000000 00000000 *................*
AMTC12I 00109140 00F20030 00000000 00000000 004E2000 *.2...........+..*
AMTC12I 00109150 00000001 23903000 00000000 00000000 *................*
AMTC12I 00109160 00000000 143B905A BCE2BF0E AF5A0BE8 *.........S.....Y*
AMTC12I 00109170 C6C2D3D2 00000000 00000001 00109000 *FBLK............*
AMTC12I 00109180 00000000 00000000 00000001 001091D0 *..............j.*
AMTC12I 00109190 C6D9C5C5 00000000 00000000 00000000 *FREE............*
AMTC12I 001091A0 00000000 00000000 00000000 00000000 *................*
AMTC12I 001091B0 00000000 00000000 C6C2D3D2 00000000 *........FBLK....*
AMTC12I 001091C0 00000001 00109000 00000000 00000000 *................*
AMTC12I 001091D0 00000001 00109218 C6D9C5C5 00000000 *......k.FREE....*
AMTC12I 001091E0 00000000 00000000 00000000 00000000 *................*
AMTC12I 001091F0 00000000 00000000                     *........        *

Note

The resulting storage is within a memory object.

See OLIST for additional information about working with memory objects.

Usage notes

The DUMP service operates in SRB mode when displaying data. Therefore, PSATOLD (task control block -TCB old pointer of the prefixed saved area) always contains zero and cannot be used to locate the current TCB (task control block).
ZAP is sometimes used immediately following DUMP. The beginning address of the storage area last displayed by DUMP is retained. The ZAP service can refer to this address by using an asterisk (*) for the hexadecimal location parameter.
For processor complexes consisting of more than one CPU, you can specify a CPU number. Add /c to the end of the value specified for expression, where c is the number of an available CPU.
LIST or LI is a valid alias for the DUMP service.
If you omit the length parameter on the COMMAND line, you can specify the asi parameter in its place; for example, DUMP @CSCB INVENTRY, where INVENTRY is an address space instance.