Header Record Field

This is the header for all the record types. It contains all the common fields that are needed regardless of the type of data collected. All other output record data is appended to the header.

Name

Description

DCURDW

This field is NOT the RDW for the record that an assembler program sees. Assembler programs see the true RDW (4 bytes) preceding DCURDW by specifying RDW=YES in the DSECT statement. High-level languages, such as PL/1, have the true RDW stripped and see DCURDW as the first field in the record.

A parameter RDW=YES/NO can be specified with the IDCDOUT DSECT in the assembler program to generate the true RDW (4 bytes) which is located before the DCURDW field. The default value is NO.

For example,

DCOLL DSECT
IDCDOUT RDW=YES

DCULENG

Length of this record in bytes.

DCURCTYP

Record type for this record. Types are:

D: Active Data Set Record
A: VSAM Association Information
V: Volume Information
M: Migrated Data Set Information
B: Backup Data Set Information
C: DASD Capacity Planning Information
T: Tape Capacity Planning Information.

DCUVERS

The version number describing the returned format of IDCDOUT. Applications may utilize the returned version number to detect incompatible format changes. DCUVERS can contain constants DCUVERS1, DCUVERS2, and DCUVERSC.

1: Initial version of IDCDOUT.
2: DFSMS V1R10 version of IDCDOUT.
*: Used version of IDCDOUT - contains one of the above values.

The version number indicates when the IDCDOUT format was changed. All releases following the change will provide the same DCUVERS until a new format and version is defined. Version numbers change to indicate incompatible formats with prior versions. Version numbers do not change for compatible changes such as new fields and functions being added which do not affect prior fields or functions.

In the event of an IDCDOUT format change which is incompatible with prior versions, the value of DCUVERSC will be updated to a new value. Programs invoking DCOLLECT can compare the referenced IDCDOUT version being used by the program as indicated in the DCUVERSC constant to the system version being returned in DCUVERS to detect incompatible IDCDOUT formats.

DCUSYSID

Identification field of the system running DCOLLECT. This is the same as the SMF system ID for the system.

DCUTMSTP

The timestamp of the DCOLLECT run. This timestamp is the same for all records collected during one invocation of DCOLLECT. The timestamp consists of:

DCUTIME: The time in hundredths of a second from midnight (same format as in the SMF record header time stamp).
DCUDATE: The date in CCYYDDDF format (packed decimal).