HELPLIB.HLB  —  Lexicals  F$SEARCH  Arguments
 filespec

    Specifies a character string containing the file specification
    to be searched for. If the device or directory names are omitted,
    the defaults from your current default disk and directory are
    used. The F$SEARCH function does not supply defaults for a file
    name or type. If the version is omitted, the specification for
    the file with the highest version number is returned. If the
    filespec argument contains the asterisk (*)  or the percent
    sign (%)  wildcard characters, each time F$SEARCH is called, the
    next file specification that agrees with the filespec argument
    is returned. A null string is returned after the last file
    specification that agrees with the filespec argument.

 stream-id

    Specifies a positive integer representing the search stream
    identification number.

    The search stream identification number is used to maintain
    separate search contexts when you use the F$SEARCH function
    more than once and when you supply different filespec arguments.
    If you use the F$SEARCH function more than once in a command
    procedure and if you also use different filespec arguments,
    specify stream-id arguments to identify each search separately.

    If you omit the stream-id argument, the F$SEARCH function starts
    searching at the beginning of the directory file each time you
    specify a different filespec argument.
Close Help