TAL Reference Manual

Compiler Directives
TAL Reference Manual—526371-001
16-60
Usage Consideration
Usage Consideration
This directive can appear in the compilation command or anywhere in the source code.
LIST turns the listing setting on for subsequent code. LIST has no effect if SUPPRESS
is in effect. LIST is required by the ABSLIST, CODE, CROSSREF, DEFEXPAND,
FMAP, GMAP, ICODE, INNERLIST, MAP, PAGE, and PRINTSYM directives. To list
cross-references, LIST and NOSUPPRESS must be in effect at the end of the source
file.
NOLIST turns the listing setting off for subsequent code (the LMAP maps, compiler
leader text, error messages, and trailer text still get listed).
PUSHLIST pushes the current listing setting onto the directive stack without changing
the current setting.
POPLIST removes the top value from the directive stack and sets the current listing
setting to that value.
Source Listing
Each line in the source listing consists of:
•
An edit file number
•
A 6-digit octal code address—an instruction offset or a secondary global count
•
One of the following lexical-level values:
•
Nesting level of BEGIN-END items such as structures, substructures, IF
statements, and CASE statements
Examples of LIST Directive
1. This example shows how to suppress listings of system declarations, but not your
own source code, by using NOLIST and LIST:
?NOLIST, SOURCE $SYSTEM.SYSTEM.EXTDECS (
? PROCESS_GETINFO_, PROCESS_STOP_)
?LIST
Lexical Level Meaning
0 Global Level
1 Procedure Level
2 Subprocedure Level