Previous Topic: DELETE FunctionNext Topic: FORMAT Function


DUMP Function

The DUMP function dumps the contents of a named VLS file member in standard dump format (for example, hexadecimal), plus EBCDIC translation. The DUMP statement has the following format:

►►─ DUMP ─ memname ─┬───────────────────┬─┬─────────┬─────────────────────────►◄
                    └─ ,n1 ─┬─────────┬─┘ └─ ,CTRL ─┘
                            ├─ ,n2 ───┤
                            └─ ,LAST ─┘
DUMP

Specifies the DUMP function.

memname

Specifies the qualified name of the member to delete. For instructions to format the member name, see HEX Function. To dump all of the records in a member, specify:

DUMP memname
n1

Specifies either one record number or the first record number in a series of records. To dump one record, specify:

DUMP memname,n1
n2

Specifies the final record number in a series of records. To dump a series of records, specify:

DUMP memname,n1,n2
LAST

Specifies the last record in the member. To dump a series of records up to and including the last record in a member, specify:

DUMP memname,n1,LAST
CTRL

Dumps the member control block. To dump all of the records in a member and the member control block, specify:

DUMP memname,CTRL

If the records you want to display are no more than 132 bytes long, you can use the LIST function or the DUMP function. Always use the DUMP function for records that contain more than 132 bytes or for members that contain binary data. Using the DUMP function is the only way to determine the actual size of a VLS member.

Example 1

To dump a program called DUMPEX in system ABC in version 2, specify:

HEX /
DUMP ABCDUMPEX/404040404040404040/002L

The DUMP statement has the following format when dumping an output member from ADROUT:

HEX /
DUMP ssspppp/nnnnnnnn/
sss

System name

pppp

Prefix name

nnnnnnnn

Eight-digit output number in hex, preceded by zeros.

To dump output number 10 from the ADROUT library, enter:

HEX /
DUMP PSSPSS#/0000000A/

Where system = PSS and prefix = PSS#.