TAA Tools
RSTLIBIFS       RESTORE LIBRARY FROM IFS               TAAIFTF

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
					

Added to TAA Productivity tools September 1, 2004


Home Page Up to Top