Trail: PROIV Documentation > Developer > PROIV Developer > Developing Functions > Events and Logic > GET_LOGICAL_PATH

 

 

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)
 

Comment on this topic

Topic ID: 520062