Specify the working directory for a Uniface application.


Use With

All applications


Run the application using the working directory specified. You can specify the full path name to the directory. If the path contains spaces, enclose the full path name in double quotes. When a file name is encountered in ProcScript that is not fully qualified, this directory is used as the current directory.

Using with Uniface Router

In Microsoft Windows, the Uniface Router can be started with the /dir switch on the command line, or started as a service ( Control Panel > Services ) with /dir in the Startup Parameters field. In the Startup Parameters field, backslashes are removed, so you can either use two backward slashes or use one forward slash to separate directory specifications in the path. For example, for the path c:\uniface\project, you need to specify one of the following /dir switches:

/dir=c:\\uniface\\project or /dir=c:/uniface/project

The /dir switch can also be used in the [SERVERS] section of the Uniface Router assignment file (urouter.asn) to specify the working directory for a particular Uniface server name (UST). If the server working directory cannot be determined from urouter.asn, the default will be the same as for the Router.

Using with Uniface Deployment Utility

Using the /dir command line switch sets the current working directory for the deployment utility.

The /dir command line switch requires the presence of the /uar command line switch.


On iSeries, /dir can be used to set an IFS working directory or to set the current library to any user library for which the user is authorized. It is not possible to set QTEMP as the current library.

When /dir is used to set an IFS working directory, the default file system becomes the IFS and is no longer the installation library. Paths such as LIBRARY/USYS.ASN are now interpreted as paths relative to the IFS directory specified with the /dir flag, which may be unexpected.

Therefore, to indicate files in the library system, the QSYS: disk specification must be added: QSYS:LIBRARY/USYS(ASN). Without the /dir=IFS:… flag, QSYS: is implicit, but with /dir=IFS:…, IFS: becomes implicit and QSYS: must be made explicit. This affects all places where paths are used: in ProcScript, assignment files and commandline switches such as /asn.

Related Topics