Enform Plus Reference Manual

Clauses
Enform Plus Reference Manual—422684-001
5-28
AT START PRINT Clause
AT START PRINT Clause
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:
print-list
can contain 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
.
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.
Specifying a Field Name in an AT START PRINT Clause
If you specify a field name within a print-list of an AT START PRINT clause,
Enform Plus 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 Plus in effect adds it with a NOPRINT clause.
Spacing Considerations
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 Total Sales
If you specify either a SKIP clause or a slash (/) within a print-list, Enform Plus
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)
AT START PRINT print-list [ CENTER ]