The Convert All Output Queue command takes the output from WRKOUTQ
OUTQ(*ALL) and creates a data base file ALLOUTQP with one record per
output queue. This allows you to easily determine those output
queues which have spooled files.
A typical command would be entered as:
CVTALLOUTQ OUTLIB(QTEMP)
The command creates a file named ALLOUTQP in QTEMP with one record
for each output queue. You can then read the file in a CL or other
HLL program. For example, you could then request the CVTOUTQ command
for each output queue which has spooled files for further processing.
Command parameters *CMD
------------------
LIB The library to convert the output queues from. The
default is *ALL. If a library is named, only the
output queues in that library will be converted.
The special values *LIBL, *USRLIBL, *CURLIB, or
*ALLUSR may also be entered.
OUTLIB The library in which the file ALLOUTQP will be
placed. The default is *LIBL. If the ALLOUTQP file
does not exist, a library must be specified.
OUTMBR The member of the ALLOUTQP file to be used. If the
member does not exist, it is added. The default is
ALLOUTQP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
ASPDEV Specifies the auxiliary storage pool (ASP) device
name where storage for the library containing the
object is allocated. If the library resides in an
ASP that is not part of the thread's library name
space, this parameter must be specified to ensure
the correct library is searched. If this parameter
is used when the library qualifier specified for the
Object prompt (OBJ parameter) is *CURLIB, *LIBL, or
*USRLIBL, ASPDEV(*) is the only valid value.
This parameter can be specified as a list of two
values (elements) or as a single value. The
possible single values are:
* = The ASPs that are currently part of the thread's
library name space will be searched to locate the
library. This includes the system ASP (ASP 1), all
defined basic user ASPs (ASPs 2-32), and, if the
thread has an ASP group, the primary and secondary
ASPs in the thread's ASP group.
*ALLAVL = All available ASPs will be searched. This
includes the system ASP (ASP 1), all defined basic
user ASPs (ASPs 2-32), and all available primary and
secondary ASPs, (ASPs 33-255) with a status of
'Available'.
*CURASPGRP = If the thread has an ASP group, the
primary and secondary ASPs in the thread's ASP group
will be searched to locate the library. The system
ASP (ASP 1) and defined basic user ASPs (ASPs 2-32)
will not be searched. If no ASP group is associated
with the thread, an error will be issued.
*SYSBAS = The system ASP (ASP 1) and all defined
basic user ASPs (ASPs 2-32) will be searched to
locate the library. No primary or secondary ASPs
will be searched even if the thread has an ASP
group.
Element 1:
ASP Device name. The device name of the primary or
secondary ASP to be searched. The primary or
secondary ASP must have been activated (by varying
on the ASP device) and have a status of 'Available'.
The system ASP (ASP 1) and defined user basic ASPs
(ASPs 2-32) will not be searched.
Element 2: Search type.
*ASP = Specifies that only the single auxiliary
storage pool (ASP) device named in element 1 is to
be searched.
*ASPGRP = Specifies that the entire group of the
primary auxiliary storage pool (ASP) device named in
element 1 is to be searched.
File format
-----------
The file name that is output is ALLOUTQP.
The model file used is TAASPLGP with a format name of AORCD.
To see the field names used:
DSPFMT TAASPLGP
Restrictions
------------
Because all output queues must be accessed, you must have *ALLOBJ
authority to use CVTALLOUTQ.
Prerequisites
-------------
The following TAA Tools must be on your system:
EDTVAR Edit variable
RTVOUTQA Retrieve output queue attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
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
------ ----- --------- ---------- -----------
CVTALLOUTQ *CMD TAASPLG QATTCMD
TAASPLGP *FILE PF TAASPLGP QATTDDS
TAAOUTQ *OUTQ No source
TAASPLGC *PGM CLP TAASPLGC QATTCL
TAASPLGC2 *PGM CLP TAASPLGC2 QATTCL
TAASPLGR *PGM RPG TAASPLGR QATTRPG
|
