The Scan Save File Attributes command scans one or more save files
for attribute values. For example, you could scan for all save files
that have more than 100 records. This acts as a simple query to
determine the value of attributes of save files.
A typical command would be:
SCNSAVFA ATTR(NBRRCD) FILE(xxx/*ALL)
SCNVAL(500) SCNOPR(*GT)
A spooled file would be displayed of all save files in the named
library that have more than 500 records.
SCNSAVFA escape messages you can monitor for
--------------------------------------------
TAA9891 No save files were found for the specified parameters
Escape messages from based on functions will be re-sent.
SCNSAVFA Command parameters *CMD
---------------------------
ATTR The Save File attribute to be scanned for. The
value must be one of the following:
ASP. The ASP where the save file exists. A numeric
scan value must be used.
MAXRCD. The maximum number of records that may
exist in the save file. A numeric scan value must
be used or the special value *NOMAX.
NBRRCD. The number of records that exist in the
save file. A numeric scan value must be used.
SHARE. Whether the file open data path may be
shared. The scan value must be *YES or *NO.
TEXT. The member text. The scan operator must be
*CT. The scan value should be entered in upper
case. The object text is folded to upper case
before scanning. Trailing blanks are trimmed off
the scan value.
WAITFILE. The number of seconds to wait for a lock
to be satisfied when opening a save file. If the
scan value is *IMMED or *CLS, the scan operator must
be *EQ or *NE. A numeric value may be entered.
FILE The qualified name of the save file to be scanned.
A single file, a generic name, or *ALL may be
entered.
The library qualifier defaults to *LIBL. *CURLIB,
*USRLIBL, *ALL, *ALLUSR, or *IBM may be entered.
SCNVAL The value to be scanned for. Up to 10 bytes may be
entered.
To scan for blank entries, leave the value blank.
If SCNOPR(*CT) is entered when ATTR(TEXT) is
specified, 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 SHARE 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 it is ended with F3/F12 or the Enter
key. To retain the spooled file, you may use the
the System Request 'Cancel' function and the spooled
file will exist in a HLD status.
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:
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
------ ---- --------- ---------- ----------
SCNSAVFA *CMD TAASAWR QATTCMD
TAASAWRC *PGM CLP TAASAWRC QATTCL
TAASAWRR *PGM RPG TAASAWRR QATTRPG
|
