TAA Tools
SCNJOBQA        SCAN JOB QUEUE ATTRIBUTES              TAAJOEX

The Scan  Job  Queue Attributes  command scans  one or  more Job  queue
objects  for  attribute  values.    This  acts  as a  simple  query  to
determine the value of attributes of Job Queues.

A typical command would be:

              SCNJOBQA  ATTR(OPRCTL) JOBQ(QGPL/*ALL)
                         SCNVAL(*NO) SCNOPR(*EQ)

A  spooled file would be  displayed of all Job  Queue objects that have
an OPRCTL attribute of *YES.

SCNJOBQA escape messages you can monitor for
--------------------------------------------

      TAA9891    No Job Queue objects exist

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

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

   ATTR          The Job  Queue  attribute  to  be scanned  for.    The
                 value must be one the following:

                 AUTCHK.   The  authority required  to hold  or release
                 the  job queue.  A  value of *OWNER  or *DTAAUT may be
                 entered.

                 NBRJOBS.   The number of  jobs on  the job  queue.   A
                 number may be entered.

                 OPRCTL.   The  type  of operator  control required  to
                 operate  on jobs  on the  job  queue.   A *YES  or *NO
                 value may be entered.

                 STATUS.  The  status of  the job  queue.   A value  of
                 RLS or HLD may be entered for the scan value.

                 SUBSYSTEM.   The  name of  a subsystem  where the  job
                 queue is  attached.  An *EQ or  *NE scan operator must
                 be used.

                 TEXT.    A string  of characters  to  be found  in the
                 text  description may  be  entered with  the  operator
                 *CT.

   JOBQ          The  qualified name  of  the Job  Queue  object to  be
                 scanned.    A single  job  queue, a  generic  name, or
                 *ALL may be entered.

                 The library qualifier  defaults to  *LIBL.   *USRLIBL,
                 *CURLIB, *ALL,  *ALLUSR, *ALLUSR2,  *ALLNONQ, or  *IBM
                 may  be  entered.   For  a full  description  of these
                 values, see the CVTLIBOBJD command.

   SCNVAL        The value to be  scanned for.  Up  to 10 bytes may  be
                 entered.

                 If  SCNOPR(*CT)  is  entered,  the  SCNVAL  should  be
                 entered   without    quotes   as   the   object   text
                 description  will  be  folded  to  upper  case  before
                 scanning.

   SCNOPR        The scan operator to be used.  *EQ is the default.

                 *NE, *GT,  *GE, *LT,  *LE,  or *CT  (contains) may  be
                 entered.   Non-meaningful  functions such  as scanning
                 the  OPRCTL attribute (supports only  *YES or *NO) for
                 a scan operator other than *EQ/*NE are rejected.

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

None.

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

The following TAA Tools must be on your system:

     CVTJOBQA        Convert class attributes
     CVTLIBOBJD      Convert library object description
     RTVVALA         Retrieve value attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     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
   ------        ----    ---------      ----------    ----------

   SCNJOBQA      *CMD                   TAAJOEX       QATTCMD
   TAAJOEXC      *PGM       CLP         TAAJOEXC      QATTCL
   TAAJOEXR      *PGM       RPG         TAAJOEXR      QATTRPG
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top