Reporting : Native reporting system : Reporting system command language : HEADER subcommand
  
HEADER subcommand
Description
Of the specifications in a SETTING command, the most frequently used specification is HEADER. Up to four header lines can be printed on a page. Each header requires a new HEADER specification line, its line number, and the text to be printed.
The structure of this statement is:
SETTING { HEADER header-number "header text" }
The HEADER subcommand statement must conform to the following rules:
If more than one character string is included in a single HEADER, the strings must be separated by commas.
The character string must always be enclosed in quotation marks, whether or not it contains embedded white spaces.
Note The HEADERFONT subcommand is the only command that can be used to specify a specific user-defined font to be used for a header. Only one HEADERFONT command is permitted in each report block.
See also HEADERFONT subcommand and HEADERSPACE subcommand.
Examples – HEADER subcommand
The following are examples of HEADER specifications:
SETTING { HEADER 2 "Date", " ", "Time", " ", "Page #pg#" }
SETTING { HEADER 3 "Library Modernization Project" }
Creating a header with multiple strings enables the user to include a date, time, and page number in the same line as the report title. System Architect substitutes the current date, time, and correct page number when the Reporting System-supplied DEFINE identifiers are used. These identifiers are: Date, Time, and #pg#.
At run time, the #pg# identifier is replaced with a numeric page number, up to four digits. The space strings (" ") is used to separate the date, time, and page fields.
System Architect automatically creates HEADER 1 with the report’s name, and places it at the top of each page. The following statement overrides the default heading, and prints the pages without any header:
SETTING { HEADER 1 "" }
A user-specified heading can also be used to override the default.
The space after headers is controlled by the HEADERSPACE subcommand, and tab characters are used for header justification (see Justifying headers and footers for details).
See Headers and Footers dialogs (in Printing a header and footer on the report page) for instructions on using the Report Editor to specify a header.
Parent topic
Reporting system command language