Use the FIND command on panels
Most RMGR panels that display tables support the FIND and >RFIND commands. You can use these commands to search for a specified character string in the table.
RMGR performs the FIND command as follows:
- RMGR searches all columns of a row. To be a match for the search string, the data must be contained entirely within a column; it cannot span multiple columns of the table. RMGR searches for one occurrence of the data for each row.
- If RMGR finds a match for the search string in a row, it scrolls the table to place the row at the top of the display (if necessary), and it places the cursor at the beginning of the column that contained the match. If the row is already visible, RMGR does not scroll the table.
- If RMGR does not find the search string, it does not scroll the table. It places the cursor on the command line and issues a message to explain that the search failed.
After you enter the first FIND command in the RMGR session, you can use the >RFIND command to repeat the FIND command with the last specified search string, in the same direction as the last FIND command. The > character is required to overcome an ISPF limitation.
The >RFIND command has no operands. You can assign the >RFIND command to a program function key for more convenient use. See the ISPF documentation for information about assigning commands to program function keys.
Syntax
The syntax of the FIND command follows:
Start the command with the verb FIND or its abbreviation F. After the verb, specify the character string to search for, using the following guidelines. You can also include a directional parameter (optional).
- If the string contains one or more blanks, enclose the entire string in single quotes (') or double quotes (').
- If the string contains one or more double quotes ('), enclose the entire string in single quotes (').
- If the string contains one or more single quotes or apostrophes ('), enclose the entire string in double quotes (').
The following directional parameters are valid; the default is NEXT:
Parameter | Action |
|---|---|
NEXT | Find the next occurrence of the specified character string. The search starts with the top row on the current display and proceeds forward. |
PREV | Find the previous occurrence of the specified character string. The search starts with the bottom row on the current display and proceeds backward. |
FIRST | Starting at the top of the table, search forward for the first occurrence of the specified character string. |
LAST | Starting at the bottom of the table, search backward for the last occurrence of the specified character string. |
Examples
The following table shows example FIND commands and their results.
Command | Result |
|---|---|
F IMS4 | Search for the character string IMS4, starting at the first column of the first displayed row of the table. |
FIND 'SOME THING' FIRST | Search for the character string SOME THING, starting at the top of the table and searching forward. |
F 'SOMETHING'ELSE' PREV | Search for the character string SOMETHING'ELSE, starting with the bottom row on the current display and searching backward. |
Related topic