HP 3000 Manuals

SUPPRESS FOR [ HP Business BASIC/XL Reference Manual ] MPE/iX 5.0 Documentation


HP Business BASIC/XL Reference Manual

SUPPRESS FOR 

The SUPPRESS FOR statement provides a means of inhibiting print for a
specified number of pages at the beginning of a report.  The report is
generated normally, but no output is actually produced until the correct
number of pages have been processed.

Syntax 

                               [PAGE ]
SUPPRESS [PRINT] FOR num_pages [PAGES]

Parameters 

num_pages        A numeric expression indicating how many pages should be
                 skipped before printing starts.  This must be a
                 non-negative valid INTEGER value.

Examples 

The following show the use of the SUPPRESS FOR statement.

     100 SUPPRESS PRINT FOR Spf PAGES
     100 SUPPRESS FOR 1 PAGE

The SUPPRESS FOR statement is evaluated by BEGIN REPORT, and is busy
during its evaluation.

The report is generated normally, but all output is prevented by this
statement.  The Report Writer counts the number of physical pages
produced.  When the correct number of pages has been produced, actual
output starts up.  All Report Writer errors, including the not enough
lines on a page, may occur while output is suppressed.

As an example of using this statement, assume that the first nine pages
of a report have been printed, and an error occurs on the tenth page.
After fixing the error, the user may wish to re-run the program.  Since
the first nine pages are correct, the following statement prevents the
reprinting of those pages:

                    SUPPRESS PRINT FOR 9 PAGES

Suppressing print for zero pages allows all output to take place.



MPE/iX 5.0 Documentation