C Proxy › Executing the User-written C Proxy Application › Configuring the C Proxy at Runtime › Configuring C Proxy Using commcfg.ini

Configuring C Proxy Using commcfg.ini

The commcfg.ini file is an ASCII text file that lets runtime modifications to the communication configuration for a given set of transactions codes associated with the target DPS applications.

There is only one copy of the commcfg.ini file, by default. The installed location is the CA Gen installation directory. As there is only one file all proxies must use this same 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\logs\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 defined in the model. The proxy runtime provides a capability for specifying the communication information at runtime. This information overrides any information specified in the model and built into the proxy during generation.

In addition, the proxy runtime has the capability of turning tracing ON and OFF, as well as providing a capability for controlling the amount of file caching that takes place at runtime.

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