{
{   This request is used to convert a string to a resolved file reference.  The
{ resolved path is returned in two forms:  the complete path, and optionally
{ the "path handle name" form.
{
{       CLP$CONVERT_STRING_TO_FILE_PATH (STR, USE_$LOCAL_AS_WORKING_CATALOG,
{         RETURN_PATH_HANDLE_NAME, PATH_HANDLE_NAME, RESOLVED_PATH, STATUS)
{
{ STR: (input)  This parameter specifies the string, representing a file
{       expression, to be converted.
{
{ USE_$LOCAL_AS_WORKING_CATALOG: (input)  This parameter specifies whether
{       $LOCAL should be used as the working catalog in the event that the file
{       reference is a relative path.  If this parameter is FALSE, the path is
{       considered to be relative to the current working catalog.
{
{ RETURN_PATH_HANDLE_NAME: (input)  This parameter specifies whether the
{       path_handle_name for the file reference should be returned.  This
{       option exists soley for compatibility reasons, and should normally be
{       set to FALSE.
{
{ PATH_HANDLE_NAME: (output)  This parameter specifies the resulting path in
{       the form of a path handle name.  Its value will be a null name if
{       RETURN_PATH_HANDLE_NAME is set to FALSE.  This parameter exists soley
{       for compatibility reasons.  Use of this parameter is not recommended.
{
{ RESOLVED_PATH: (output)  This parameter specifies the resulting path in the
{       complete path format.  This record contains information that allows
{       easy access to the entire path or components of it.
{
{ STATUS: (output)  This parameter specifies the request status.
{
