Oracle AQ agent settings

This dialog box enables you to configure the Service Virtualization Oracle AQ agent. The Oracle agent handles communication between applications that are using Oracle Advanced Queuing.

To access
  1. From the main menu, select Tools > Options.
  2. Click Agents.
  3. Select OracleAQ and click Add to define a new configuration. Alternatively, select an existing configuration.
Important information
  • For additional important configuration information, see the task Configure the Oracle AQ agent.
  • To connect to the Oracle database, you can specify either a connection string or specific database connection properties.
  • When specifying database connection properties, you can enter either the database name or SID.
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 selected configuration of the agent on and off.


Enter a name for the configuration or accept the default name.


The host machine and port for the Oracle database.

Database Name

The name of the Oracle database.

SID The Oracle system ID.
Connection String The connection string for connecting to the Oracle database.

Enter credentials for a user with permissions to access the Oracle database.

Although the connection string may contain a password, it is recommended to specify the password in this password box.

Back to top