CVTOUTQ CONVERT WRKOUTQ TO A DATA BASE FILE TAASPLC
The Convert Output Queue command creates a data base file OUTQP with
one record per spooled file. This allows you to automate several
functions involving spooled files. The API QGYOLSPL is used to
access the information.
The typical command would be entered as:
CVTOUTQ OUTQ(xxxx) OUTLIB(QTEMP)
The command creates a file named OUTQP in QTEMP with one record for
each spooled file. You can then read the file in a CL or other HLL
The QGYOLSPL API used by CVTOUTQ usually causes the system
QGYSERVER jobs to be started in the same subsystem where CVTOUTQ
is running. The server job is ended when CVTOUTQ ends.
You can request the tool to use a synchronous version of the
QGYOLSPL API by specifying AUXJOB(*NO) on the command. This will
result in no QGYSERVER jobs being submitted.
Command parameters *CMD
OUTQ Specifies a qualified name for the OUTQ to be
converted. The default library is *LIBL.
OUTLIB The library in which the file OUTQP will be placed.
The default is *LIBL. If the OUTQP file does not
already exist, a library must be specified.
OUTMBR The member of the OUTQP file to be used. If the
member does not exist, it is added. The default is
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
TAAUSE A *YES/*NO value for whether the command is called
as a sub tool from another TAA command.
*NO is the default and should be used when invoked
directly or by a user program.
*YES may be specified when another TAA Tool command
is the high level interface.
ESCAPE A *YES/*NO value for whether a CPF9898 message
should be sent if the initial count of the files in
the queue does not match the number of records
written to the output file. This could happen if
the queue was volatile. *NO is the default. Use
*YES if you want to be notified if the queue is
changing in size.
AUXJOB A *YES/*NO value that determines if auxiliary
QGYSERVER jobs are used to provide access to the
contents of the output queue in an asynchronous
fashion. Specifying *YES may provide better
performance than specifying *NO. Prior versions of
this tool functioned as if *YES was used. *YES is
The file name that is output is OUTQP.
The model file used is TAASPLCP with a format name of SPLREC.
To see the field names used:
The following TAA Tools must be on your system.
CRTUSRSPC Create user space
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RTVOUTQA Retrieve output queue attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ----- --------- ---------- -----------
CVTOUTQ *CMD TAASPLC QATTCMD
TAASPLCP *FILE PF TAASPLCP QATTDDS
TAAOUTQ *OUTQ No source
TAASPLCC *PGM CLP TAASPLCC QATTCL
TAASPLCR *PGM RPG TAASPLCR QATTRPG
Added to TAA Productivity tools April 1, 1995