TAA Tools

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

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

You may omit a list of libraries from being restored.


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


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.


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

   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

                 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

   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

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


The following TAA Tools must be on your system:

      CHKSAVRST  Check save/restore
      EDTVAR     Edit variable


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


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 Up to Top