Establishes default qualifiers (/ALL or /NEXT, /IDENTIFIER or
/STRING) for the SEARCH command.
Format
SET SEARCH search-default[, . . . ]
1 – Parameters
search-default
Specifies a default to be established for the SEARCH command.
Valid keywords (which correspond to SEARCH command qualifiers)
are as follows:
ALL Subsequent SEARCH commands are treated as SEARCH/ALL,
rather than SEARCH/NEXT.
IDENTIFIER Subsequent SEARCH commands are treated as
SEARCH/IDENTIFIER, rather than SEARCH/STRING.
NEXT (Default) Subsequent SEARCH commands are treated as
SEARCH/NEXT, rather than SEARCH/ALL.
STRING (Default) Subsequent SEARCH commands are treated as
SEARCH/STRING, rather than SEARCH/IDENTIFIER.
2 – Description
The SET SEARCH command establishes default qualifiers for
subsequent SEARCH commands. The parameters that you specify with
SET SEARCH have the same names as the qualifiers for the SEARCH
command. The qualifiers determine whether the SEARCH command:
(1) searches for all occurrences of a string (ALL) or only the
next occurrence (NEXT); and (2) displays any occurrence of the
string (STRING) or only those occurrences in which the string is
not bounded on either side by a character that can be part of an
identifier in the current language (IDENTIFIER).
You can override the current SEARCH default for the duration of
a single SEARCH command by specifying other qualifiers. Use the
SHOW SEARCH command to identify the current SEARCH defaults.
Related commands:
SEARCH
(SET,SHOW) LANGUAGE
SHOW SEARCH
3 – Example
DBG> SHOW SEARCH
search settings: search for next occurrence, as a string
DBG> SET SEARCH IDENTIFIER
DBG> SHOW SEARCH
search settings: search for next occurrence, as an identifier
DBG> SET SEARCH ALL
DBG> SHOW SEARCH
search settings: search for all occurrences, as an identifier
DBG>
In this example, the SET SEARCH IDENTIFIER command directs
the debugger to search for an occurrence of the string in
the specified range but display the string only if it is not
bounded on either side by a character that can be part of an
identifier in the current language.
The SET SEARCH ALL command directs the debugger to search for
(and display) all occurrences of the string in the specified
range.