tcl.find Verb: Access/TCL


Command tcl.find Verb: Access/TCL
Applicable release versions: AP, AP 6.1, R83
Category TCL (746)
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.
Syntax find {file.reference}
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 

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.
Related tcl.find_rp