VTOC DSN Level Report

Related topic

The VTOC DSN Level Report lists information about each data set on each volume selected by the option keywords.

Purpose	Lists information about each data set on each volume selected by the option keywords
Data source	VTOC scan
Initial order	Data set name
Report name verb	VTOC_DSN
Member name	SRMBR039

The following table describes option keywords for the VTOC DSN Level Report.

Option keywords for the VTOC DSN Level Report

Entry	Default	OR...	Description
DSN	/	DSN up to 44 characters	Specifies the data-set name level or data set filter.
DSTYPE	ALL	VSAM, NONVSAM	Specifies the data set type restricts reporting to data sets that are either VSAM or non-VSAM based The ALL option reports both types of data sets.
MERGECAT	NO	YES	Determines whether information should be acquired from the catalog If NO, only information found in the VTOC and VVDS is included.
MERGECTL	NO	YES	Determines whether the application information for the data sets should be calculated and displayed
MOUNT	ALL	PUBLIC, PRIVATE, STORAGE	Specifies the mount type of the device
PREFIX	/	DSN up to 44 characters	Specifies the data-set name level or data set filter
SMSGROUP	-	-	Specifies the SMS group from which the volume should be selected
SMSSTATE	ALL	INITIAL, MANAGED, UNMANAGED	Indicates the SMS status indicator
UADFIRST	0000	4 characters	Specifies the first unit address
UADLAST	FFFF	4 characters	Specifies the last unit address
VOLSER	?*	up to 6 characters	Includes only volumes that match the specified volume serial number or volume serial number filter in the VTOC DATASET report Use?* to generate a report for all volume serial numbers.
VSCF_SUFFIX	None	two character suffix for the SMVSCF member to be used for the VTOC scan	Invokes a VTOC scan by using the SMVSCF xx PARMLIB member, from which it derives the control statements for the scan, and then generates the VTOC DSN report

The following table presents a field list for the VTOC DSN Level Report

Field list for the VTOC DSN Level Report

Column Heading	Field name	Description
DATA SET NAME	DSN	Data set name
VOLSER	VOLSER	Volume serial number of the device on which the data set was found
UCB	UCB	UCB or device address
DS ORG	DSORG	Data set organization
RECFM	RECFM	Record format
SIZE	SIZE	Data set size in kilobytes
TRACKS ALLOC	TRACKS	Number of tracks occupied by the data set
XTS	EXTS	Number of extents occupied by the data set
%USED	PUSED	Percentage of allocated space that is used
TRACKS USED	TRKSUSED	Number of tracks used
TRACKS FREE	TRKSFREE	Number of tracks allocated but free
LRECL	LRECL	Logical record length
CI/BLK SIZE	BLKSIZE	Block size or, for a VSAM data set, the control interval size
% EFF	EFF	Percentage of space used in a track by the block size or physical CI size of the data set
CA SPLITS	CASPLITS	Number of VSAM control area splits performed on the data set
CI SPLITS	CISPLITS	Number of VSAM control interval splits performed on the data set
CRDATE	CRDATE	Data set creation date No filters allowed.
EXPDATE	EXPDATE	Data set expiration date No filters allowed.
LSTREFD	LSTREFD	Date the data set was last referenced No filters allowed.
DAYS NREF	DAYSNREF	Number of days since the data set was opened
CAT	CAT	Catalog indicator
CHG	CHG	Changed indicator
REB	REBLOCK	Reblock indicator
BLK PTRK	BLKPTRK	Number of physical blocks that will fit into one track
SMS IND	SMSIND	SMS-managed indicator
SMS GRP	SMSGROUP	SMS storage group
STORCLAS	STORCLAS	SMS storage class
MGMTCLAS	MGMTCLAS	SMS management class
DATACLAS	DATACLAS	SMS data class
ACCLVL1	ACCLVL1	Application level 1
ACCLVL2	ACCLVL2	Application level 2
ACCLVL3	ACCLVL3	Application level 3
ACCLVL4	ACCLVL4	Application level 4
MESSAGE	MESSAGE	Error message relating to a specific data set

The following figure provides a sample of the VTOC DSN Report.

VTOC DSN Level Report example

Produced by BMC AMI Storage                          VTOC DSN LEVEL REPORT                                               Page:   30
BMC Software, Inc.                                                                        Generated:02/19/2004(2004.324) @ 10:34

DATA SET NAME                                VOLSER UCB DS   RECFM SIZE      TRACKS XTS %USED TRACKS TRACKS LRECL CI/BLK % EFF
                                                          ORG        (KB)      ALLOC            USED   FREE           SIZE

EMP.SGDR251.ASM                              EMP001 051A PO   FB         9130    165   1 98.1    162      3    80 23440   82.7
EMP.SGDR251.ISPLLIB                          EMP005 051E PO   U          4150     75   1 21.3     16     59     0 23476   82.8
EMP.SGDR251.ISPMLIB                          EMP001 051A PO   FB          166      3   1 100.0      3      0    80 3120   82.5
EMP.SGDR251.ISPPLIB                          EMP001 051A PO   FB         4980     90   1 76.6     69     21    80 3120   82.5
EMP.SGDR251.ISPTLIB                          EMP001 051A PO   FB          110      2   1 100.0      2      0    80 23440   82.7
EMP.SGDR251.JCL                              EMP004 051D PO   FB         2490     45   1 100.0     45      0    80 6240   88.0
EMP.SGDR251.LINK                             EMP004 051D PO   FB          830     15   1 26.6      4     11    80 6240   88.0
EMP.SGDR251.LISTING                          EMP002 051B PO   FBA       87984   1590   2 71.3   1135    455   121 23474   82.8
EMP.SGDR251.LLISTING                         EMP004 051D PO   FBA        3320     60   2 76.6     46     14   121 23474   82.8
EMP.SGDR251.LOAD                             EMP003 051C PO   U          4980     90   1 15.5     14     76     0 23476   82.8
EMP.SGDR251.MACLIB                           EMP004 051D PO   FB         1660     30   1 100.0     30      0    80 6240   88.0
EMP.SGDR251.OBJ                              EMP004 051D PO   FB         1660     30   1 80.0     24      6    80 6240   88.0
************************************************** END OF VTOC_DSN REPORT **************************************************

Example

The following example shows how to display a list of data sets on volume WORK02 that have not been opened for more than 50 days. The data sets are selected from the VTOC.

In this example:

VOLSER report option keyword limits the request to data sets on volume WORK02.
DAYSNREF data output field name limits the request to data sets that have not been referenced for more than 50 days.
SORT report option keyword sorts the report in descending order by tracks allocated and ascending order by data set name.
ORDER report option keyword builds the report by using the data set name followed by the number of tracks allocated, days not referenced, creation date, and last referenced date.

VTOC_DSN,
VOLSER(WORK02),
DAYSNREF(>50),
SORT(TRACKS,D,DSN,A),
ORDER(DSN,TRACKS,DAYSNREF,CRDATE,LSTREFD)

The following figure provides a sample of the customized report.

Customized VTOC DSN Level Report example

Produced by BMC AMI Storage             VTOC DSN LEVEL REPORT            Page: 2
BMC Software, Inc.                                           Generated:03/31/2013(2013.352) @ 17:11

DATA SET NAME                                TRACKS DAYS CRDATE     LSTREFD
                                              ALLOC NREF
RICKH.BB03845.SYSMDUMP                          630   58 03/19/2013 03/20/2013
RAY.NAME3.TEST                                  135   58 03/19/2013 03/20/2013
ISR.V3R3M0.ISRLOAD                              105   58 03/19/2013 03/20/2013
SYS1.V410.SSPLIB                                 26   58 03/19/2013 03/20/2013
ISR.V3R3M0.ISRCLIB                               20   58 03/19/2013 03/20/2013
DOUG.BB01681.DATA                                16   58 03/19/2013 03/20/2013
DAVE.BBISPRNT                                    14   58 03/19/2013 03/20/2013
SYS1.VTOCIX.WORK02                               14   59 03/19/2013 00/00/00
HSM26.OUTPUT.DFSMShsm.D950526                    10   58 03/19/2013 03/20/2013
SYS1.IODF18.ACTLOG                                8   58 03/19/2013 03/20/2013
SYS1.WLM.PDS                                      5   58 03/19/2013 03/20/2013
HSM26.AAAA.BBBB.QUAL4.QUAL5.FILE                  3   58 03/19/2013 03/20/2013
MIKE2.HCD.TRACE                                   3   58 03/19/2013 03/20/2013
DAVE.TEST.MULTIVOL.SAM                            1   58 03/19/2013 03/20/2013
JIM.IVP33.DASDPOOL.WRKTEST                        1   58 03/19/2013 03/20/2013
JOHNW1.SPFTEMP2.CNTL                              1   58 03/19/2013 03/20/2013
JOHNW2.SPFTEMP2.CNTL                              1   58 03/19/2013 03/20/2013
MIKE.HCD.TERM                                     1   58 03/19/2013 03/20/2013
MIKE2.HCD.MSGLOG                                  1   58 03/19/2013 03/20/2013
MIKE2.HCD.TERM                                    1   58 03/19/2013 03/20/2013
FIELDS.VOLREF                                     0   58 03/19/2013 03/20/2013
**************************** END OF VTOC_DSN REPORT ****************************

VTOC DSN Level Report

On this page