{
{   The purpose of this request is to get a file reference from a local file
{ name.
{
{       CLP$GET_PATH_NAME (LOCAL_FILE_NAME, FORMAT, FILE_REFERENCE)
{
{ LOCAL_FILE_NAME : (input)  This parameter specifies the file name for which
{       the file reference is to be obtained.
{
{ FORMAT : (input)  This parameter specifies the message level for the file
{       reference:
{
{       OSC$BRIEF_MESSAGE_LEVEL - The path is presented relative to the working
{                                 catalog.
{       OSC$FULL_MESSAGE_LEVEL  - The path is presented as an absolute path.
{
{ FILE_REFERENCE: (output)  This parameter specifies the path represented by
{       the local file name.
{
