Description

   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.