FIND

This primary command finds the next occurrence of a character string in the data being browsed. When the string is found, Z Data Tools positions the cursor at the beginning of the string and, if necessary, scrolls the data to bring the string into view.

There are two forms of the FIND command. The first form is simply FIND string. The second form, as detailed below, is only available when zoomed on a disk track.
Read syntax diagramSkip visual syntax diagram
Syntax

>>-+-FIND-+--+-+-----+--string-+--+---------------+------------->
   +-F----+  | '-ALL-'         |  '-col1-+------+-'   
   '-⁄----'  '-string--ALL-----'         '-col2-'     

>--+----------------+--+----+----------------------------------><
   '-label1--label2-'  +-X--+   
                       +-EX-+   
                       '-NX-'   

Parameters
ALL
Searches forwards from the top of data. Same as FIRST, except that ALL also displays the total number of occurrences of string in the records searched.
Note: Suppressed or not-selected records that are hidden from display or represented by shadow lines are not searched, even when you specify ALL.
col1
The first column to be included in the range of columns to be searched. Must be greater than or equal to 1, and less than or equal to the maximum record length.
col2
The last column to be included in the range of columns to be searched. Must be greater than or equal to col1 and less than or equal to the maximum record length. If not specified, the last column of the record is used.
EX
Excluded records only.
label1
Label identifying the start of a range of records. The label must start with a period (.) followed by one to four alphabetic characters (no numeric or special characters). Labels starting with the letter “Z” indicate an editor-assigned label.
label2
Label identifying the end of a range of records. The label must start with a period (.) followed by one to four alphabetic characters (no numeric or special characters). Labels starting with the letter “Z” indicate an editor-assigned label.
NX
Non-excluded records only.
X
Same as EX.
string
Search string. Can be:
  • A character string not starting or ending with a quotation mark and not containing any embedded blanks or commas. The case of the string is ignored. Uppercase and lowercase representations of the same character match. For example, Mixed matches MIXED.
  • A character string enclosed in quotation marks. The string can contain blanks and commas. The case of the string is ignored. For example, 'Exact string' matches 'exact string'.
  • C followed by a character string enclosed in quotation marks (C'Frog'), or a character string enclosed in quotation marks followed by C ('Frog'C). The string can contain blanks and commas. The string must match exactly (including case). For example, C'Exact string' does not match C'exact string'.
  • X followed by a hexadecimal string enclosed in quotation marks (X'C1C2'), or a hexadecimal string enclosed in quotation marks followed by X ('C1C2'X).

To find the next occurrence of the same string, press the RFind function key (F5), or enter the FIND command with no parameters. A message is displayed if the string cannot be found.