LISTVTOC Statement

The LISTVTOC statement is used to request a partial or complete listing of the entries in a specified volume table of contents.

If you are using IEHLIST to list both the VTOC and the index data set of an indexed VTOC, refer to Listing a Volume Table of Contents.

The syntax of the LISTVTOC statement is:

Label	Statement	Parameters
[label]	LISTVTOC	[{DUMP\|FORMAT[,PDSESPACE]}] [,INDEXDSN=SYS1.VTOCIX.xxxx] [,DATE={dddyy\|dddyyyy}] [,VOL=device=serial] [,DSNAME=(name[,name[,...]])

where:

DUMP

specifies that the listing is to be in unedited, hexadecimal form. The dump option will show SMS indicators for the volume and DSCBs in the VTOC (format 1, 2, 3, 4, 5, 8 and 9 DSCBs) and the VTOC index in hexadecimal format.

FORMAT [,PDSESPACE]

specifies that a comprehensive edited listing is to be generated.

When PDSESPACE is specified, the space allocated, and space used, is displayed. This display occurs only for PDSE data sets, and is in kilobytes (kbytes).

If both FORMAT and DUMP are omitted, an abbreviated edited format is generated.

INDEXDSN=SYS1.VTOCIX.xxxx

specifies that index information is to be listed, in addition to the VTOC. The value xxxx is any third level qualifier. DUMP or FORMAT must be specified if INDEXDSN is specified. For more information on indexed VTOCs, refer to Listing a Volume Table of Contents.

DATE={dddyy|dddyyyy}

specifies that each entry that expires before this date is to be flagged with an asterisk (*) after the entry name in the listing. This parameter applies only to the abbreviated edited format. The specification of dddyy is the same as ddd19yy.

The VTOC expiration date of 'never expire' (1999.365 or 1999.366) is treated in a special way. That is, even if the DATE= parameter specifies a year date after 1999, those expiration dates are not flagged with an asterisk (*). The 'never expire' expiration date will never be flagged with an asterisk with any DATE= specification.

The DATE= parameter specifies a date with ordinary days. Even if a date such as DATE=36599 is specified, it does not mean a 'never expire' date. Instead, it just means a day of 1999/12/31. So, the VTOC expiration date of a date year after 1999 is not flagged with an asterisk.

If you code a date after 1999, then data sets that have the special expiration dates of 36599, 36699, 3651999, 3661999, 99999, or 9991999 are not flagged with an asterisk. Those data sets never expire.

The date that you code is not treated as a 'never expire' date. For example if you code 36599 or 3651999, data sets that expire December 30, 1999 will be flagged and data sets with expiration dates of December 31, 1999 and January 1, 2000 will not be flagged. If you code a ddd value that exceeds the number of days in that year, IEHLIST adds the extra days into the following year. For example, 36699 means January 1, 2000, 3671999 means January 2, 2000, and 9999 means September 25, 2001.

dddyy: specifies the day of the year, ddd, and the last two digits of the year, this form designates years before 2000yy.
dddyyyy: specifies the day of the year, ddd, and the year from 1900 to 2155, yyyy.

Default: No asterisks appear in the listing.

VOL=device=serial

specifies the device type and volume serial number of the volume on which the VTOC resides.

DSNAME=(name[,name[,...]])

specifies the fully qualified names of the data sets whose entries are to be listed. You can specify a maximum of 10 names, or one pattern with a wildcard such as * or %. If the list consists of only a single name, the parentheses can be omitted.

Note: If the DSNAME specified is a VSAM cluster name, the information returned indicates that the data set exists on the physical device (volume). But since there is no format 1 or 8 DSCB for the VSAM cluster, the output for a VSAM cluster will not be identical to the output for a normal data set.