DATATYPE MCDS Field Name Table


DATATYPE MCDS field name table

This is complete list of all operands that are available for use with DATATYPE=MCDS. MCDS extracts data set information from the DFSMShsm Migration Control Data Set (MCDS), a VSAM cluster. A LOCATE SVC (SVC 26) is issued to determine if data sets extracted from the MCDS are still cataloged for auto recall under DFSMShsm.

DATATYPE=MCDS Field Name Table

Field Name

XSELECT

REPORT

SORT

SUMMARY

PUNCH

Length

Attribute

Description

%FREE

A

Y

Y

V

Y

3

NUM

Tracks not in use within a data set as a percentage

%USED

A

Y

Y

V

Y

3

NUM

Tracks in use within a data set as a percentage

ADATE

A

Y

Y

V

Y

D

DATE

Archive date

ADAYS

A

Y

Y

V

Y

5

NUM

Days since archived

ATIME

A

Y

Y

V

Y

8

TIME

Archive time - hh.mm.ss

BYTES

A

Y

Y

S

Y

B

BYTE

Allocated space (bytes / kB / MB)

BYTESFRE

A

Y

Y

S

Y

B

BYTE

Unused space (bytes / KB / MB)

BYTESTRK

A

Y

Y

V

Y

5

NUM

Bytes per track (calculated)

BYTESUSE

A

Y

Y

S

Y

B

BYTE

Used space (bytes / KB / MB)

BLKSIZE

A

Y

Y

V

Y

5

NUM

Data set block size

BLKSTRK

A

Y

Y

V

Y

4

NUM

Number of blocks per track

CATALOG

E

Y

Y

V

Y

3

CHAR

Catalog status:

CAN - Cataloged to candidate volume

DRF - DASD read failure

ERR - Cataloged to another volume

NO - Not cataloged

ONL - Only cataloged

UNK - Cataloged, but unable to process with LOCATE

YES - Cataloged to this volume

Important

This can be expensive to collect if a large number of data sets are to be reported

CLUSTER

A

Y

Y

V

Y

44

CHAR

Cluster name (ICF VSAM)

COMPTYPE

E

Y

Y

N

N

5

CHAR

Component type (ICF VSAM):

AIXDA - AIX data component

AIXIN - AIX index component

DATA - Base cluster data component

INDEX - Base cluster index component

CRDATE

A

Y

Y

Y

Y

D

DATE

Creation date

CRDAYS

A

Y

Y

V

Y

5

NUM

Days since created

DATACLAS

E

Y

Y

V

Y

8

CHAR

SMS data class

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

DAYSEXP

A

Y

Y

V

Y

5

NUM

Days since until expiration

Important

If the expiration date is 99.000, 99.xxx (where xxx is 365 or above), DAYSEXP is set to 65535.

DEVCLASS

E

Y

N

V

Y

4

CHAR

Device class

DEVTYPE

E

Y

Y

V

Y

7

CHAR

Device type

DSGROUP

A

Y




44

CHAR

Data set group name

DSIND

E

Y

Y

V

N

2

HEX

Data set indicators (printed in hex):

LASTV (x’80’) - Last volume

MULT8 (x’20’) - Block size multiple of 8

PASSA (x’10’) - Read / write password

PASSW (x’14’) - Write password

RACF (x’40’) - Discrete profile

UPDAT (x’02’) - Data set updates

DSNAME

A

Y

Y

C

Y

44

CHAR

Data set name / VSAM component name

DSSN

E

Y

Y

Y

Y

6

CHAR

HEX

Volume serial number field in DSCB

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

DSORG

E

Y

Y

V

Y

3

CHAR

Data set organization

AM - All VSAM

DA - Direct access

EF - ICF VSAM

HFS - Hierarchical File System

IAM - Innovation Access Method

PO - Partitioned (PDS)

POE - Partitioned Data Set Extended (PDSE)

PS - Physical Sequential

PSE - PS Extended format (large sequential)

U - Unmovable (may be appended to other forms)

UM - Unmovable (alternate format)

UN - Undefined

EXPDATE

A

Y

Y

V

Y

D

DATE

Expiration date

EXPDAYS

A

Y

Y

V

Y

5

NUM

Days until expiration

Important

If the expiration date is zero or is earlier than the run date, EXPDAYS is set to zero; if the expiration date is 99.000 or 99.xxx (where xxx is 365 or above), EXPDAYS is set to 65535.

HSMCDCSZ

A

Y

Y

Y

Y

10

NUM

Size of migration volume in 2k blocks (HSM MCDS)

HSMIGVOL

E

Y

Y

Y

Y

6

CHAR

First migration volume (HSM BCDS / MCDS)

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

INDEX

N

Y

Y

V

Y

8

CHAR

Index value from data set name (

INDEXNUM

N

Y

Y

V

Y

3

NUM

# of index level in the data set or cluster name that is extracted into field INDEX

KEYLEN

A

Y

Y

V

Y

3

NUM

Data set key length

LRDATE

A

Y

Y

Y

Y

D

DATE

Last reference date

LRDAYS

A

Y

Y

Y

Y

5

NUM

Days since last referenced

LRECL

A

Y

Y

V

Y

5

NUM

Data set logical reference length

LRTIME

N

Y

Y

N

N

8

TIME

Last reference time - hh.mm.ss (IAM / ICF VSAM)

MGMTCLAS

E

Y

Y

V

Y

8

CHAR

SMS management class

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

NTMIGRAT

A

Y

Y

N

N

8

CHAR

Number of times data set has been migrated (MCDS) or backed up (BCDS)

NAME

N

Y

Y

N

Y

44

CHAR

Data set name or VSAM cluster name

OPTCD

E

Y

Y

V

Y

2

CHAR

Option code byte:

A - (DAM) Actual addressing

BC - ICF VSAM catalog

C - (SAM) Chained scheduling using PCI

DB - (DAM) Dynamic buffering

E - (DAM) Extended search

F - (DAM) Feedback

I - (IS) Independent overflow area

IC - ICF VSAM data set

L - (IS) Delete

M - (IS) Master index

R - (IS) Reorganization criteria

RB - (DAM) Relative block addressing

RE - (DAM) Read exclusive

TO - (DAM) Track overflow

UF - (IS) Full track index write

W - (All) Write validity check

Y - (IS) Cylinder overflow area

RANK

A

Y

Y

N

N

6

NUM

Rank within sorted data (assigned)

RECFM

E

Y

Y

V

Y

5

CHAR

Record format:

A - ASA control character

B - Blocked

F - Fixed

M - Machine control character

S - Standard/spanned

T - Track overflow

U - Undefined

V - Variable

* - None of the above

RECTYPE

N

Y

Y

V

N

3

NUM

FDREPORT data record type:

1 - Volume record

2 - Data set / component record

4 - Volume summary record

8 - Prior compressed data record

9 - Prior active fields record

64 - Compressed data record

128 - Active fields record

RECVER

N

Y

Y

V

Y

4

CHAR

FDREPORT product version record format

RUNDATE

A

Y

Y

Y

Y

D

DATE

Run date

RUNTIME

A

Y

Y

Y

Y

8

TIME

Run time - hh.mm.ss

SCLUSTER

N

Y

N

N

N

20

CHAR

Short cluster name (first 20 bytes only)

SDSN

N

Y

N

N

N

20

CHAR

Short data set name (first 20 bytes only)

SECAFLAG

E

Y

Y

V

Y

5

CHAR

Secondary allocation flags:

BLK - Allocated in blocks

CON - Contiguous (CONTIG)

CYL - Allocated in cylinders

FIV - Five largest extents (ALX)

MAX - Largest extent (MXIG)

RND - Rounded to cylinders (ROUND)

TRK - Allocated in tracks

SECALLOC

A

Y

Y

Y

Y

8

NUM

Secondary allocation quantity

SIZE

A

Y

Y

S

Y

5*

NUM

Allocated tracks

Important

The width of the size fields (in tracks) is 6 if the FATDISK option is enabled and 8 if the EAVDISK option enabled.

SIZEFREE

A

Y

Y

S

Y

5*

NUM

Tracks not in use within data set extents

Important

The width of the size fields (in tracks) is 6 if the FATDISK option is enabled and 8 if the EAVDISK option enabled.

SIZEUSED

A

Y

Y

S

Y

5*

NUM

Tracks in use within data set extents

Important

The width of the size fields (in tracks) is 6 if the FATDISK option is enabled and 8 if the EAVDISK option enabled.

SMSCLASS

N

Y

N

N

N

26

CHAR

Includes fields: STORCLAS, DATACLAS, MGMTCLAS

SMSFLAGS

E

Y

Y

V

N

4

CHAR

SMS-managed data set flag byte in DSCB:

MANAGED (S) - SMS-managed

NOBCS (N) - Not cataloged

REBLOCK (R) - Reblockable

DADSMCRT (D) - DADSM assigned blksize

PDSE (I) - Partitioned data set extended

PDSEX (X) - Hierarchical File System (HFS)

ATTREXTN (E) - Extended Attribute (EA)

STRIPE (Z) - Extended Format (EF)

SNAME

N

Y

N

N

N

20

CHAR

Short data set name or VSAM cluster name (first 20 bytes only)

SOURCE

E

Y

Y

N

N

7

CHAR

Source of the data record:

ARCHIVE - Archive control file

BCDS - HSM backup control data set

CATALOG - System catalog

CATARCH - Auto-recall records from catalog appended with Archive Control File (ACF) data

CATVTOC - Catalog records appended with VTOC and VVR data of selected volumes

MCDS - DFSMShsm migration control data set

TVTOC - FDR, FDRABR, or FDRDSF backup files

VTOC - VTOC of volume

VTOCVVR - VTOC of volume appended with VVDS data

SPLCLS

N

Y

N

N

N

27

CHAR

Split ICF cluster name on two lines

SPLDSN

N

Y

N

N

N

27

CHAR

Split data set name on two lines

SPLNAME

N

Y

N

N

N

27

CHAR

Split data set name or ICF cluster name on two lines

STORCLAS

E

Y

Y

V

Y

8

CHAR

SMS storage class

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

SYSID

A

Y

Y

Y

Y

4

CHAR

System identification from SMF

TRKCYL

N

Y

Y

V

N

3

NUM

Number of tracks per cylinder

TRKSVOL

N

Y

Y

S

Y

6

NUM

Number of tracks on this volume

TVTOCDSN

A

Y

Y

V

Y

44

CHAR

Input backup data set name

UCBID

E

Y

N

V

Y

8

HEX

UCB 4-byte device type (hex)

VOLGROUP

A

Y





CHAR

Volume group

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

VOLSQ

A

Y

Y

V

Y

3

NUM

Data set volume sequence number

VOLUME

A

Y

Y

Y

Y

6

CHAR

Volume serial number

Important

This field supports selection via a mask. See “VOLUME=” in FDREPORT-Catalog-Examples.

XDSNAME

E

Y





CHAR

Extended data set name (selection only)

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*