.TITLE

Specify the listing page header

WTSupported in traditional Synergy on Windows

 

USupported on UNIX
VSupported on OpenVMS
.TITLE[  header]

Arguments

header

(optional) The alpha expression or text to be used as the listing page header (up to 65 characters).

Discussion

The .TITLE compilation control directive specifies the listing page header.

The .TITLE directive is the first source line listed on a new page. If the listing is already at the beginning of a page when .TITLE is encountered, the compiler won’t generate a new page.

The compiler uses the specified header string or text in the listing page header for all pages until it encounters a new .TITLE directive. The header string is moved to the listing page header according to the rules for moving alpha data to an alpha destination. (See Assignment statements for more information about these rules.) If header is not specified, the listing page header is filled with spaces.

Examples

In the following example, the compiler generates a new page in the listing, the page header is “This is the title,” and this source line is the first line of the new page.

.title "This is the title"

In the following example, the compiler generates a new page, the page header is blank, and this source line is the first line on a new page.

.title

In the following example, the compiler generates a new page, the page header is “Program name: A_PROG,” and this source line is the first line on the new page.

.title "Program name: A_PROG"