Enform Plus Reference Manual

Statements

Enform Plus Reference Manual—422684-001

4-5

AT START Statement

The AT START statement allows you to specify information that is printed just before

the first set of column headings for all subsequent reports in the current session unless

canceled or reset by another AT START statement or overridden by an AT START

clause. (See the AT START PRINT Clause

on page 5-28.) The syntax of the AT START

statement is:

print-list

can contain any combination of literals, FORM, SKIP, SPACE, or TAB clauses. The

print-list can also contain the following elements that can be modified by AS,

AS DATE, AS TIME clauses: field names, arithmetic expressions, IF/THEN/ELSE

clauses, System Variable clauses, JULIAN-DATE clauses, TIMESTAMP-DATE

clauses, TIMESTAMP-TIME clauses, user variables, or 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.

If you specify both an AT START statement and a TITLE or SUBTITLE statement, the

AT START information is printed after the title or subtitle. The AT START statement

differs from the TITLE statement in that the AT START information is printed only on

the first page of a report while the title or subtitle is printed on every page of a report.

Specifying a Field Name in an AT START Statement

If you specify a field name within the print-list of an AT START statement,

Enform Plus prints the same field value as in the first row of the report. A field name

appearing within the print-list of an AT START 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 AT START information begins printing in the same column position as

the leftmost report column. By using SPACE or TAB clauses as the first element of the

print-list, you can override 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 the symbol / (slash) within a print-list, the

printer advances one or more lines before printing the rest of the AT START 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

AT START [ PRINT print-list [ CENTER ] ] [ ; ]