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:
  1. The run-time system is checked to see if the program is loaded. If it is, the search ends.
  2. If the COBPATH environment variable is set, the paths specified are searched in order. Otherwise, the current directory is searched. (You should not modify the COBPATH environment variable as it is used by this COBOL system.)
  3. The path in which the calling program was loaded is searched.
  4. If the COBDIR environment variable is set, the paths specified are searched in order.
2 Uses the following search sequence:
  1. The run-time system is checked to see if the program is loaded. If it is. the search ends.
  2. The path in which the calling program was loaded is searched.
  3. If the COBPATH environment variable is set, the paths specified are searched in order. Otherwise, the current directory is searched. (You should not modify the COBPATH environment variable as it is used by this COBOL system.)
  4. If the COBDIR environment variable is set, the paths specified are searched in order.
3 Uses the following search sequence:
  1. The run-time system is checked to see if the program is loaded. If it is. the search ends.
  2. The current directory is searched.
  3. If the COBPATH environment variable is set, the paths specified are searched in order. (You should not modify the COBPATH environment variable as it is used by this COBOL system.)
  4. If the COBDIR environment variable is set, the paths specified are searched in order.
4 Uses the following search sequence:
  1. The run-time system is checked to see if the program is loaded. If it is. the search ends.
  2. If the COBPATH environment variable is set, the paths specified are searched in order. Otherwise, the current directory is searched. (You should not modify the COBPATH environment variable as it is used by this COBOL system.)
  3. The path in which the calling program was loaded is searched.
  4. If the COBDIR environment variable is set, the paths specified are searched in order.
  5. The current directory is searched.

Properties:

Default: 4
IDE equivalent: None

Comments:

Set program_search_order 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:


  1. The run-time system is checked to see if the program is loaded.
  2. The path specified in the call is searched.
Parent topic: List of Run-time Tunables