Micro Focus Studio Enterprise Edition for UNIX > General Reference > Run-time System Configuration > Run-time Tunables > List of Run-time Tunables > program_search_order

program_search_order

Changes the order of locations in which the run-time system searches for program files.

Restriction: These tunables are supported for native COBOL only.

Syntax:

>>-----set program_search_order=---.-1-.-----------><
                                   +-2-+
                                   +-3-+
                                   +-4-+

Parameters:

1	Uses the following search sequence: The run-time system is checked to see if the program is loaded or statically linked. If it is. the search ends. If the COBPATH environment variable is set, the paths specified are searched in order. Otherwise, the current directory is searched. The path in which the calling program was loaded is searched. If the COBDIR environment variable is set, the $COBDIR/dynload path specified is searched. Otherwise, /usr/lpp/cobol/dynload (on AIX) or /opt/lib/cobol/dynload (on other systems) is searched.
2	Uses the following search sequence: The run-time system is checked to see if the program is loaded or statically linked. If it is. the search ends. The path in which the calling program was loaded is searched. If the COBPATH environment variable is set, the paths specified are searched in order. Otherwise, the current directory is searched. If the COBDIR environment variable is set, the $COBDIR/dynload path specified is searched. Otherwise, /usr/lpp/cobol/dynload (on AIX) or /opt/lib/cobol/dynload (on other systems) is searched.
3	Uses the following search sequence: The run-time system is checked to see if the program is loaded or statically linked. If it is. the search ends. The current directory is searched. If the COBPATH environment variable is set, the paths specified are searched in order. If the COBDIR environment variable is set, the $COBDIR/dynload path specified is searched. Otherwise, /usr/lpp/cobol/dynload (on AIX) or /opt/lib/cobol/dynload (on other systems) is searched.
4	Uses the following search sequence: The run-time system is checked to see if the program is loaded or statically linked. If it is. the search ends. If the COBPATH environment variable is set, the paths specified are searched in order. Otherwise, the current directory is searched The path in which the calling program was loaded is searched. If the COBDIR environment variable is set, the $COBDIR/dynload path specified is searched. Otherwise, /usr/lpp/cobol/dynload (on AIX) or /opt/lib/cobol/dynload (on other systems) is searched. The current directory is searched

Properties:

Default:	1
IDE equivalent:

Comments:

Set program_search_order to 2 for compatibility with previous UNIX versions of Micro Focus COBOL, or to 3 for compatibility with previous DOS versions.

Note:

If a program is called with a specific path the search sequence is not affected by the value of program_search_order and instead:

The run-time system is checked to see if the program is loaded or statically linked.
The path specified in the call is searched.