LINC Programming Reference Manual - Public Support Login - Unisys

BEGIN.PAGE (BP)
BEGIN.PAGE (BP)
The BEGIN.PAGE; command designates a Frame that is to appear as a heading at the top
of each new page of a Report. The BEGIN.PAGE; command does not generate a new page
when it occurs.
If several Frames are required as headings, use multiple BEGIN.PAGE; commands to
specify the required Frames. The Frames are printed at the top of all subsequent pages in
numerical frame order, not the order in which they are specified.
The logic of the heading Frame is executed after the logic of the Frame currently being
printed, during the printing of the Frame.
The BEGIN.PAGE; CLEAR command cancels the definition of all headings. It causes an
advance to a new page when the next frame is printed.
Note: When the BEGIN.PAGE; CLEAR command is executed, GLB.LINECOUNT is set
to 9999 to force the new page. Since the logic of the print frame is executed
before the advance to new page occurs, the value of GLB.LINECOUNT is 9999,
not 0.
Reports Using LINC Report Output Control (ROC)
An ADVANCE; NEW.PAGE command specified within a heading causes the heading to
continue on the next page without restarting the heading. Use the END.NO.PRINT;
command to suppress output.
There is no limit on the length of the heading.
Notes:
$ If GLB.FORMDEPTH is set to zero, headings are not printed. In this case, use the
PRINT.FRAME; command to print the headings you require.
$ ROC is not available with LDA.
Reports Not Using ROC
During the definition of headings, the following situations may result in the creation of an
infinite loop:
$ An ADVANCE; NEW.PAGE command included within a heading
$ An END.NO.PRINT; command in a heading
$ The length of a heading equals or exceeds GLB.FORMDEPTH
These situations should be avoided.
1-48 v