The  Display  First  Spooled  File  in   Output  Queue  Status  command
displays the  status of the first  spooled file on an  output queue for
the  current  user.   It  describes how  many  other spooled  files and
pages must be printed before  the users first spooled file  is printed.
This provides a  simple function for end users  to determine when their
spooled file will be printed.

A typical command would be entered as:

             DSPFSTSPLF

The  default is to display the  first spooled file for  the user in the
job's output queue.  A specific output queue may be named.

The status  of the  output queue  and the  writer  are displayed  along
with a  count of  how many  files and  how many  pages must  be printed
before the users first spooled file is printed.

If  a spooled file  exists prior in  the output queue  it is considered
to count in  the totals  if it is  in a  status of RDY,  WTR, or  MSGQ.
Any other status conditions are bypassed.

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

   OUTQ          The  qualified  name   of  the  output  queue   to  be
                 considered.   The default  is *JOB meaning  the output
                 queue assigned to the job.

                 If  an output queue name  is entered without a library
                 qualifier, *LIBL is assumed.

                 A  library qualifier  may  be  entered.   The  special
                 values *LIBL or *CURLIB may be used.

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

None.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CRTUSRSPC       Create user space
     EDTVAR          Edit variable
     RTVOUTQA        Retrieve output queue attributes
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   DSPFSTSPLF    *CMD                   TAASPMI       QATTCMD
   TAASPMIC      *PGM       CLP         TAASPMIC      QATTCL
   TAASPMID      *FILE      DSPF        TAASPMID      QATTDDS