The Restore Objects to Save File command reads a tape saved by SAVLIB
or SAVOBJ for one, many, or all libraries and restores the objects to
the TAATMPLIB library for each library found. After each library is
restored, a save file is created in a named library and the TAATMPLIB
library is saved to the save file. The TAATMPLIB library is then
cleared and the next library is processed.
RSTOBJSAVF allows you to restore from a save tape and then restore
one or more libraries (or objects) to a library name that differs
from the original library. This allows uniqueness of objects to meet
your specific requirements. For example, you may need to replace a
specific object in the original library after performing some
checking.
You must have *SAVSYS special authority to use RSTOBJSAVF.
RSTOBJ is used for each library on tape to allow the objects from
either SAVLIB or SAVOBJ to be restored.
Assume libraries ABC, DEF, and GHI were on a tape saved by the SAVLIB
command. To restore all libraries to save files in the SAVFS
library, you would specify:
RSTOBJSAVF DEV(xxx) SAVFLIB(SAVFS) RSTLIB(*ALL)
Assuming the command completes successfully, if you specified DSPLIB
of LIB(SAVFS), you would see 3 save files named ABC, DEF, and GHI.
Each would have a text description describing how and when they were
created.
If you displayed the contents of one of the save files you would see
the objects that were saved for the library. A SAVLIB command was
used to save the contents of TAATMPLIB so you would see the TAATMPLIB
library object in each of the save files.
To restore the objects from the DEF library to the DEF2 library, you
would specify:
RSTLIB SAVLIB(TAATMPLIB) DEV(*SAVF)
SAVF(SAVFS/DEF) RSTLIB(DEF2)
You can then use one or more of the objects in DEF2 per your
requirements.
Assume you want to restore the XYZ object from a save tape and
compare it to the current XYZ version in library DEF. You must first
create a library and then use RSTOBJ. Assume you will create a
library DEF2 for this purpose and the SAVFS library to contain the
save files created by RSTOBJSAVF.
CRTLIB LIB(DEF2)
CRTLIB LIB(SAVFS)
RSTOBJSAVF DEV(xxx) SAVFLIBS(SAVFS) RSTLIB(DEF)
RSTOBJ OBJ(XYZ) SAVLIB(TAATMPLIB) DEF(*SAVF)
SAVF(SAVFS/DEF) RSTLIB(DEF2)
The RSTOBJSAVF command creates the DEF save file in library SAVFS.
The RSTOBJ command restores the XYZ object to the DEF2 library.
You may now review the differences between the XYZ object in DEF and
the saved version which is now in DEF2.
Tolerant of S/R Errors
----------------------
The RSTOBJSAVF command attempts to be tolerant of S/R errors to allow
the command to complete on as many libraries as possible. An
individual completion or failure message will exist for each library.
CHKSAVRST Option
----------------
An option exists to run the CHKSAVRST command. By default this runs
if any errors occur and nets out the job log to show only S/R errors
that have occurred since the RSTOBJSAVF command started.
Libraries with no objects
-------------------------
A library with no objects can be saved, but not restored
using RSTOBJ.
This type of library will prevent a save file from being created.
TAATMPLIB Library
-----------------
The TAATMPLIB is created when the RSTOBJSAVF command runs and is
deleted by a successful completion.
If the library exists when the command starts, the command aborts
with a message stating how to perform a recovery.
RSTOBJSAVF escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
RSTOBJSAVF Command parameters *CMD
-----------------------------
DEV The device to restore from. It must be a tape
device.
SAVFLIB The library where the save files should be created.
For a simple use, it is best to have an empty
library that will contain the save files created by
this use of RSTOBJSAVF.
RSTLIB The libraries to be restored from the device. *ALL
is the default for all libraries found on the
device.
Up to 300 specific libraries may be named.
SEQ The sequence number to start processing the tape.
*SEARCH is the default from the current position of
the tape. A sequence number may be specified in a
range of 1-16777215.
ENDOPT The end option when the command completes. *REWIND
is the default. *LEAVE or *UNLOAD may be specified.
CHKSAVRST Whether the CHKSAVRST command should be run with the
ERRORSONLY option.
*ERR is the default meaning the command will be run
if any errors occur during the running of
RSTOBJSAVF.
*YES may be specified to always cause the use of
CHKSAVRST.
*NO may be specified to always prevent the use of
CHKSAVRST.
Restrictions
------------
You must have *SAVSYS special authority to use RSTOBJSAVF.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ2 Check object 2
CHKSAVRST Check save restore
CHKSAVSYS Check *SAVSYS special authority
EDTVAR Edit variable
EXTLST2 Extract list 2
LOOKUP Lookup CLP array
RTVTIMSTM Retrieve time stamp
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log 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
------ ---- --------- ---------- ----------
RSTOBJSAVF *CMD TAARSTM QATTCMD
TAARSTMC *PGM CLP TAARSTMC QATTCL
|
