Purpose

GET_LOGICAL_PATH provides information about a logical path definition and returns the directory name.  This command also returns the existence of the logical database or directory.
 

Syntax

#status = GET_LOGICAL_PATH (logical path name, directory name)
 

Operation

#status has the return value:
      0   the logical path is defined and the directory exists.
  674   the logical path does not exist
  675   the directory defined in the logical path does not exist

logical path name is defined in the .INI file as DATABASE.  Can be a scratch, alpha/mixed variable or literal. 

directory name must be a scratch variable.  Depending on the operating system, the area for this variable must be allocated.
 

Remarks

The error 675 is returned even if the second optional parameter (directory name) is not supplied. Error messages 674 and 675 are returned by PROIV if a fatal error occurs.  

For SQL logical paths, this command returns the SQL connection string.  No attempt is made to check for a connection.
 

Example

#RC=GET_LOGICAL_PATH(“PERSONNEL",$DIRECTORY)