{
{   This request is used to evaluate a file reference.  The reference has the
{ form of a file expression as defined for the NOS/VE command interface.
{
{       CLP$EVALUATE_FILE_REFERENCE (FILE, FILE_REFERENCE_PARSING_OPTIONS,
{         RESOLVE_CYCLE_NUMBER, EVALUATED_FILE_REFERENCE, STATUS)
{
{ FILE: (input)  This parameter specifies the file expression to be evaluated.
{
{ FILE_REFERENCE_PARSING_OPTIONS: (input)  This parameter specifies the
{       parsing options which will govern the manner in which the expression
{       is evaluated.  The options are:
{
{       clc$use_$local_as_working_cat:  This option specifies that
{             $LOCAL should be used as the working catalog in the event that
{             the file reference is a relative path.  If this option is
{             omitted, the path is considered to be relative to the current
{             working catalog.
{
{       clc$evaluating_command_ref:  This option specifies that the
{             file reference is part of a command reference. Specifying
{             this option in conjunction with the clc$evaluating_entry_
{             point_ref option will result in an error.
{
{             Not applicable for this request.
{
{       clc$evaluating_entry_point_ref:  This option specifies that the
{             file reference is part of an entry point reference. Specifying
{             this option in conjunction with the clc$evaluating_command_ref
{             option will result in an error.
{
{             Not applicable for this request.
{
{       clc$multiple_reference_allowed:  This option specifies that the
{             "wild card" notation is to be allowed in the file reference.
{
{       clc$command_file_ref_allowed:  This option specifies that a
{             command file reference (i.e.  $COMMAND or $COMMAND_OF_CALLER) is
{             to be allowed.
{
{       clc$file_ref_evaluation_stage:  This option specifies the
{             extent to which the expression is evaluated.  If
{             this option is specified, the values of any variables or
{             functions in the expression are determined and an
{             absolute path is constructed. If omitted, additional
{             interpretation of generic path elements and cycle
{             references occurs, which is the case when the file
{             expression is being used to access a file or catalog.
{
{             Not applicable for this request.
{
{ RESOLVE_CYCLE_NUMBER: (input)  This parameter specifies whether a generic
{       cycle reference ($high, $low, $next) is to be resolved (TRUE) or not
{       (FALSE).
{
{ EVALUATED_FILE_REFERENCE: (output)  This parameter specifies the information
{       resulting from the evaluation of the file reference.
{
{ STATUS: (output)  This parameter specifies the request status.
{
