VTOC

File 4
Op-Sys z/OS, z/VSE, BS2000
Statement FIND
Task List the VTOC of a specified disk with related information such as volume serial number, dataset name, file size, etc.

In BS2000, this view can be used to display the same information as returned by the system command /FSTAT with the VOL parameter or /SHOW-FILE-ATTRIBUTES with SELECT=BY-ATTRIBUTES(VOLUME=).

Common Fields for all Operating Systems

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
SYSTEM-MESSAGE-CODE A10      
VOLSER A6   D Required.
DSNAME A54   D  
FILE-SIZE N10   D  

Additional Fields supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
DSORG A4   D  
CREATION-DATE A8   D  
EXPIRATION-DATE A8   D  
LAST-TTR B3   D  
LAST-TTTR B4   D  
EXTENTS A192   D  
NUMBER-OF-EXTENTS N3   D  
CYLINDERS-ALLOCATED N7   D  
UNIT A4   D  
SERIES A8   D  
CREATION-DATX D   D  
EXPIRATION-DATX D   D  
EXTENT-TYPE A4   D  
EXTENTS-ARRAY A192 M/16 D  
LRECL N5   D  
BLKSIZE N5   D  
RECFM A5   D  
ALLOCATION-TYPE A4   D  
PRIMARY-QTY N10   D  
SECONDARY-QTY N10   D  
PERCENT-USED N3   D  
TRACKS-ALLOCATED N3   D  
SECURITY A5      
LAST-REFERENCE A8   D  
LAST-REFERENCE-DATX D   D  
UPDATED-SINCE-BACKUP A3   D  
SMS A3   D  
DSNTYPE A8   D  

Additional Fields Supported for z/VSE

Dictionary Field Name F/L Mu DE Remarks
DSORG A4   D  
CREATION-DATE A8   D  
EXPIRATION-DATE A8   D  
EXTENTS A192   D  
NUMBER-OF-EXTENTS N3   D  
CYLINDERS-ALLOCATED N7   D  
UNIT A4   D  
SERIES A6   D  
CREATION-DATX D   D  
EXPIRATION-DATX D   D  
EXTENT-TYPE A4   D  
EXTENTS-ARRAY A192 M/16 D  

Additional Fields Supported for BS2000

Dictionary Field Name F/L Mu DE Remarks
SYSTEM-CODE B2      

Relevant Error Codes

Code Text z/OS z/VSE BS2000
500 VSAM error. X    
530 Access denied by Security Facility.     X
565 Syntax error in dataset name.     X
604 No volumes specified.     X
696 Cannot assign logical unit.   X  
699 Not enough main storage available. X X X
701 DSNAME missing.     X
722 Requested dataset not found.     X
733 User ID does not exist.     X
750 Invalid operand within operand list.     X
781 Unable to obtain storage for work area extension. X    
782 Error from :1: for :2:, RC :3:, REASON :3: X    
783 Unable to allocate :1:, RC :2:, REASON :3: X    
784 Unable to open VTOC on :1:, RC :2: X    
785 CVAF:1: failed with RC :2: and CVSTAT :3: X    
798 Task was not started under TSOS.     X
799 Entire System Server internal error.     X
899 I-O error during read. X X  
996 Volume not online. X X X

Field Descriptions

Field Name Type/Length Operating System
ALLOCATION-TYPE (A4) z/OS

Allocation type specified. Possible values:

Value Explanation
ABS  Absolute
BLK  Block
CYL  Cylinder
TRK  Track
Field Name Type/Length Operating System
BLKSIZE (N5) z/OS

Block size.

Field Name Type/Length Operating System
CREATION-DATE (A8) z/OS, z/VSE

Dataset creation date in format DD/MM/YY. If no creation date is specified, the field is filled with asterisks ****.

Field Name Type/Length Operating System
CREATION-DATX (D) z/OS, z/VSE

Creation date of file in Natural format.

Field Name Type/Length Operating System
CYLINDERS-ALLOCATED (N7) z/OS, z/VSE

Number of integral cylinders allocated.

Field Name Type/Length Operating System
DSNAME (A54) z/OS, z/VSE, BS2000

Fully qualified dataset name when returned as output field. When used as input fields, this field can be used to select further datasets and supports the asterisk notation (*) as wildcard selection.

Field Name Type/Length Operating System
DSNTYPE (A8) z/OS

Data Set Type Specification.

Field Name Type/Length Operating System
DSORG (A4) z/OS, z/VSE

Dataset organization, for example PS for sequential dataset, PO for partitioned dataset, POE for PDSE.

Field Name Type/Length Operating System
EXPIRATION-DATE (A8) z/OS, z/VSE

Dataset expiration date in format DD/MM/YY. If no creation date is specified, the field is filled with asterisks ****.

Field Name Type/Length Operating System
EXPIRATION-DATX (D) z/OS, z/VSE

Expiration date of file in Natural format.

Field Name Type/Length Operating System
EXTENTS (A192) z/OS, z/VSE

Extent information. The field contains 16 entries, each 12 bytes long. Each entry contains the following:

  • Low cylinder and head (track) address of extent (binary CCHH)

  • High cylinder and head (track) address of extent (binary CCHH)

  • Number of cylinders in extent

  • Number of additional tracks in extent

Field Name Type/Length Operating System
EXTENTS-ARRAY (A192)  M16 z/OS, z/VSE

Extent information array of 16 x 16 entries, each 12 bytes long. Each entry contains the following:

  • Low cylinder and head (track) address of extent (binary CCHH)

  • High cylinder and head (track) address of extent (binary CCHH)

  • Number of cylinders in extent

  • Number of additional tracks in extent

Field Name Type/Length Operating System
EXTENT-TYPE (A4) z/OS, z/VSE

Possible values:

Value Explanation
FREE  This entry describes a free extent.
USED  This entry describes a regular data set (default value).
VTOC  Indicates the VTOC extent (z/OS only).
Field Name Type/Length Operating System
FILE-SIZE (N10) z/OS, z/VSE, BS2000

Number of tracks currently allocated. (CYLINDERS-ALLOCATED in tracks + TRACKS-ALLOCATED).

In BS2000, the number of PAM pages allocated.

Field Name Type/Length Operating System
LAST-REFERENCE (A8) z/OS

Last reference date in format DD/MM/YY. If the last reference date is null, this field is filled with asterisks ****.

Field Name Type/Length Operating System
LAST-REFERENCE-DATX (D) z/OS

Last reference date in Natural format.

Field Name Type/Length Operating System
LAST-TTR (B3) z/OS

Last track.

Field Name Type/Length Operating System
LAST-TTTR (B4) z/OS

Last used track and block on track (TTTR).

Field Name Type/Length Operating System
LRECL (N5) z/OS

Logical record length.

Field Name Type/Length Operating System
NUMBER-OF-EXTENTS (A192) z/OS, z/VSE

Number of extents used. Valid values are 1 - 255.

Field Name Type/Length Operating System
PERCENT-USED (N3) z/OS

Amount of space used in the dataset as a percentage of total space.

Field Name Type/Length Operating System
PRIMARY-QTY (N10) z/OS

Primary allocation.

Field Name Type/Length Operating System
RECFM (A5) z/OS

Record format, for example, FB.

Field Name Type/Length Operating System
SECONDARY-QTY (N10) z/OS

Secondary allocation.

Field Name Type/Length Operating System
SECURITY (A5) z/OS

Security status. Possible values:

Value Explanation
NONE  Not password-protected.
READ  Password-protected for read and write operations.
VSAM  VSAM file.
WRITE  Password-protected for write operations.
Field Name Type/Length Operating System
SERIES (A8) z/OS, z/VSE

Device series for the unit, for example, 3380.

Field Name Type/Length Operating System
SMS (A3) z/OS

Specifies whether the file is on an SMS-managed unit or device, YES or NO.

Field Name Type/Length Operating System
TRACKS-ALLOCATED (N3) z/OS

Number of remaining tracks allocated in addition to CYLINDERS-ALLOCATED.

Field Name Type/Length Operating System
UNIT (A4) z/OS, z/VSE

Device number of the unit on which the dataset resides.

Field Name Type/Length Operating System
UPDATED-SINCE-BACKUP (A3) z/OS

Specifies whether the file has been updated since the last backup, YES or NO.

Field Name Type/Length Operating System
VOLSER (A6) z/OS, z/VSE, BS2000

Volume serial number.