Scans a range of memory locations for all occurrences of a
specified value or string. If you press Ctrl/T while using
the SEARCH command, the system displays how far the search has
progressed.
Format
SEARCH [/qualifier] range [=] {expression | string}
1 – Parameters
range
Location in memory to be searched. A location can be represented
by any valid SDA expression. To search a range of locations, use
the following syntax:
m:n Range of locations to be searched, from m to n
m;n Range of locations to be searched, starting at m and
continuing for n bytes
You must use either an equals sign or a blank to separate range
from expression or string.
expression
Value for which SDA is to search. SDA evaluates the expression
and searches the specified range of memory for the resulting
value. For a description of SDA expressions, type HELP
EXPRESSIONS.
string
Character sequence for which SDA is to search. If all characters
in the sequence are printable characters, the string is enclosed
in quotes, for example,
"My_String". If the character sequence contains nonprintable
characters, it must be specified as a comma-separated list
composed of quoted strings and hexadecimal numbers; for example,
("My_String",0C00,"More") would specify a search for "My_
String<NUL><FF>More". Each hexadecimal number can be no more
than 8 digits (4 bytes) in length. Nonprintable sequences of more
than 4 bytes must be split into multiple hexadecimal numbers.
The maximum length of a search string is 127 bytes. Note that the
quote character itself cannot be included in a quoted string and
must be specified as a hexadecimal number.
2 – Qualifiers
2.1 /IGNORE_CASE
Specifies that searches for strings are not to be case-specific.
(By default, searches look for an exact match.) This qualifier is
ignored for value searches.
2.2 /LENGTH
/LENGTH={QUADWORD | LONGWORD | WORD | BYTE}
Specifies the size of the expression value that the SEARCH
command uses for matching. If you do not specify the /LENGTH
qualifier, the SEARCH command uses a longword length by default.
This qualifier is ignored for string searches.
2.3 /MASK
/MASK=n
Allows the SEARCH command finer qranularity in its matches.
It compares only the given bits of a byte, word, longword, or
quadword. To compare bits when matching, you set the bits in the
mask; to ignore bits when matching, you clear the bits in the
mask. This qualifier is ignored for string searches.
2.4 /PHYSICAL
Specifies that the addresses used to define the range of
locations to be searched are physical addresses.
2.5 /STEPS
/STEPS = {QUADWORD | LONGWORD | WORD | BYTE | value}
Specifies the step factor of the search through the specified
memory range. After the SEARCH command has performed the
comparison between the value of expression or the given string
and memory location, it adds the specified step factor to the
address of the memory location. The resulting location is the
next location to undergo the comparison. If you do not specify
the /STEPS qualifier, the SEARCH command uses a step factor of
a longword for value searches, and a step factor of a byte for
string searches.