+---------------------------------+
|           EJECT PAGE            |
+---------------------------------+
EJECT PAGE

-----------------------------------
Conditional page advance.
-----------------------------------

The EJECT PAGE command advances streaming output (output from the ?, ??,
DISPLAY and LIST commands) to the top of the next page, or triggers a
previously defined ON PAGE routine.  EJECT PAGE behaves in the following
manner:

If the system memory variable _PADVANCE is set to 'FORMFEED' and if an
ON PAGE routine is not in effect, EJECT PAGE performs the following:

        . A formfeed is sent to the printer if the printer is on.

        . _PLENGTH - _PLINENO linefeeds are sent to the screen and/or to the
alternate file if an alternate file has been opened.

        . The system memory variable _PAGENO is incremented by one.

        . The system memory variable _PLINENO is set to 0.

If the system memory variable _PADVANCE is set to 'LINEFEEDS', an ON
PAGE routine is in effect, and the system memory variable _PLINENO is
less than the page line number specified in the current ON PAGE routine,
EJECT PAGE performs the following:

        . As many linefeeds as needed to advance to the top of the next page
are sent to the printer, the screen and/or the alternate file.

If an ON PAGE routine is not in effect, or if the system memory variable
_PADVANCE is set to 'LINEFEEDS' and the system memory variable _PLINENO
is greater than the page line number specified in the current ON PAGE
routine, EJECT PAGE performs the following:

        . _PLENGTH - _PLINENO linefeeds are sent to the printer, the screen
and/or to the alternate file if an alternate file has been opened.

        . The system memory variable _PAGENO is incremented by one.

        . The system memory variable _PLINENO is set to 0.

-----------------------------------

See Also:  EJECT, ON PAGE, SET ALTERNATE, SET DEVICE, SET PRINTER,
PCOL(), PROW(), System Memory Variables

-----------------------------------