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


Home Page Up to Top