The SECTIONS parameter allows the output report to be divided into sections.
The format of the SECTIONS parameter is illustrated below.
Figure 1. SECTIONS Parameter Format
The SECTIONS parameter identifies the control field(s) that determine or control section
breaks. More than one control field can be specified to subdivide a report within
sections. However, if more than one control field is specified, the specifications must
be made in major to minor order. A major control field break causes all minor control
fields to break at the same time.
Each control field is identified by its position
p and length
l.
p
|
The position value indicates the first byte of the field relative
to the beginning of the record after processing by an
E15/E32 exit, the INREC control statement, the OUTREC control
statement, and an E35 exit, if specified, but
before processing by the OUTREC parameter and other
report writing parameters of the OUTFIL control statement, if
specified.
|
l
|
The length value indicates the length of the field. The length
must be an integer number of bytes and cannot exceed 256
bytes.
|
|
For each control field, one or more of the following subparameters may be specified:
SKIP, HEADER3, or TRAILER3. The SECTIONS subparameters are described below.
Figure 2. SECTIONS Subparameter
SKIP
|
The SKIP subparameter specifies the amount of spacing that should
occur after a section is completed. This spacing will follow
immediately after the last TRAILER3 for that section, if
specified. SKIP=nL specifies that the next line of the report
will appear after n number of blank lines, with n being
between 0 and 255. SKIP=P specifies a page break following the
completion of a section.
|
HEADER3
|
The HEADER3 subparameter specifies a section header or title that
will appear at the start of each new section. The HEADER3 format
is identical to the format of the HEADER1/HEADER2 parameters.
(See HEADER1/ HEADER2 Parameters for details.)
|
TRAILER3
|
The TRAILER3 subparameter specifies a section trailer that will
appear at the end of each section. The TRAILER3 format is
identical to the format of the TRAILER1/TRAILER2 parameters.
(See TRAILER1/ TRAILER2 Parameters for details.)
|
PAGEHEAD
|
The PAGEHEAD subparameter may be specified in conjunction with
the HEADER3 subparameter. The PAGEHEAD subparameter specifies
that the HEADER3 appear at the top of each page following any
HEADER2, as well as at the start of each new section. PAGEHEAD
is ignored if no HEADER3 is specified.
|
|
A control field may be specified without any subparameters. This allows multiple
non-contiguous control fields to be specified for each SECTIONS break field.
SECTIONS may not be used with the IFTRAIL parameter.