WRITE
[(rep)] TITLE
[LEFT [JUSTIFIED ]] [UNDERLINED ]
|
||||||||
[(statement-parameters)] | ||||||||
nX
|
'text' [(attributes)] | |||||||
nT
|
'c'( n ) [(attributes)] | |||||||
x/y | ['='] operand1 [(parameters)] | |||||||
[SKIP
operand2 [LINES ]]
|
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 | NEWPAGE | PRINT | SKIP | SUSPEND IDENTICAL SUPPRESS | WRITE | WRITE TRAILER
Belongs to Function Group: Creation of Output Reports
The WRITE TITLE
statement is used to override the default
page title with a page title of your own. It is executed whenever a new page is
initiated.
See also the following sections (in the Programming Guide):
This statement is non-procedural, that is, its execution depends on an event, not on where in a program it is located.
If a report is produced by statements in different objects, the
WRITE TITLE
statement is only executed if it is contained in the
same object as the statement that causes a new page to be initiated.
WRITE TITLE
may be specified only once per report.
WRITE TITLE
cannot be specified within a special
condition statement block.
WRITE TITLE
cannot be specified within a subroutine.
Operand Definition Table:
Operand | Possible Structure | Possible Formats | Referencing Permitted | Dynamic Definition | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
operand1 | S | A | G | N | A | U | N | P | I | F | B | D | T | L | G | O | yes | no | ||
operand2 | C | S | N | P | I | B | yes | no |
Syntax Element Description:
(rep) |
Report Specification:
If multiple reports are to be produced, the
notation
As report identification, a value in the range 0 - 31 or a logical
name which has been assigned using the If For information on how to control the format of an output report created with Natural, see Controlling Data Output (in the Programming Guide). |
---|---|
Page Title Justification and/or Underlining:
By default, page titles are centered and not underlined. If Natural first applies all spacing or tab specifications and creates
the line before centering the whole line. For example, a notation of
|
|
statement-parameters |
Parameter Definition at Statement Level:
One or more parameters, enclosed within parentheses, may be
specified at statement level, that is, immediately after the If more than one parameter is specified, one or more blanks must be present between each entry. An entry may not be split between two statement lines. Note: For information on which parameters may be used, see
List of
Parameters (in the |
Format Notation and Spacing Elements:
See Format Notation and Spacing Elements (below). |
|
Text/Attribute Assignment:
See Text/Attribute Assignments (below). |
|
operand1 |
Field to Be Displayed in Title:
operand1 represents the field(s) to be displayed within the title. Arrays with ranges that allow to vary the number of occurrences at execution time may not be specified. |
parameters |
Parameter Definition at Element (Field) Level:
One or more parameters, enclosed within parentheses, may be
specified at element (field) level, that is, immediately after
operand1. Each parameter specified in this manner
will override the corresponding parameter previously specified
at statement level
or in a If more than one parameter is specified, one or more blanks must be present between each entry. An entry may not be split between two statement lines. For information on which parameters may be used, see
List of
Parameters (in the |
SKIP operand2 LINES |
Lines to Be Skipped:
Note: |
nX |
Column Spacing:
This notation inserts n spaces between columns. n must not be zero. |
---|---|
nT |
Tab Setting:
The nT notation causes positioning (tabulation) to print position n. Backward positioning is not permitted. |
x/y |
x/y Positioning:
Causes the next element to be placed x lines below the output of the last statement, beginning in column y. y must not be zero. Backward positioning in the same line is not permitted. |
'text' |
Text Assignment:
The character string enclosed by single quotes is displayed. |
---|---|
'c'(n) |
Character Repetition:
The character enclosed by single quotes is displayed n times immediately before the field value. |
attributes |
Field Representation and Color Attributes:
It is possible to assign various attributes for text/field display. These attributes and the syntax that may be used are described in the section Output Attributes below. Examples: WRITE TITLE 'TEXT' (BGR) WRITE TITLE 'TEXT' (B) WRITE TITLE 'TEXT' (BBLC) |
attributes indicates the output attributes to be used for text display. Attributes may be:
|
||||
AD-value
|
For the possible session parameter values, refer to the corresponding sections in the Parameter Reference documentation:
Note:
The compiler actually accepts more than one attribute value for an
output field. For example, you may specify: AD=BDI
. In such a
case, however, only the last value applies. In the given example, only the
value I
will become effective and the output field will be
displayed intensified.
** Example 'WTIEX1': WRITE (with TITLE option) ************************************************************************ DEFINE DATA LOCAL 1 EMPL-VIEW VIEW OF EMPLOYEES 2 NAME 2 FIRST-NAME 2 CITY 2 JOB-TITLE END-DEFINE * * FORMAT LS=70 * WRITE TITLE LEFT JUSTIFIED UNDERLINED *TIME 3X 'PEOPLE LIVING IN NEW YORK CITY' 11X 'PAGE:' *PAGE-NUMBER SKIP 1 * FIND EMPL-VIEW WITH CITY = 'NEW YORK' DISPLAY NAME FIRST-NAME 3X JOB-TITLE END-FIND END
09:33:16.5 PEOPLE LIVING IN NEW YORK CITY PAGE: 1 --------------------------------------------------------------------- NAME FIRST-NAME CURRENT POSITION -------------------- -------------------- ------------------------- RUBIN SYLVIA SECRETARY WALLACE MARY ANALYST