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