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
|
