LIST

Display lines of source code

WSupported on Windows
USupported on Unix
VSupported on OpenVMS

 

LIST
LIST line#
LIST line# count
LIST/ALL

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.

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#.

The following example lists five lines beginning at the current line.

LIST . 5