The Scan Output Queue command scans for a spooled file name, generic
name, or all spooled files in an output queue for 1 to 20 arguments.
A spooled file is output with the results including the spooled file
name, line number, and the data for each successful scan.
Only spooled files that can be converted with CPYSPLF can be scanned.
Spooled files that are open or cannot be converted (such as created
by the Advanced Print Function) will be noted on the listing and
bypassed.
A typical command would be:
SCNOUTQ OUTQ(xxx) ARGUMENT(ABC)
All spooled files in the named output queue would be scanned for ABC.
By default, the spooled file print lines are converted to upper case
before scanning.
If the argument is found, a line is printed with:
- Spooled file name
- Line number within the spooled file
- Position within the line where the argument starts
- Some of the print line
If the full argument is found within the first 100 bytes of the print
line, the first 100 are printed. Otherwise, ellipsis are printed
followed by the argument and any remaining data on the print line.
A second form of output format exists by using the OUTPUTFMT(*JOB).
This lists one line for every argument found and identifies the job,
user, job number, spooled file, spooled file number, etc.
SCNOUTQ escape messages you can monitor for
-------------------------------------------
The TAA9892 message is sent for a situation such as when a generic
spooled file name is entered and no spooled files match the name. No
spooled files were actually scanned.
The TAA9893 message is sent if one or more spooled files were
scanned, but no arguments were found.
TAA9891 No spooled files exist in the output queue
TAA9892 No spooled file meets the criteria specified
TAA9893 No spooled file found that has an argument
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
OUTQ The qualified name of the output queue to be
scanned. The library value defaults to *LIBL.
*CURLIB may also be used.
ARGUMENT A list of 1 to 20 arguments to be scanned for. The
argument value is folded to upper case by command
processing. By default the print lines are folded
to upper case before scanning.
To scan for a lower case value only, specify the
argument in quotes and TRANSLATE(*NO).
FILE The spooled file name to be scanned. The default is
*ALL.
A specific spooled file name or generic name may be
entered.
TRANSLATE A *YES/*NO parameter for whether the print lines
should be translated to upper case before scanning.
*YES is the default.
*NO may be specified when scanning for a specific
lower case value. The argument must be in quotes.
JOB The job name to be scanned. The default is *ALL. A
name or a generic name may be entered.
USER The user name to be scanned. The default is *ALL.
A name or a generic name may be entered.
OUTPUTFMT The type of output format.
*DATA is the default to list one line per argument
found along with the first 100 bytes of print line
data.
*JOB may be specified to list one line per argument
found along with the identification of job, user,
job number, spooled file name, number etc.
Restrictions
------------
Only spooled files that can be converted with CPYSPLF can be scanned.
Spooled files that are open or cannot be converted (such as created
by the Advanced Print Function) will be noted on the listing and
bypassed.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKGENERC Check generic
CHKSPLF Check spooled file
CVTDAT Convert date
CVTOUTQ Convert output queue
EDTVAR Edit variable
EXTLST2 Extract list 2
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SCNOUTQ *CMD TAASPNW QATTCMD
TAASPNWC *PGM CLP TAASPNWC QATTCL
TAASPNWR *PGM RPG TAASPNWR QATTRPG
|
