TAA Tools
RSTALLLIB     RESTORE ALL LIBRARIES                    TAARSTD

The Restore All Libraries  command allows the restore of  all libraries
found on  a tape.   You do not need  to know the name  of the libraries
on the tape.

The  normal RSTLIB command allows only  a single library to be restored
per command unless a special  value was used for the library  on SAVLIB
(e.g.  *NONSYS).

There are a few important restrictions with RSTALLLIB:

  **   The  user must  be  authorized to  the TAARSTALLC  authorization
       list.   This  is the same  authorization list  used by RSTMNYLIB
       and RSTALLCHG.

  **   The  tape  must  have  been  saved  with  the  SAVLIB   command.
       Objects  saved  by  SAVOBJ, SAVCHGOBJ,  SAVSECDTA,  SAVDLO  etc.
       will not be restored.

  **   The  file on tape  must be  the same name  as the library  to be
       restored.   You  must default  the  LABEL parameter  when  using
       SAVLIB.

The RSTALLLIB  command uses  CHKTAP and  RSTLIB to restore  all of  the
libraries  which are  found on the  media.   The CHKTAP  command allows
the  retrieval of  the tape  file name  for each file  sequence number.
The SAVLIB  command defaults to  store the library  name into the  tape
file name field.   The RSTLIB command is then  issued for each library.
Thus  you  do   not  have  to  know  the  library  names  in  order  to
successfully restore.

The  library  does  not  have  to  exist  on  the  system   when  using
RSTALLLIB.  The  same rules for restoring over an  existing library are
in  effect as  with RSTLIB.    RSTALLLIB supports  the same  options as
does RSTLIB (e.g.  OPTION, MBROPT,  ALWOBJDIF) to allow you to  specify
various actions if objects already exist.

Printed output occurs  to QPRINT with  one line per  library containing
counts  for  how many  objects  were or  were  not restored.    For the
specific  objects which  were not  restored and  the reasons,  you will
need either the:

  **   RSTLIB OUTPUT listing

  **   Job log.  This  can be provided in  a more readable fashion,  by
       use of  the CHKSAVRST command  which is the default  provided on
       the  command.  For  some low  level messages, you  will need the
       job log.

If you  want to  restore only  some of  the libraries  or  some of  the
objects  on the  media,  you must  issue  individual  RSTLIB or  RSTOBJ
commands.

A  restart capability exists by  allowing the restore  of all libraries
beginning at a specified file sequence number on the tape.

You may omit up to 40 libraries from being restored.

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

  **   Only libraries saved by SAVLIB can  be restored.  Saving by  the
       use of  SAVOBJ, SAVCHGOBJ etc.   will  create files that  cannot
       be restored by RSTALLLIB.

  **   You must  take the default of LABEL(*LIB)  on the SAVLIB command
       in order for RSTALLLIB to be successful.

  **   If   SAVLIB  *NONSYS  media  is  used,  the  first  file  output
       contains the  library names.   This file  must be bypassed  with
       the  SEQNBR  option.    Normally,  you would  not  want  to  use
       RSTALLLIB against the *NONSYS media.

Considerations
--------------

During  processing, status  messages are  sent to the  external message
queue informing  the operator  of what  library is  being restored  and
what file sequence number is being operated on.

If  the  RSTALLLIB command  is  interrupted  (e.g.   ENDJOB),  recovery
capability  is  provided  by the  sequence  number  parameter.   If  an
interruption occurs, you  can restart  processing at  a specified  file
sequence number.  The  file sequence number is presented  in the status
message and  is also sent as  an informational message to  the job log.
You  can  look at  the  job log  to  determine the  last  file sequence
number correctly restored.

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

   DEV           The tape  device name.   Only a  single device may  be
                 named (no overlap rewind support).

   SEQNBR        The  beginning   tape  file  sequence   number.    The
                 default is 1 meaning the first file on the tape.

                 A  different number should  be used if  you have other
                 files on the same tape  you want to jump over such  as
                 the  first file  created  by  a function  like  SAVLIB
                 LIB(*NONSYS).   You may  also use  the sequence number
                 if  the  restore  was  interrupted  and  you  want  to
                 continue or  you want  to begin  the restore with  the
                 Nth volume of a multi-volume save.

   ENDSEQNBR     The  ending tape  file sequence  number.   The default
                 is  *END meaning the last file  found on the tape.  If
                 a  value  like 10  is  specified,  the  file  sequence
                 number  10 would be  restored, but  none of  the files
                 after 10.

   ENDOPT        Whether  to   rewind  the  tape  at  the  end  of  the
                 command.  The default is  *REWIND.  *LEAVE or  *UNLOAD
                 can be  specified.   The option  you specify does  not
                 take   affect  until   the  last  RSTLIB   command  is
                 complete.

   OPTION        Whether to  restore  all  objects,  new  objects  etc.
                 This  is  the  same  parameter  as  on  RSTLIB.    The
                 default is *ALL (the same as RSTLIB).

   MBROPT        Whether to  restore data base files if  the members do
                 not  completely match.  This  is the same parameter as
                 on  RSTLIB.   The  default  is  *MATCH  (the  same  as
                 RSTLIB).

   ALWOBJDIF     Whether  to  allow object  differences  or  not.   The
                 default  is *NONE (the  same as RSTLIB).   *ALL may be
                 specified.        If    MBROPT(*MATCH)    is     used,
                 ALWOBJDIF(*ALL) cannot be specified.

   RSTASP        The ASP to  restore the libraries to.   The default is
                 *SAVASP  meaning the  same ASP  the library  was saved
                 from.

                 An ASP number from 1 to  32 may be entered to  restore
                 the libraries to a specific ASP.

   OMITLIBS      Whether to  omit  any libraries  from being  restored.
                 The default is *NONE.

                 A list  of up to  40 libraries may  be omitted.   If a
                 library  is specified and does  not exist on the tape,
                 the printed output contains a special message.

   OUTPUT        Whether to  print a listing  of the restored  objects.
                 This is  the same  option as on  RSTLIB.   The default
                 is  *NONE (the same  as RSTLIB).  A  listing to QPRINT
                 (one line per library restored) will always occur.

   CHKSAVRST     A *YES/*NO option  for should  the TAA Tool  CHKSAVRST
                 command be run.   The default is *YES.   The CHKSAVRST
                 command  will produce a  listing to QPRINT  of all the
                 S/R messages  which  have  occurred  during  the  job.
                 When  the  RSTALLLIB   command  begins  and   ends,  a
                 message  is  sent  to the  job  log  with the  CPF9898
                 message.    This will  be picked  up by  the CHKSAVRST
                 command to  assist you in  determining which  messages
                 belong to the RSTALLLIB command.

   ERRORSONLY    A  *YES/*NO  value  which   defaults  to  *NO.    This
                 minimizes   the  number  of   messages  that  will  be
                 printed.   This  parameter is  passed through  to  the
                 CHKSAVRST  command.    See CHKSAVRST  for  a  complete
                 description.

Security considerations
-----------------------

The  RSTALLLIB tool must be  created by a user  with Security Officer's
rights.  This will avoid any  security restrictions on a restore.   For
this reason,  the  objects are  created by  CRTTAATOOL so  that only  a
user with  *USE authority to the TAARSTALLC  authorization list may use
them.  The CL program TAARSTDC is created as USRPRF(*OWNER).

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

The following TAA Tools must be on your system:

      CHKSAVRST  Check save/restore
      EDTVAR     Edit variable

Implementation
--------------

The  tool  is ready  to  use,  but a  user  must be  authorized  to the
TAARSTALLC authorization  list.   This is the  same authorization  list
used by RSTMNYLIB  and RSTALLCHG.  To authorize a  user, use EDTAUTL or
specify:

      ADDAUTLE     AUTL(TAARSTALLC) USER(xxx) AUT(*USE)

Objects used by the tool
------------------------

   Object        Type       Attribute      Src member     Src file
   ------        -----      ---------      ----------     -----------

   RSTALLLIB     *CMD                      TAARSTD        QATTCMD
   TAARSTDC      *PGM          CLP         TAARSTDC       QATTCL
   TAARSTDR      *PGM          RPG         TAARSTDR       QATTRPG
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top