At Start Print Clause; Specifying A Field Name In An At Start Print Clause; Spacing Considerations - Tandem ENFORM 058057 Reference Manual

AT START PRINT
Clause
Specifying a Field Name in
an AT START PRINT Clause

Spacing Considerations

The AT START PRINT clause allows you to specify information to be printed just
before the first set of column headings for the current report. This clause is an optional
part of the LIST statement. The syntax of the AT START PRINT clause is:
AT START PRINT print-list [ CENTER ]
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 appear in a print-list are described in this section. The other
elements are described in Section 3.
The AT START PRINT clause differs from both the TITLE and SUBTITLE statements
and clauses in that a title or subtitle is printed on every page of a report while the AT
START PRINT information is printed only on the first page of a report. The
information supplied in an AT START PRINT clause prints after either a title or a
subtitle.
If you specify a field name within a print-list of an AT START PRINT clause, ENFORM
prints the same field value as in the first row of the report. A field name appearing
within the print list of a AT START PRINT clause need not be explicitly included
within the associated LIST statement. If the field name is not included, ENFORM in
effect adds it with a NOPRINT clause.
By default the AT START PRINT information 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:
AT START PRINT "Report" SPACE 15 "Total Sales",
Report
If you specify either a SKIP clause or the slash symbol (/) within a print-list, ENFORM
advances one or more lines before printing the rest of the 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:
AT START PRINT "End of Report for" SKIP "Region " regnum,
End of Report for
Region 1
058057 Tandem Computers Incorporated
Total Sales
Clauses

AT START PRINT Clause

5–29