{
{    This request is used to complete the evaluation of a file reference.  The
{ reference has the form of a file expression as defined for the NOS/VE command
{ interface.
{
{       CLP$COMPLETE_FILE_REF_PARSE (INITIAL_PATH, PARSE, WORK_AREA,
{         FILE_REFERENCE_PARSING_OPTIONS, USER_IDENTIFICATION,
{         EVALUATED_FILE_REFERENCE, COMMAND_NAME, FORM, PARAMETER_NAME, STATUS)
{
{ INITIAL_PATH: (input, output)  This parameter specifies a pre-evaluated
{       portion of the file reference.  If it is not NIL, then it represents an
{       evaluated file variable or function to be concatenated to the beginning
{       of the file reference contained within the PARSE.text.
{
{ PARSE: (input, output)  This parameter specifies the file expression whose
{       evaluation is to be completed.
{
{ WORK_AREA: (input, output)  This parameter specifies an area of storage that
{       will be used to parse the file reference.  The current position of this
{       sequence pointer is updated to reflect the amount of storage used by
{       this request.
{
{ 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 identification
{       of the current user.
{
{ EVALUATED_FILE_REFERENCE: (output)  This parameter specifies the information
{       resulting from the evaluation of the file reference.
{
{ COMMAND_NAME: (output)  This parameter is set only if the
{       clc$evaluating_command_ref option is specified in the
{       FILE_REFERENCE_PARSING_OPTIONS parameter.  It specifies the command
{       name part of the command reference.
{
{ FORM: (output)  This parameter is set only if the clc$evaluating_command_ref
{       option is specified in the FILE_REFERENCE_PARSING_OPTIONS parameter.
{       It represents the form in which the command reference was specified:
{
{       clc$module_or_file_command_ref <file> <.> <command_name> OR <catalog>
{       <.> <command_name> clc$file_cycle_command_ref <catalog> <.>
{       <command_name> <.> <cycle_reference>
{
{ PARAMETER_NAME: (output)  If this parameter's value is a null name then it
{       indicates that the file reference represents an omitted parameter.  In
{       this case, all other output parameters of this request are meaningless.
{
{ STATUS: (output) This parameter specifies the request status.
{
