SPLIT Parameter (Optional) - mfx - 3.1

Syncsort™ MFX Programmers Guide

Product type
Software
Portfolio
Integrate
Product family
Syncsort™ Software
Product
Syncsort™ MFX > MFX
Version
3.1
Language
English
Content type
Programmer’s Guide
Product name
Syncsort™ MFX
Title
Syncsort™ MFX Programmers Guide
Copyright
2024
First publish date
2010
Last updated
2024-11-06
Published on
2024-11-06T17:38:26.716054

The SPLIT parameter of the OUTFIL control statement causes output records to be distributed in rotation among files in an OUTFIL group.

In the normal case, when the SPLIT parameter is not used, the output files in the group will contain the same records. SPLIT distributes the output records. The following OUTFIL control statement will distribute records among three output files:
Figure 1.  Sample OUTFIL Control Statement with SPLIT

For the above example, the first record will be written to the SORTOF01 data set; the second, to SORTOF02; the third, to SORTOF03. The fourth record will be written to SORTOF01 again, and so on in round-robin fashion.

The OUTFIL control statement can contain an INCLUDE/OMIT and an OUTREC parameter, in which case the selected and reformatted subset of records will be distributed among the output files.

SPLIT, SPLITBY=n and SPLIT1R=n are mutually exclusive. SPLITBY=1 is equivalent to SPLIT.

Note that the SPLIT parameter cannot be used with any report writing (SortWriter) functions. Specifically, report writing parameters (HEADERn, TRAILERn, SECTIONS, LINES, NODETAIL, IFTRAIL) cannot be specified on the OUTFIL control statement that defines the output group.

SPLIT can be used with BatchPipes/MVS; that is, the output records can be distributed among BatchPipes/MVS data sets.