The Restore Many Libraries command allows the restore of named
libraries or generic libraries found on a tape. Up to 300 library
names may be entered. This differs from the following support:
** The system 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).
** The TAA Tool RSTALLLIB restores all libraries on a tape. No
selection capability exists.
RSTMNYLIB provides a solution when you have saved multiple libraries
on a tape, but only want to restore some of them. A typical command
would be:
RSTMNYLIB DEV(xxx) LIB(LIB1 LIB2 LIBA* ...)
There are a few important restrictions with RSTMNYLIB:
** The user must be authorized to the TAARSTALLC authorization
list. This is the same authorization list used by RSTALLLIB
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.
** If the files were saved to multiple tape media (more than one
volume), the command will complete after each volume.
Mounting succeeding volumes and re-entering the command (using
the default of SEQNBR(*FIRST) to access the first file) should
restore all required libraries.
The RSTMNYLIB command uses CHKTAP to determine each library that
exists on the tape and compares it to the list specified on the
command. If a match is found, RSTLIB is used. When the media has
been processed, the list of libraries specified is checked and an
error message is sent if a library was specified that was not found
on the media.
The library does not have to exist on the system when using
RSTMNYLIB. The same rules for restoring over an existing library are
in effect as with RSTLIB. RSTMNYLIB supports the same options as
does RSTLIB (e.g. OPTION, MBROPT, ALWOBJDIF) to allow you to specify
various actions if objects already exist.
If the TAATOOL library is named, it is bypassed with a message to
prevent the deletion of the program performing the restore.
Printed output occurs to TAAPRT3 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.
Command parameters *CMD
------------------
DEV The tape device name. Only a single device may be
used.
LIB The list of libraries to be restored. A specific
library or generic name may be used. Up to 300
names may be entered. If the library does not exist
on the media, an error message is sent.
SEQNBR The beginning tape file sequence number. The
default is *FIRST for the first file on the tape. A
specific number should be used if you have multiple
files of the same name on the tape and want to use a
later version.
If multiple volumes exist, a separate command must
be used for each volume. Using the default of
*FIRST will find the libraries to be restored.
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.
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 RSTMNYLIB 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 RSTMNYLIB 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.
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 RSTMNYLIB.
** You must take the default of LABEL(*LIB) on the SAVLIB command
in order for RSTMNYLIB to be successful.
** The TAATOOL library may not be specified as this would cause a
deletion of the program performing the restore. The RSTLIB
command must be used to restore the TAATOOL library.
Security considerations
-----------------------
The RSTMNYLIB 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 TAARSTFC is created as USRPRF(*OWNER).
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKGENERC Check generic
CHKSAVRST Check save/restore
EDTVAR Edit variable
EXTLST Extract list
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 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
------ ----- --------- ---------- -----------
RSTMNYLIB *CMD TAARSTF QATTCMD
TAARSTFC *PGM CLP TAARSTFC QATTCL
TAARSTFR *PGM RPG TAARSTFR QATTRPG
|
