CHKSAVTAP CHECK SAVE TAPE TAATAPD
The Check Save Tape command is designed to perform a read test of a
save tape. This includes any media output from a SAV command, a new
release tape or a PTF tape.
The command uses CHKTAP and CPYF to see if the data on the tape can
be read. This does not ensure that the tape can be successfully
restored, but it does cause the entire tape to be read. This is
essentially a 'sanity' check against the tape.
Only a single device and volume ID may be entered. The same device
may be used for additional volumes (see the INQMSG parameter). A
second device may be used for other volumes (see the INQMSG
The typical command would be entered as:
Messages describing the files found are sent as both status messages
and to the job log.
Multi-volumes may be used.
If the default of SEQNBR(1) is used, the checking begins with the
first file on the tape and continues thru all subsequent files. It
is valid to mount other than the first volume of a multi-volume set
to begin the command. If this occurs, an inquiry message is sent to
the operator and I = Ignore may be used to begin the check.
This inquiry message can be avoided by specifying INQMSG(*NO).
Differences from DSPTAP
The system supplied DSPTAP command only reads the labels from the
tape. It uses a special hardware command to skip to the next label.
Consequently, DSPTAP does not do as thorough a job of sanity checking
a tape when compared with CHKSAVTAP. CHKSAVTAP reads every byte on
Differences from VFYTAP
The system Verify Tape command is a problem determination aid. It is
designed for interactive use with prompt screens and can take a long
time to execute. It checks only the tape drive and not the rest of
the system implications of saving and restoring an object.
Command parameters *CMD
DEV The tape device to be used.
PRTSUM A *YES/*NO value that defaults to *NO. When *NO is
specified, a message is sent to the job log for
every file read. When *YES is specified, the
message is not sent to the job log, but a spooled
file is created with the same information.
INQMSG A *YES/*NO value that defaults to *YES. If the tape
mounted is not the first volume, *YES causes an
inquiry message CPA4034 where the operator can
ignore the warning. A *NO entry allows the inquiry
message to be bypassed.
If you are mounting other than the first volume, *NO
may be used to bypass the inquiry message.
VOL The tape volume to be checked. *MOUNTED is the
default to mean the volume that is currently on the
A specific volume ID may be entered.
If the device specified is a media library device,
then the volume specified should be the cartridge
identifier to be mounted and used.
SEQNBR The sequence number of the first file to check. The
default is 1 which causes all files on the tape to
If a number greater than 1 is specified, the
checking begins at that sequence number for all
ENDOPT Determines the position of the tape at the end of
the command. *REWIND is the default. *UNLOAD may
also be specified.
*LEAVE is not valid because of internal
Only a single device and volume ID may be entered.
The following TAA Tools must be on your system:
EDTVAR Edit variable
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ----- --------- ---------- -----------
CHKSAVTAP *CMD TAATAPD QATTCMD
TAATAPDC *PGM CLP TAATAPDC QATTCL
TAATAPDR *PGM RPG TAATAPDR QATTRPG
Added to TAA Productivity tools April 1, 1995