Configuration Files

Uniface configuration files include assignment files, initialization files, and web application files.

  • Assignment files (*.asn) contain settings that establish the location of application resources and servers, set environment variables, define application logicals, and set Uniface system settings to influence runtime behavior. Usually, each application and Uniface product has its own assignment file, but files can be named, organized, and chained to suit organization's requirements.
  • Initialization files (*.ini) contain settings that determine the user interface (UI) resources and language settings to use for the client. Some UI features are dependent on the current operating system, such as Windows. They enable the user to set user interface defaults.
  • Web application files (web.xml) contain settings that configure the WRD servlet used to communicate between the web application server and Uniface in web applications.

Note:  The Uniface IDE is a Uniface application, so you can use its assignment and initialization files to customize your development environment.

Uniface Configuration Files

The following tables list the most commonly used assignment files. These can edited to suit your own environment or used as a model for creating the configuration files required for your application.

When starting Uniface applications, you need to specify the location of its configuration files using the /adm command line switch.

The following files are located in the UnifaceInstallDir\common\adm directory.

Common Configuration Files
File Purpose
dbms.asn Defines the database driver and default paths for the Development Repository
usys.asn Defines the language and the location of components used by the Uniface via the USYS environment variable.
urouter.asn Defines the Uniface servers that the Uniface Router is responsible for.
usys.ini Defines logical paths and Windows-specific initialization settings for the Uniface applications and servers.

The following files are located in the UnifaceInstallDir\uniface\adm directory.

Uniface Configuration Files
File Purpose
ide.asn Defines the settings and logicals for the Uniface IDE.
udbg.asn Defines the settings for the Uniface Debugger.
userver.asn Defines the settings for the Uniface Server.
wasv.asn Defines the settings for the Uniface Web Application Server used for testing.
uproperties.ini Defines the logical to physical widget mappings for Dynamic Server Page widgets.
usys.ini Defines logical paths and Windows-specific initialization settings for the Uniface IDE.

Related Topics