MESSAGE PSAM/DAPDB Commands MESSAGE
NAME
message - display the psam or dapdb entry information
SYNOPSIS
message
DESCRIPTION
The message command displays the psam or dapdb entry infor-
mation. The message command resets the currently selected
file, procedure and line, where appropriate, to their values
on entry to psam or dapdb.
The precise form of the entry information depends on the
nature of the DAP program interrupt. Its most general form
is as follows:
<Diagnostic Message>
<Backtrack>
<Errors>
<Line/Procedure Variables>
<Displayed Variables>
<Source Line>
End of Report
The components of the entry information are described indi-
vidually below:
<Diagnostic Message>
Describes briefly the type of program interrupt
which caused entry to psam or a dump of the DAP
state and indicates the point in the executing
program at which execution halted. Examples of
program interrupts are pause statements, break-
points and run-time errors.
<Backtrack>
Gives details of the procedures currently on the
stack. The form of the display is identical to
that of the backtrack command.
<Errors> Displays the mode and location of the current
unsuppressed computational error, if any.
Following an unsuppressed scalar error, this
report is simply Scalar Error. Following
unsuppressed vector and matrix errors a logical
AMT Release 4.1S Last change: 8th Jan 1991 1
MESSAGE PSAM/DAPDB Commands MESSAGE
pattern, in which .TRUE. values indicate error
positions, is displayed.
The size of the error pattern is determined by the
size of the DAP. For vector errors, up to edge-
size squared elements can be displayed; for matrix
errors, up to edge-size rows by edge-size columns
can be displayed. The error pattern is annotated
to indicate which elements of the vector or matrix
have caused the error.
<Line/Procedure Variables>
Following a computational error and subject to the
run-time diagnostic level, the -d flag to dapopt
[see DAP Series: Program Development under UNIX
(man003), Section 3.4], prints the FORTRAN-PLUS
variables on the current line or all variables in
the current FORTRAN-PLUS procedure.
<Displayed Variables>
Prints any variables in the display string as
defined by the display command.
<Source Line>
Displays the current source line if execution
halted in a FORTRAN-PLUS procedure. If execution
halted in a user-written APAL procedure and the
next instruction is also in a user-written APAL
procedure, displays both instructions. Otherwise,
displays the last user-written instruction.
SEE ALSO
backtrack, display, errors, file, list, procedure, set
AMT Release 4.1S Last change: 8th Jan 1991 2