.TI     TItle

Syntax:

        TI  [S] [,[expression [,title]]]

See also:

.EJ   .LM   .PG  

Function:

In Version 2 of the SB-Assembler the .TI directive is used to set the page length and title for each page in the list file.
Version 3 of the SB-Assembler doesn't support any page formatting, therefore the .TI is missing here.

Explanation:

If only the .TI directive is given on a source line, or when the text following the .TI directive is more than 9 spaces away from it, all default parameters are set. This means that the Single Sheet mode is switched off, the page length is set to infinite and the title is erased. The infinite page length implies that no form feeds are inserted after a certain number of lines.
Please note that these are the default settings for list files. So these settings also apply if no .TI directive is present in your source file.

The Single Sheet mode is selected if the first character of the operand field is a single S, or an S followed by a comma. This means that the SB-Assembler will wait for the operator to insert a new page in the printer when the previous page is full. The user is prompted to press almost any key when the new page is loaded in the printer with the message: Insert new sheet and press any key.
The SB-Assembler will not ask you to insert the first sheet of paper though. So the operator should provide the first sheet before starting the SB-Assembler.
Please note that this function was included when ink jet and laser printers were not as common as they are today. The Single Sheet mode is a bit outdated nowadays.

The expression defines the number of lines that are to be printed on a page in the list file. The minimum number of lines is 8, the maximum number is 254. All other values result in a Out of range error to be reported.
A form feed is generated every time the number of lines reaches the pre-set value, starting a new page. The title and a page number is printed above each new page.

The title can be any piece of text, up to 127 characters in length. The title is treated as literal text, where case and spaces are not changed. The title is always printed above each new page in the list file. It does not matter if that page is started automatically or was forced by the .PG directive.
The .TI directive will force a new page to be started with the new title printed above it.

The title may be changed as often as you want during the assembly. Every time you change the title, using the .TI directive, a new page is started with the new title above it.

The .TI directive is never listed in a listing file itself. Therefore it does not accept comments. Everything following the title will be treated as part of the title itself.

The .TI directive is only parsed during pass 2 of the assembly process. Errors will not be discovered during pass 1.

Examples:

; Set the list page length to 55 lines, without a title
         .TI  55

; Set the page length to 55 lines, with title
         .TI  55,This is the title

; Set the page length to 40 lines, with title and
; Single Sheet mode
         .TI  S,40,New title

; Switch off auto page mode and titles.
         .TI