The Display  Job Queue command  provides a display  that is similar  to
that provided  by the system WRKJOBQ command except  that only a single
job  queue  may  be  displayed  and  the  user  cannot  perform actions
against the jobs.  DSPJOBQ may  be helpful if you have a  menu oriented
system  and want  to prevent  users from  changing, holding,  or ending
jobs on a job queue.

The  intent  of the  command  is that  it  would  be used  in  place of
WRKJOBQ as an option on a user  menu.  It allows a user to see  all the
jobs on  the job queue sequenced  by priority within  status (released,
scheduled, or held).  No command line exists.

A typical command would be:

          DSPJOBQ   JOBQ(QBATCH)

This  displays  the jobs  that  exist on  the  QBATCH job  queue.   The
subsystem the job queue is attached to  (or *NONE) is shown at the  top
of the  display along with the  status of the  job queue.   The display
that  appears is similar  to that provided  by WRKJOBQ, but  would only
allow the option to display more details about the job.

The APIs used include:

       - QUSCRTUS
       - QUSLJOB
       - QUSRTVUS
       - QUSRJOBI

Security considerations
-----------------------

In  order  to retrieve  the  information about  jobs  that are  not the
users  own, the  RTVJOBAPI  tool is  used.    This adopts  the  QSECOFR
profile while job  information is being retrieved to  allow for *JOBCTL
special  authority.   This provides the  user with  more authority than
he would  receive  from  WRKJOBQ  in terms  of  displaying  information
about  a job.   If  you feel  this is  too much  information, make  the
DSPJOBQ command private.

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

   JOBQ          The  job  queue  to  be  displayed.   The  default  is
                 QBATCH.    The  qualified  name  defaults  to   *LIBL.
                 *CURLIB may also be specified.

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

A maximum of 1000 jobs  can be displayed.  If the limit  is exceeded, a
message appears  on the first  display informing the user  that not all
jobs are shown.

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

The following TAA Tools must be on your system:

     CVTDTS          Convert date/time in *DTS format
     FILEFDBCK       File feedback
     HLRMVMSG        HLL Remove message
     RTVJOBAPI       Retrieve job API
     RTVJOBQA        Retrieve job 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
   ------        ----    ---------      ----------    ----------

   DSPJOBQ       *CMD                   TAAJOCF       QATTCMD
   TAAJOCFC      *PGM       CLP         TAAJOCFC      QATTCL
   TAAJOCFR      *PGM       RPG         TAAJOCFR      QATTRPG
   TAAJOCFD      *FILE      DSPF        TAAJOCFD      QATTDDS