MRGSPLF MERGE SPOOLED FILES TAASPNO |
The Merge Spooled Files command combines all spooled files from an
output queue into a single spooled file. This essentially makes a
book out of multiple chapters. You are responsible for using the
same spooled file attributes (such as LPI) for all spooled files
being combined. Only standard DP output is provided for (no special
graphics).
A typical command would be:
MRGSPLF FRMOUTQ(xxx) TOOUTQ(yyy) SPLFNAM(zzz)
All spooled files in the FRMOUTQ would be converted to a single data
base file which would then be converted (using CPYF) to the named
spooled file in the TOOUTQ.
MRGSPLF escape messages you can monitor for
-------------------------------------------
None. Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
FROMOUTQ The qualified name of the output queue where the
spooled files exist. The library defaults to *LIBL.
*CURLIB may be specified.
TOOUTQ The qualified name of the output queue where the
combined spooled file will be written. The library
defaults to *LIBL. *CURLIB may be specified. The
value of this parameter overrides the output queue
specified in the TOPRTF printer file.
The typical use would be to name a different output
queue than that specified in FROMOUTQ.
SPLFNAME The name of the new spooled file in the To output
queue. The default is MRGOUTPUT. The value of this
parameter overrides the spooled file name that would
be used based on the TOPRTF parameter.
The special value *FIRSTSPLF may be entered to use
the name of the first spooled file in the FROMOUTQ.
TOPRTF The qualified name of the printer file to be used
when writing to the combined spooled file. The
default is QSYSPRT. The library defaults to *LIBL.
*CURLIB may be specified. CPYF is used to reprint
the data.
All the attributes from the printer file will be
used except for the spooled file name (from SPLFNAME
parameter), OUTQ (from the TOOUTQ parameter) and
USRDTA (MRGSPLF is used).
You may use an OVRPRTF command in your job prior to
using MRGSPLF to specify individual printer file
attributes (except for OUTQ, SPLFNAME, and USRDTA).
Restrictions
------------
Only standard DP output is provided for (no special graphics).
You must ensure that the spooled file attributes (such as LPI) of the
spooled files that are to be combined are consistent.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CVTOUTQ Convert output queue
SNDCOMPMSG Send completion 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
------ ---- --------- ---------- ----------
MRGSPLF *CMD TAASPNO QATTCMD
TAASPNOC *PGM CLP TAASPNOC QATTCL
|
Added to TAA Productivity tools June 1, 2002