LIST
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
|
LIST LIST line# LIST line# count LIST/ALL
Arguments
line#
Sets the current source line to the specified line number and displays 12 lines of code. Line# can either be the number of a source line or a period (.), which indicates the current line.
line# count
Sets the current source line to the specified line number and displays the number of lines of code specified by count. Line# can either be the number of a source line or a period (.), which indicates the current line.
/ALL
Displays all source lines within the current routine.
Discussion
The LIST command displays lines of code beginning at the current source line. If you don’t specify any arguments, LIST displays 12 lines.
The current source line is the line at which the debugger was entered. If you specify a line number rather than a period for the line# argument, the specified line becomes the current line. The current debug line is marked with a right angle bracket (>) in the display.
All nonprinting alpha field data is displayed as periods (.), except BS, HT, LF, VT, FF, and CR.
You cannot list any lines that come before the start of a routine or after the end of the routine. Therefore, the command
LIST 1
always lists from the beginning of the routine, even if the first line in the routine is line number 1255, for example. Likewise, the following command always lists the last line of the routine, even if 99999 is outside of the possible range of line numbers:
LIST 99999
Program routines that are .INCLUDEd display the line number in the form source_file#.line#.
Examples
The following example lists five lines beginning at the current line.
LIST . 5