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).