Active Data Set Record Field

This is the section for data set information. These records are collected when the VOLUME, or STORAGEGROUP, or both of the parameters are selected, and the NODATAINFO parameter is not specified. One of these records is created for each data set encountered on every volume scanned. The record type for this record is D.

Name

Description

DCDDSNAM

1-to-44 character data set name. For a VSAM data set, this is the component true name (that is, the data or index name).

DCDERROR

This is the error indication byte. Each bit in this byte represents a distinct error encountered during processing. The following are indicated if the specified bit is 1.

Note: If DCOLLECT indicates errors in the VTOC/VVDS, use the DIAGNOSE command to get further information on the errors.

DCDEMNGD

An inconsistency was found in the SMS indicators for this data set.

DCDNOSPC

No space information was generated for this data set. The affected fields are:

• DCDALLSP
• DCDUSESP
• DCDSCALL
• DCDNMBLK

DCDVSAMI

An inconsistency was found in the VSAM indicators for this data set.

DCDNOFM1

A VTOC entry does not exist for this data set.

DCDFLAG1

This is the first byte of flags. The following are indicated if the specified bit is 1.

DCDRACFD

The data set is RACF® defined.

DCDSMSM

The data set resides on an SMS-managed volume.

DCDTEMP

The data set is a temporary data set. This indicator is valid only for SMS-managed data sets.

DCDPDSE

The data set is a partitioned extended data set.

DCDGDS

The data set is a generation data group data set. This indicator is valid only for SMS-managed data sets.

DCDREBLK

The data set can be reblocked.

DCDCHIND

The data set has been opened for other than input since the last time a backup copy was made.

DCDCKDSI

The data set is a Checkpoint/Restart Checkpoint data set.

DCDFLAG2

This is the second byte of flags. The following are indicated if the specified bit is 1.

DCDNOVVR

There is no VVDS entry (VVR) for this data set.

DCDINTCG

This data set is an integrated catalog facility catalog.

DCDALLFG

When ON, DCDALLSP value is set. DCDALLSX value is zero.

DCDUSEFG

When ON, DCDUSESP value is set. DCDUSESX value is zero.

DCDDECFG

When ON, DCDSCALL value is set. DCDSCALX value is zero.

DCDNMBFG

When ON, DCDNMBLK value is set. DCDNMBLX value is zero.

DCDFLAG3

This is the third byte of flags. The following are indicated if the specified bit is 1.

DCDPDSEX

Data set is an z/OS® UNIX System Services MVS™ data set.

DCDSTRP

Data set is an extended format data set.

DCDDDMEX

Indicates that Distributed Data Management (DDM) information exists in the catalog for this data set.

DCDCPOIT

Checkpointed data sets.

DCDGT64K

Data set can be greater than 64K tracks.

DCDDSORG

This field describes the data set organization. Only one bit will be set to 1.

DCDDSGIS

Data set organization is indexed sequential.

DCDDSGPS

Data set organization is physical sequential.

DCDDSGDA

Data set organization is direct.

DCDDSGPO

Data set organization is partitioned.

DCDDSGU

Data set organization is immovable.

DCDDSGGS

Data set organization is graphics.

DCDDSGVS

Data set organization is VSAM.

DCDRECRD

The record format byte for the data set.

DCDRECFM

These two bits describe the record format for the data set. This field is mapped by constants DCDRECFV, DCDRECFF, and DCDRECFU.

X'00'

Unused (undetermined)

X'01'

Variable length records

X'10'

Fixed length records

X'11'

Undefined length records

DCDRECFT

Blocks in the data set can use the hardware track overflow feature.

DCDRECFB

The data set records are blocked. This bit should not be set if the record format is "Undefined".

DCDRECFS

If the record format is "Fixed", the data set is using standard blocks, that is, there are no truncated blocks or unfilled tracks. If the record format is "Variable", the records are spanned.

DCDRECFA

The data set uses ANSI control characters.

DCDRECFC

The data set uses machine control characters.

DCDNMEXT

The number of extents the data set is using on this volume.

DCDVOLSR

6-character volume serial number the data set resides on.

DCDBKLNG

The length of each block for this data set.

DCDRCLNG

The length of each record for this data set.

DCDALLSP

The number of tracks allocated, multiplied by the track capacity. The actual number of bytes available to the data set might be less because of non-optimal block sizes. The amount of space allocated to the data set is rounded to the nearest kilobyte. See DCDNMBLK below. The maximum value is X'7FFFFFFF'. IBM® recommends utilizing the 63 bit value in DCDALLSX.

DCDUSESP

The number of tracks containing data from the data set, multiplied by the optimal track capacity (space used). It does not indicate the number of bytes in a data set.

Note: This information cannot be provided for VSAM data sets. For VSAM data sets, this field is set to zeros.

The maximum value is X'7FFFFFFF'. IBM recommends utilizing the 63 bit value in DCDUSESX.

DCDSCALL

The amount of space for the secondary allocation of this data set in kilobytes (rounded to the nearest kilobyte). The maximum value is X'7FFFFFFF'. IBM recommends utilizing the 63 bit value in DCDSCALX.

DCDNMBLK

The amount of space in kilobytes (rounded to the nearest kilobyte) that are wasted from non-optimal block size and from unused tracks on allocated cylinders. (This information cannot be provided for VSAM data sets.) If the data set is not VSAM and the system determined the block size, then this value is zero. The maximum value is X'7FFFFFFF'. IBM recommends utilizing the 63 bit value in DCDNMBSX.

DCDCREDT

The creation date of the data set in packed decimal. The format is X'YYYYDDDF'.

DCDEXPDT

The expiration date of the data set in packed decimal. The format is X'YYYYDDDF'. For VSAM data sets, this will always be a 'never expire' date.

DCDLSTRF

The last referenced date of the data set in packed decimal. The format is X'YYYYDDDF'.

DCDDSSER

The data set serial number. The data set serial number identifies the first or only volume containing the data set.

DCDVOLSQ

The volume sequence number.

DCDLBKDT

The system timestamp when the data set was backed up last. This field is an 8-byte binary value; it is only valid for SMS data sets. The format is STCK.

DCDDCLAS

Data class name¹

DCDDCLNG

The actual length of the data class name in DCDDATCL.

DCDDATCL

The data class name field.

DCDSCLAS

Storage class name field¹

DCDSCLNG

The actual length of the storage class name in DCDSTGCL.

DCDSTGCL

The storage class name.

DCDMCLAS

Management class name field¹

DCDMCLNG

The actual length of the management class name in DCDMGTCL.

DCDMGTCL

The management class name.

DCDSTOGP

Storage group name field¹

DCDSGLNG

The actual length of the storage group name in DCDSTGRP.

DCDSTGRP

The storage group name.

DCDCCSID

The coded character set identifier. This field is used to identify the coded character set to be used with this data set.

DCDUDSIZ

Data set size before compression. This field is applicable to extended format data sets. If this value and DCDCUDSZ are both zero, it is an indication that the data set is not compressed.

DCDCUDSZ

Data set size after compression. This field is applicable to extended format data sets only, and refers only to user data within the data set. That is, any system data written to the data set is not included here. If this value and DCDCUDSZ are both zero, it is an indication that the data set is not compressed.

DCDBDSZ

Data set sizes that are not valid in either or both of DCDUDSIZ or DCDCUDSZ. These fields might contain non-zero values, but should not be used. This field is applicable to non-VSAM extended format data sets only.

DCDOVERA

VSAM space available for release. This is the difference between the High Used Relative Byte Address (HURBA) and the High Allocated Relative Byte Address. This field is computed for all VSAM data sets but only applies to data sets eligible for partial release (VSAM Extended Format data sets). The space value is represented in bytes.

DCDFLAG5

This is the fifth byte of flags. The following are indicated if the specified bit is 1.

DCDALLFX

Allocated space information was returned from DASDCALC in field DCDALLSX.

DCDUSEFX

Used space information was returned from DASDCALC in field DCDUSESX.

DCDSCAFX

Secondary space information was returned from DASDCALC in field DCDSCALX.

DCDNMBFX

Space wasted information was returned from DASDCALC in field DCDNMBLX.

DCDALLSX

The number of tracks allocated, multiplied by the track capacity. The actual number of bytes available to the data set might be less because of non-optimal block sizes. The amount of space allocated to the data set is rounded to the nearest kilobyte. See DCDNMBLK below. The maximum value is X'7FFFFFFFFFFFFFFF'.

DCDUSESX

The number of tracks containing data from the data set, multiplied by the optimal track capacity (space used). It does not indicate the number of bytes in a data set.

Note: This information cannot be provided for VSAM data sets. For VSAM data sets, this field is set to zeros. The maximum value is X'7FFFFFFFFFFFFFFF'.

DCDSCALX

The amount of space for the secondary allocation of this data set in kilobytes (rounded to the nearest kilobyte). The maximum value is X'7FFFFFFFFFFFFFFF'.

DCDNMBLX

The amount of space in kilobytes (1024 bytes) that might be added in the used space if the data set had a more optimal block size (non-VSAM) or CI size (VSAM). If the data set is not VSAM and the system determined its block size, then this value is zero. The maximum value is X'7FFFFFFFFFFFFFFF'.

DCDDS9F1

This is one byte field flag for DCSB format 9. The following are indicated if the specified bit is 1.

DCDDS9CR

Format 9 DSCB has been build by DADSM CREATE DCDJBNMC. This field contains the name of the JOB that created the data set described by its format 8 DSCB .

DCDSTNMC

This field contains the name of the STEP that created the data set described by its format 8 DSCB.

DCDTIMEC

This field contain the value in microseconds since midnight, local time, that the date ser described by its format 8 DSCB was recreated.

DDCEATTR, DCDEATRC, DCDEATRV

Provides the data set EATTR attribute for EAS eligibility as defined in constants DDCEANUL, DDCEATNO, and DDCEATOP.

0

EAS eligibility is not specified.

1

Data set is not EAS eligible.

2

Data set is EAS eligible.

For non-VSAM data sets the EATTR value is not recorded in the catalog. For VSAM the system uses the EATTR value in the catalog and the VTOC value is not used. The catalog value is defined at the cluster level and recorded in the data component. Returned EATTR value for index and alternate index components are undefined.