COM Proxy › Preparing for Execution › Configuring the COM Proxy Runtime › Configuring COM Proxy Communications

Configuring COM Proxy Communications

The COM Proxy runtime can use the commcfg.ini file to find the CA Gen servers it needs to access. This is an ASCII text file that allows runtime modifications to the communication configuration for a given set of transactions codes associated with the target DPS applications. The commcfg.ini must be available in directories specified by PATH or in a directory specified by the COMMCFG_HOME environment variable. A default version of this file is available in the installed CA Gen directory.

There is only one copy of the commcfg.ini file, by default. All proxies must use this file. Alternatively, a proxy application searches for the commcfg.ini file in the following order:

1. %COMMCFG_HOME%
2. %USERPROFILE%\AppData\Local\CA\Gen xx\cfg\client
3. %ALLUSERSPROFILE%\Gen xx\cfg\client
4. %PATH%

If the file is not available in these directories, the proxy application assumes that the file does not exist.

If there are multiple copies of the commcfg.ini file, the order of precedence for the files is the same as the order described above.

The following list defines the use of this search order:

%COMMCFG_HOME%

The environment variable COMMCFG_HOME can be set to a directory that contains the commcfg.ini file. This file is used by the invoking proxy application. This variables setting enables customization on a proxy by proxy basis.

%USERPROFILE%\AppData\Local\CA\Gen xx\cfg\client

If the commcfg.ini file is stored in this directory, the file is accessible by all proxies that are executed by a specific user on the system.

%ALLUSERSPROFILE%\Gen xx\cfg\client

If the commcfg.ini file is stored in this directory, the file is accessible by all proxies that are executed by all users on the system.

%PATH%

If the commcfg.ini file is not available in the above locations, the file is searched in all the directories that are specified by the PATH environment variable. By default, CA Gen is part of the PATH environment variable.

A generated proxy contains communications information as it was defined in the model when the proxy was generated. The proxy runtime provides capability to specify the communication information at runtime. This information overrides any information specified in the model and was built into the proxy during generation.

Additionally, the proxy runtime is capable of turning the tracing ON and OFF, as well as provides capability to control the amount of file caching that takes place at runtime.

Note: For specific formatting instructions, see the default file installed with the CA Gen software, or see the Distributed Processing - Overview Guide.