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
|
