|
|
|
EVEN [IF]
TOP [OF] [PAGE]
|
|
|
||||||
NEWPAGE [(rep)]
|
|
|
IF
|
|
|
LESS [THAN]
operand1 [LINES] [LEFT]
|
||||
WHEN
|
||||||||||
WITH]
TITLE
title-definition]
|
||||||||||
This document covers the following topics:
For an explanation of the symbols used in the syntax diagram, see Syntax Symbols.
Related Statements: AT END OF PAGE | AT TOP OF PAGE | CLOSE PRINTER | DEFINE PRINTER | DISPLAY | EJECT | FORMAT | PRINT | SKIP | SUSPEND IDENTICAL SUPPRESS | WRITE | WRITE TITLE | WRITE TRAILER
Belongs to Function Group: Creation of Output Reports
The NEWPAGE statement is used to cause an advance to a new
page. NEWPAGE also causes any AT END OF PAGE and
WRITE TRAILER statements
to be executed. A default title containing the date, time of day, and page
number will appear on each new page unless a WRITE TITLE,
WRITE NOTITLE, or
DISPLAY NOTITLE
statement is specified to define specific title processing.
Notes:
NEWPAGE statement is executed. It is performed only when a
subsequent statement which produces output is executed.
NEWPAGE statement is not used, page advance is
controlled automatically based on the Natural profile/session parameter
PS (Page Size
for Natural Reports).
Operand Definition Table:
| Operand | Possible Structure | Possible Formats | Referencing Permitted | Dynamic Definition | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operand1 | C | S | N | P | I | yes | no | ||||||||||||
Syntax Element Description:
| (rep) |
Report Specification:
The notation
A value in the range 0 - 31 or a logical name which has been assigned using the DEFINE PRINTER statement may be specified. If For information on how to control the format of an output report created with Natural, see Controlling Data Output (in the Programming Guide). |
|---|---|
| EVEN IF TOP OF PAGE | This option is used to cause a new page (with corresponding
AT TOP OF PAGE and page
title processing) to be generated, even if a new page was initiated immediately
before the NEWPAGE statement was encountered.
|
| WHEN LESS THAN operand1 LINES LEFT | This option is used to cause a new page to be generated when
there are less than operand1 lines left on the
current page (current line count compared with value for the Natural
profile/session parameter PS).
|
| WITH TITLE title-definition | This option may be used to specify a title which is to be
written to the new page generated. The
title-definition is specified using the same syntax
as described for the WRITE
TITLE statement, except that the
SKIP clause in a
NEWPAGE WITH TITLE title-definition
statement is not allowed.
|
** Example 'NWPEX1': NEWPAGE
************************************************************************
DEFINE DATA LOCAL
1 EMPLOY-VIEW VIEW OF EMPLOYEES
2 CITY
2 NAME
2 SALARY (1)
2 CURR-CODE (1)
END-DEFINE
*
LIMIT 15
READ EMPLOY-VIEW BY CITY FROM 'DENVER'
DISPLAY CITY (IS=ON) NAME SALARY (1) CURR-CODE (1)
AT BREAK OF CITY
SKIP 1
/*
NEWPAGE WHEN LESS THAN 10 LINES LEFT
WRITE '****************************************'
/ 'SUMMARY FOR ' OLD(CITY)
/ '****************************************'
/ '****************************************'
/ 'SUM OF SALARIES:' SUM(SALARY(1))
/ 'AVG OF SALARIES:' AVER(SALARY(1))
/ '****************************************'
NEWPAGE
/*
END-BREAK
END-READ
END
Page 1 05-01-18 10:01:45
CITY NAME ANNUAL CURRENCY
SALARY CODE
-------------------- -------------------- ---------- --------
DENVER TANIMOTO 33000 USD
MEYER 50000 USD
****************************************
SUMMARY FOR DENVER
****************************************
****************************************
SUM OF SALARIES: 83000
AVG OF SALARIES: 41500
****************************************
Page 2 05-01-18 10:01:45
CITY NAME ANNUAL CURRENCY
SALARY CODE
-------------------- -------------------- ---------- --------
DERBY DEAKIN 8750 UKL
GARFIELD 6750 UKL
MUNN 8800 UKL
MUNN 5650 UKL
GREBBY 9550 UKL
WHITT 8650 UKL
PONSONBY 5500 UKL
MAGUIRE 4150 UKL
HEYWOOD 3900 UKL
BRYDEN 6750 UKL
SMITH 39000 UKL
CONQUEST 45000 UKL
ACHIESON 11300 UKL
****************************************
SUMMARY FOR DERBY
****************************************
-------------------- -------------------- ---------- --------
DERBY DEAKIN 8750 UKL
GARFIELD 6750 UKL
MUNN 8800 UKL
MUNN 5650 UKL
GREBBY 9550 UKL
WHITT 8650 UKL
PONSONBY 5500 UKL
MAGUIRE 4150 UKL
HEYWOOD 3900 UKL
BRYDEN 6750 UKL
SMITH 39000 UKL
CONQUEST 45000 UKL
ACHIESON 11300 UKL
****************************************
SUMMARY FOR DERBY
****************************************
****************************************
SUM OF SALARIES: 163750
AVG OF SALARIES: 12596
****************************************