TAA Tools
RSTOBJSAVF      RESTORE OBJECTS TO SAVE FILE           TAARSTM

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
					

Added to TAA Productivity tools April 15, 2009


Home Page Up to Top