AUTOCONFIG

Purpose:

Configures the installation directory layout to conform to recommended locations for certain Windows implementations.

Syntax:

AUTOCONFIG()

Example:

autoconfig()

 

Automatically sets up a default directory layout for the location of runtime files and objects. The following is an example of a directory layout where username is login name of the current user:

 

 

LABBOOKS

 

C:\Documents and Settings\username\My Documents\DADiSP

 

Labbooks are normally placed in the same directory as the DADiSP executable and may cause security warnings under Vista and higher. If not already present, DADiSP will automatically copy the example Labbooks found in the executable directory to the documents directory.

 

 

SESSION File

 

C:\Documents and Settings\username\Application Data\DADiSP

 

Session files (dadisp6.ses) will be written to the user's application specific directory. The session file is sometimes saved in the \Windows directory, which may cause security warnings under Vista and higher.

 

 

OPL Files

 

C:\Documents and Settings\username\Application Data\DADiSP

 

Generated .OPL files will be written to the user's application specific directory. OPL files are normally saved in the same directory as the corresponding SPL files, which may cause security warnings under Vista or higher.

 

 

SPILL Files (temporary files)

 

C:\Documents and Settings\username\Local Settings\temp

 

Temporary files will be written to a system defined directory with read/write privileges. By default, temporary files are written in the current Labbook directory which may cause security warnings under Vista and higher.

Remarks:

To prevent security violations, various locations for application specific files and data are preferred under certain versions of Windows. Normally the particular version of Windows is detected at initial startup and the directory layout is setup if it does not already exist.

 

AUTOCONFIG can be used to manually setup the conforming layout for systems that do not require such a layout. For example, the directory layout is generally not required under XP. However, some system administrators routinely "lock down" systems to prevent file writes in the product installation directory. AUTOCONFIG can be used to create a layout that conforms to the locked down environment.

 

AUTOCONFIG is generally not required under Vista and higher as these environments are automatically detected.

 

The specific directory layout is dependent on the running version of Windows.

 

The OS_AUTOCONFIG configuration parameter in DADISP.CNF also controls the directory layout. The parameter accepts the following values:

 

0:

do not setup a conforming layout

1:

setup a conforming layout under Vista and higher (default)

2:

always setup a conforming layout

 

AUTOCONFIG internally sets OS_AUTOCONFIG to 2.

 

Once AUTOCONFIG has created a directory layout, it is not necessary to execute AUTOCONFIG in future sessions.

See Also:

GETCONF

GETLABPATH

GETMISCPATH

SETCONF

WRITECNF