Configuration Manager and Call Handlers

The Configuration Manager for Java Call-In API is used to configure the Uniface environment in which the Uniface component runs. It starts up a call handler that uses Java properties set by the Configuration Manager to set up the appropriate environment.

The Configuration Manager is implemented as a Java Bean (ConfigManagerBean) for the ConfigManager class. The methods provided by the Configuration Manager provide a simple and consistent interface to the Java system properties for Uniface components and call handlers.

When you create instances for a component, the UnifaceComponent class queries the Configuration Manager for the type of call handler for this component, and then loads the required handler. The Uniface Virtual Machine (uvm) is the default call handler, but you can specify the Java Virtual Machine (jvm) instead.

The handler uses properties that have been set with the Configuration Manager to configure and start the runtime environment for the Uniface component. These properties may specify the Uniface application name, configuration files (.ini and .asn), working directory, or Uniface command line options.

Each handler uses a specific set of properties.

Java Properties used by Handler Classes
Property uvm jvm Value
name uvm: Uniface name of the component
class   Name of the Java class (not the file name) that implements the component
commandline Command line to start an embedded Uniface VM
asnname Name of the assignment file
apsname Name of the application shell file
workdir Working directory for the embedded Uniface VM