The Open Spooled  File command is a  testing aid.  It allows  a spooled
file to  be opened with  a specific name  and remain open.   The intent
of  OPNSPLF is to allow other functions to  test how they operate on an
opened spooled file.

If you open  the file more than  once, a misleading completion  message
will be sent.  See the discussion on 'Multiple use of OPNSPLF'.

No close command exists.  A close occurs when:

             - An escape message occurs in the same job
             - The job ends or RRTJOB is used
             - The spooled file is deleted

If  allowed to  print, the  spooled  file has  a single  line of  print
which is a page heading.

A typical command is:

             OPNSPLF

The default is to open the spooled file STAYOPEN.

Multiple use of OPNSPLF
-----------------------

If  OPNSPLF is used more than  once in the same  job before closing the
file, the same printer file  (TAAOPNSP) is used again and another  page
is written to  the file.  This  occurs regardless of the  value for the
SPLFNAME parameter.

If multiple  open spooled files are required,  different jobs should be
used.

OPNSPLF escape messages you can monitor for
-------------------------------------------

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

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

   SPLFNAME      The name of the spooled  file to be opened.   STAYOPEN
                 is the default.  A specific name may be entered.

   OUTQ          The output queue  to place the  spooled file in.   The
                 library  qualifier  defaults  to  *LIBL.   A  specific
                 library may be specified.


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

None.

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

The following TAA Tools must be on your system:

     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   OPNSPLF       *CMD                   TAASPPA       QATTCMD
   TAASPPAC      *PGM       CLP         TAASPPAC      QATTCL
   TAASPPAR      *PGM       RPG         TAASPPAR      QATTRPG
   TAAOPNSP      *FILE      PRTF