RSTTAASTMF      RESTORE TAA STREAM FILE                TAATOMG

 The Restore TAA  Stream File command  is designed to restore  the PF528
 stream file  containing a library for  TAA tool source or  object.  The
 stream  file  is the  standard  name used  when  revised TAA  source or
 object is sent to  you via an E mail  attachment.  You must first  copy
 the E mail attachment into an IFS directory.

 After you  have restored  the library, follow  the directions  to apply
 the fix in the E mail.

 Assume  you   received  an  E  mail  with  an  attachment  named  PF528
 containing the source to correct a TAA Tool.

 Once the  file has been  copied into  the IFS,  the RSTTAASTMF  command
 can be used to restore the library.

 The  library you  intend  to restore  to  must not  exist  (it will  be
 created by RSTTAASTMF).

 A typical command would be:

              RSTTAASTMF    DIR(/HOME) LIB(TAAxxx)
                  or
              RSTTAASTMF    DIR(/HOME/user) LIB(TAAxxx)
                  or
              RSTTAASTMF    DIR(*HOMDIR) LIB(TAAxxx)

 The  default stream file  name is  '/PF528.savf'.  RSTTAASTMF  would do
 the following:

             - Ensure the library to restore to does not exist
             - Ensure the directory exists
             - Ensure the stream file exists
             - Create a save file in QTEMP
             - Copy the stream file to the save file
             - Restore the library from the save file

 The directory  name must  begin with  a  leading '/'  and exist.    The
 special  value  *HOMDIR may  be  used  if  you have  a  home  directory
 specified  for your  user profile.   The  value  of the  STMF parameter
 (default  is '/PF528.SAVF')  is concatenated  to the  directory name to
 address the stream file.

 SAVLIB vs SAVOBJ
 ----------------

 The normal  use of  RSTTAASTMF is when  SAVLIB was  used to  originally
 save  all  contents of  a  library.   RSTLIB  is  used  to restore  the
 library and its objects.

 If  SAVOBJ was used  for one or  more objects, RSTTAASTMF  may still be
 used.  The command still requires  that the library to restore to  does
 not exist.   If  SAVOBJ was  used, RSTTAASTMF  will create the  library
 and use RSTOBJ to restore the objects.

 FTP use
 -------

 Assume  you received  an  E mail  with an  attachment  named PF528.STMF
 containing the source to correct a TAA Tool.

 If you FTP the file, you can copy  it directly to a save file.   If the
 save  file does  not exist,  it  will be  created.   If  the save  file
 exists, it is replaced.

 From the FTP session:

        quote site namefmt 1         (changes to IFS naming convention)
        cd /qsys.lib/targetlib.lib   (changes current directory to
                                        a library)
        bin                          (changes to binary mode which
                                        is required for save files)
        put pcfilename (tosavefilename.savf)
                                     (choose a "tosavefilename")
 Notes about the put:

   A)   If the  second parameter is  not specified, it is  treated as if
        it  were the same as the  first parameter.  The second parameter
        is required if:

              - The pc file's extension is not '.savf' or
              - The savefile name on the i5 System is different
                  from the pc file's name (the part to the left
                  of the period)

   B)   Assuming the  PC file  contains a valid  save file,  any of  the
        following could be used:

               put pf528.savf              (save file pf528 is written)
               put pf528.savf myfile.savf  (save file myfile is written)
               put x.y   myfile.savf       (save file myfile is written)
               put x.savf   myfile.savf    (save file myfile is written)

        The following would be invalid:

               put pf528.sav    (since the second parameter copies
                                  the first and the extension

                                  is 'sav' and not 'savf', a
                                  a data base file would be written)
              put pf528.savf x  (since the second parameter's
                                  extension is not .savf, a data
                                  base file would be written)

 Once  the  data is  in  the  save file,  you  do  not need  RSTTAASTMF.
 Instead, use:

                 RSTLIB    LIB(TAAxxx) DEV(*SAVF) SAVF(xxx/PF528)
                             RSTLIB(zzz)

 RSTTAASTMF escape messages you can monitor for
 ----------------------------------------------

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

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

    DIR           The   directory  where  the   PF528.STMF  stream  file
                  exists.  You  would normally  have copied  the E  mail
                  attachment to  a specific  directory in  the IFS.   Up
                  to 5000 bytes may be entered.

                  A  simple  directory  name  would  be entered  without
                  quotes,  but  containing   a  leading  /.     If   the
                  directory exists,  the name  is concatenated with  the
                  FROMSTMF  parameter  value  (default is  /PF528.SAVF')
                  and searched for.

                  The  special value *HOMDIR  may be used  if you have a
                  home directory specified in your user profile.

                  Other typical directory entries would be:

                       /
                       /home
                       /home/joe
                       /home/joe/dir1

    SAVLIB        The  library where  the  TAA  source was  saved  from.
                  The library  name is normally  sent to you as  part of
                  the E mail note describing the revised TAA source.

    FROMSTMF      The  stream  file  you  want  to  restore  from.   The
                  default is '/PF528.SAVF'.

                  A different  value may  entered if  required.   Up  to
                  1000 bytes may be entered.

    RSTLIB        The library  where the TAA  source should  be restored
                  to.   The default is *SAVLIB  meaning the same library
                  as specified  in the  SAVLIB parameter.   The  library
                  must not exist as it will be created by the tool.

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

 None.

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

 The following TAA Tools must be on your system:

      CHKIFSE         Check IFS entry
      CHKOBJ2         Check object 2
      RTVSAVFD        Retrieve save file description
      SNDCOMPMSG      Send completion message
      SNDESCMSG       Send escape 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
    ------        ----    ---------      ----------    ----------

    RSTTAASTMF    *CMD                   TAATOMG       QATTCMD
    TAATOMGC      *PGM       CLP         TAATOMGC      QATTCL

Added to TAA Productivity Tools December 15, 2002


Home Page

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.