Accessing Auxiliary Storage: FILE › BDAM Files › FILE Functions for BDAM Records › Search for a Data String

Search for a Data String

This function is valid only for files with the browse capability. Check the lower‑right corner of the FILE screen for the properties of the file before attempting to use this function.

1. Complete the following fields as shown next:

   FUNC= SRCH
   RCID= record id of first record to be searched
   DATA= search argument
   LOC= position in the record to search
   

   or

   LOC=ANY
   

   • LOC= position instructs FILE to look for the search argument only at the specified position.
   • LOC=ANY instructs FILE to look for the search argument in the entire record.

   In addition, there is an optional field:

   SIZE= number of records to be searched (default=1)
   

2. Press Enter. If a match is found, the record displays, and the following information is on the FILE screen:
   • The MESSAGE= field shows the message DATA HAS BEEN LOCATED.
   • The RETNRCID= field contains the returned record's identification.
   • The LOC= field contains the location of the found data.
   • If no match is found, the MESSAGE= field shows the message DATA NOT FOUND.