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.