The Scan Class Attributes command scans one or more Class Objects for
attribute values. This acts as a simple query to determine the value
of attributes of Class objects.
A typical command would be:
SCNCLSA ATTR(RUNPTY) CLS(QGPL/*ALL)
SCNVAL(30) SCNOPR(*GE)
A spooled file would be displayed of all Class objects that have a
RUNPTY of 30 or higher.
SCNCLSA escape messages you can monitor for
-------------------------------------------
TAA9891 No Class Objects exist
Escape messages from based on functions will be re-sent.
SCNCLSA Command parameters *CMD
--------------------------
ATTR The Class attribute to be scanned for. The value
must be one the following:
CPUTIME. The maximum amount of time a job may use
before it is ended. A value in milliseconds or
*NOMAX may be entered.
DFTWAIT. The maximum of time that a job may wait
for a lock. A value in seconds or *NOMAX may be
entered.
MAXTHD. The maximum number of threads that may be
used in a job. A number between 1 and 32767 or
*NOMAX may be entered.
MAXTMPSTG. The maximum of amount of temporary
storage that may be used by a job. A value in
kilobytes or *NOMAX may be entered.
PURGE. Whether the job is eligible to be purged
from active storage at the end of a time slice or
when there is a long wait. A *YES or *NO scan value
may be entered.
RUNPTY. The run priority of the job. A scan value
number between 00 and 99 may be entered.
TIMESLICE. The amount of processor time given to
each thread when the job is given the opportunity to
run. A value in milliseconds may be entered.
TEXT. A string of characters to be found in the
text description may be entered with the operator
*CT.
CLS The qualified name of the Class object to be
scanned. A single class, 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 PURGE 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:
CVTCLSA 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
------ ---- --------- ---------- ----------
SCNCLSA *CMD TAACLSD QATTCMD
TAACLSDC *PGM CLP TAACLSDC QATTCL
TAACLSDR *PGM RPG TAACLSDR QATTRPG
|