RSTALLCHG     RESTORE ALL CHANGES                      TAARSTA

 The  RSTALLCHG  command  is  the  companion  tool   for  the  TAA  Tool
 SAVALLCHG (Both  the SAVALLCHG and  SAVALLCHG2 commands).   It may also
 be   used  with   any  SAVCHGOBJ  media.     For   use  with  SAVCHGOBJ
 LIB(*ALLUSR), see the special instructions.

 It is  intended to  restore  from the  tape created  by  either of  the
 SAVALLCHG  approaches.   This  allows a  simple  recovery for  disaster
 protection.    For  disaster recovery,  you  would  normally  issue the
 following commands:

          RSTLIB      LIB(*NONSYS) DEV(xxxx)
          RSTALLCHG   DEV(xxxx)

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

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

 If  a  library  does not  exist,  it  is  created  to allow  RSTOBJ  to
 successfully  complete.   The  text  description for  the  library will
 contain 'Created by  RSTALLCHG command'.   MBROPT(*ALL) is the  default
 on the Restore command.

 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:

   **   RSTOBJ 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.

 The RSTALLCHG  command could  also be  used  against any  Save tape  to
 perform  the same function.   This  avoids having  to know  the library
 names in order to perform the restore.

 If  you want to  restore only some  of the libraries or  objects on the
 media, you  must issue  individual RSTOBJ  commands.   You can  restore
 all of  the libraries beginning at  a specified sequence number  on the
 tape.

 You  can use  RSTALLCHG against  a  tape created  by SAVLIB,  SAVOBJ or
 SAVCHGOBJ.

 You may omit a list of libraries from being restored.

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

   **   If the library  does not  exist on  the system,  it is  created.
        Any   library  information   saved   (text,  type   and   public
        authority) is ignored.

   **   You  must take the  default of  LABEL(*LIB) on the  save command
        in order for RSTALLCHG 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
        RSTALLCHG against the *NONSYS media.

   **   You  must use standard  labeled tapes for  the RSTALLCHG command
        to operate successfully.

   **   If you are  saving only changed objects,  there will be  certain
        conditions  which  will  not  be restored  properly.    See  the
        discussion under SAVALLCHG.

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

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

 If  the RSTALLCHG  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
 sequence number.    The  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  sequence number
 correctly restored.

 Use with SAVCHGOBJ LIB(*ALLUSR)
 -------------------------------

 When SAVCHGOBJ LIB(*ALLUSR) is specified,  the first file on tape  will
 contain  a list  of the  libraries.   RSTALLCHG cannot  work with  this
 file.   You  must specify  SEQNBR(2)  to begin  with the  first library
 containing objects.


 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  RSTOBJ   command  is
                  complete.

    OPTION        Whether  to  restore  all  objects,  new  objects etc.
                  This is the same parameter as on RSTOBJ.

    MBROPT        The data  base  member option.    The values  are  the
                  same  as on  RSTOBJ,  but the  default  is changed  to
                  *ALL  instead of  *MATCH.   Other  values that  may be
                  entered are *MATCH, *NEW, and *OLD.

    ALWOBJDIF     Whether to allow object differences  or not.  This  is
                  the  same parameter  as  on  the  RST commands.    The
                  default is  *ALL which differs from  the RST commands.

    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 99 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 RSTOBJ.   The  default
                  is *NONE  or you  may specify  *PRINT.   A listing  to
                  QPRINT  (one line  per library  restored)  will always
                  occur.

    CHKSAVRST     A  *YES/*NO option  for should the  TAA Tool CHKSAVRST
                  command 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 RSTALLCHG 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
                  RSTALLCHG 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 RSTALLCHG  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 TAARSTAC 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 RSTALLLIB and  RSTMNYLIB.  To authorize a user,  use EDTAUTL or
 specify:

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

 You should  have a disaster  recovery plan with  the steps you  plan to
 use.    If you  use the  default for  SAVALLCHG to  save from  the last
 SAVLIB  *NONSYS  date  (or  the  default  from  SAVCHGOBJ),   only  one
 RSTALLCHG command  should be needed.   If you specify  a reference date
 on  the SAVALLCHG command, you  will need a  RSTALLCHG command for each
 set of media.

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

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

    RSTALLCHG     *CMD                      TAARSTA        QATTCMD
    TAARSTAC      *PGM          CLP         TAARSTAC       QATTCL
    TAARSTAR      *PGM          RPG         TAARSTAR       QATTRPG

Added to TAA Productivity Tools April 1, 1995


Home Page

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.