DEBUG SEARCH — VMS FORTRAN_5.2
Directs the debugger to search the source code for the specified
string and to display the source line or lines containing an
occurrence of the string.
The range parameter designates a program region to be searched.
The string parameter specifies the source code characters for
which to search. If the string parameter is not specified, the
debugger uses the last specified search string, that is, the
string parameter specified in the last SEARCH command.
Format:
SEARCH[/qualifier[/qualifier]] range string
Additional information available:
Examples
To see the first occurence of string "XYZ" in module M:
DBG> SEARCH M XYZ
module M
10: XYZ := 3
To see the next occurence of string XYZ in module M:
DBG> SEARCH
module M
13: XYZ := XYZ + 1
To see all occurences of string "XYZ" in module M:
DBG> SEARCH/ALL M XYZ
module M
10: XYZ := 3
13: XYZ := XYZ + 1
Parameters
range
Limits the debugger's search for occurrences of the string to
specified program regions. These program regions may be given in
any of the specified formats (see range-format for more detail).
string
Specifies the string in the source code for which to search. The
string parameter may be enclosed in quotation marks (") or in
apostrophes ('), or may be specified without delimiters. If the
string is delimited by either quotation marks or apostrophes, it
may contain spaces and tabs, as well as any alphanumeric or
special characters.
Additional information available:
range-format
o MODNAME indicates a search of the specified module from line
number 0 to the end of the module
o MODNAME\LINE-NUM indicates a search of the specified module
from the specified line number to the end of the module
o MODNAME\LINE-NUM:LINE-NUM indicates a search of the specified
module beginning at the line number specified to the left of
the colon and ending at the line number specified to the right
of the colon
o LINE-NUM indicates a search of the module designated by the
current scope setting from the specified line number to the
end of the module
o LINE-NUM:LINE-NUM indicates a search of the module designated
by the current scope setting beginning at the line number
specified to the left of the colon and ending at the
line-number to the right of the colon
o NULL (that is, no entry) indicates a search of the same module
as that from which a source line was most recently displayed
(as a result of either a TYPE or an EXAMINE/SOURCE command),
beginning at the first line following the line most recently
displayed and continuing to the end of the module
Qualifiers
Additional information available:
/ALL
Specifies that the debugger search for all occurrences of the
string in the specified range and display every line containing
an occurrence of the string.
/IDENTIFIER
Specifies that the debugger search for an occurrence of the
string in the specified range but display the string only if it
is bounded on either side by a character that cannot be part of
an identifier in the current language.
/NEXT
Specifies that the debugger search for the first occurrence of
the string in the specified range and only display the line
containing this occurrence. This is the default.
/STRING
Specifies that the debugger search for and display the string as
specified, and not interpret the context surrounding an
occurrence of the string, as it does in the case of /IDENTIFIER.
This is the default.