Declaring report title statements

!title

Declare title statements


SYNTAX

!title {
 statements
}

Declare a block of statements to be executed once only, at the start of the report before the first record is read, but after the !init section. Any valid Sculptor command, except goto, may be used within the statements.

Automatic new page checking is performed if the !title statements include print commands.

NOTES

  • The !init section is similar to !title except that automatic page checking is not performed.

  • If the startrec command (which defines the first record to be read from the driving file) is used, it must be placed within the !init or !title statements.

  • Placing the main body of the program code in subroutines or functions called from within the !title statements effectively allows a program to bypass the normal driving logic. There are occasions when the driving logic is not suitable for the task to be performed. Note however that at least one main statement must always be included. See Report driving logic.

  • If the !title section consists of a single statement the braces may be omitted and the statement placed on the same line as the !title command.

  • Only one !title section may be defined.


EXAMPLE

!title {
     print tab(5); sys.Date;
     print tab(28); PSC_DOUBLE_WIDTH;
     print "COMPLAINTS by DATE RECEIVED";
     print PSC_SINGLE_WIDTH;
     print
}

RELATED TOPICS

Reports

!final

!footnote

!heading

!init