Enform Plus Reference Manual

Statements
Enform Plus Reference Manual—422684-001
4-45
SUBTITLE Statement
SUBTITLE Statement
The SUBTITLE statement allows you to specify a subtitle for all subsequent reports in
the current session. The subtitle is printed at the top of each page immediately following
the title. The SUBTITLE statement can be overridden or reset by another SUBTITLE
statement or temporarily overridden by a SUBTITLE clause. The syntax of the
SUBTITLE statement is:
print-list
can be any combination of literals, FORM, SKIP, SPACE or TAB clauses. A
print-list can also contain the following elements that can be modified by AS,
AS DATE, or AS TIME clauses: field names, arithmetic expressions,
IF/THEN/ELSE expressions, System Variable clauses, JULIAN-DATE clauses,
TIMESTAMP-DATE clauses, TIMESTAMP-TIME clauses, user variables, and
parameter names.
The clauses that can be used in a print-list are described in Section 5, Clauses
. The
other elements are described in Section 3, Enform Plus Language Elements.
Specifying a Field Name Within a SUBTITLE Statement
If you specify a field name within the print-list of a SUBTITLE statement, the field
name has the same value as in the first row of the page. A field name appearing within
the SUBTITLE statement need not be explicitly included within the following LIST
statements. If the field name is not included, Enform Plus effectively adds it with a
NOPRINT clause.
Spacing Considerations
By default the subtitle begins printing in the same column position as the leftmost report
column. Using SPACE or TAB clauses as the first element of the print-list overrides this
default. SPACE or TAB clauses can also appear anywhere within the print-list. In the
following example, the SPACE clause causes the two literals to be separated by 15
spaces:
SUBTITLE "Inventory" SPACE 15 "Parts in Stock";
Inventory Parts in Stock
If you specify either a SKIP clause or the slash symbol (/) within a print-list,
Enform Plus advances one or more lines before printing the rest of the SUBTITLE
print-list. The number of lines advanced can be affected by one or more of the
following: the digit (if any) following the keyword SKIP, the number of slashes
specified, or the option variable @VSPACE. In the following example, the SKIP clause
of the SUBTITLE statement causes two lines to be printed:
SUBTITLE [ print-list [ CENTER ] ] [ ; ]