TAA Tools

 DSPJOBQ         DISPLAY JOB QUEUE                      TAAJOCF

 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

Added to TAA Productivity Tools August 1, 1997


Home Page

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.