Edit Function › Edit Commands › Locate Data

Locate Data

Find/Rfind

Scans the test stream for a character string. You can specify these commands in all three formats.

Note: Although the Find and Rfind commands can be typed in Display format, the value specified in the Scan parameter applies to the screen in Field format. Similarly, if the commands are typed in Field or Hex format, the value specified in the Screen ID parameter applies to the screen in Display format.

The Find command searches once for the specified value; the Rfind command repeats the previous Find command. Use the Rfind command to locate additional occurrences of the character string without respecifying it.

When you type the Find command, CA Verify for VTAM inserts the Find parameters on the menu as illustrated next.

CCC.ORDERAPP.001 --------  EDIT: FIELD FORMAT  ------------------------12:43:12
 ENTER COMMAND ===>                                                           E4
                                                                                
 ROW      COLUMN              VALUE                                             
 ===>     ===>      SCREEN ID ===>                                              
 ===>     ===>      SCAN      ===>                                              
                                RH:   039040             RECORD NUMBER:        9
 TYPE:       OUTPUT             APPL: A04IC9NA           DATA LENGTH:        266
 OPERATION:  ERASE/WRITE        DATE: 11/03/1998         SCREEN SIZE:  24 BY  80
 RESPONSE:   00:00:00.596       TIME: 11:53:58.406       TERMINAL:      A55TG001
 WCC: C2: NL/EM/CR PRINT CNTL, KEYBOARD RESTORE                                 
 ORDER  ROW  COL  ATTR  LENGTH  ----+----|----+----|----+----|----+----|----+---
  SBA     7   16         00000                                                  
  IC                     00000                                                  
  FLD     1    1  PSH    00004  DATE                                            
  SF              PS     00008  11/03/98                                        
  FLD     1   29  PSH    00023  CAROL'S COOKIES COMPANY                         
  FLD     1   63  PSH    00007  RELEASE                                         
  SF              PSM    00003  6.2                                             
  FLD     2    1  PSH    00004  TIME                                            
  SF              PS     00008  11:53:58                                        
  FLD     2   36  PSH    00009  MAIN MENU                                       
  FLD     7    1  PSH    00013  ENTER OPTION:                                   
  SF              UM     00000                                                 

The Find command has two parameters: Screen ID and Scan. You can specify values for one or both parameters. If you specify both values, both must be satisfied.

Screen ID

The value specified for this parameter applies to the screen as it appears in Display format. The Row and Column sub-parameters must be specified. CA Verify for VTAM will search for the value only in that row and column.

Scan

The value specified for this parameter applies to the screen in Field format. The Row and Column sub-parameters are optional. Specify a row without a column to limit the search to a single row; specify a column without a row to limit the search to a single column. Omit both row and column to search the entire screen.

Although the Find and Rfind commands can be typed in Display format, the value specified in the Scan parameter applies to the screen in Field format.

Note: To find orders, specify the Find and Rfind commands in Hex format, omitting the Scan parameter row and column.

If CA Verify for VTAM finds the string, it displays the record in which it was found; otherwise, the current record is redisplayed along with a message.

Specifying the Value

Follow these rules when specifying the Screen ID and Scan values:

• A character value should not be specified in single quotes; for example, value
• A hexadecimal value should be preceded by X and enclosed in single quotes; for example, X'value'
• Embedded blanks are permitted within a character value; trailing blanks are ignored.

When to Use Screen ID or Scan

A difference exists between the data you view on your terminal and the data transmitted between your terminal and CICS for the following reasons:

• On output, successive transmissions can cumulatively build a terminal display.
• On input, only modified data is transmitted, not the entire display.

Although CA Verify for VTAM captures only the actual transmission, during the Browse, Run, and Edit functions the terminal display is reconstructed.

Use Screen ID to find a screen based on how it appears at a terminal (Display format); use Scan to find a screen by the actual data transmitted to or from the terminal (Field format).