The  Retrieve Last  Spooled File  command  retrieves information  about
the last  spooled file written in  the current job.   This includes the
name  of the spooled  file, the spooled  file number, and  the date and
time  of the  create.    The  API  QSPRILSP is  used  to  retrieve  the
information.

A typical command would be:

              DCL         &SPLF *CHAR LEN(10)
               .
              RTVLSTSPLF  SPLF(&SPLF)

RTVLSTSPLF escape messages you can monitor for
----------------------------------------------

      CPF333A    No spooled file exists

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

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

   SPLF          The  last  spooled file  name  from  the current  job.
                 This  is  an  optional return  variable  that  if used
                 must be specified as *CHAR LEN(10).

   JOB           The  job  name  of  the  current  job.    This  is  an
                 optional  return   variable  that  if  used   must  be
                 specified as *CHAR LEN(10).

   USER          The  user of  the current  job.   This is  an optional
                 return variable  that if  used  must be  specified  as
                 *CHAR LEN(10).

   JOBNBR        The  job number  of  the  current  job.   This  is  an
                 optional  return   variable  that  if   used  must  be
                 specified as *CHAR LEN(6).

   SPLFNBR       The   spooled  file  number  assigned.    This  is  an
                 optional  return  variable   that  if  used   must  be
                 specified as *CHAR LEN(6).

   JOBSYSNAM     The  name  of  the  system  where  the  job  was  that
                 created  the  spooled  file.    This  is  an  optional
                 return variable  that if  used  must be  specified  as
                 *CHAR LEN(8).

   CRTDAT        The  create date  of the  spooled file  in the  format
                 CYMD.   This  is an optional  return variable  that if
                 used must be specified as *CHAR LEN(7).

   CRTTIM        The create  time of  the spooled  file in  the  format
                 HHMMSS.  This  is an optional return variable  that if
                 used must be specified as *CHAR LEN(6).


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

Because  the  RTVLSTSPLF command  returns  variables,  the command  may
only be used in a CL program.

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

The following TAA Tools must be on your system:

     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
   ------        ----    ---------      ----------    ----------

   RTVLSTSPLF    *CMD                   TAASPPC       QATTCMD
   TAASPPCC      *PGM       CLP         TAASPPCC      QATTCL