{
{   The purpose of this request is to convert a string to a file reference.
{ The string is assumed to contain a file expression.  The returned parsed file
{ reference provides for accessing the entire path of the file reference or its
{ components.
{
{       CLP$CONVERT_STRING_TO_FILE_REF (STR, PARSED_FILE_REFERENCE, STATUS)
{
{ STR: (input)  This parameter specifies the string to be converted.
{
{ PARSED_FILE_REFERENCE: (output)  This parameter specifies the file reference.
{
{ STATUS: (output)  This parameter specifies the request status.
{
