The Copy AFP  Resources to Stream  File command copies an  AFP resource
such  as a page  segment to  a stream  file.  This  allows a  PC editor
such  as InfoPrint Designer  to edit the information.   The stream file
would then be  copied back and  a command such as  CRTPAGSEG to be  run
to re-create the original object.

The QGSCPYRS API is used internally.

A typical command would be:

             CPYAFPSTMF   OBJ(xxx) OBJTYPE(*PAGSEG) TOSTMF(...)

The *PAGSEG object would be copied to the specified stream file.

Each object type that may be copied has a specific create command:

            *PAGSEG        CRTPAGSEG
            *PAGDFN        CRTPAGDFN
            *OVL           CRTOVL
            *FORMDF        CRTFORMDF
            *FNTRSC        CRTFNTRSC

CPYAFPSTMF escape messages you can monitor for
----------------------------------------------

      TAA9891    Not authorized to replace the stream file

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

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

   OBJ           The  qualified name of  the AFP  object.   The library
                 value  defaults to *LIBL.   *CURLIB may  also be used.

   OBJTYPE       The AFP object  type to be copied.   The valid  values
                 are *PAGSEG, *PAGDFN, *OVL, *FORMDF, and *FNTSRC.

   TOSTMF        The stream file to be written to.

   STMFOPT       The option  to use  when writing  to the  stream file.
                 The  default is *NONE  which may  only be used  if the
                 stream file does not currently exist.

                 *REPLACE must  be  specified to  replace  the  current
                 contents  of  the  stream  file  if  the  stream  file
                 exists.

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

None.

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

The following TAA Tools must be on your system:

     CHKIFSE         Check IFS entry
     CHKOBJ3         Check object 3
     CLRUSRSPC       Clear user space
     CRTUSRSPC       Create user space
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     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
   ------        ----    ---------      ----------    ----------

   CPYAFPSTMF    *CMD                   TAAIFTI       QATTCMD
   TAAIFTIC      *PGM       CLP         TAAIFTIC      QATTCL
   TAAIFTIR      *PGM       RPGLE       TAAIFTIR      QATTRPG