/sys$common/syshlp/helplib.hlb CQUAL Routines, UTIL$CQUAL_FILE_MATCH, Description  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    UTIL$CQUAL_FILE_MATCH compares the file named in either the user_
    fab or file_name parameter (only one can be specified) against
    criteria specified by the common file qualifier database pointed
    to by the context and the disable parameter flags. UTIL$CQUAL_
    FILE_MATCH returns a status as to whether the file does or does
    not match the criteria.

    If a failure occurs during processing, such as those listed in
    the Abnormal Completion Codes, the routine quits processing files
    for the context under which the failure occurred. A processing
    failure is the same as receiving a quit processing response from
    a user prompt. Any additional calls to this routine with the
    context that incurred the processing failure will return UTIL$_
    QIOPRO. This applies even if the user responded ALL to a previous
    confirmation prompt.

    For a description of the /CONFIRM prompting, see UTIL$CQUAL_
    CONFIRM_ACT.

                                   NOTE

       The UTIL$CQUAL_FILE_MATCH current_form parameter is
       different from the same parameter in UTIL$CQUAL_CONFIRM_
       ACT. UTIL$CQUAL_FILE_MATCH retains the user's last requested
       form between calls.