VMS Help RMS, $SEARCH  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Search service scans a directory file and fills in various
    NAM or NAML block fields. This service should be preceded by
    the Parse service, in order to initialize the NAM or NAML block
    appropriately.

    Format

      SYS$SEARCH  fab [,[err] [,suc]]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword
    access:       write only
    mechanism:    by value

    The value is returned in symbolic offset FAB$L_STS. Symbolic
    offset FAB$L_STV may contain additional status information.

2 - Arguments

 fab

    OpenVMS usage:fab
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference

    FAB control block whose contents are to be used as indirect
    arguments for the Search service call. The fab argument is the
    address of the FAB control block.

 err

    OpenVMS usage:ast_procedure
    type:         procedure value
    access:       call without stack unwinding
    mechanism:    by reference

    AST-level error completion routine that the service invokes if
    the operation is unsuccessful. The err argument is the address of
    the entry mask of this user-written completion routine.

 suc

    OpenVMS usage:ast_procedure
    type:         procedure value
    access:       call without stack unwinding
    mechanism:    by reference

    AST-level success completion routine that the service invokes if
    the operation is successful. The suc argument is the address of
    the entry mask of this user-written completion routine.

3 - Condition Values Returned

 The following condition values can be returned. Use the Help Message
 utility to access online message descriptions.