TAA Tools
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
program.

QGYSERVER Job
-------------

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
                 OUTQP.

   REPLACE       A *YES/*NO value for whether the member should be
                 cleared before writing records into it.  The default
                 is *YES.

   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 default.

File format
-----------

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:

       DSPFMT    TAASPLCP

Restrictions
------------

None.

Prerequisites
-------------

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

Implementation
--------------

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


Home Page Up to Top