Navigation Bar

Large FDReport Advert

FDREPORT FIELD NAMES


Report fields - How the tables work
The FIELDs available from the data set's DSCB in the VTOC
The FIELDs available from the VVDS or ICF catalog for ICF VSAM clusters
Additional FIELDs available for a data set on an SMS- managed volume
FIELDs available for dataset backup information from the ABR system
FIELDs which can be generated by ABR from information contained in the VTOC, Catalog or the VVDS
FIELDs which can be obtained from the directory of a PDS or a PDSE
FIELDs available from IAM dataset Control Blocks for IAM datasets
FIELDs which can be obtained from the volume-level record
DFHSM FIELDs which can be obtained from the MCDS
DFHSM FIELDs which can be obtained from the BCDS

Report fields - How the tables work

These field names are valid for FDR Report version 5.4 Level 50. Some fields may not be available in earlier versions. All the data below is lifted straight from the FDR manual and the copyright is owned by Innovation Data Processing Inc.

The following tables list the FIELDs which can be used in REPORT, SORT, (X)SELECT/(X)EXCLUDE, and SUMMARY statements as well as PUNCH masks and TITLE statements. All of the fields listed are valid on a REPORT statement. The tables show the following information for each FIELD:

NAME -- The FIELD name. On a REPORT, SORT, or SUMMARY statement, specify the FIELD NAME in the FIELD= operand. In a PUNCH mask or TITLE statement, specify it where you want its value substituted, surrounded by the field prefix/suffix characters (e.g., <DSN>). On a SELECT/EXCLUDE statement, specify the FIELD NAME followed by an equal (=) sign and a value appropriate to the NAME (e.g., %CI=10). On a XSELECT/XEXCLUDE statement, the FIELD NAME may be followed by any of the operations supported (e.g., %CI>10)

DESCRIPTION -- A brief description of the field. For fields which represent attributes or flag bytes, the strings which are used in (X)SELECT/(X)EXCLUDE statements are shown, e.g., one of the values of CATALOG is YES so you may specify CATALOG=YES. For some such fields, the value is abbreviated in the report so the abbreviated printed value is shown in parentheses, e.g., under ARCFLAG2 it says RECALL (A), so you specify ARCFLAG2=RECALL, but in a report ARCFLAG2 will include A if the recall flag is set.

LEN -- The number of print positions the field will occupy on the report.

ATTR -- How the field will be displayed. There are three (3) types of fields: Character (CHAR), Numeric (NUM) and Hexadecimal (HEX). MIX indicates a combination of these types.

SOURCE -- The source of the information displayed.

VTOC DSCB of the data set
CAT system or ABR catalog
VVDS VVR or NVR in SYS1.VVDS.Vvolser
ARCH ABR archive control file
MODL ABR MODEL DSCB
IAM IAM control blocks
TRKC TRKCALC macro
DIRB PDS directory
FAMS SMS File Attribute Management Support.
VTIX VTOC Index
SMS SMS
GEN generated from one or more of the above sources

Although it is not indicated under SOURCE, some FDREPORT fields are taken from the HSM MCDS or BCDS when those file are used as input.

PUNCH/SORT -- These columns indicate whether the field is eligible for the specified statement. If an 'X ' appears under the heading, it means the field can be specified on that statement. Fields valid for SORT can also be specified in a TITLE statement.

SELECT -- A value in this column indicates that the field is eligible for the SELECT/EXCLUDE statements. If an 'E' appears in the column, the data set will be selected if the value in the file is EQUAL TO the value on the SELECT statement. If a 'G' appears in the column, the data set will be selected if the value is GREATER THAN or EQUAL TO the value on the SELECT statement.

XSELECT -- A value in this column indicates that the field is eligible for the XSELECT/XEXCLUDE statements. If an 'E' appears in the column, only the equal (= or .EQ.) and not-equal (¬= or .NE.) comparisons may be used. If an 'A' appears, all comparisons supported by those statements may be used.

SUMMARY -- A value in this column indicates that the field is eligible for the SUMMARY statement. If an 'C' (count) appears, then the number of unique occurrences of the value are simply counted. If a 'V' (value) occurs, each unique value of the field is displayed with the number of occurrences of that value. If a 'S' (sum) is displayed, then a total of all values of the field is displayed.

The FIELDs available from the data set's DSCB in the VTOC

  TABLE 1 lists the FIELDs available from the data set's DSCB in the VTOC. If a VSAM cluster is being reported, some of the information may be found in the VVDS or catalog. SELECT XSELECT PUNCH SORT SUMMARY
NAME DESCRIPTION LEN ATTR SOURCE          
DSN Data Set Name/VSAM component name 44 CHAR VTOC E A X X C
SPLDSN Data Set Name on two lines 27 CHAR VTOC          
SDSN Data Set Name (First 20 bytes only) 20 CHAR VTOC            
NAME Data Set Name or VSAM Cluster Name 44 CHAR VTOC/VVDS     X X  
SPLNAME Data Set Name or VSAM Cluster Name on two lines 27 CHAR VTOC/VVDS          
SNAME Data Set Name or VSAM Cluster Name (First 20 bytes only) 20 CHAR VTOC/VVDS          
GDGBASE Generation Data Group base name 44 CHAR VTOC     X X  
SPLGDGB GDG base name on two lines 27 CHAR VTOC          
SGDGBASE GDG base name (first 20 bytes only 20 CHAR VTOC          
DEFAULTS Includes: SPLDSN,VOL,DSORG,RECFM, BLKSIZE,LRECL,SIZE,SIZEFREE,%FREE 72 MIX            
DSSN Volume serial -- stored in DSCB*** 6 CHAR VTOC E A X X  
VOLSQ Data Set Volume Sequence Number 3 NUM VTOC E A X X V
DATES Includes: CRDATE,EXPDATE,LRDATE * NUM            
CRDATE Creation Date * NUM VTOC/CAT G A X X V
EXPDATE Expiration Date * NUM VTOC/CAT G A X X V
LRDATE Last Reference Date * NUM VTOC/VVDS G A X X V
NOEPV Number of Extents for Data Set 3 NUM VTOC G A X X S
NOBDB Number of Bytes in Last Directory Block 3 NUM VTOC G A X X  
SYSCODE System Code Field in DSCB*** 13 CHAR VTOC E A   X V
DCBINFO Includes DSORG,RECFM,BLKSIZE,LRECL 21 MIX            
DSORG Data Set Organization:
 DA--BDAM
 PS-- SEQUENTIAL
 U-- UNMOVABLE
 AM-- Non-ICF VSAM
 PO-- PARTITIONED
 UN-- UNDEFINED
 EF-- ICF VSAM
 POE-- PDS
 PSE--PS Extended Format (Striped)
 IAM--Innovation Access Method
 HFS--Hierarchical File System (Open Edition)
3 CHAR VTOC E E X X V
RECFM Record Format 5 CHAR VTOC E E X X V
OPTCD Option Code Byte 2 HEX VTOC E E X X V
BLKSIZE Data Set Block Size 5 NUM VTOC/VVDS E A X X V
LRECL Data Set Logical Record Size 5 NUM VTOC/VVDS E A X X V
KEYLEN Data Set Key Length 3 NUM VTOC/VVDS E A X X V
RKP Data Set Relative Key Position 4 NUM VTOC/VVDS E A X X V
DSIND Data Set Indicators - printed in hex; for selection use:
  LASTV - last volume (X'80')
  UPDAT - data set updates (X'02')
  RACF -discrete profile (X'40')
  PASSW - write password (X'14')
  PASSA -read/write password (X'10')
2 HEX VTOC E E   X V
SECALLOC Secondary Allocation Quantity 8 NUM VTOC/VVDS E A X X V
SECAFLAG Secondary Allocation Flags:
 BLK - allocated in blocks
 FIV - 5 largest extents (ALX)
 CYL - allocated in cylinders
 RND - rounded to cylinders
 TRK - allocated in tracks (ROUND)
 CON - contiguous (CONTIG)
 MAX largest extent (MXIG)
5 CHAR VTOC/VVDS E A X X V
SECXFLAG Secondary Allocation extension flag :
 ABL average block length
 MBY megabytes
 KBY kilobytes
 BYT - bytes
3 CHAR VTOC       X V
SECXVALU Secondary Allocation extension value 11 NUM VTOC       X V
LSTAR Data Set Last Block Pointer; specify as LSTAR=X'ttttrr' 6 HEX VTOC E A X X  
TRKBAL Data Set Track Balance; remaining bytes on last track used 5 NUM VTOC G A X X  
EXTENTS Data Set Extents (with extent type); each extent will be stacked, up to 123 extents may be printed 15** CHAR VTOC   A      
EXTENTSX Data Set Extents (with extent type); each extent will be stacked, up to 123 extents may be printed 17** CHAR VTOC         V
CTFLD Count Field of data set DSCB (CCHHR) 10 HEX VTOC   A X X  
BPTR Format 1 DSCB Pointer to Format 2/3 DSCB 10 HEX VTOC       X  
LMJOB Last Modifying JOB (for ASM2 users)*** 8 CHAR VTOC   A   X  

* the format and width of date fields varies depending on the value of the DATEFORMAT= operand.

** these fields will be two columns larger if the FATDISK option is enabled.

*** this field supports selection via a mask; see the VOL= operand in Section 54.13 FDREPORT (X)SELECT/ (X)EXCLUDE STATEMENT

Published with permission of Innovation Data Processing

back to top

The FIELDs available from the VVDS or ICF catalog for ICF VSAM clusters

 TABLE 2 lists the FIELDs available from the VVDS or ICF catalog for ICF VSAM clusters. This is in addition to the FIELDs available from the VTOC (TABLE 1). non-VSAM data sets, these fields will contain blanks.
Those fields that show a source of IAM are also valid For for IAM files; those that show IAM+ are valid only for enhanced IAM files
SELECT XSELECT PUNCH SORT SUMMARY
NAME DESCRIPTION LENATTR SOURCE          
CLUSTER ICF VSAM Cluster Name 44 CHAR VVDS E A X X V
SPLCLS ICF VSAM Cluster Name on two lines 27 CHAR VVDS          
SCLUSTERCluster name (First 20 bytes only) 20 CHAR VVDS          
VSAMID Includes: SPLCLS,SPLDSN,VOLSER 62 CHAR            
VSAMINFOIncludes: DSORG,RECFM,MAXLRECL,LRECL,CISIZE,TRKSCA, CICA,%CI,%CA,COMPATTR 68 MIX           
VSAMUSE Includes: RECORDS,RETRIEVE,UPDATES,INSERTS,DELETES, HIALORBA,HIUSERBA,CISPLIT,CASPLIT 85 NUM            
TIMES Includes: CRTIME,LRTIME 17 NUM            
CRTIME Time of creation (hh.mm.ss) 8 NUM VVDS/IAM      X  
LRTIME Time of last reference (hh.mm.ss) 8 NUM VVDS/IAM      X  
CATNAME Name of the Catalog 44 CHAR VVDS/IAME A   X V
%CA Free Percent in Control Area (CA) 3 NUM VVDS/IAMG A X X V
%CI Free Percent in Control Interval (CI) 3 NUM VVDS/IAMG A X X V
CICA Number of Control Intervals per CA 3 NUM VVDS G A X X V
CISIZE Control Interval (CI) Size 5 NUM VVDS/IAME A X X V
BUFSIZE VSAM Buffer Size 6 NUM VVDS E A X X V
MAXLRECLVSAM Maximum Record Length 6 NUM VVDS/IAME A X X V
TRKSCA VSAM Number Tracks per Control Area 3 NUM VVDS G A X X  
CLUSATTR VSAM Cluster Attributes:
 PAGESPACE Pagespace
 ATL Tape Volume Catalog
 SWAPSPACE Swapspace
 ATTREXT Extended Attribute (EA)
 TIMESTAMP Timestamps Exist
 EXTEND Extended Format (EF)
 VERIFYREQ Verify is Required
 FORMAT Formatted Pagespace
24 CHAR VVDS   E   X  
COMPTYPE VSAM Component type:
 DATA-- Base cluster data
 INDEX-- Base cluster index
 AIXDATA (AIXDA) -- Alternate Index data
 AIXINDEX (AIXIN) -- Alternate Index index:
5 CHAR VVDS   E   X  
COMPATTR VSAM Component Attributes
 IXD-- Indexed
 RUS--Reusable
 KRNG- - Key Range
 NUMD-- Relative
 RCVY-- Recovery
 SPED-- Speed
IMBD-- Imbedded
 NIXD-- non-Indexed
 ERAS- - Erase
 ORD-- Ordered
 WCK-- Write Check
 SPND-- Spanned
 REPL-- Replicate
24 CHAR VVDS     X    
VOLCFLAG VSAM Volume Flag:
 CANDWSPACE (C candidate with space)
 EXTENTSYNC (S extents do not match VTOC)
 GUARSPACE (G SMS guaranteed space)
 OVERFLOWVOL (O overflow volume)
 PRIMEVOLUME (P prime volume)
 RELCIADDR (R relative CI addressing)
8 CHAR VVDS   E   X X
DSNEIFLG VSAM Dataset Extended Info Flag:
 G extended addressability (>4GB)
 R relative CI addressing
2 CHAR VVDS  E   X X
AMDATTR VSAM Cluster Attributes from AMDSB:
 ESDS (ES) IMBED (IM) KEYRANGE (KE)
 KSDS (KS) ORDERED (OR) RRDS (RR)
 REPLICATE (RE) SPANNED (SP) WRITECHECK(WR)
24 CHAR VVDS/IAM  E   X  
AMDATTR3VSAM Cluster Attributes from AMDSB:
 LINEAR (LI) LOADED (LO)
 NONUNIQUE (NO)
 SHRBCS (SH) -- shared catalog
 VARIABLE (VA) - Variable RRDS
24 CHAR VVDS/IAM  E   X  
AIXATTR Attribute of Alternate Index:
 AIX -- this is an AIX
 UPGRADE - AIX with the UPGRADE attribute
7 CHAR VVDS   E   X V
SHROPT VSAM Share Options 3 CHAR VVDS/IAM  E  XV
PRIALLOCVSAM Primary Allocation Quantity 8 NUM VVDS/IAME A X X V
HIALORBAVSAM High Allocated Relative Byte Address 10 NUM VVDS/ IAM+ G A X X  
HIKEYRBAVSAM High Key Relative Byte Address 10 NUM VVDS/IAM+ G A X X  
HIUSERBAVSAM High Used Relative Byte Address 10 NUM VVDS/IAM+ G A X X 
EXCPEXITVSAM Exception Exit 8 CHAR VVDS E A     V
OWNER VSAM Owner Identification 8 CHAR CAT E A X X V
TIMESTMPVSAM Time Stamp 16 HEX VVDS/IAM      X  
CASPLIT Number of Control Area (CA) Splits 5 NUM VVDS G A X X S
CASPLITR CA Split Ratio (splits per 100 CAs) 6 NUM VVDS   A X X S
CISPLIT Number of Control Interval (CI) Splits 5 NUM VVDS G A X X S
CISPLITR CI Split Ratio (splits per 100 CIs) 5 NUM VVDS   A X X S
INDEXLEVVSAM Number of Index Levels 5 NUM VVDS   A X X V
EXCPS VSAM Number of EXCPs 10 NUM VVDS G A X X S
DELETES VSAM Number of Records Deleted 10 NUM VVDS/IAMG A X X S
INSERTS VSAM Number of Records Inserted 10 NUM VVDS/IAMG A X X S
RECORDS VSAM Number of Records in Cluster 10 NUM VVDS/IAMG A X X S
RETRIEVEVSAM Number of Records Retrieved 10 NUM VVDS G A X X S
UPDATES VSAM Number of Records Updated 10 NUM VVDS/IAMG A X X S
VSFREBYTVSAM Number of Bytes Free 10 NUM VVDS G A   X S
CATVRBA Relative Byte Address of VVR from catalog 8 HEX CAT G A X X V
VVRVRBA Actual Relative Byte Address of VVR in VVDS 8 HEX VVDS G A   X V

* this field supports selection via a mask; see the VOL= operand in Section 54.13 FDREPORT (X)SELECT/ (X)EXCLUDE STATEMENT

Published with permission of Innovation Data Processing

back to top

Additional FIELDs available for a data set on an SMS- managed volume

TABLE 3 lists the additional FIELDs available for a data set on an SMS- managed volume. For non-SMS data sets, these fields will be blank SELECT XSELECT PUNCH SORT SUMMARY
NAME DESCRIPTION LEN ATTR SOURCE          
SMSCLASS Includes: STORCLAS,DATACLAS,MGMTCLAS 26 CHAR            
STORCLAS SMS Storage Class* 8 CHAR VVDS   E X X V
MGMTCLAS SMS Management Class* 8 CHAR VVDS   E XX V
DATACLAS SMS Data Class* 8 CHAR VVDS   E X X V
STORGRP SMS Storage Group on which the data set resides* 8 CHAR GEN   E X X V
SMSFLAGS SMS flag byte in DSCB:
 MANAGED (S) - SMS-managed
 NOBCS (N) - not cataloged
 REBLOCK (R) - reblockable
 DADSMCRT (D) - DADSM assigned blksize
 PDSE (I) - PDS Extended
 PDSEX (X) - HFS (Hierarchical File Sys)
 STRIPE (Z) - Extended Format (EF)
 ATTREXTN (E) - Extended Attribute (EA)
4 CHAR VTOC   E   X V
LASTBKUP SMS last backup Date and Time 13 CHAR VVDS   A   X  
NVSAMFLG SMS NONVSAM Flags:
 ATTREXT- Extended Attribute (EA)
 EXTEND Extended Format (EF)
7 CHAR VVDS   E   X V
NVSAMATR SMS NONVSAM Attributes:
 ACTGDG - active GDG generation
 DEFGDG - deferred GDG generation
 ROLGDG - rolled-out GDG generation
 PDSE - PDS Extended POSIX - HFS (Hierarchical File Sys)
7 CHAR VVDS   E   X V
STRIPECT Stripe Count, for Extended Format (EF) 3 CHAR VVDS   E   X V
RECOVDTA SMS Recovery Data 8 CHAR VVDS   E   X V
RESOROWN SMS Resource Ownership 16 CHAR VVDS   E   X V
SUBCFLAG SMS Subcell Flag Byte 17 CHAR VVDS   E   X V
SUBCVERS SMS Subcell Version Number 3 NUM VVDS   A   X V
COMPUSER Compressed DataSet Size 10 NUM VVDS   A X X S
USERDATA Original Size of Compressed DataSet 10 NUM VVDS   A X X S

* this field supports selection via a mask; see the VOL= operand in Section 54.13 FDREPORT (X)SELECT/(X)EXCLUDE STATEMENT

Published with permission of Innovation Data Processing

back to top

FIELDs available for dataset backup information from the ABR system

  Table 4 lists dataset backup information from the ABR system.
If DATATYPE=ARCHIVE was specified, this information is from the archive control file, otherwise it is from the ABR backup subsystem. If COPY= or OLDBACKUP= was specified, there may be more than one line of this information available;
REPORT will list them on multiple lines, SELECT/XSELECT will test against all copies of the fields.
SELECT XSELECT PUNCH SORT SUMMARY
NAMEDESCRIPTIONLEN ATTR SOURCE          
ABRGEN Current ABR Generation Number 4 NUM MODL E A X X V
ARBCYCLE Current ABR Cycle Number 3 NUM MODL E A X X V
ABRIND ABR Indicators:
 A - Always backup/never archive
 B - Current ABR backup exists
 N - Normal backup/never archive
 R - Archive requested
 X - Exclude from ABR processing For reports only, not for selection:
 C - No current ABR backup exists
 I - Instant backup is pending; SNAP/SPLIT/PSPLIT/FCOPY has been done, but the point-in-time image has not yet been copied to a backup file (only in a report line for an ABR model DSCB)
 M - Multi-volume dataset
 T - old backup recording is enabled
 U - Updated since last ABR backup
5 CHAR VTOC E E   X V
ADATEArchive Date * NUM ARCH G A X X V
BKTIMEFDRAPPL Backup time (hhmmss) 8 NUMARCHG A X X V
ADAYS# days since Archive 5NUMARCHG A X X V
ARCDSNArchive Control File name 44 CHAR GEN    X   V
ARCFLAGSIncludes: ARCFLAG1, ARCFLAG2           
ARCFLAG1 ARCHIVE control file flag 1 -
 FIVEVOL (F) - backup over 5 volumes
 MULTIVOL (M) - multi-vol dataset
 RESTORED (R) - restored from ARCHIVE ARCH
6 HEX ARCH   A X X V
ARCFLAG2 ARCHIVE control file flag 2 -
 CLUSTER (C) - entry for ICF cluster
 DELETE (D) - entry flagged for deletion
 NOTCAT (N) - backup not cataloged
 RECALL (A) - archived for auto-recall
 ARCH
 ARCTTR TTR used for auto recall
6 HEX ARCH   A X X V
ACTTTR Actual TTR of record in ARCHIVE ctl file 6 HEX ARCH  A X X V
BKINFO Includes: BKDATE,BKSUFFIX,BKFILENO,BKVOL * CHAR            
TVTOCDSN Input Backup dsn, for RPTYPE=TVTOC 44 CHAR GEN     X X V
OLDBKUP ABR Old Backup # of ABR backup displayed 2 NUM GEN       X V
BKCYCLE Cycle # of ABR backup displayed 3 NUM CAT   A X X V
BKGEN Generation # of ABR backup displayed 4 NUM CAT   A X X V
BKDATE Backup Date * NUM CAT G A X X V
BKDAYS # days since Backup 5 NUM CAT G A X X V
BKEXDATE Backup or Archive expiration date * NUM ARCH/CAT   A X X V
BKEXDAYS # days until expiration of Backup or Archive** 5 NUM ARCH/CAT   A X X V
BKFILENO File Seq Number of Backup or Archive 4 NUM ARCH/CAT E A X X V
BKSUFFIX Backup or Archive DataSet Name Suffix. This is the last index level in the name*** 8 CHAR ARCH/CAT E A X X V
BKTAPCNT Number of Backup or Archive Volumes 2 NUM ARCH/CAT E A X V
BKVOL Volume Serials for the Backup/Archive (5)*** 34 CHAR ARCH/CAT E A X X V
BKXVOL Volume Serials for the Backup/Archive (20) 139 CHAR ARCH/CAT E A     V
BKDEVCLS Device class of backup (TAPE or DISK) 4 CHAR ARCH/CAT   E X X V
BKDEVTYP Device type of backup 7 CHAR GEN   E X X V

* the format and width of date fields varies depending on the value of the DATEFORMAT= operand.

** if the expiration date is 99.000 or 99.365 or above, this is set to 65535.

*** this field supports selection via a mask; see the VOL= operand in Section 54.13 FDREPORT (X)SELECT/(X)EXCLUDE STATEMENT

Published with permission of Innovation Data Processing

back to top

FIELDs which can be generated by ABR from information contained in the VTOC, Catalog or the VVDS

  TABLE 5 lists the FIELDs which can be generated by ABR from information contained in the VTOC, Catalog or the VVDS. SELECT XSELECT PUNCH SORT SUMMARY
NAME DESCRIPTION LEN ATTR SOURCE          
SIZEINFO Includes: SIZE,SIZEFREE,%FREE 15* NUM            
SIZE Size of the DataSet in Tracks 5* NUM GEN G A X X S
BYTES Size of the DataSet in bytes/KB/MB ** NUM GEN   A X X S
MAXSIZE Maximum size of DataSet in Tracks if all secondary allocations taken5* NUM GEN G A X X S
SIZEFREE Number of Tracks Unused for DataSet PS, PO and VSAM actual free tracks all others zero (0) 5* NUM GEN G A X X S
BYTESFRE Bytes unused in the DataSet ** NUM GEN   A X X S
SIZEUSED Number of Tracks Used for DataSet PS, PO and VSAM actual used tracks all others total allocated space 5* NUM GEN G A X X S
BYTESUSE Bytes used in the DataSet ** NUM GEN   A X X S
BLKSTRK Number of Blocks per Track 5 NUM VVDS/TRKCG A X X V
BYTESTRK Bytes per Track (BLKSIZE times allocated space 5 NUM GEN   A X X V
PRIBYTES Bytes in primary allocation (ICF VSAM only) ** NUM GEN   A X X S
SECBYTES Bytes/KB/MB size of secondary allocation ** NUM GEN   A X X S
TRACKCAP Max Track Capacity of Device in Bytes 5 NUM VTOC     X X V
CAPBYTES Bytes size of allocated space if used at track capacity ** NUM GEN   A X X S
%FREE Percentage of Free Space in DataSet 3 NUM GENG A X X V
%USED Percentage of Used Space in DataSet 3 NUM GEN G A X X V
FREEEXT Number of allocated extents containing no data 3 NUM GEN   A X X V
USEDEXT Number of allocated extents containing data 3 NUM GEN   A X XV
%CAPUSED Percentage of Capacity Utilization (based on allocation and BLKSIZE) 3 NUM GEN   A X X V
CATALOG Indicates if DataSet is Cataloged
This can be expensive to collect if a large number of datasets are to be reported.
 YES cataloged to this volume
 NO not cataloged at all
 ERR cataloged to another volume
 ONL only cataloged, not in VTOC
 UNK error reading catalog
 CAN cataloged to candidate volume
 DRF disk read failure
3 CHAR CAT E E X X V
CATTTR DSCBTTR from Catalog (used by ABR to indicate auto recall) 6 HEX CAT   A X X X
CATVOL Volume to which dataset is cataloged 6 CHAR CAT     X X X
CATVOLCT Number of unique non-candidate volumes to which the dataset is cataloged 3 NUM CAT   A X X V
CANDVOLC Number of unique non-candidate volumes to which the dataset is cataloged 3 NUM CAT   A X X V
CATVOLTL Total number of unique volumes to which the dataset is cataloged 3 NUM CAT   A X X V
DSNALCNT Number of catalog aliases for this dataset 5 NUM CAT   A X X S
DSNALIAS An alias for this dataset (indexed by RELALCNT) 44 CHAR CAT   A X X V
RELALCNT Relative alias number 5 NUM CAT   A X X V
GDGENTRY GDG Active Entry Count 3 NUM CAT   A X X V
GDGFLAGS GDG base flags: EMPTY/NOEMPTY/SCRATCH/NOSCRATCH 9 CHAR CAT   E X X V
GDGGENER GDG generation number 4 NUM VTOC   A X X V
GDGLIMIT GDG generation limit 3 NUM CAT   A X X V
GDGRELGN GDG relative generation number 3 NUM GEN   A X X V
GDGVERSN GDG version number 2 NUM VTOC   A X X V
CRDAYS Number of days since creation 5 NUM GEN G A X X V
EXPDAYS Number of days until expiration**** 5 NUM GEN G A X X V
LRDAYS Number of days since last reference 5 NUM GEN G A X X V
NOEXTENT Number of Extents Used for DataSet 3/4 NUM GEN G A X X S
PROTECT Reports on Type of Protection indicates if RACF or PASSWORD protected 4 CHAR VTOC       X V
RUNDATE Date of FDREPORT execution *** NUM GEN   A X X V
RUNTIME Time of FDREPORT execution (hh.mm.ss) 8 NUM GEN   A X X  
VOL Volume Serial DataSet resides on***** 6 CHAR VTOC E A X X V
FILESEQ File Sequence Number (tape only) 4 NUM CAT   A X X  
UNIT Device address the dataset is on 3/4 CHAR GEN   A X X V
DEVTYPE Type of Device DataSet resides on 7 CHAR GEN E E X X V
DEVCLASS Class of Device DataSet resides on, 'TAPE' or 'DISK' 4 CHAR GEN     X   V
UCBSTATS UCB status: ONLINE/OFFLINE 7 CHAR UCB   E X   V
UCBID 4-byte UCB device type 8 HEX CAT/UCB   E X   V
INDEXNUM # of Index Level in the dataset or cluster name that is extracted into field INDEX 3 NUM USER     X X V
INDEX Extracted level from dataset or Cluster name 8 CHAR DSN/CLUS     X X V
  TABLE 5 lists the FIELDs which can be generated by ABR from information contained in the VTOC, Catalog or the VVDS. SELECT XSELECT PUNCH SORT SUMMARY
NTMIGRAT HSM only: number of times dataset has been migrated (MCDS) or backed up (BCDS) 8 CHAR   E E   X  
SYSID SMF system ID on which FDREPORT was run 4 CHAR     A X X X
SOURCE Source of this data record (ARCHIVE, CATALOG, VTOC, VVDS, MCDS, BCDS) 8 CHAR   E E   X  

* the width of the size (in tracks) fields will be 6 if the FATDISK option is enabled.

** the format and width of byte fields varies depending on the value of the BYTEFORMAT= operand.

*** the format and width of date fields varies depending on the value of the DATEFORMAT= operand.

**** if the expiration date is 99.000 or 99.365 or above, this is set to 65535.

***** this field supports selection via a mask; see the VOL= operand in Section 54.13 FDREPORT (X)SELECT/(X)EXCLUDE STATEMENT

Published with permission of Innovation Data Processing

back to top

FIELDs which can be obtained from the directory of a PDS or a PDSE

  TABLE 6 lists the FIELDs which can be obtained from the directory of a Partitioned DataSet or an Extended Partitioned DataSet (via FAMS). SELECT XSELECT PUNCH SORT SUMMARY
NAME DESCRIPTION LEN ATTR SOURCE          
DIRBINFO Includes: DIRBLOCK,DIRBFREE,%DIRFREE   NUM            
DIRBLOCK Number of PDS Directory Blocks 5 NUM DIRB/FAMS   A X X V
DIRBFREE Number of Free PDS Directory Blocks 5 NUM DIRB/FAMS   A X X V
DIRBUSED Number of used PDS Directory Blocks 5 NUM DIRB/FAMS   A X X V
%DIRFREE Percentage of PDS Directory Blocks not used 3 NUM GEN   A X X V
%DIRUSED Percentage of PDS Directory Blocks in use 3 NUM GEN   A X X V
MEMBERS Number of Members in PDS 6 NUM DIRB/FAMS   A X X S

Published with permission of Innovation Data Processing

back to top

FIELDs available from IAM dataset Control Blocks for IAM datasets

  TABLE 7 lists the FIELDs available from IAM dataset Control Block for IAM datasets. This is in addition to the FIELDs available from the VTOC (TABLE 1) and the fields that are normally reserved for VSAM. SELECT XSELECT PUNCH SORT SUMMARY
NAMEDESCRIPTION LEN ATTR SOURCE          
IAMINFO Includes: DSORG,RECFM,MAXLRECL,LRECL, BLKSIZE, CISIZE 33 MIX           
IAMUSE Includes: RECORDS,UPDATES,INSERTS,DELETES,OVERFLOW,OVERUSED,%OVER 69 NUM            
IAMINDIC IAM Indicators:
  ENHANCED (E) - Enhanced IAM format
  DATACOMP (D) - Data compressed
  KEYCOMP (K) - Keys compressed
5 CHAR IAM   E   X V
%PRIMEXT Used Percent of the Prime Extension 3 NUM IAM   A X X V
PRIMEXTN Number of Prime Extension Blocks allocated 8 NUM IAM   A X X S
PRIMEUSE Number of used Prime Extension Blocks 8 NUM IAM   A X X S
%OVER Used % of the Independent Overflow records 3 NUM IAM   A X X V
OVERFLOW # of Independent Overflow records allocated 10 NUM IAM   A X X S
OVERUSED # of used Independent Overflow records 10 NUM IAM   A X X S

Published with permission of Innovation Data Processing

back to top

FIELDs which can be obtained from the volume-level record

  TABLE 8 lists the FIELDs which can be obtained from the volume-level record. Data is gathered and summarized from the LSPACE SVC, VTOC, VTOC index, and VVDS. SELECT XSELECT PUNCH SORT SUMMARY
NAME DESCRIPTION LEN ATTR SOURCE          
VLDEFAUL Volume report defaults,includes: VLVOLSER, VLDEVTYPE,VLUNIT, VLINDSTA, VLUSEATR, VLTRKVOL, VLUSERS, VLALOTRK, VL%UTRKS, VLFRETRK, VLLRGCYL, VLLRGTRK, VLFREEXT and VLFRAGIN 83 MIX          
VLVOLSER Volume Serial DataSet resides on *** 6 CHAR VTOC   A X X V
VLUNIT Device address the volume is on 3/4 CHAR GEN   E X X V
VLUCBID 40byte UCB device type 8 HEX UCB   E X   V
VLDEVTYP Type of Device DataSet resides on 7 CHAR GEN   E X X V
VL%FTRKS Percentage of disk volume free 3 NUM VTOC   A X X V
VL%UTRKS Percentage of disk volume in use 3 NUM VTOC   A X X V
VL%FDSCB Percentage of DSCBs free within the VTOC 3 NUM VTOC   A X X V
VL%UDSCB Percentage of DSCBs used within the VTOC 3 NUM VTOC   A X X V
VL%FINDX Percentage of VTOC Index Records free 3 NUM VTIX   A X X V
VL%UINDX Percentage of VTOC Index Records used 3 NUM VTIX   A X X V
VL%FVVDS Percentage of VVDS Control Intervals free 3 NUM VVDS   A X X V
VL%UVVDS Percentage of VVDS Control ????? 3 NUM VVDS   A X X V
VLALOCYL Number of Allocated Cylinders 5 NUM VTOC   A X X S
VLALOTRK Number of Allocated Tracks 5* NUM VTOC   A X X S
VLALOBYT Number of Allocated Bytes ** NUM VTOC   A X X S
VLALTRKS Number of Alternate Tracks on the volume 5 NUM DEVT   A X X S
VLAVGTRK Average File Size in Tracks 5* NUM VTOC   A X X V
VLAVGBYT Average File Size in Bytes ** NUM VTOC   A X X V
VLBYTRK Track Capacity in bytes 5 NUM DEVT     X X V
VLCYLVOL Number of Cylinders per Volume 5 NUM DEVT     X X S
VLTRKCYL Number of Tracks per Cylinder 3 NUM DEVT     X X V
VLBYTCYL Number of Bytes per Cylinder ** NUM DEVT     X X V
VLTRKVOL Number of Tracks per Volume 5* NUM DEVT   A X X S
VLBYTVOL Number of Bytes per Volume ** NUM DEVT     X X S
VLDIRBTR Number of PDS Directory Blocks per Track 3 NUM DEVT     X X V
VLDSCBTR Number of VTOC DSCBs per Track 3 NUM DEVT     X X V
VLDSCB Total Number of DSCBs 5* NUM VTOC   A X X S
VLDSCBU Number of Used DSCBs 5* NUM VTOC   A X X S
VLDSCB0 Number of FORMAT0 DSCBs 5* NUM VTOC   A X X S
VLDSCB1 Number of FORMAT1 DSCBs 5* NUM VTOC   A X X S
VLDSCB2 Number of FORMAT2 DSCBs 5* NUM VTOC     X X S
VLDSCB3 Number of FORMAT3 DSCBs 5* NUM VTOC   A X X S
VLDSCB4 Number of FORMAT4 DSCBs 5 NUM VTOC     X X S
VLDSCB5 Number of FORMAT5 DSCBs 5 NUM VTOC     X X S
VLDSCB6 Number of FORMAT6 DSCBs 5 NUM VTOC     X X S
VLDSCB7 Number of FORMAT7 DSCBs 5 NUM VTOC     X X S
VLDSOAM Number of non-ICF VSAM Data Spaces 5* NUM VTOC   A X X S
VLDSODA Number of Direct Access datasets 5* NUM VTOC   A X X S
VLDSOEF Number of ICF/VSAM Components 5* NUM VTOC   A X X S
VLDSOIS Number of Indexed Sequential datasets 5* NUM VTOC   A X X S
VLDSOPO Number of Partitioned datasets5* NUM VTOC   A X X S
VLDSOPOE Number of PDSE datasets (SMS volumes) 5* NUM VTOC   A X X S
VLDSOPS Number of Physical Sequential datasets 5* NUM VTOC   A X X S
VLDSOUN Number of datasets with an Unknown dataset Organization 5* NUM VTOC   A X X S
VLFRAGIN IBM Fragmentation Index 4 NUM LSPC   A X X V
VLFRECYL Number of Unused Cylinders 5 NUM LSPC   A X X S
VLFREBYT Number of Unused Bytes ** NUM VTOC     X X S
NAME DESCRIPTION LEN ATTR SOURCE        
VLFREEXT Number of Unused Extents 5* NUM LSPC   A X X S
VLFRETRK Number of Unused Tracks 5* NUM VTOC   A X X S
VLFREVCI Number of Unused VVDS Control Intervals        
VLUSEVCI Number of Used VVDS Control Intervals 5 NUM VVDS     X X S
VLTOTVCI Total Number of VVDS Control Intervals 5 NUM VVDS     X X S
VLFREVIR Number of Unused VTOC Index Records 5 NUM LSPC   A X X S
VLUSEVIR Number of Used VTOC Index Records 5 NUM GEN     X X S
VLTOTVIR Total Number of VTOC Index Records 5 NUM GEN     X X S
VLALOSTA Volume Allocation Status:
  SYSRES - system residence volume
  ALLOC - allocated
  UNLOAD - unload pending
  ONLINE - online, not allocated or sysres
6 CHAR UCB       X X
VLINDSTA Status of Indexed VTOC ACTIVE Indexed VTOC Active NONE No Indexed VTOC YES Indexed VTOC Not Active 6 CHAR LSPC   E   X V
VLMOUSTA Volume Mount Status RESERVED Volume Dismountable RESIDENT Volume Not Dismountable 8 CHAR UCB       X V
VLUSEATR Volume Use Attribute PRIVATE Allocated if specific PUBLIC Temporary non-specific STORAGE Non-temporary non-specific 7 CHAR UCB   E   X V
VLSMSTAT Volume SMS State INITIAL Volume Initialized for SMS MANAGED Volume SMS Managed NONE No SMS Processing 7 CHAR VTOC   E   X V
VLSMSVST Volume SMS Status ENABLED NONE (non-SMS)QUIESCED ALL QUIESCED NEW DISABLED ALL DISABLED NEW 12 CHAR SMS       X V
VLSMSGST Volume SMS Storage Group Status (same values as VLSMVST) 12 CHAR SMS       X V
VLSMSSTG Volume SMS Storage Group name 8 CHAR SMS   A X X V
VLSMSHTR Volume SMS High Threshold 3 NUM SMS   A X X V
VLSMSLTR Volume SMS Low Threshold 3 NUM SMS   A X X V
VLLRGCYL Number of Cylinders in Largest Free Extent 5 NUM LSPC   A X X S
VLLRGTRK Number of Tracks in Largest Free Extent 5* NUM LSPC   A X X S
VLLRGBYT Number of Bytes in Largest Free Extent ** NUM LSPC   A X X S
VLUSERS Number of Current Allocations to Volume 5 NUM UCB   A   X S
VLVTIXTR Number of Tracks Allocated to the VTOC Index 5 NUM VTOC   A   X S
VLVTOCTR Number of Tracks Allocated to VTOC 5 NUM VTOC   A   X S
VLVVDSTR Number of Tracks Allocated to VVDS 5 NUM VTOC   A   X S
VLVVDSXT Number of Extents Allocated to VVDS 3 NUM VTOC   A   X S
VLABRGEN Current ABR backup generation number 4 NUM MODL   A X X V
VLABRCYC Current ABR backup cycle number 2 NUM MODL   A X X V
VLABRHTR Volume ABR High Threshold 3 NUM MODL   A X X V
VLABRLTR Volume ABR Low Threshold 3 NUM MODL   A X X V
VLABROPT ABR Volume Processing Options: C Cycle table is active N Never Archive from this volume S Scratch is permitted T ABR thresholds are enabled X Copy 1 expiration date active Y Copy 2 expiration date active I Instant backup attempted 7 CHAR MODL   A X X V
VLSYSID SMF system id on which FDREPORT was run 4 CHAR   A X X V

* the width of these fields will be 6 if the FATDISK option is enabled.

** the format and width of byte fields varies depending on the value of the BYTEFORMAT= operand and the FATDISK option.

*** this field supports selection via a mask; see the VOL= operand in Section 54.13

Published with permission of Innovation Data Processing

back to top

HSM REPORTING

The HSM data sets supported by FDREPORT are:

MCDS - information on migrated data sets

BCDS - information on backups of current data sets

This allows you to use all the power and flexibility of FDREPORT to generate reports about the data that HSM is managing.

With the exception of NTMIGRAT, there are no new field names defined when reporting from HSM data. Instead, data fields from the HSM records and calculated values are mapped into standard FDREPORT field names.

DFHSM FIELDs which can be obtained from the MCDS

For DATATYPE=MCDS, the MCDS data set record is described by the IBM MCD macro and the mapping is:

MCDS field nameFDREPORT field Field Description name
MCKDSNData set name
MCDFRVSN VOLVolume Serial Number
MCDUCBTY UCBIDUCB 4-byte device type(hex)
 DEVTYPEDisk device type (e.g., 3390)
MCDFLGSDSSN MGRATx (x=migration level)
MCDDLC CRDATE Creation Date
  CRDAYS Days since Creation (calculated)
MCDEXPDT EXPDATEExpiration Date
 EXPDAYSDays since Expiration (calculated)
MCDDLR LRDATE Last Reference Date
MCDTLR LRTIME Last Referenced Time
 LRDAYS Days since Last Reference (calculated)
MCDDMIGADATEDate Archived (Migrated)
MCDTMIGATIMETime Archived (Migrated)
  ADAYSDays since Migration (calculated)
MCDDSORG DSORGData Set Organization
MCDRECFM RECFMRecord Format
MCDOPTCD OPTCDOption Code
MCDBLKSZ BLKSIZEBlock Size
  BLKSTRKBlocks/track (calculated)
  BYTESTRK Bytes/track (calculated)
MCDKEYLN KEYLEN Key Length
MCDDSIND DSINDData Set Indicators
MCDSIZESIZE Allocated Tracks
  SIZEUSED Used Tracks (calculated)
  SIZEFREE Free Tracks (calculated)
MCDSIZEB BYTESBytes Allocated
  BYTESUSE Bytes Used (calculated)
  BYTESFRE Bytes Free (calculated)
  %USEDPercentage used (calculated)
  %FREEPercentage free (calculated)
  LSTARLast Used ttttrr
MCDSCNAM STORCLAS SMS Storage Class
MCDMCNAM MGMTCLAS SMS Management Class
MCDMDNAM DATACLAS SMS Data Class
MCDSMSFG SMSFLAGS SMS Data Set Flag Byte
MCDSCAL1 SECAFLAG Secondary Allocation Flags
MCDSCAL3 SECALLOC Secondary Allocation Quantity
MCDNMIGNTMIGRAT Number of times data set was migrated
  SOURCE 'MCDS'

Published with permission of Innovation Data Processing

back to top

DFHSM FIELDs which can be obtained from the BCDS

For DATATYPE=BCDS, the BCDS data set record is described by the IBM MCB macro and the mapping is:

BCDS field nameFDREPORT field name Field Description
MCKDSN Data set name
MCBFRVOL VOL Volume Serial Number
MCBDBU ADATE Date Backed Up
MCBTBU ATIME Time Backed Up
  ADAYS Days since backup (calculated)
MCBDLRPD LRDATELast Reference Date
  LRDAYSDays since last reference (calculated)
MCBDSORG DSORG Data Set Organization
MCBRECFM RECFM Record Format
MCBBLKSZ BLKSIZE Block Size
MCBKEYLN KEYLENKey Length
MCBDSIND DSIND Data Set Indicators
MCBSIZESIZEAllocated Tracks
MCBSIZEB BYTESUSEBytes Used
  BYTES Bytes Allocated (calculated)
MCBNBC NTMIGRATNumber of times data set was backed up
 SOURCE'BCDS'

Published with permission of Innovation Data Processing

back to top


                           VENDOR SHOWCASE

Copyright © Lascon Storage Ltd. 2000 to present date. By entering and using this site, you accept the conditions and limitations of use