CVTTAPSAVD -- Convert Tape Save Description

CVTTAPSAVD CONVERT TAPE SAV DESCRIPTION TAASAVH
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 SAVOBJ/SAVCHGOBJ. A typical command would be entered as: CVTTAPSAVD DEV(TAP01) LIB(ALL) 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. The 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 specified. 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 TAPSAVDP. 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 information. 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: DSPFMT TAASAVHP 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. Restrictions ------------ 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. Prerequisites ------------- The following TAA Tools must be on your system: 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 ------ ---- --------- ---------- ---------- CVTTAPSAVD CMD TAASAVH QATTCMD TAASAVHP FILE PF TAASAVHP QATTDDS TAASAVHC PGM CLP TAASAVHC QATTCL TAASAVHR PGM RPG TAASAVHR QATTRPG

CVTTAPSAVD      CONVERT TAPE SAV DESCRIPTION           TAASAVH


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
       SAVOBJ/SAVCHGOBJ.

A typical command would be entered as:

       CVTTAPSAVD      DEV(TAP01) LIB(*ALL)

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.

The

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

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

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

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:

       DSPFMT    TAASAVHP

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.

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

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.

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

The following TAA Tools must be on your system:

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

   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