The Save  Object to  IFS command  simplifies saving objects  to an  IFS
stream file in  order to allow the stream file to be  used as an E mail
attachment.   The  command does the  following: 1) Creates  a save file
in QTEMP with the name of  the library 2) Uses SAVOBJ to the  save file
3) Uses CPYTOSTMF  to copy the save file to  the specified stream file.
See the companion tool RSTOBJIFS.

You  must have  the special authority  *SAVSYS or  the object existence
right to the objects being saved.

SAVOBJIFS uses the CPYTOSTMF default  for the AUT parameter to set  the
authority  to a  new  stream  file.   If  the  stream file  exists,  no
authority change occurs.

A typical SAVOBJIFS command would be:

             SAVOBJIFS     OBJ(xxx/ABC)

A library qualifier must be entered.

Several defaults occur:

  **   The  default for the  OBJTYPE parameter  is *ALL for  all object
       types.

  **   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 *LIB  meaning the same
       name as the qualified library.

  **   The default for the stream file extension is '.stmf'.

The  home  directory  would  be  retrieved  and  concatenated  with the
stream file  name and  extension  to produce  an IFS  stream file  name
such as:

             /HOME/usrprf/ABC.savf

The file  can then  be attached  to an  E mail and  sent to  another i5
System.

If the  stream file does not exist, it is  added.  If it does exist, it
is replaced.

SAVOBJIFS escape messages you can monitor for
---------------------------------------------

      TAA9896    No objects exist to be saved
      TAA9897    The stream file directory was not found

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

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

   OBJ           The name or  generic name of the  object to be  saved.
                 Up to  300 entries may be  made.  All objects  must be
                 in the same library.

   LIB           The library where the objects exists.

   OBJTYPE       The type  of object to be saved.   The default is *ALL
                 for all types.   Up to  100 may be  specified.  For  a
                 list of the valid types, use the prompter.

   STMFDIR       The  stream file  directory.    The default  is  *HOME
                 meaning to  use the home directory stored  in the user
                 profile.   A home  directory must be  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
                 *LIB  meaning  the  same  name  as  the  library  name
                 entered.

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

                 If  the stream file does  not exist, it is  added.  If
                 it does exist, it is replaced.

   DTACPR        A parameter for  whether to  compress the  data as  it
                 is written  to the  save file.   The  value is  passed
                 thru to  the SAVOBJ DTACPR parameter.   The default is
                 *NO.

                 The  other values  are *YES, *LOW,  *MEDIUM, or *HIGH.

   TGTRLS        The  target release  to  be  used.   *CURRENT  is  the
                 default  for the  current release.   Use  the prompter
                 to see the supported values.

   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
     CHKOBJ3         Check object 3
     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
   ------        ----    ---------      ----------    ----------

   SAVOBJIFS     *CMD                   TAAIFTG       QATTCMD
   TAAIFTGC      *PGM       CLP         TAAIFTGC      QATTCL