IBM CICS TG agent settings

This dialog box enables you to configure the Service Virtualization IBM CICS TG agent. The agent handles communication between a client (CICS TG SDK) and a real or virtual service (CICS Transaction Gateway).

Note: The IBM CICS TG agent is an early access feature. For more details, see Early access features.

To access
  1. From the main menu, select Tools > Options.
  2. Click Agents.
  3. Select IBM CICS TG and click Add to define a new configuration. Alternatively, select an existing configuration.
Important information
Relevant tasks

Configure agents

See also Service Virtualization agents

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element Description
<left pane>

Displays the server configured for your project.

Expand the server to display the available agents and configurations.


Enables you to define additional configurations of the agent.

Delete Deletes the selected configuration.

Creates an additional configuration of the agent by copying the selected configuration. You can then modify the configuration settings.

Note: By default, the configuration is created with a sequential unoccupied port number.


Saves the selected agent configuration as a file. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

Export All Exports all agent configurations on the selected server. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

Enables you to select an exported agent configuration file stored on the file system. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

If the configuration file you are importing contains multiple configurations, you can select which configurations you want to import.

If you choose to import an agent configuration that is identical to a configuration that already exists on your server, you can choose to overwrite your existing configuration, or create a new, additional configuration.

Agent State The current status of the agent. Values include Running, Not Running.
Test Configuration link Tests the configuration based on the settings you select. If Service Virtualization identifies any problems in your configuration, the details are displayed.
Is Enabled Turns the agent on and off.
Name Enter a name for the configuration or accept the default name.
Host The hostname of the interface on which the agent is listening.
Port The port on the local machine on which the agent is listening.
Remote Host The hostname or IP address of the IBM CICS TG server.
Remote Port The remote port of the IBM CICS TG server.
Code Page The character set used by the tested client application.
Use SSL Enables SSL over TCP/IP. If enabled, you must provide certificate file and password details.
Certificate File The server side P12/PFX certificate file used by the BM CICS TG Agent during an SSL handshake.
Certificate Password The password used to access the certificate file specified above.

Back to top