TAA Tools

The Convert  Tape  Save Description  command converts  the output  from
DSPTAP of  save information to an outfile.   Because the DSPTAP spooled
output  is  copied with  CPYSPLF,  the CVTTAPSAVD  function  is release
dependent.   Only the lower  and upper  case English language  versions
are supported.   The model  file is TAASAVHP  in TAATOOL with  a format
name of TAPSAVDR.

IFS and QDOC objects are not converted.

The command generally has three uses:

  **   After  a save  to tape,  you can  use CVTTAPSAVD  to get  a data
       base file of the objects  and members actually saved.  This  can
       be important  when SAVCHGOBJ is used.   The same  function could
       be performed using the OUTFILE parameter on a SAV command.

  **   If  you  are  going  to  restore  from  tape,  you may  want  to
       understand the makeup of the saved objects.

  **   If you are going to  restore from a tape,  you may want to  know
       whether    the   objects    were    saved   with    SAVLIB    or

A typical command would be entered as:


The file TAPSAVDP would be written to the OUTLIB specified.

Each record  output contains the  same heading information  such as the
volume  ID, the command used, the time of  the save, etc.  There is one
record for each object saved.   If a data base file is saved,  there is
one record  for the file  and one record for  each of the  members.  An
object  record can  be distinguished  from a  member record  by whether
the TFMBR field is blank.

The member  records  will not  contain  the owner  or  size.   It  will
contain the object name and attribute for each file.

The  following fields  will  contain the  same  value  for each  record
written for the same library:

   TFOBJS        The number of objects saved.

   TFMBRS        The number of members saved.

   TFACP         The number of access paths saved.

   TFSPL         The number of spooled files saved.


A QDOC library cannot be processed.

Command parameters                                    *CMD

   DEV           The tape device to be used.

   LIB           The   library  on   tape  (the   tape  label)   to  be
                 converted.    A  specific  library  or  *ALL  may   be

                 If a  specific  library is  named, the  tape which  is
                 mounted  is searched  (beginning at  the  current file
                 sequence  number) for  that library.   If  the library
                 is not on the tape, an error message will occur.

                 An entry  of  *ALL specifies  that  all files  on  the
                 tape  will be  processed.   File  sequence  1 is  used
                 first.    If  a  multi-volume  tape  was  written, the
                 CVTTAPSAVD command will not  cause a request to  mount
                 a subsequent  tape.   It will  end at  the end of  the
                 mounted  tape.   To do  all  files for  a multi-volume
                 save,  you   need   to   mount  each   tape   of   the
                 multi-volume save and use CVTTAPSAVD on each tape.

   VOL           The tape volume to be converted.

                      Note:  If  the   device  specified  is   a  media
                      library  device, or a  virtual tape  device, then
                      the  volume  specified  should  be  the cartridge
                      identifier or virtual  volume name to  be mounted
                      and used.

                 The default  is *MOUNTED.   For media  library device,
                 the  volume to  be used is  the next  cartridge in the
                 category mounted by the SETTAPCGY command.

   SEQNBR        The sequence number on the  tape where the library  is
                 located.   The default  is *SEARCH  meaning the  first
                 library name found will be used.

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

   ENDOPT        The operation  to  be  performed on  the  tape  volume
                 when the tape has  been read.  The default  is *REWIND
                 to rewind the tape.

                 *UNLOAD may be specified to unload the tape.

   OUTLIB        The  library  in  which  the  file  TAPSAVDP  will  be
                 placed.   The default is *LIBL.   If the TAPSAVDP file
                 does not already exist,  a library must be  specified.

   OUTMBR        The member  of the TAPSAVDP file  to be used.   If the
                 member  does not exist,  it is added.   The default is

   REPLACE       A *YES/*NO  value  for whether  the member  should  be
                 cleared before writing  records into it.   The default
                 is *YES.

   ONERCD        A  *YES/*NO value for  whether a  single record should
                 be output for each tape file.  The default is *NO.

                 The intent  of  the  *YES entry  is  to  allow  faster
                 access to  the data  if only  the heading  information
                 is  needed.   The  single output  record  will contain
                 all  of  the heading  information (command  used, time
                 of the  save, etc),  but  no detail  object or  member

File format

The file name that is output is TAPSAVDP.

The model file used is TAASAVHP with a format name of TAPSAVDR.

To see the field names used:


The TFSIZ2  field is in K  bytes.  The TFSIZE  field will hold  up to a
value  of 99,999,999,999.    If the  actual size  exceeds this,  all 9s
will exist.


Because  the  DSPTAP  spooled  output  is  copied  with  CPYSPLF,   the
CVTTAPSAVD function  is release  dependent.  Only  the lower  and upper
case  English language versions  are supported.   If the format  of the
DSPTAP printed output is changed  on a subsequent release, the  program
must be modified.

A QDOC library cannot be processed.

IFS objects cannot be processed.


The following TAA Tools must be on your system:

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

   CVTTAPSAVD    *CMD                       TAASAVH       QATTCMD
   TAASAVHP      *FILE          PF          TAASAVHP      QATTDDS
   TAASAVHC      *PGM           CLP         TAASAVHC      QATTCL
   TAASAVHR      *PGM           RPG         TAASAVHR      QATTRPG

Added to TAA Productivity tools April 1, 1995

Home Page Up to Top