HLASM: V1R6 Language Ref

TITLE instructionv Provides headings for each page of the source and object section of the assemblerlisting. If the first statement in your source program is an ICTL instruction or a*PROCESS statement then the title is not printed on the first page of the Sourceand Object section, because each of these instructions must precede all otherinstructions.v Identifies the assembly output records of your object modules. You can specifyup to 8 identification characters that the assembler includes as a deck ID in allobject records, beginning at byte 73. If the deck ID is less than 8 characters, theassembler puts sequence numbers in the remaining bytes up to byte 80.►►nameTITLE title_string ►◄nameYou can specify name only once in the source module. It is one of thefollowing:v A string of printable charactersv A variable symbol that has been assigned a string of printable charactersv A combination of the abovev A sequence symbolExcept when the name is a sequence symbol, the assembler uses the first 8characters you specify, and discards the remaining characters without warning.title_stringis a string of 1 to 100 characters enclosed in single quotation marksIf two or more TITLE instructions are together, the title provided by the lastinstruction is printed as the heading.Deck ID in object recordsWhen you specify the name, and it is not a sequence symbol, it has a specialsignificance. The assembler uses the name value to generate the deck ID in objectrecords. The deck ID is placed in the object records starting at byte 73. It is notgenerated for records produced by the PUNCH and REPRO instructions. The namevalue does not need to be on the first TITLE instruction.The name value is not defined as a symbol, so it can be used in the name entry ofany other statement in the same source module, provided it is a valid ordinarysymbol.GOFF Assembler Option (z/OS and CMS): When you specify the GOFF assembleroption the deck ID is not generated.Printing the headingThe character string denoted by title_string is printed as a heading at the top ofeach page of the source and object section of the assembler listing. The heading isprinted beginning on the page in the listing that follows the page on which theTITLE instruction is specified. A new heading is printed each time a new TITLE214 HLASM: V1R6 Language Ref