Locates a string and displays the section of code where it
occurs.
>>-Find--+--------+--+-string-+--------------------------------->
'-window-' '-*------'
>--+---------------------------+--+----------+-----------------><
'-start-col--+------------+-' +-FIRst----+
'-finish-col-' +-LASt-----+
+-NEXt-----+
'-PREvious-'
- window
- A Disassembly window. Select by a Window Specification or by placing the cursor
in the window.
If omitted, and the cursor is not in a Disassembly window,
uses the first Disassembly window.
- string
- The group of characters being searched for, the search string.
Enclose this search text in quotes if it is numeric or
contains embedded blanks.
Both "…"
and '…' are accepted.
- *
- Use the current search string.
- start-col
- The column at which searching starts.
Integer. If omitted, searching starts from column 1.
- finish-col
- The column at which searching ends.
Integer greater than the start column. If omitted, searching finishes
at column 80.
- FIRST
- Begin search at lowest address, and look for
search string in a forward direction.
- LAST
- Begin search at highest address, and look for
search string in a reverse direction.
- NEXT
- Begin search at current address, and look for search string
in a forward direction.
- PREVIOUS
- Begin search at current address, and look for search string
in a reverse direction.
The function of this command is
essentially the same as the ISPF editor FIND command.
The search begins at the first source line shown on the
screen; the target code, if found, is displayed at the top of
the screen.
Unless otherwise qualified, the search is performed from the current
address, in the direction last specified.
Examples
FIND string
f 'text'
f text
f text
f info first
f init( next
f * prev
f bit( last
find =3 'window 3'
Return codes
- 0
- Operation successful
- 1
- Missing keyword
- 2
- Keyword truncated
- 3
- Keyword unknown
- 5
- Arguments are invalid
- 6
- Specified string was not located or the search was not conducted