TAA Tools
SCNJOBDA        SCAN JOB DESCRIPTION ATTRIBUTES        TAAJBDM

The Scan  Job  Description Attributes  command scans  one  or more  job
description  objects  for attribute  values.   This  acts  as a  simple
query to determine the value of attributes of job descriptions.

A typical command would be:

              SCNJOBDA  ATTR(USER) JOBD(xxx/*ALL)
                         SCNVAL(xxx) SCNOPR(*EQ)

A  spooled  file would  be  displayed of  all  job descriptions  in the
specified library that have  a USER parameter that matches  the SCNVAL.

SCNJOBDA escape messages you can monitor for
--------------------------------------------

      TAA9891    No job description objects exist

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

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

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

                 ACGCDE.   Accounting code.   SCNVAL(' ')  is valid for
                 either *EQ or *NE.

                 ALWMLTTHD.  Allow  Multiple Threads.   A  *YES or  *NO
                 value may be entered.

                 DATE.   The  date of  the job  to be  used within  the
                 job.   *SYSVAL or a date may  entered in job format of
                 6 characters.

                 DDMCNV.  DDM  conversations.   *KEEP or  *DROP may  be
                 entered.

                 ENDSEV.  Job ending  severity.  Up to 2  digits may be
                 entered in a range of 0 to 99.

                 HOLD.  Whether  to hold the job.   A *YES or *NO value
                 may be entered.

                 JOBMSGQFL.   Job Message Queue  full action.  *SYSVAL,
                 *WRAP, *NOWRAP, or *PRTWRAP may be entered.

                 JOBMSGQMX.  Job  Message Queue maximum size.   *SYSVAL
                 or a number  in the range of 2 to  64 megabytes may be
                 entered.

                 JOBQ.   Job Queue.   A job queue name  may be entered.

                 JOBQLIB.   Job Queue  Library.   A library  containing
                 the job queue may be entered.

                 JOBPTY.   Job Priority.   A  one digit  number may  be
                 entered in a range of 0 to 9.

                 INLLIBL.    Initial  library  list.    The scan  value
                 entered  will  be  searched   for  in  all   libraries
                 specified in  the job description.   Either a  full or
                 partial  name  may be  entered.   The  SCNOPR  must be
                 *CT.

                 INQMSGRPY.   Inquiry  Message Reply.   *RQD,  *DFT, or
                 *SYSRPYL may be entered.

                 LOGLVL.   Log  level.    A  one digit  number  may  be
                 entered in a range of 0 to 4.

                 LOGSEV.    Log  severity  Up  to  two  digits  may  be
                 entered in a range of 0 to 99.

                 LOGTXT.   Log text.  *NOLIST,  *MSG, or *SECLVL may be
                 entered.

                 LOGCLPGM.   Log CL  program.   A *YES  or  *NO may  be
                 entered.

                 LOGOUTPUT.   Job  log  output.   *SYSVAL,  *JOBLOGSVR,
                 *JOBEND, or *PND may be entered.

                 OUTPTY.   Output Priority.  A one  digit number may be
                 entered.

                 OUTQ.   Output queue.   An  output queue  name may  be
                 entered.

                 OUTQLIB.     Output   Queue   Library.     A   library
                 containing the output queue may be entered.

                 PRTDEV.   Print  device.   *USRPRF,  *SYSVAL, *WRKSTN,
                 or a printer name may be entered.

                 PRTTXT.   Print  text.  A  string of  characters to be
                 found in the  print text.   SCNOPR(*CT) must be  used.

                 RTGDTA.  Routing  data.  A string of  characters to be
                 found  in  the  routing  data.    SCNOPR(*CT) must  be
                 used.

                 RQSDTA.  Request data.   A string of characters to  be
                 found  in  the  request data.    SCNOPR(*CT)  must  be
                 used.

                 SPLFACN.   Spooled  file action.   *SYSVAL,  *KEEP, or
                 *DETACH may be entered.

                 SYNTAX.  CL Syntax check.   *NOCHK or 2 digits may  be
                 entered in a range of 0 to 99.

                 SWS.   Job  switches.   Eight digits  must be  entered
                 with values of 0 or 1.

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

                 TSEPOOL.   Time slice end  pool.   *SYSVAL, *BASE,  or
                 *NONE may be entered.

                 USER.   User of the job.   *RQD or a  user profile may
                 be entered.

   JOBD          The  qualified name of  the Job  Description object to
                 be scanned.    A  single job  description,  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.

                 To   scan  for  non-blank   entries  enter  '   '  and
                 SCNOPR(*NE).

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

     CHKNAM          Check name
     CVTJOBD         Convert job description 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
   ------        ----    ---------      ----------    ----------

   SCNJOBDA      *CMD                   TAAJBDM       QATTCMD
   TAAJBDMC      *PGM       CLP         TAAJBDMC      QATTCL
   TAAJBDMR      *PGM       RPG         TAAJBDMR      QATTRPG
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top