{
{   The purpose of this procedure is to validate that a  string  represents  a
{ syntactically  valid  local  file name.  Further, it checks whether the name
{ has the form of a path handle name and if so  it  returns  the  path  handle
{ represented by the name.
{
{       CLP$VALIDATE_LOCAL_FILE_NAME (POTENTIAL_NAME, LOCAL_FILE_NAME,
{         PATH_HANDLE, NAME_IS_PATH_HANDLE, NAME_IS_VALID)
{
{ POTENTIAL_NAME: (input) This parameter specifies the name to be validated.
{
{ LOCAL_FILE_NAME:  (output) This parameter specifies the validated local file
{       name.  Any lower case letters in the POTENTIAL_NAME are  converted  to
{       their uppercase counterparts.
{
{ PATH_HANDLE:   (output)   This   parameter   is   meaningful   only  if  the
{       NAME_IS_PATH_HANDLE parameter is TRUE.  In that case this parameter is
{       set to the path handle derived from the name.
{
{ NAME_IS_PATH_HANDLE:  (output)  This  parameter  specifies  whether the name
{       designated a path handle.
{
{ NAME_IS_VALID: (output) This parameter specifies whether the  POTENTIAL_NAME
{       was a syntactically correct local file name.  If this parameter is set
{       to FALSE none of the other output parameters  of  this  procedure  are
{       meaningful.
{
