FIND

Used to locate a text string in the current display.

Figure 1. Syntax

where:

t: Indicates that a text string is being searched for. Text strings are non-case-sensitive in all displays, except for the Dump Storage display where all strings are case-sensitive.
c: Indicates that a character string is being searched for. Character strings are case-sensitive.
x: Indicates that a hexadecimal value is being searched for. An even number of digits must be specified.
string: The character string to be searched for. If the string includes blanks, quotes, or tokens that could be mistaken for a FIND command keyword (for example, if searching for the string NEXT), the string must be enclosed in either single quotes or double quotes. The ending quote must be of the same type (single or double) as the starting quote. All other quotes are considered part of the search string.
*: Indicates that the same string as previously searched for is to be used.
NEXT: Indicates that the search should start at the first position after the current cursor location and proceed ahead to find the next occurrence of the string. NEXT is the default.
PREV: Indicates that the search should start at the first position before the current cursor location and proceed backwards to find the previous occurrence of the string.
FIRST: Indicates that the search should start at the top of the display and proceed ahead to find the first occurrence of the string.
LAST: Indicates that the search should start at the bottom of the display and proceed backwards to find the last occurrence of the string.
ALL: Indicates that the search should start at the top of the display and proceed ahead to find all occurrences of the string. A message in the upper-right corner of the display shows the number of occurrences found.
CHARS: Indicates that any occurrence of the sequence of characters searched for is considered a match. This value is the default.
PREfix: Indicates that one or more blank or attribute characters must precede the sequence of characters searched for in order to be considered a match. Either PRE or PREFIX can be specified.
SUFfix: Indicates that one or more blank or attribute characters must follow the sequence of characters searched for in order to be considered a match. Either SUF or SUFFIX can be specified.
WORD: Indicates that one or more blank or attribute characters must surround the sequence of characters searched for in order to be considered a match.

FIND command: differences between display types

The FIND command that is issued from the Dump Storage display behaves differently to the FIND command that is issued from all other displays. (The Dump Storage display is invoked by using the SHOW command, or by placing the cursor on an address point-and-shoot field and pressing Enter.)

Table 1. FIND command: differences between display types
FIND command in Dump Storage display	FIND command in all other displays
All character strings are case sensitive, regardless of whether T'text' or C'text' or neither is used.	Character string case sensitivity is determined by the use of T'text' (default) or C'text'.
Only the minidump, and any associated MVS™ dump, is searched for the target string; storage descriptions, headings and similar formatted character-based text is not included in the search. However, the entire minidump and MVS™ dump is included in the search, not just the currently displayed address range.	Only the formatted character-based text, including any hex-dump formatting, is searched for the target string. No searching of the minidump or MVS™ dump is performed.
When searching for hexadecimal values in the minidump, use the X'text' format.	When searching for values in hex-formatted storage, use character string format.
The FIND command target can be split over multiple lines in the formatted display, but can still be found.	The FIND command target cannot be found if split over multiple lines in the formatted display.

Dump Storage display FIND ALL command progress

If the FIND string ALL command is issued from the Dump Storage display, and processing has not completed within approximately 10 seconds, then the FIND ALL Progress display is shown. An example of this display is shown in Command progress display.

Figure 2. Command progress display

┌─────────────────────────────────────────────────────────────────────────────┐
│ FIND ALL Progress                                   Lin   CHARS X'ef' found │
│ Command ===> ___________________________________________  Scroll ===> CSR   │
│                                                                             │
│ Number of matches so far. : 201,967                                         │
│ Address of last match . . : 1639801C                                        │
│                                                                             │
│ Press ENTER to keep searching or PF3/PF12 to abort.                         │
│                                                                             │
│ Seconds before next progress                                                │
│   display . . . . . . . . . : 10 (1-99 or 0 to disable)                     │
│                                                                             │
│ *** Bottom of data.                                                         │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
   00000030       +30  00000000 00000000 7FFFF000 7FFFF000 *........".0.".0.*  
   00000040       +40  00000000 00000000 00000000 00FD7D08 *..............'.*  
   00000050       +50  00000000 00000000 00000000 00000000 *................*  
         Lines 00000060-00000070 (X'20' bytes) same as above                   
   00000080       +80  00000000 00001005 00020001 00040016 *................*  
   00000090       +90  00000001 000E0000 00000000 00000000 *................*  
   000000A0       +A0  00000001 00000000 000001EF C17FF400 *............A"4.*  
   000000B0       +B0  00000000 00000F1F 00010087 027361C0 *...........g../{*  
   000000C0       +C0  18000000 00000000 FBEBFFFB FEFFFF7C *...............@*  
   000000D0       +D0  07FCE000 00000000 F7003B98 00800000 *..\.....7..q....*

The number of matches found so far is shown, along with the storage address of the most recent match.

To continue the search for matches, press Enter. Optionally, specify a different number of seconds between 1 and 99 before the next progress display is shown. Specify the value 0 to disable any further progress displays.

To abort the search, press PF3 or PF12.