HLASM Language Reference

TITLE Instruction
PGM1 The First Heading Page 3
Active Usings: None
Loc Object Code Addr1 Addr2 Stmt Source Statement HLASM R5. 24/6/11 17.48
4 2 PGM1 CSECT LRM2
R:C 3 USING PGM1,12 Assign the base register
PGM1 The Next Heading Page 4
Active Usings: PGM1,R12
Loc Object Code Addr1 Addr2 Stmt Source Statement HLASM R5. 24/6/11 17.48
18CF 5 LR 12,15 Load the base address
6 &VARSYM SETC 'Value from Variable Symbol'
7 TITLE 'The &VARSYM'
PGM1 The Value from Variable Symbol Page 5
Active Usings: PGM1,R12
Loc Object Code Addr1 Addr2 Stmt Source Statement HLASM R5. 24/6/11 17.48
2 7FE 8 BR 14 Return
9 END LRM9
Figure 60. Sample Program Using TITLE Instruction
Page Ejects
Each inline TITLE statement causes the listing to be advanced to a new page
before the heading is printed unless it is preceded immediately by one of the
following:
A CEJECT instruction
An EJECT instruction
A SPACE instruction that positions the current print line at the start of a new
page
A TITLE instruction
If the TITLE statement appears in a macro or contains a variable symbol and
PRINT NOGEN is specified, the listing is not advanced to a new page.
Valid Characters
Any printable character specified appears in the heading, including spaces.
Double-byte data can be used when the DBCS assembler option is specified. The
double-byte data must be valid. Variable symbols are allowed. However, the
following rules apply to ampersands and single quotation marks:
The DBCS ampersand and single quotation mark are not recognized as
delimiters.
A double-byte character that contains the value of an EBCDIC ampersand or
single quotation mark in either byte is not recognized as a delimiter when
enclosed by SO and SI.
A single ampersand initiates an attempt to identify a variable symbol and to
substitute its current value.
A pair of ampersands is printed as one ampersand.
A pair of single quotation marks is printed as one single quotation mark.
An unpaired single quotation mark followed by one or more spaces simply ends
the string of characters printed. If a non-space character follows an unpaired
single quotation mark, the assembler issues an error message and prints no
heading.
Chapter 5. Assembler Instruction Statements 217