The Scan Output Queue Attributes command scans one or more Output
Queues for attribute values. This acts as a simple query to
determine the value of attributes of Output Queue objects.
A typical command would be:
SCNOUTQA ATTR(DTAQ) OUTQ(QGPL/*ALL)
SCNVAL('*NONE') SCNOPR(*NE)
A spooled file would be displayed of all Output Queue objects that
have a data queue specified.
SCNOUTQA escape messages you can monitor for
--------------------------------------------
TAA9891 No Output Queue objects exist
Escape messages from based on functions will be re-sent.
SCNOUTQA Command parameters *CMD
---------------------------
ATTR The Output Queue attribute to be scanned for. The
value must be one of the following:
AUTCHK. The authority required to control files in
the output queue. *OWNER or *DTAAUT may be entered
for the scan value.
CNNTYPE. The connection type to a remote system.
*SNA, *IP, or *USRDFN may be entered for the scan
value.
DESTTYPE. *OS400, *OS400V2, *PSF2, *S390, *NDS,
*NONE, or *OTHER may be entered for the scan value.
DSPDTA. Whether users who can display the list of
spooled files can also display the data in a spooled
file. *YES, *NO, or *OWNER may be entered for the
scan value.
DTAQ. A data queue name or blank may entered for
the scan value.
DTAQL. A data queue library name or blanks may be
entered for the scan value.
FCB. The forms control buffer sent to VM/VMS
systems. *USRDTA, *NONE, *PRTF, or a name may be
entered for the scan value. SCNOPR(*CT) must be
used if a name is entered.
IMGCFG. The image configuration to control
transformations for a variety of requirements.
JOBSEP. Whether job separators should exist between
spooled files. *MSG may be entered for the scan
value or a digit 0 to 9.
MFGTYPMDL. The manufacturers type and model of the
printer device. The scan operator must be *CT.
NBRFILES. The number of spooled files in the output
queue. A number must be entered for the scan value.
NBRWTRS. The number of writers assigned to the
output queue. A number must be entered for the scan
value.
OPRCTL. Whether a user with *JOBCTL special
authority can manage the output queue. *YES or *NO
may be entered for the scan value.
PRTDEV. The print device assigned to the spooled
file.
RMTSYT. The remote system type. A *YES or *NO may
be entered (0 = no remote system name, 1 = A
Passthru system is used, 2 = the name of the remote
system, 3 = an internet address.
RMTSYS. The remote system name. SCNVAL(*CT) must
be used. The value to be scanned works in
conjunction with RMTSYT.
SEPPAGE. Whether separator pages should exist
between spooled files. A *YES, *NO, or blank may be
entered for the scan value. A blank is used for a
connection type that is not *IP or *USRDFN.
SEQ. The sequence of files in the output queue.
*JOBNBR or *FIFO may be entered for the scan value.
STATUS. The status of the output queue. RELEASED
or HELD may be entered in the scan value.
TEXT. A string of characters to be found in the
text description may be entered with the operator
*CT.
TRANSFORM. Whether to make use of host printer
transform services. *YES, *NO, or blank may be
entered in the scan value. Blank is used for *SNA.
WCCST. Workstation customizing object name.
WCCSTL. Workstation customizing object library.
WTRMQ. Writer message queue.
WTRMQL. Writer message queue library.
WTRNAM. Writer name.
WTRUSR. Writer user name.
WTRSTS. Writer status. STR or HLD may be entered
for the scan value.
OUTQ The qualified name of the Output Queue to be
scanned. A single output queue, 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.
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 OPRCTL 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:
CVTOUTQD Convert output queue description
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
------ ---- --------- ---------- ----------
SCNOUTQA *CMD TAASPOV QATTCMD
TAASPOVC *PGM CLP TAASPOVC QATTCL
TAASPOVR *PGM RPG TAASPOVR QATTRPG
|
