Previous Topic: Snap FacilityNext Topic: Modifying the System


Dump Facility

The DUMP facility traces the activity to or from the DRWORK file. The system places several different types of information on this file during the execution of the Reporting Facility. They include:

You can invoke the DUMP facility using either a special OPTION command in the Reporting Facility program or by standard JCL specifications.

►►─ OPTION ─ DUMP ─┬────────────────┬─────────────────────────────────────────►◄
                   └─ control-word ─┘
control-word

Optionally use one of the following control words with this command:

DRREAD

Specifies that only reads to the DRWORK file are to cause formatted output by the DUMP routines.

DRWRITE

Specifies that only writes to the DRWORK file are to cause formatted output by the DUMP routines.

DRADD

Specifies that output is to be formatted only when data is being added to the DRWORK file.

DRWORK <ID>

Specifies that all reads, writes, and additions to the DRWORK file are to be reported. The ID parameter denotes the specific phases of the program in which data is to be formatted.

This parameter is optional, but, when coded, must be coded in the same manner as with the OPTION TRACE phaseid parameter.

In a z/OS environment, use the PARM= parameter of the EXEC command to initiate the DUMP facility. For example:

 // EXEC PGM=DRREPORT,PARM='DUMP,xxxxxxx,yyyyy'
,xxxxxxx

Is one of the four options discussed above (DRADD, DRREAD, DRWRITE, or DRWORK).

,yyyyy

Is one or more of the optional phaseid parameters.

In a z/VSE environment, use the UPSI command as follows:

 // UPSI 01234567
bits 0-2

Correspond to DRWRITE, DRREAD, and DRADD, respectively

bits 3-7

Correspond to phases A, C, G, H, and I, respectively