DUMP command

This section provides an overview of the Troubleshooting command DUMP.

Usage

The DUMP command is a tool used for diagnosis. It provides, in dump format, a printout of an input data set. All records in the input data set, a selected range of records, or specific record types can be dumped.

Usage notes

  • The DUMP command defines options for the record dump module.
  • Dumps are written to SYSPRINT in a hexadecimal dump format.
  • Sample JCL for DUMP and TAPECOPY commands shows sample JCL for DUMP and TAPECOPY commands.

Syntax

Read syntax diagramSkip visual syntax diagramdump nameDUMP(EXEC(INPUTDD)OFFSET(4integer)CODES(codelist)SKIP(0integer)STOPAFT(0integer)MAXDUMP(whole recordinteger))

Subcommand options

dump name
A user-defined name printed on the dump. If this field is omitted, the records are identified with the name DUMP0001.

Ensure that the specified name is not the same as a OMEGAMON® for DB2® PE command keyword or abbreviation.

EXEC
Specifies INPUTDD as the ddname of the input data set. INPUTDD is the only valid ddname for this option and must be specified.
OFFSET
The offset of the record code into the record. The record code is a 1-byte field at position offset-plus-1. For example, OFFSET(4) defines a record code in the fifth byte of the record. The offset must be a numeric value less than the actual length of the record. The maximum value is 999 999 999. The default is 4.
CODES
The code values for records to be processed. Each code is a 2-digit hexadecimal number. You can specify either of the following:
  • A list of values, for example '01,02,03'
  • A range of values, for example '01-03,05-07'

Each entry must be separated by a comma. Enclose the code list in quotes if more than one value is specified.

If this option is omitted, all record codes (00-FF) are processed.

SKIP
The number of records to be skipped before processing begins. The maximum value is 999 999 999. The default is 0, which means that processing begins with the first record.
STOPAFT
The number of records to be processed, starting after the number of records to be skipped (SKIP option). The maximum value is 999 999 999. The default is 0, which causes all records (after skipping, if specified) to be processed.
MAXDUMP
The length of the dump in bytes, starting from the beginning of the record. The default is the full length of the record. You can enter any integer in the range of 1 to 99 999. For example, if you specify MAXDUMP(128), only the first 128 bytes of input records are dumped.
Note: Some IFCID records can be up to 32 KB in length. If you use the default for MAXDUMP (the entire record), very large reports can be produced.

Example using DUMP

In this example:
  • The DUMP is named DUMPSTAT.
  • The ddname of the input data set is INPUTDD (the GLOBAL default).
  • The offset of 4 defines a record code in the fifth byte of the record.
  • Only records with a value of 01 or 02 in the fifth byte are dumped.
  • The first 125 records of the input data set are skipped.
  • The next 10 records that meet the specifications are dumped.
  • Only the first 1 000 bytes of each record are dumped.
DUMPSTAT DUMP (
EXEC    (INPUTDD)
OFFSET  (4)
CODES   ('01,02')
SKIP    (125)
STOPAFT (10)
MAXDUMP (1000))
Note: See also Sample JCL for DUMP and TAPECOPY commands.