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