The Scan Display File Attributes command scans one or more display
files for attribute values. This acts as a simple query to determine
the value of attributes of display files.
A typical command would be:
SCNDSPFA ATTR(DFRWRT) FILE(xxx/*ALL)
SCNVAL(*YES) SCNOPR(*EQ)
A spooled file would be displayed of all display files in the
specified library that have a DFRWTR value of *YES.
SCNDSPFA escape messages you can monitor for
--------------------------------------------
TAA9891 No display files exist
Escape messages from based on functions will be re-sent.
SCNDSPFA Command parameters *CMD
---------------------------
ATTR The Display File attribute to be scanned for. The
value must be one of the following:
ASSUME. Whether the ASSUME keyword is used. It
must be a scan value of *YES or *NO.
DECFMT. The type of decimal format used for the
job. It must be a scan value of *JOB or *FILE.
DFRWRT. Whether to defer writes written to the file
until a read is requested. It must be a scan value
of *YES or *NO.
DSPSIZ1. User define display size. It must be a
scan value of *YES or *NO.
DSPSIZ2. User defined display size. It must be a
scan value of *YES or *NO.
DSPSIZ3. A display size of 24 x 80. It must be a
scan value of *YES or *NO.
DSPSIZ4 A display size of 27 x 132. It must be a
scan value of *YES or *NO.
DTAQ. The data queue assigned to the display file.
It may be a name or *NONE. The SCNOPR value must be
*EQ or *NE.
DTAQLIB. The data queue library where the data
queue assigned to the display file exists. It may
be a name or blanks. The SCNOPR value must be *EQ
or *NE.
ENHDSP. Whether the display file used the enhanced
capabilities function. It must be a scan value of
*YES or *NO.
EXTDSC. Whether the file is externally described.
It must be a scan value of *YES or *NO.
FILEATR. The file attribute. It must be a scan
value of DSPF or DSPF38.
IGCDTA. Whether the file can contain IGC data. It
must be a scan value of *YES or *NO.
INDARA. Whether the file has a separate indicator
area. It must be a scan value of *YES or *NO.
KEEP. Whether the file supports a KEEP keyword. It
must be a scan value of *YES or *NO.
LANGID. The language ID used for the file. A
character value or *JOB may be entered.
LVLCHK. Whether to check the level ID of the file
that was used when a program opens the file. It
must be a scan value of *YES or *NO.
MAXDEV. The maximum number of devices that can use
the display file. A numeric scan value must be
used.
NBRDSPDEV. The number of devices that use the
display file. A numeric scan value must be used.
NBRFMTS. The number of formats that exist in the
display file. A numeric scan value must be used.
PASSRCD. Whether the file uses the PASSRCD keyword
for unformatted data. It must be a scan value of
*YES or *NO.
PGMDEV. The program device specified for the file.
It must be a scan value of *YES or *NO with a SCNVAL
of *REQUESTER or a device name.
PRTALW. Whether the PRINT keyword has been used.
It must be a scan value of *YES or *NO.
RSTDSP. Whether the RSTDSP command parameter has
been used. It must be a scan value of *YES or *NO.
SFLEND. Whether the SFLEND command parameter has
been used. It must be a scan value of *JOB or
*FILE.
SHARE. Whether the SHARE command parameter has been
used. It must be a scan value of *YES or *NO.
SRTSEQ. The sort sequence to be used. The scan
value must be a character value or one of the
special values *HEX, *JOB, *SRC, *LANGIDUNQ, or
*LANGIDSHR
SRTSEQLIB. The library of the sort sequence.
TEXT. The scan operator must be *CT.
WAITFILE. Then number of seconds to wait for a lock
to be satisfied when opening the file. If the scan
value is *IMMED or *CLS, the scan operator must be
*EQ or *NE. A numeric value may be entered.
WAITRCD. The number of seconds to wait for the
completion of a read-from-invited-devices operation.
If the scan value is *IMMED or *NOMAX, the scan
operator must be *EQ or *NE. A numeric value may be
entered.
FILE The qualified name of the display file to be
scanned. A single display file, 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 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
------ ---- --------- ---------- ----------
SCNDSPFA *CMD TAADSPR QATTCMD
TAADSPRC *PGM CLP TAADSPRC QATTCL
TAADSPRR *PGM RPG TAADSPRR QATTRPG
|
