{
{    This request obtains a work area, identifies lexical units, initializes
{ the parse state and calls clp$complete_file_ref_parse to evaluate the
{ file reference.
{
{       CLP$SETUP_AND_PARSE_FILE_REF (FILE, FILE_REFERENCE_PARSING_OPTIONS,
{         USER_IDENTIFICATION, EVALUATED_FILE_REFERENCE, STATUS)
{
{ FILE: (input)  This parameter specifies the file expression whose
{       evaluation is to be completed.
{
{ 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.
{
{       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.
{
{       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.
{
{ USER_IDENTIFICATION: (input)  This parameter specifies the family and
{       user identification to be used for a relative path.
{
{ 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.
{
