FIND primary command — search for a specified value

Use the FIND primary command to search through all dump output for a single occurrence of a specified value.

Syntax

The syntax of the FIND primary command varies depending on whether you are in the BROWSE option or any other option except TUTORIAL.

Syntax for the BROWSE Option

 { FIND }  [ relational-operator ]
 { F    }
             value
           [ BOUNDARY(bdy [,index]) ]
           [ BREAK | NOBREAK ]
           [ MASK(mask) | NOMASK ]
           [ FIRST    ]
           [ LAST     ]
           [ NEXT     ]
           [ PREVIOUS ]

Syntax for searching the IPCS output stream

 { FIND }  [ relational-operator]
 { F    }
             value
           [ col [ col ]]
           [ ALL      ]
           [ FIRST    ]
           [ LAST     ]
           [ NEXT     ]
           [ PREVIOUS ]
           [ X  ]
           [ NX ]

Parameters
relational-operator
Specifies one of the following symbolic or programming operators to be used with the value operand:
```
[<|LT|<=|LE|¬>|NG|=|EQ|>=|&cont;
GE|¬<|NL|>|GT|¬=|NE]
```
Note: If a programming relational-operator is entered alone, such as FIND EQ, IPCS interprets EQ not as a search value but as an operator and does not perform a search. Enter the command with a relational-operator and a value. For example, FIND EQ EQ causes IPCS to search for an occurrence of EQ.
value

Specifies the general value that IPCS is to search for. See General values for more information, the syntax, and examples.

col [col ]

Specifies that FIND is to limit the search to specified columns. When entering a single column number, the value must start in the specified column. When entering a pair of column numbers, indicating the first and last columns to be searched, the string is found if it is completely contained within the designated columns. The column range is 1 through 250. The default is 1.

BOUNDARY(bdy[,index])

Specifies that IPCS is to divide storage into strings bdy bytes in length. The address of each string is divisible by bdy. FIND performs only one comparison with data whose first byte lies within any string. The abbreviation BDY is accepted for this parameter.
The index value designates which byte in the string FIND is to select. The index can be a single value or a range, with the first and last values separated by a colon. For example:
BDY(1) or BDY(1,1) or BDY(1,1:1)

FIND examines each byte.

BDY(2) or BDY(2,1) or BDY(2,1:1)

FIND performs comparisons with strings originating at even-numbered addresses.

BDY(2,2) or BDY(2,2:2)

FIND performs comparisons with strings originating at odd-numbered addresses.

BDY(5,5) or BDY(5,5:5)

FIND performs comparisons only with strings originating at addresses 4 bytes past an address divisible by 5.

BDY(7,6:7)

FIND performs comparisons only with strings originating at addresses 5 or 6 bytes past an address divisible by 7.

BDY(8) or BDY(8,1) or BDY(8,1:1)

FIND performs comparisons only with strings aligned on doubleword boundaries.

Both bdy and index can be 1 through 2 raised to the thirty-first power 2³¹ and can be expressed in decimal, hexadecimal (X'xxx...'), or binary (B'bbb...') notation.

When you specify this option, it remains in effect until you specify a new search argument or you override this option. If you enter a new search argument and omit BDY, the default is BDY(1,1).

BREAK

NOBREAK

BREAK specifies that FIND is to stop processing if it cannot retrieve storage from the dump to continue the search. This happens if the required storage was not acquired through the GETMAIN macro or the required storage is not contained in the dump.
NOBREAK specifies that FIND is to continue processing if it cannot retrieve storage from the dump. FIND continues the search with the next available address in the dump.

When you specify this option, it remains in effect until you specify a new search argument or you override this option. If you enter a new search argument and omit NOBREAK, the default is BREAK.

MASK(mask)

NOMASK

MASK defines a value that is logically ANDed with both operands before performing the comparison. The mask must be the same size as the data items being compared. The mask is specified using the same value notation used for either operand. See Literal values for more information.
NOMASK suppresses masking.

ALL

FIRST

LAST

NEXT

PREVIOUS

ALL specifies that a search for all occurrences is to be done. A message "n matches found" will display the number of matches found. Enter the HELP primary command immediately to see a longer message showing both the search argument and the number of matches to be shown.
FIRST specifies that a search for the first occurrence of the value is to be done. The search starts at the beginning of the displayed report or address space; the search finishes at the end of the report or address space.

LAST specifies that a search for the last occurrence of the value is to be done. The search starts at the end of the displayed report or address space; the search finishes at the beginning of the report or address space.

NEXT specifies that a search for the next occurrence of the value is to be done. The search starts at the beginning of the line being displayed (if the cursor is on the command/option line), or at the cursor location (if the cursor is within the data display area). The search finishes at the end of the displayed report or address space.

PREVIOUS specifies that a search for the previous occurrence of the value is to be done. The search starts at the end of the line preceding the first line being displayed (if the cursor is on the command/option line), or at the cursor location (if the cursor is within the data display area). The search finishes at the beginning of the displayed report or address space. The abbreviation PREV is accepted for this parameter.
Usage notes
- FIND can be used in all options except TUTORIAL. Note that the syntax varies depending on which option you are using.
- The starting point for the search initiated by the FIND primary command depends on the command parameters that control the direction of the search (FIRST, LAST, NEXT, PREVIOUS) and on the position of the cursor.
- Use the RFIND primary command (PF key 5 or 17) to continue the search for the specified argument.
Example 1: Search for a value in columns 1 through 9.
- Action
```
COMMAND ===> find abc 1 9
```
- Result
  FIND searches for the value abc only in columns 1 through 9. When found, the value is intensified.

Example 2: Find a search argument repeatedly.

Action

The following screens depict use of the FIND and RFIND primary commands. Figure 1 shows the FIND command entered on the COMMAND line to search through the display and find the first occurrence of the search argument “dsp”.

Figure 1. Using FIND on the Dump Display Reporter Panel

 IPCS OUTPUT STREAM ------------------------------------------ LINE 0 COLS 1 78
---------------------
|COMMAND ===> f dsp_ |                                 SCROLL ===> CSR
---------------------
 ****************************** TOP OF DATA ***********************************

     * * * *   K E Y F I E L D S   * * * *
 JOBNAME RASP
     SELECTED BY: CURRENT

  ASCB: 00F09E00
     FWDP..... 00F09C00  ASID..... 0003      TRQP..... 80F09301
     CSCB..... 00F1D3C8  TSB...... 00000000  AFFN..... FFFF
     ASXB..... 00AFDF00  DSP1..... 00        FLG2..... C4
     SRBS..... 0000      LOCK..... 00000000  ASSB..... 01AB6D00

  TCB: 00AFE178
     CMP...... 00000000  PKF...... 00        LMP...... FF        DSP...... FF
     TSFLG.... 00        STAB..... 00AFD300  NDSP..... 00000000
     JSCB..... 00AFDD84  BITS..... 00000000  DAR...... 00
     RTWA..... 00000000  FBYT1.... 00
     Task non-dispatchability flags from TCBFLGS4:
      Top RB is in a wait

  PRB: 00AFDD60
     WLIC..... 00020001  FLCDE.... 00C12630  OPSW..... 070C1000  810D7C20

Result

Figure 2 shows the results of the FIND command. IPCS highlights the line that contains the search argument, positions the cursor at the beginning of the search argument, and displays a message in the upper right corner of the display indicating in which line and column the argument was found.

Figure 3 is a result of pressing PF5 to invoke the RFIND command. This screen displays the next occurrence of the search argument following the position of the cursor. Notice that the display message is changed, reflecting a newly found search argument.

Figure 2. Result of Using FIND

IPCS OUTPUT STREAM ----------------------------------- FOUND IN LINE 16 COL 17
COMMAND ===>                                                  SCROLL ===> CSR
 ****************************** TOP OF DATA ***********************************

     * * * *   K E Y F I E L D S   * * * *
 JOBNAME RASP
     SELECTED BY: CURRENT

  ASCB: 00F09E00
     FWDP..... 00F09C00  ASID..... 0003      TRQP..... 80F09301
     CSCB..... 00F1D3C8  TSB...... 00000000  AFFN..... FFFF
----------------------------------------------------------------------
|    ASXB..... 00AFDF00: DSP1..... 00        FLG2..... C4            |
----------------------------------------------------------------------
     SRBS..... 0000      LOCK..... 00000000  ASSB..... 01AB6D00

  TCB: 00AFE178
     CMP...... 00000000  PKF...... 00        LMP...... FF        DSP...... FF
     TSFLG.... 00        STAB..... 00AFD300  NDSP..... 00000000
     JSCB..... 00AFDD84  BITS..... 00000000  DAR...... 00
     RTWA..... 00000000  FBYT1.... 00
     Task non-dispatchability flags from TCBFLGS4:
      Top RB is in a wait

  PRB: 00AFDD60
     WLIC..... 00020001  FLCDE.... 00C12630  OPSW..... 070C1000  810D7C20

Figure 3. Result of Using PF5/RFIND

IPCS OUTPUT STREAM ----------------------------------- FOUND IN LINE 16 COL 39
COMMAND ===>                                                  SCROLL ===> CSR
 ****************************** TOP OF DATA ***********************************

     * * * *   K E Y F I E L D S   * * * *
 JOBNAME RASP
     SELECTED BY: CURRENT

  ASCB: 00F09E00
     FWDP..... 00F09C00  ASID..... 0003      TRQP..... 80F09301
     CSCB..... 00F1D3C8  TSB...... 00000000  AFFN..... FFFF
     ASXB..... 00AFDF00  DSP1..... 00        FLG2..... C4
     SRBS..... 0000      LOCK..... 00000000  ASSB..... 01AB6D00

  TCB: 00AFE178
---------------------------------------------------------------------------
|    CMP...... 00000000  PKF...... 00        LMP.....  FF       DSP.....FF|
---------------------------------------------------------------------------
     TSFLG.... 00        STAB..... 00AFD300  NDSP..... 00000000
     JSCB..... 00AFDD84  BITS..... 00000000  DAR...... 00
     RTWA..... 00000000  FBYT1.... 00
     Task non-dispatchability flags from TCBFLGS4:
      Top RB is in a wait

  PRB: 00AFDD60
     WLIC..... 00020001  FLCDE.... 00C12630  OPSW..... 070C1000  810D7C20