Advanced Tab

You can use the Advanced tab to configure advanced options for an adapter configuration, such as termination subject or topic, debug level, alerter name, and so on.

The following table lists the advanced options:

Name Description
General Information Panel
Termination Subject or Topic If a message is sent on the termination subject (if TIBCO Rendezvous is the transport) or topic (if JMS is the transport), the adapter will stop. The default value of the termination subject or topic is as follows:

%%Domain%%.%%Deployment%%.adb.%%InstanceId%%.exit

See TIBCO Rendezvous Concepts for information about specifying subject names. See TIBCO Enterprise Message Service User’s Guide for information about publishing on a topic.

JMS Destination Prefix You have to specify this prefix if you use the JMS transport type and have selected the Use Separate Session check box for Subscription Service. The destination prefix is the subject used by single-threaded Subscription Service.

By default, the adapter uses a dynamic destination that is generated using the Domain and Deployment module properties, and the adapter configuration name.

If you use this default dynamic destination, ensure that the values for Domain and Deployment are not empty. You can override the default dynamic destination by specifying the static destination in this field. The static destination must be defined with write permissions on the TIBCO EMS server before it can be used by the runtime adapter.

Debug Level This field is valid only if the Log Debug Messages check box is selected, as described in Log Level Panel.

Select how much debugging output to be provided in the console window or log file location specified in the Log File field.

The options are:
  • Log no debug information
  • Log SQL commands executed against the database
  • Log binding data for each SQL Command (default)
  • Log all debug information
Generate Verbose Output This field is valid only if the Log Info Messages check box is selected, as described in Log Level Panel.

Select this check box to include verbose output (all available information) in the console window or log file location specified in the Log File field.

Generate Payload on Error Select this check box to log the Subscription Service reply payload information under Error role when an error occurs in Subscription Service.
Script File You can use the script file to change the location where the SQL script file is written.
Alerter Name Name of the alerter service registered in the database.
Note: When you use Oracle or Microsoft SQL Server databases, the value of the Alerter Name field cannot be null. If the value is null, the adapter configuration uses the existing adapter configuration name as the alerter name. If the adapter configuration name contains more than 30 characters, an error occurs in TIBCO Business Studio. This is because the alerter name length must be equal to or less than 30 characters.
Reconnection Configuration Panel
Maximum Number of Reconnect Attempts Total number of reconnection attempts to be made after a service is suspended. When this number is reached, the runtime adapter or adapter service is terminated. See the following two examples:
  • The value of 3 indicates that reconnection attempts continue 3 times.
  • The value of -1 indicates that reconnection attempts continue indefinitely.

To prevent data loss, it is good practice to configure preregistered listeners for a TIBCO Rendezvous Certified transport session.

When a database connection is lost, reconnection attempts vary according to different adapter services:

  • Publication Service obtains an exception immediately and attempts to reconnect to the database.
  • Subscription Service and Request-Response Service do not obtain an exception until the services receive a message. After that, they attempt to reconnect to the database.
Note: If you set a value for the adb.RetryTotal <total reconnection attempts> property in the adbagent.tra file, the value you set in TIBCO Business Studio is replaced.
Number of Reconnect Attempts Before Suspending Impacted Service(s) Number of reconnection attempts to be made before a service is suspended.

This field has a fixed value of 1, and the value cannot be changed.

Interval between Reconnect Attempts (milliseconds) Time interval (in milliseconds) at which reconnection attempts are made.
Note: If you set a value for the adb.SleepBetweenRetries <milliseconds of sleep between two reconnection attempts> property in the adbagent.tra file, the value you set in TIBCO Business Studio is replaced.
Adapter Services General Configuration Panel
Use Exception Table Select this check box to use an exceptions table. The exceptions table is defined when you create Subscription Service.
Number of Request-Response Service Default Session Threads Number of request-response threads to be used. Valid values are in the range 1 - n. Each thread has a separate connection to the database. You can specify multiple threads to load balance incoming RPC requests.