The Runtime Service for CICS requires a configuration file, which you create and save using the CICS management console. Configuration files are saved to different locations and handled in a different way, depending on the circumstances.
When Runtime Service for CICS is installed, a default server configuration file,
CICSConnectorConfig.xml, is created and saved to
If you do not use MCS to update the configuration file, the run-time engine uses this default file exclusively. When you use MCS to update the configuration file, depending on whether the run-time service is active when the file is modified, two scenarios are possible.
In this scenario, MCS saves a version of the server configuration file to two locations:
For example, if you create a reference to your run-time service named "ServerA", and then edit the configuration file of the server via the CICS manager, the edited file is saved locally in MCS as
If this is not the first time you have edited and saved a configuration file (such as
ServerA.cfg in the preceding example), the configuration file is handled as follows:
If you edit the configuration file when This occurs The Runtime Service for CICS is not active MCS opens only its version of the configuration file (
Server_Name.cfg), and saves changes to it.
The Runtime Service for CICS is active MCS asks which version of the file you want to open, and then when changes are made, they are saved to both the MCS version (
Server_Name.cfg) and the run-time version (
If the run-time service is not active when you configure it, you are prompted to create a "default" configuration. If you answer "yes," any edits to the default configuration file are saved within MCS in the
install_directory\webapps\mcs\resources\connector_CICS directory. (The name of the file is derived from the Runtime Server name given to your configuration in MCS, in the form
Because the run-time is not active, MCS cannot update any of the configuration files in the
To manually update the configuration file:
install_directory\webapps\mcs\resources\connector_CICS, to the Runtime Service for CICS directory,
CICSConnectorConfig.xmlfile by changing the first line from
This step is necessary so that the run-time engine will use the MCS-created configuration file (
CICSConnectorConfigMCS.xml) to define the run-time environment. If
MCS="false" is specified, the previously loaded
CICSConnectorConfig.xml file will be used to define the run-time environment.
|Configuring Your Run-time Environment|
|Starting and Stopping the Runtime Service|
|Manually Configuring the Client Environment|