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
parameter).

The typical command would be entered as:

    CHKSAVTAP    DEV(TAP01)

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
the tape.

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
                 device.

                 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
                 be checked.

                 If   a  number  greater  than   1  is  specified,  the
                 checking  begins  at  that  sequence  number  for  all
                 remaining files.

   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
                 requirements.

Restrictions
------------

Only a single device and volume ID may be entered.

Prerequisites
-------------

The following TAA Tools must be on your system:

           EDTVAR         Edit variable
           SNDCOMPMSG     Send completion message
           SNDESCMSG      Send escape message
           SNDSTSMSG      Send status message

Implementation
--------------

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