|Command||tcl.find Verb: Access/TCL
Applicable release versions: AP, AP 6.1, R83
|Description||searches a file for the existence of one or more strings of characters in any attribute and optionally creates and saves a list.
On releases 6.1.0 and above, the file.reference may be specified on the command line. Otherwise, the program requests it. Next, the search strings are requested by the program. Enter the string(s) without any enclosing delimiters. The system repeatedly asks for additional "search strings". If there are no additional strings to scan for, then entering a <return> at the "search string" prompt begins the search.
The program requests a list name. If provided, the list will be saved in the "pointer-file".
The item-id's of the items containing the search string(s) appear on the screen.
Note that the "find" command actually invokes the "search-file" command, and is simply a synonym.
find<return> source file to search = bp<return> string to search for = customer.file<return> string to search for = invoice.file<return> string to search for = <return> enter list item name = find.list<return> After responding to the last prompt in this example, the "find" process begins searching each item in the "bp" file. If an item contains either of the two strings provided, the item-id is added to the list. After searching the entire file, the list "find.list" is saved in the pointer-file. find source file to search =errmsg<return> string to search for =bad<return> string to search for =<return> enter list item name =errmsg.with.bad<return> Item will be saved in the "DM,POINTER-FILE" file 1539 : E^H Bad descriptor type found. B14 : E Line ^A^H: Bad stack descriptor. 69 : E^H BAD GROUP 30 : verb definition is bad 1514 : E^H Bad MDS 'D' type item. B102 : E Line ^A^H: Bad statement. 1521 : E^H Bad group found. 1522 : E^H Item with bad count field found.