Creates a page break.

Available in:

Apps (win) Apps (char) Reportwriter RPC Standalone PL
  X     X


void paginate( [header] [| break] [| footer]  )
keyword     header,break,footer


Creates the following page break for each keyword:
footer Appends the current block's page footer (if any).

break Writes out the report page, clears report page, resets line count (G.LINENUMBER = G.PAGEHEADERLINES) and increases page number (G.PAGENUMBER = G.PAGENUMBER + 1).

header Inserts the current block's page header (if any).


If no block is currently active (for example, the main trigger), then the first block's page header is printed. If a different header is required, remove paginate(header) from the main trigger and put it in the PRE-BLOCK trigger of the first block.


By default the page trigger contains the single statement:
For special effects, the page trigger can be changed to perform actions such as resetting offsets.