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
|
