GTDVTOC - printed output

For each device, information displays in the GTDVTOC output file that is defined by the SYSPRINT DD statement.

The following information is contained in the GTDVTOC printed output file:

Table 1. GTDVTOC device level output
Unit The four-digit device number. Only devices that are online and not flagged as changing status (pending offline) are selected.
Volser The volume serial number.
Primary Cyls - Device The number of primary cylinders that are returned in the Read Device Characteristics data.
Primary Cyls - VTOC The number of primary cylinders that are calculated from fields in the Format 4 DSCB. If the DS4DEVAC field (number of alternative cylinders) is valid, the value is subtracted from DS4DEVSZ (the number of logical cylinders). In older VTOCs, the number of alternative cylinders is calculated by dividing DS4NOATK (the number of available alternative tracks) by 15 and rounding up.
Alt. Tracks - Device The number of alternative tracks that are returned in the Read Device Characteristics data.
Alt. Tracks - VTOC The number of available alternative tracks from the VTOC, taken from field DS4NOATK. This column contains both values that are separated by a slash if the format for DSCB also contains the number of alternative cylinders, and a mismatch exists between DS4NOATK and DS4DEVAC multiplied by 15.
DS4DEVAV set Blank, or a flag that indicates the VTOC contains a valid DS4DEVAC.
Primary Cylinder Mismatch1 Blank, or a flag to draw attention to the fact that the values in fields, Primary Cyls - Device and Primary Cyls - VTOC are different.
Alternative Track Mismatch1 Blank, or a flag that indicates the calculated number of alternative tracks does not match the value that is returned in the Read Device Characteristics data.
Note: The numbers of alternative tracks are not compared, and this field is blank if the numbers of primary cylinders are unequal.
XRC Blank or a flag that indicates + for XRC supported or X for XRC active on the volume.
PPRC Blank or a flag that indicates + for PPRC supported or X for PPRC active on the volume.
Channel Extender Blank or a flag that indicates the volume is attached to a channel extender

Other Messages1

 Blank, or a message that reports an index error or explaining why no counters or flags are reported for the device.

1 An entry is listed if any of the last three items in the table are non-blank for a device, even if the BRIEF parameter was specified.

Messages that might appear in the Other Messages field are as follows.

Table 2. GTDVTOC messages
Volume has non-standard VTOC The pointer to the Volume Table of Contents in the UCB shows that the VTOC does not start at the beginning of a track. So, GTDVTOC does not attempt to allocate to the volume. This volume might be a VM volume.
Device has no operational paths The online device is unusable.
Device is TDMF target The device is the target of a TDMF volume migration. It would be impossible to OPEN the VTOC, as TDMF does not allow access to the volume.
OPENJ Abend Sxxx-rr The DCB Abend exit was called during OPEN TYPE=J processing for the VTOC or VTOC index. The system completion and reason codes that are encountered by OPEN are formatted into the message. GTDVTOC will de-allocate the volume and continue with the next device.
OPENJ timeout More than 5 seconds elapsed during run of the OPEN TYPE=J. The cause might be that another system reserved the device, or a hardware/pathing error. GTDVTOC will deallocate the volume and continue with the next device.
I/O Error (RDC). Sense - ‘ssss’ The VTOC was opened successfully, but the control unit rejected the Read Device Characteristics request. The contents of the first two sense bytes are displayed in the message.
I/O Error (Read). Sense - ‘ssss’ The VTOC was opened successfully and the device characteristics were obtained from the control unit. The I/O operation to read a track from either the VTOC or its index failed. The contents of the first two sense bytes are displayed in the message.
VTOC format error An invalid DSCB was encountered during the read of the VTOC
Unable to open VTOC index An OPENJ of the VTOC index whose name was found in the VTOC itself was unsuccessful.
VTOC index format error An invalid VIR record was found in the index, or the number of tracks mapped by the VPSM records was not a multiple of 15.
Index size error - nn,nnn Cyls The number of logical cylinders that are described in the index’s VPSM records (displayed in this message) differs from the value found in the format four DSCB.
XRC Session ID = session name An XRC session is active for this volume on this system.
XRC Session An XRC session is active for this volume on a different system.