The Restore Library from IFS command simplifies restoring a library
from an IFS stream file such as was sent in an E mail attachment.
The library must have been saved by the companion tool SAVLIBIFS or a
SAVLIB command. The command does the following: 1) creates a save
file in QTEMP using the name of the SAVLIB 2) uses CPYFRMSTMF to copy
the stream file to the save file 3) uses RSTLIB to restore the
library. The library to be restored must not exist.
An option exists to determine what is in the save file and the
command that was used to save the objects without attempting a
restore.
RSTLIBIFS uses RSTLIB internally which requires authority. The
typical requirement is to have *SAVSYS special authority.
A typical RSTLIBIFS command would be:
RSTLIBIFS SAVLIB(ABC)
The default for the STMFDIR parameter is *HOME meaning the user
profile must have a home directory and the directory must exist. The
default for the stream file name is *SAVLIB meaning the same name as
the library that was saved. The home directory would be retrieved
and concatenated with the stream file name to produce an IFS stream
file name such as:
/HOME/usrprf/ABC.savf
RSTLIBIFS escape messages you can monitor for
---------------------------------------------
TAA9892 The RSTLIB already exists
TAA9897 The stream file directory was not found
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
SAVLIB The library that was saved.
The default for the RSTLIB parameter is *SAVLIB
meaning that the library that was saved should be
restored to the same library.
The library to be restored must not exist.
The library must have been saved with a SAVLIB
command such as used by SAVLIBIFS.
STMFDIR The stream file directory. The default is *HOME
meaning to use the home directory specified in the
user profile and the directory must exist. A home
directory must exist to use this value.
A directory entry may be specified such as /HOME/xxx
STMF The stream file name to be used. The default is
*SAVLIB meaning the same name as the SAVLIB
parameter.
RSTLIB The name of the library to be restored. The default
is *SAVLIB meaning the same name as the library that
was saved. The library to be restored must not
exist.
*CHECK may be specified when you are not sure what
the stream file contains. The save file will be
created and copy stream file will be used to fill
the save file. The save file information is then
accessed and a completion message is sent describing
the library name, the save command used, and the
number of objects.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKIFSE Check IFS entry
EDTVAR Edit variable
RTVHOMDIR Retrieve home directory
RTVSAVFD Retrieve save file description
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
RSTLIBIFS *CMD TAAIFTF QATTCMD
TAAIFTFC *PGM CLP TAAIFTFC QATTCL
|
