Input and output

IFHSTATR uses, as input, ESV records that contain error and usage information about magnetic tape volumes. If no ESV records are found, a message is written to the output data set. If the ESV record is not 62 or 80 bytes long, an INVALID TYPE 21 RECORD message is printed.

Run IFASMFDP to convert SYS1.MANX or SYS1.MANY from VSAM to physical sequential prior to using IFHSTATR to retrieve data from the ESV records.

IFHSTATR produces an output data set which contains information selected from ESV records. The output takes the form of 121-byte unblocked records, with an American National Standards Institute (ANSI) control character in the first byte of each record.

The input data set cannot have a block size that exceeds 32760 bytes. The tapes represented by the SMF records can have block sizes that exceed 32760 bytes.

If the block size field or the usage SIO count field in the Type 21 record exceeds 99,999, IFHSTATR scales the output. For example, if the field was greater than 99,999 but less than 1,000,000 it will be scaled to multiples of 1,000 and the letter "K" will be appended. If the field is greater than 999,999 it will be scaled to multiples of 1,000,000 and the letter "M" will be appended. Note that in this case the meanings of "K" and "M" differ from the meanings of "K" and "M" in the BLKSIZE value on the DD statement. On the DD statement, they mean multiples of 1024 and 1048576 respectively.

Related reading: For information about IFASMFDP, see z/OS MVS System Management Facilities (SMF).

Figure 1 shows a sample of printed output from IFHSTATR. The fields in the printed output are explained in the legend that follows.

Figure 1. Sample Output from IFHSTATR

Legend
TIME OF DAY	The time the ESV record was written.
DEV ADR	The device address of the tape drive on which the tape was mounted
T/U SER	Serial number of the tape drive that wrote the tape, which is obtained from the tape label for input tapes if available.
MODE¹	The OPEN flag bits for the data set being accessed. OUT = OPENED for OUTPUT RF = OPENED for INPUT forward RB = OPENED for INPUT read backward
BLOCKSIZE¹	The block size in the last data set accessed.
TAPE FORMAT¹	The recording format of the tape.
TEMP READ	Number of read data checks that were successfully retried.
TEMP READB²	Number of read data checks on read backward commands that were successfully retried.
TEMP WRITE	Number of write data checks that were successfully retried.
PERM RD	Number of read data checks that were not successfully retried.
PERM WRT	Number of write data checks that were not successfully retried.
NOISE BLOCK	(NRZI only) Number of read data checks that had the number of bytes read less than 12.
ERASE GAPS	Number of times an erase gap command was issued during error recovery. An erase gap command is issued before a retry of a write data check.
CLEAN ACTS	Number of times that, during read data check recovery, the tape was moved over the cleaner blade. This will normally be done after every fourth retry of the original read command.
USAGE SIO	Number of channel programs completed (channel programs started by ERP are not counted). Because a channel program has any number of CCWs, this may not be the count of the reads or writes.
MBYTES READ²	Megabytes read.
MBYTES WRITTEN²	Megabytes written.
Notes: ¹ Data originates in the DCB or DCBE and may not be available. ² Buffered tape units only