The Display Total  Pages command displays  or lists a running  total of
the  pages for spooled  files in an  output queue.   The intent  of the
command  is to provide an indication for a  user of where his output is
in the queue  and how many  pages are to be  printed before a  specific
spooled file.

A typical command would be:

             DSPTOTPAG    OUTQ(QPRINT)

A  listing would  be displayed  with one  line per  spooled file  and a
running total of how many pages exist that are to be printed.

Authorization
-------------

A private output queue may not be displayed.

If  the output queue allows public access,  the user can use DSPTOTPAG.

DSPTOTPAG escape messages you can monitor for
---------------------------------------------

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

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

   OUTQ          The qualified name of the  output queue to be  listed.
                 The  library value  defaults  to  *LIBL.   A  specific
                 library or *CURLIB may also be used.

   OUTPUT        How  to  output the  results.   *  is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.  The  spooled file is deleted  after it
                 is displayed.

                 If  the  command is  entered  in  batch  or *PRINT  is
                 specified,  the spooled  file is  output and retained.


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

If the  printer device type  does not display  any pages using  WRKSPLF
Option 8, neither will DSPTOTPAG.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTOUTQ         Convert output queue
     RSNLSTMSG       Resend last message
     RTVOUTQA        Retrieve output queue attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

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

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

   DSPTOTPAG     *CMD                   TAASPOM       QATTCMD
   TAASPOMC      *PGM       CLP         TAASPOMC      QATTCL
   TAASPOMR      *PGM       RPG         TAASPOMR      QATTRPG