Enform Plus Reference Manual

Clauses
Enform Plus Reference Manual—422684-001
5-61
SUBTITLE Clause
SUBTITLE Clause
The SUBTITLE clause allows you to specify printing of information at the top of each
page immediately following the title for the current report. This clause is an optional
part of the LIST statement. See also the TITLE Clause
on page 5-69 and the
SUBTITLE Statement
on page 4-45. The syntax of the SUBTITLE clause is:
print-list
contains 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, or
parameter names.
The clauses that can be part of a print-list are described in this section. The other
elements are described in Section 3, Enform Plus Language Elements
Specifying a Field Name in a SUBTITLE Clause
If you specify a field name within a print-list of a SUBTITLE clause, Enform
Plus prints the same field value as in the first row of the report. A field name appearing
within the SUBTITLE clause need not be explicitly included within the associated
LIST statement. If the field name is not included, Enform Plus in effect adds it with a
NOPRINT clause.
Spacing Considerations
By default the subtitle begins in the same 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 literal 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
causes two lines to be printed:
SUBTITLE print-list [ CENTER ]