FILE PSAM/DAPDB Commands FILE
NAME
file - select source file
SYNOPSIS
file [ <filename> ]
DESCRIPTION
The file command selects a file for use with the list and
stop commands. If a file name is provided a test is made to
ensure that read access to the file can be obtained and if
so the file becomes the current file. If the named file has
been modified since the currently executing program was com-
piled a warning message is displayed but the file is still
selected.
If no argument is supplied the name of the currently
selected file is displayed.
The file command searches for the file <filename> in the
following way. If an absolute file name (one beginning with
'/') or a filename relative to the current working directory
(beginning with './' or '../') or a filename relative to a
user's home directory (beginning with '~/' or '~<user-
name>/') is specified then the named file is sought
directly. Otherwise the file is sought in each of the direc-
tories specified in the current Source_path environment
variable.
Subject to the availability of the relevant diagnostic
information the current file, if found, is selected automat-
ically in the following cases:
If DAP program execution halts within a FORTRAN-PLUS pro-
cedure the source file in which that procedure is defined is
selected. This file is also selected by the message command.
If a FORTRAN-PLUS procedure is selected with one of the pro-
cedure, up, down or top commands the file in which that pro-
cedure is defined is selected.
SEE ALSO
list, message, procedure, set, top
AMT Release 4.1S Last change: 11th May 1989 1