The Scan Program Attributes command scans one or more programs for
attribute values. This acts as a simple query to determine the value
of attributes of program objects.
A typical command would be:
SCNPGMA ATTR(PGMTYP) PGM(xxx/*ALL)
SCNVAL(ILE) SCNOPR(*EQ)
A spooled file would be displayed of all program objects in the
specified library that have a type of ILE.
SCNPGMA escape messages you can monitor for
-------------------------------------------
TAA9891 No program objects exist
Escape messages from based on functions will be re-sent.
SCNPGMA Command parameters *CMD
--------------------------
ATTR The Program attribute to be scanned for. The value
must be one of the following:
ALWRTVSRC. Whether to allow the retrieval of CL
source. Only a *YES may be entered for the scan
value.
COMPILER. The name of a compiler. See the names
used by the system by using DSPOBJD of a program.
CRTDATE. The create date of the program. The value
should be entered in job format with 6 characters.
CONVRQD. Whether program conversion is required. A
*YES or *NO value may be entered for the scan value.
DOMAIN. The domain of the program. A *YES or *NO
value may be entered for the scan value.
FIXDECDTA. Whether invalid decimal data should be
fixed. A *YES or *NO value may be entered for the
scan value.
LANGID. The language ID of the program. A value of
*JOB, *JOBRUN, or the abbreviation of the language
may be entered for the scan value.
LOGCLPGM. Whether to log commands from CL programs.
A value of *YES, *NO, or *JOB may be entered for the
scan value.
MINRLS. The minimum release a program may be saved
to. A value such as V7R5M0 may be entered.
NBRCPYRGTS. The number of copyrights stored in the
program. A number must be entered for the scan
value.
NBRMOD. The number of modules in the program. A
number must be entered for the scan value.
NBRSRVPGM. The number of service programs in the
program. A number must be entered for the scan
value.
OBSERVE. Whether the program is observable. A
value of *ALL, *UNOBS, or *NONE may be entered for
the scan value.l
PGMATR. The attribute of the program. A scan value
may be entered such as CLP or CLLE.
PGMSTATE. The state of the program. A value of
*USER, *SYSTEM, or *INHERIT may be entered for the
scan value.
PGMTYP. The program type. A value of OPM or ILE
may be entered for the scan value.
SRCCHGDATE The last date the source was changed for
the program. The scan value should be entered in
job format with 6 characters.
SRCMBR. The name of a source member may be entered.
SRCFILE. The name of a source file may be entered.
SRCLIB. The name of a source file library may be
entered.
USEADPAUT. Whether to allow program adoption to
occur from a program higher in the stack. A *YES or
*NO value may be entered for the scan value.
USRPRF. The user profile the program should run
under. A value of *OWNER or *USER may be entered
for the scan value.
TEXT. A string of characters to be found in the
text description may be entered with the operator
*CT.
PGM The qualified name of the program object to be
scanned. A single program, 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 CONVRQD 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:
CVTPGMA Convert program 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
------ ---- --------- ---------- ----------
SCNPGMA *CMD TAAPGNZ QATTCMD
TAAPGNZC *PGM CLP TAAPGNZC QATTCL
TAAPGNZR *PGM RPG TAAPGNZR QATTRPG
|
