LIST PSAM/DAPDB Commands LIST
NAME
list - display lines from the current file
SYNOPSIS
list [ <linenumber> ] [ , [ <linenumber> ] ]
DESCRIPTION
The list command lists lines from the currently selected
file. If no arguments are supplied list will display the
whole of the current file. Alternatively a subset of the
current file can be displayed by specifying a line number or
start and end line numbers separated by a comma. In addition
line numbers can be specified relative to the current line
by preceding the line number by '+' or '-'. The current line
can be referred to by '.'.
If DAP program execution halts in a FORTRAN-PLUS procedure
the current line is automatically set to the line at which
execution halted, provided that the relevant diagnostic
information is available. Thereafter the current line can be
modified by the list, file, message, procedure, up, down and
top commands as follows:
The list command sets the current line to the last line
displayed.
The file command sets the current line to 1.
The message command sets the current line to the line at
which execution halted.
The procedure, up, down and top commands set the current
line to the the currently executing line in the selected
procedure provided that the procedure is active. If the pro-
cedure is not active the current line is set to 1.
The message, procedure, up, down and top commands only
affect the current line if the selected procedure is a
FORTRAN-PLUS procedure for which diagnostic records are
avaliable.
The displayed form of a source line can be indicated using
the following example:
14>B1 : ivec(3) = 2
The first field ('14') is the line number. The next field
('>') is used to indicate the line at which execution
halted. It is blank everywhere except for that line. The
next field ('B1') indicates the breakpoint status of this
line. In this case, 'B1' indicates that the breakpoint with
reference number 1 is at this location and is currently
AMT Release 4.1S Last change: 11th May 1989 1
LIST PSAM/DAPDB Commands LIST
enabled. Disabled breakpoints are indicated with the letter
b in lower case and if no breakpoint is set the field is
blank. The colon is a separator common to all lines and the
area to the right of the colon contains the source line.
If the source file has been modified since the currently
executing program was compiled a warning message is printed.
Furthermore no execution halt or breakpoint information is
given in the listing.
EXAMPLES
list list the whole of the current
source file.
list 10,20 list lines 10 to 20 of the current
source file.
list -3,+6 list from 3 lines before to 6 lines
after the current line.
list ., list from the current line to the
end of the current source file.
SEE ALSO
breakpoints, file, message, procedure, top
AMT Release 4.1S Last change: 11th May 1989 2