PAGE - Set PAGE option




[  [ + | - ]  offset  ]



The desired PAGE mode status

[ + | - ]  offset

An optional page number adjustment factor.  This affects the page # displayed in the Status Bar as well as the handling of the page number operand of LOCATE PAGE nnn.

If only the offset operand is entered, ON will be assumed. The offset may not be specified if mode SCROLL is specified.


The SPFLite PAGE setting is associated with an individual Profile, and actually is only useful when the Profile is set to EOL=AUTO or EOL=AUTONL. These EOL settings provide an automated cleanup function when loading SYSOUT files with mixed end-of-line delimiter usage.   See EOL for a full description of what these EOL options support.

When PAGE OFF is specified, or PAGE ON when EOL AUTO is not also active, no special Page support will occur.

When PAGE ON is set, text data is displayed for only one print page at a time on the screen.   i.e. if a 'page' only had a few lines, they would be displayed and the remaining lines of the screen would be left blank, just as a printed page would be left blank.

This page orientation is maintained so long as scrolling is done via UP PAGE and DOWN PAGE commands. If you use mouse-wheel or arrow key scrolling, the PAGE mode display is suspended until the next normal UP PAGE or DOWN PAGE command is issued.

If the offset value is specified, (as in PAGE ON +2), then SPFLite will adjust it's calculated page number by this value.   A similar adjustment will be made by the LOCATE PAGE nnn command.   This can aid in synchronizing the SPFLite calculated page number with the printed page numbers in the report being browsed.

When PAGE SCROLL is specified it acts in most respects like PAGE ON with the exception of page data whose number of lines exceed the number of available display lines on the screen.   When this occurs, a DOWN PAGE command will not move to the next top-of-page marker, it will act as if DOWN FULL had been requested.   This can help prevent a DOWN PAGE command from skipping large quantities of lines when the creator of the print report does not consistently honor the number of lines per page.   e.g. Hercules JES2 spool output does not 'page break' the system messages log.

Note for Hercules users

Hercules users are familiar with a utility called HercPrt, which (among other things) has the ability to take a SYSOUT file and format it into a PDF file that looks remarkably like a computer printout on "green bar" paper - complete with sprocket holes and perforation!  This is cute and very clever, but it also uses a large amount of disk space.  By using alternating background colors (along with EOL AUTO and PAGE ON mode), it is possible to very closely simulate the effect of a HercPrt-formatted file without the PDF disk-space overhead.  You will still be editing or browsing ordinary text files in native mode, but the display will have the look and feel of paging through an actual hard copy printout.

If you wish to match the same colors generated by the HercPrt utility, make the main background color white, and the alternative background color a light green.  A good starting point for a HercPrt-like light green color you could try is BRG value 233, 255, 233.  You may wish to tie the profile attributes to a specific file extension like SYSOUT.

Created with the Personal Edition of HelpNDoc: Easily create PDF Help documents