TAA Tools
WRKSPLF3        WORK SPOOLED FILE 3                    TAASPPI

The Work Spooled File  3 command works in conjunction  with the CVTOUTQ
or  the CPYCVTOUTQ out  file.  WRKSPLF3  provides a display  similar to
WRKSPLF  of  the spooled  file  records in  the  outfile.   The  use of
CVTOUTQ/CPYCVTOUTQ  provides  better  selection  capability   than  the
system  WRKSPLF command.   For  example,  WRKSPLF does  not support  an
OUTQ parameter.

You must have *JOBCTL special authority to use WRKSPLF3.

While  WRKSPLF3 can be  used with  the outfile created  by CVTOUTQ, the
more typical  use is to  follow CVTOUTQ  with CPYCVTOUTQ  to produce  a
subset of the spooled file records.

Assume  you  have an  output  queue  that  contains many  thousands  of
spooled files  and you want to process some  of them based on selection
criteria.  CVTOUTQ can be used to convert the output queue such as:

              CVTOUTQ     OUTQ(bbb) OUTLIB(xxx)

Then CPYCVTOUTQ  would be  used  to copy  selected  records to  make  a
subset file such as by a specific form type.

              CPYCVTOUTQ  OUTQPLIB(xxx) TOFILE(zzz/yyy)
                            FORMTYPE(ABC)

The TOFILE that  is output can  then be displayed using  WRKSPLF3 which
provides a subfile of spooled files similar to WRKSPLF.

              WRKSPLF3   OUTQP(zzz/yyy)

Options  on the  display allow  for a  display, hold,  release, delete,
etc.

There  is a maximum  of 9,998 spooled  file records that  may be placed
in the subfile.

WRKSPLF3 escape messages you can monitor for
--------------------------------------------

None.  Escape messages from based on functions will be re-sent.

WRKSPLF3 Command parameters                           *CMD
---------------------------

   OUTQP         The qualified  name of  the  file that  was output  by
                 either  CVTOUTQ   or  the  subset   file  produced  by
                 CPYCVTOUTQ.   The library value defaults  to *LIBL.  A
                 specific library or *CURLIB may also be used.

   MBR           The member to  be processed.   The default is  *FIRST.
                 A specific member or *LAST may be specified.


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

  **   You must have *JOBCTL special authority to use WRKSPLF3.

  **   There is  a maximum of  9,998 spooled file  records that  may be
       placed in the subfile.

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

The following TAA Tools must be on your system:

     ADJVAR          Adjust variable
     CHKDBFMBR       Check data base file member
     CHKJOBCTL       Check *JOBCTL special authority
     CVTDAT          Convert date
     CVTTIM          Convert time
     RSNLSTMSG       Resend last message
     RTVFMT          Retrieve format
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     WRKSPLF2        Work spooled file 2

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

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   WRKSPLF3      *CMD                   TAASPPI       QATTCMD
   TAASPPIC      *PGM       CLP         TAASPPIC      QATTCL
   TAASPPIR      *PGM       RPG         TAASPPIR      QATTRPG
   TAASPPID      *FILE      DSPF        TAASPPID      QATTDDS
					

Added to TAA Productivity tools October 15, 2011


Home Page Up to Top