USER-PATH indicates the user name or names to be used when Acu4GL searches for files. The order of the names is significant. The syntax for this variable is:
USER-PATH user1 [user2]...
Where the user argument may either be the name of a user on the system, or a period (.), which indicates the files owned by yourself.
The type of OPEN being issued for the file will determine the effects of this setting.
Examples
If an OPEN INPUT or OPEN I/O is issued, and there is a USER-PATH variable defined in the runtime configuration file, Acu4GL will search for a user of the named file in the following sequence of places:
1) the list of users in USER-PATH
2) public synonyms
The first valid file will be opened.
If an OPEN INPUT or OPEN I/O is issued, and there is no USER-PATH variable in the runtime configuration file, Acu4GL will search for a user of the named file in the following sequence of places:
1) the user named for login (ORA-LOGIN or OPS$user-name)
2) public synonyms
Acu4GL will open the first file that has a valid combination of user and file name.
If an OPEN OUTPUT is issued (whether USER-PATH is present or not), a new table will be created with the owner being:
1) the name specified in ORA-LOGIN or
2) the name constructed by automatic login (see section C.2.5 "Setting Up a User Account" in this appendix).
See also
The ACUCOBOL-GT User's Guide Chapter 2, for a discussion of the FILE-PREFIX configuration variable and general guidelines on the use of file search paths.
Section C.2.8 "Setting Up the Search Path"