Banner Command - Oce XDL Reference Manual

Using Logical Processing

4.5 BANNER Command

The stacked reports feature enables the online and offline user to define a series of reports
in a single file. This is accomplished by specifying an end-of-report condition in the coded
logical processing commands RSTACK (online and offline) and BANNER (online use only).
End-of-report is that point in processing a report when all of the pages of a copy of a report
have been formatted to disk and processing has begun on the next report.
Reports are stacked in a file if more than one report is included in a single file and separated
from each other logically but not physically (with tapemarks, operating system labels, and
so forth). In processing stacked reports, the system checks each record for the logical end-
of-report specification as defined by the TEST parameter of the RSTACK and BANNER
commands. When BANNER is coded, the user specifies the number of consecutive banner
pages which must satisfy the test criteria before end-of-report occurs.
Report separation based on banner page detection is performed with the BANNER com-
mand. This includes a test expression to detect a banner page and a count of the header
or trailer pages used to separate reports.
Parameter
HCOUNT=
value
HJOBNO=
(offset,length)
HJOBNO=
NONE
HRPTNA=
(offset,length)
A29247-X4-X-8-7672
Definition(s)
value
Specifies the total number of consecutive header
banner pages which must be detected to satisfy the
test expression.
The default is 0.
This option has the following components:
offset
Specified in bytes (relative to zero) from the start of
the user's portion of the record to the subfield within
the record.
length
The number of bytes in the subfield (0 to 6).
NONE
Specifies that no HOST job number is to be selected.
The default is NONE.
This option has the following components:
offset
Specified in bytes (relative to zero) from the start of
the user's portion of the record to the subfield within
the record.
length
The number of bytes in the subfield (0 to 16).
BANNER Command
Offline Online DJDE
N Y N
N Y N
N Y N
147