TAA Tools
CVTSAVFD        CONVERT SAVE FILE DESCRIPTION          TAASAVG

The Convert  Save  File Description  command converts  the output  from
DSPSAVF to  an outfile.  The  file output is SAVFDP with  a format name
of SAVFDR.  The command generally has two uses:

  **   After  a save  to a  save file,  you can  use CVTSAVFD to  get a
       data base  file  of  the  objects and  members  actually  saved.
       This can be important when SAVCHGOBJ is used.

  **   If you  are going to restore from  a save file, you  may want to
       understand the makeup of the save file.

A typical command would be entered as:

       CVTSAVFD    SAVF(xxxx) OUTLIB(yyyy)

The file SAVFDP would be written to the OUTLIB specified.

Each  record output contains  the same heading information  such as the
save file name,  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 SFMBR  field is blank.   Member  records are  blank for
the SFOWNR, SFSIZE, and SFODTA fields.

The sequence of the output is:

          - Library record (if SAVLIB was used)
          - Objects by name within type
          - Member name within object

CVTSAVFD escape messages you can monitor for
--------------------------------------------

      TAA9893    No objects exist in the save file.

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

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

   SAVF          The  qualified save file  name to  be converted.   The
                 library defaults to *LIBL.

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

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

   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 only  one record should
                 be output.  The default is *NO.

                 The  intent  of  the   *YES  value  has  been   mostly
                 replaced by  the RTVSAVFD command.   *YES may  be used
                 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.).   The first
                 record  (the library record  if SAVLIB  was used) will
                 be the only record in the outfile.

   MBRRCDS       A *YES/*NO  value for  whether member  records  should
                 be output.   The default is *YES to  output one record
                 for each member that was saved.

                 *NO  may be specified  so only the  library record (if
                 SAVLIB was used) and object records are output.

File format
-----------

The file name that is output is SAVDP.

The model file used is TAASAVGP with a format name of SAVFDR.

To see the field names use:

       DSPFMT    TAASAVGP

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

Save files can contain the objects from  a single library.  There is  a
limit of approximately:

           - 70,000  objects
           - 300,000 member

There is no restriction on the size of the data saved.

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

The following TAA Tools must be on your system:

           CHKOBJ3      Check object 3
           EDTVAR       Edit variable
           HLRMVMSG     HLL Remove message
           RTVSAVFD     Retrieve save file description
           RTVSYSVAL3   Retrieve system value 3
           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
   ------        ----        ---------      ----------    ----------

   CVTSAVFD      *CMD                       TAASAVG       QATTCMD
   TAASAVGP      *FILE          PF          TAASAVGP      QATTDDS
   TAASAVGC      *PGM           CLP         TAASAVGC      QATTCL
   TAASAVGR      *PGM           RPG         TAASAVGR      QATTRPG
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top