The Scan Object Description Attributes command scans one or more
objects for attribute values. This acts as a simple query to
determine the value of attributes of objects.
A typical command would be:
SCNLFA ATTR(DAMAGE) OBJ(xxx/*ALL)
SCNVAL(*NONE) SCNOPR(*NE)
A spooled file would be displayed of all objects in the specified
library that have a damage condition that is not *NONE.
SCNOBJDA escape messages you can monitor for
--------------------------------------------
TAA9891 No objects exist
Escape messages from based on functions will be re-sent.
SCNOBJDA Command parameters *CMD
---------------------------
ATTR The Object Description attribute to be scanned for.
The value must be one of the following:
ALWCHGAPI. Whether the object can be changed by the
QLICOBJD API.
CHGDATE. The last change date to the object. The
scan value must be a valid date.
COMPRESS. Whether the object has been compressed.
It must be a scan value of *YES or *NO.
CRTDATE. The date the object was created. The scan
value must be a valid date.
CRTSYS. The system the object was created on. It
must be a scan operator of *EQ or *NE.
CRTUSR. The user who created the object. It must
be a scan operator of *EQ or *NE.
DAMAGE. Whether the object is damaged. It must be
a scan value of *NONE, *PARTIAL, or *FULL.
DOMAIN. The domain the object resides in. It must
be a scan value of *USER or *SYSTEM.
JRN. The journal name the object is (or was)
journaled to. It must be a scan operator of *EQ or
*NE.
JRNL. The library containing the journal that the
object is (or was) journaled to. It must be a scan
operator of *EQ or *NE.
OBJATR. The attribute of the object such as CLP or
PF. It must be a scan operator of *EQ or *NE.
OBJASP. The ASP the object exists in. It must be a
scan operator of *EQ or *NE. An ASP or *SYSBAS may
be named.
OBJASPL. The ASP library that the object exists in.
It must be a scan operator of *EQ or *NE. An ASP or
*SYSBAS may be named.
OBJAUD. The auditing attribute of the object. It
must be a scan operator of *EQ or *NE. The scan
value must be *NONE, *USRPRF, *CHANGE, or *ALL.
OFLASP. Whether the ASP has overflowed. It must be
a scan value of *YES or *NO.
OWNER. The owner name of the object. It must be a
scan operator of *EQ or *NE.
PTFNBR. The PTF number (if any) applied to the
object. It must be a scan operator of *EQ or *NE.
RESETDATE. The date the use count of the object has
been reset. A valid date or blanks may be entered.
RSTDATE. The date the object was restored. A valid
date or blanks may be entered.
SAVACTDATE. The date the object was saved with
SAVACT(*YES). A valid date or blanks may be
entered.
SAVDATE. The date the object was saved. A valid
date or blanks may be entered.
SAVF. The save file the object was saved to. It
must be a scan operator of *EQ or *NE.
SAVFL. The save file the object was saved to. It
must be a scan operator of *EQ or *NE.
SIZE. The size of the object. It must be a decimal
scan value.
SAVACTDATE. The last change date to the source used
to create the object (if any). A valid date or
blanks may be entered.
SRCFILE. The name of the source file (if any) used
to create the object. It must be a scan operator of
*EQ or *NE.
SRCLIB The name of the library of the source file
(if any) used to create the object. It must be a
scan operator of *EQ or *NE.
SRCMBR. The name of the member of the source file
(if any) used to create the object. It must be a
scan operator of *EQ or *NE.
SYSVER. The version of the system (e.g. V7R5M0)
the object was created on. It must be a scan
operator of *EQ or *NE.
STGFREE. Whether the storage was freed when the
object was saved. It must be a scan operator of *EQ
or *NE.
USECNT. The number of days the object was used. It
must be a decimal value.
USEDATE. The last date the object was used. A
valid date or blanks may be entered.
USRDFNATR. The user defined attribute of the
object. It must be a scan operator of *EQ or *NE.
USRMDFY. Whether the object has been modified by
the QLICOBJD API. It must be a scan operator of *EQ
or *NE.
TEXT. The text description of the object. The scan
operator must be *CT and a non-blank value must be
entered.
OBJ The qualified name of the object description to be
scanned. A single object, 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.
OBJTYPE The object type to be scanned for. The default is
*ALL. Use the prompter for the full list.
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 EXTDSC 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:
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
------ ---- --------- ---------- ----------
SCNOBJDA *CMD TAAOBLT QATTCMD
TAAOBLTC *PGM CLP TAAOBLTC QATTCL
TAAOBLTR *PGM RPG TAAOBLTR QATTRPG
|
