*PLBCURDIR (GETMODE)

PLBCMP GUI Only

*PLBCURDIR={value}

Where:

value

Required. A previously defined Character String Variable or a string Literal that receives the current working directory.

The *PLBCURDIR control retrieves the runtime's current working directory through program control. The need for the control is to address a Windows multiple thread issue where a change to the current working directory affects all of the threads. This problem can occur for the Application Server or the Automation Server when a PL/B application requires unique working directories for all threads.

When the PL/B current directory is set, the runtime will perform the following actions when executing a program:

1. The PL/B current directory is the default directory for all OPEN or PREP operations when a path is not specified in the file name.

2. The PL/B current directory is the default directory when an BATCH/EXECUTE/ROLLOUT instruction is executed.

3. When the PL/B current directory is specified, the PATH CHANGE instruction will only change the PL/B current directory. If the PL/B current directory is not specified and a PATH CHANGE is executed, only the OS working directory is set.

4. When the PL/B current directory is specified, the PATH CURRENT instruction will return the PL/B current directory. If the PL/B current directory is not specified, the PATH CURRENT returns the current operating system working directory.

5. When the PL/B current directory is specified, the PATH CREATE instruction will use the PL/B current directory when the user specified string does not specify a pathed name.

6. When the PL/B current directory is specified, the PATH DELETE instruction will use the PL/B current directory when the user specified string does not specify a pathed name.

7. The current working directory may be set by use of the runtime's command line 'z' option or the PLB_CURDIR runtime keyword.

See Also: List Controls (GETMODE), GETMODE