The Restore Object  from IFS command simplifies restoring  objects from
an  IFS stream file  such as  was sent  in an E  mail attachment.   The
objects  must  have  been  saved  by  a  SAVOBJ  command  such  as  the
companion  command  SAVOBJIFS.    RSTOBJIFS  does  the   following:  1)
Creates a  save file in QTEMP using  the name of the  library where the
objects  exist 2) Uses CPYFRMSTMF  to copy the stream  file to the save
file 3)  Uses RSTOBJ to  restore the  objects to  an existing  library.
See the companion tool SAVOBJIFS.

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.

RSTOBJIFS  uses  RSTOBJ  internally  which  requires  authority.    The
typical requirement is to have *SAVSYS special authority.

A typical RSTOBJIFS command would be:

             RSTOBJIFS     SAVLIB(ABC)

All of  the objects  that were  saved by  the SAVOBJ  command would  be
restored.

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

RSTOBJIFS escape messages you can monitor for
---------------------------------------------

      TAA9892    The library to restore to does not exist
      TAA9897    The stream file directory was not found

Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   SAVLIB        The library where the objects were saved from.

                 The  default  for  the  RSTLIB  parameter  is  *SAVLIB
                 meaning that the  library that the objects  were saved
                 from  is the same  library that the  objects should be
                 restored to.

                 The library to be restored must exist.

                 The  library  must  have  been  saved  with  a  SAVOBJ
                 command such as used by SAVOBJIFS.

   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   directory   entry   may  be   specified   such  as
                 '/home/xxx'.

                 Up to 5000  characters may be  entered and mixed  case
                 is allowed.

   STMF          The  stream file  name to  be  used.   The default  is
                 *SAVLIB   meaning  the   same   name  as   the  SAVLIB
                 parameter.

                 Up to 300  characters may  be entered  and mixed  case
                 is allowed.

   RSTLIB        The name  of the library to  restore to.   The default
                 is  *SAVLIB  meaning  the  same  name  as the  library
                 where the objects  were saved  from.   The library  to
                 be restored to must exist.

                 *CHECK may  be specified  when you  are not sure  what
                 the  stream file  contains.    The save  file  will be
                 created  CPYFRMSTMF  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.

   STMFEXT       The stream  file extension  if any  that  is added  to
                 the IFS stream file name.  The default is '.SAVF'.

                 A  different extension  may  be  used or  the  special
                 value *NONE meaning no extension is added.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKIFSE         Check IFS entry
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     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
   ------        ----    ---------      ----------    ----------

   RSTOBJIFS     *CMD                   TAAIFTH       QATTCMD
   TAAIFTHC      *PGM       CLP         TAAIFTHC      QATTCL