TAA Tools
CHKTAP2         CHECK TAPE 2                           TAATAPM

The Check  Tape  2 command  is similar  to the  system CHKTAP  command.
Neither  the  system  CHKTAP  nor  the  SAVxxx commands  will  send  an
inquiry  message to the device's message queue if  the tape is not in a
'ready' status (such  as no tape  is mounted), the  volume ID does  not
exist,  the sequence  number does  not exist,  etc.   CHKTAP2  sends an
inquiry  message  (TAA0909)  requesting a  C  = Cancel,  or  R  = Retry
response.  The message is sent with SEV(99).

The system CHKTAP  and SAVxxx  command cause escape  messages on  error
conditions.   This may prevent  the operator  from being able  to retry
after mounting the correct tape.

A typical CHKTAP2 command would be:

             CHKTAP2       DEV(TAP01)

If  the tape is  not in  a 'ready' status,  message TAA0909 is  sent to
the device's  message  queue  (typically  QSYSOPR) and  awaits  a  C  =
Cancel or R = Retry response.

CHKTAP2 supports the same parameters as the CHKTAP command.

Message handling within CHKTAP2
-------------------------------

Assume the device message queue is QSYSOPR.

When  a device  is not  ready,  the system  sends  the CPF6760  message
(Tape not ready)  to QSYSOPR.  The message  is sent as an 'Information'
type  (not  as an  Inquiry).   CPF6760  is  specified as  SEV(40) which
would cause a 'break' of  QSYSOPR if the severity setting is for  40 or
lower.

This would  occur before the  TAA0909 Inquiry Message so  QSYSOPR would
first be broken by the CPF6760 message and then by TAA0909.

To  prevent CPF6760 from causing a break,  OVRMSGF is used to allow the
TAAMSGF version  of  CPF6760  to be  used.   CPF6760  is  specified  in
TAAMSGF as SEV(00) which would normally not cause a break.

The TAA0909 message  is then sent as  an Inquiry with SEV(99)  to cause
a break.  At the end of the program, the OVR to TAAMSGF is removed.

CHKTAP2 escape messages you can monitor for
--------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   DEV           The  device name  to be checked.   It  must be  a tape
                 device.

   VOL           The volume identifier.   The default  is *MOUNTED.   A
                 specific volume  identifier  may only  be entered  for
                 standard labeled tapes.

   SEQNBR        The  sequence  number   of  the  tape  if  a  specific
                 sequence  number is  required.   The default  is *NONE
                 meaning no check is made.

                 *FIRST may be entered  to check the first file  on the
                 volume.

                 *NEXT may  be entered  to check the  next file  on the
                 volume.

                 *SEARCH  may   be  entered  to  search  for  the  file
                 specified in the label parameter.

                 A specific number  may be  entered in the  range of  1
                 to 1677215.

   LABEL         The file  label to  be checked  for.   The default  is
                 *NONE meaning no file label is checked for.

                 A  specific file  label may be  entered if  a sequence
                 number is specified.

   CRTDATE       The create date the file  was created is checked  for.
                 *NONE  is  the  default  meaning  no  create  date  is
                 checked for.

                 A  specific date  may be  entered  (in job  format) to
                 check  for the file create  date.  A specific sequence
                 number must be entered.

   ENDOPT        The end  of tape  option.   *LEAVE is  the default  to
                 leave the tape where it is positioned.

                 *REWIND may be specified to rewind the tape.

                 *UNLOAD may be specified to unload the tape.

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

None.

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

The following TAA Tools must be on your system:

     RSNLSTMSG       Resend last message
     RTVDEVTAP       Retrieve device tape
     SNDESCMSG       Send escape message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CHKTAP2       *CMD                   TAATAPM       QATTCMD
   TAATAPMC      *PGM       CLP         TAATAPMC      QATTCL
					

Added to TAA Productivity tools October 15, 2003


Home Page Up to Top