Represents an outgoing HTTP connection. HTTP clients are used by a reference's SOAP binding.
General
The name of the host that accepts the incoming requests.
For machines that have only one network card, the default Y
Y Y
Machine Name
value localhost specifies the current machine. For machines that have more than one network card, this field specifies the host name of the card that used to accept incoming HTTP requests.
Default: localhost.
The port number on which to invoke outgoing HTTP requests.
The length of time to wait before closing an inactive connection. If more than zero, and data transmission has Y
Y N
Idle Timeout
(s) not finished, a call to close the connection blocks the calling program until the data is transmitted or until the specified timeout occurs. If 0, a call to close the connection returns without blocking the caller and an attempt is made to send the data. Normally this transfer is successful, but it cannot be guaranteed. This value should be changed only on the advise of TIBCO Support.
Default: 0 s.
Defines the socket timeout (SO_TIMEOUT), which is the timeout for waiting for data or a maximum period inactivity Y
Y N
Socket Timeout
(ms) between consecutive data packets. This should be changed
when connecting to very slow external services. A timeout value of zero is interpreted as an infinite timeout.
Default: 0 ms.
Determines the timeout until a connection is established.
This should be changed when connecting to very slow Y
Y N
Connection Timeout
(ms) external services. A timeout value of zero is interpreted as
an infinite timeout.
The timeout is influenced by operating system specific behavior at the TCP socket layer. On Windows 2008, Windows 7 and Windows XP the timeout value configured in this field is not honored, and instead it uses an internal timeout of around 21 seconds. Some versions of Linux, such as Ubuntu, also do not honor this timeout.
Description
Default: 0 ms.
SSL
Enable SSL connections. When checked, the SSL properties display.
The name of an SSL Client Providerresource template.
Y Y
N SSL Client Provider
(Administrator only) Invokes a wizard to import certificates from an SSL-enabled server, optionally create an SSL Client N
N N
Configure SSL
Provider resource template, and configure the trust store of the newly created or an existing SSL Client Provider with the imported certificates. When you complete the wizard, the SSL Client Provider field is filled in.
Advanced
Indicates whether the HTTP method should automatically follow HTTP redirects.
This option is used when client connection receives the redirect responses from server like Moved Permanently, Moved Temporarily, Temporary Redirect and so on.
N
When a TCP connection is closed, the connection might remain in a timeout state for a period of time after the N
N N
Reuse Address
connection is closed (typically known as the TIME_WAIT state or 2MSL wait state).
For applications using a well-known socket address or port, it might not be possible to bind a socket to the required SocketAddress if there is a connection in the timeout state involving the socket address or port.
Default: Unchecked.
Indicate whether to use the single or multi-threaded connection manager.
Determines whether the Nagle algorithm is used.
The Nagle algorithm tries to conserve bandwidth by minimizing the number of segments that are sent. When N
N N
Suppress TCP Delay
Description
applications wish to decrease network latency and increase performance, they can disable Nagle's algorithm by enabling Suppress TCP Delay.
Data will be sent earlier at the cost of an increase in bandwidth consumption and the number of packets.
Default: Checked.
Determines whether the stale connection check is to be used.
Disabling the stale connection check can result in slight N
N N
Stale Check
performance improvement at the risk of getting an I/O error when executing a request over a connection that has been closed at the server side.
Default: Unchecked.
Socket buffer size in bytes.
A suggestion to the kernel from the application about the size of the buffers to use for the data transferred over the socket.
Default: -1. Allow the runtime to determine the buffer size.
The timeout, in milliseconds, until a connection is established.
Local host address to be used for creating the socket.
Default: None.
Controls the maximum number of simultaneous active connection that this resource instance allows. The value Y
Y N
Maximum Total
Connections should be increased for application that creates a lot of long-lived connections.
Default: 20.
Controls the maximum number of simultaneous active connection to a same host that this resource instance allows.
Y Y
N Maximum Total
This number cannot be greater than Maximum Total Connections.
Default: 2.
Connections per Host
JDBC
Represents a JDBC connection. Used by component implementations to access databases.
General
The type of the JDBC connection:
N N
Y Connection
Type • Direct The connection to the database is through a
vendor-specific driver. When selected, the Database Driver and Database URL fields display.
• XA The connection to the database is through a vendor-specific data source. When selected, the Data Source field displays. A component implementation that uses a JDBC connection of connection type XA typically executes within a global transaction and consequently may not explicitly commit transactions. To ensure that such implementations always behave correctly, the TIBCO ActiveMatrix platform detects when such a resource is used outside of a global transaction and enables the JDBC autocommit feature, so that all database access by the component is committed.
Table 38: Direct
Description
The name of the JDBC driver class. You can select from a drop-down list of supported drivers or type the name of a custom driver:
Additional drivers available when using TIBCO Business Studio:
• com.ibm.as400.access.AS400JDBCDriver
• com.informix.jdbc.lfxDriver
• ca.edbc.jdbc.EdbcDriver
When you select a driver, the Database URL field is populated with a template for the URL of the driver.
Default: org.hsqldb.jdbcDriver.
Description
The URL to use to connect to the database. A template of the URL is supplied for the driver you select in the Database Driver field or you can type the name of a URL:
Y
• jdbc:db2://<host>:<portNumber>/<database name >
• jdbc:postgresql://<host>:<port>/DB Available when using TIBCO Business Studio:
• jdbc:as400://server<server_ip>;libraries=<lib>
• jdbc:informix-sqli://<host>:<port
>/<database>:informixserver=<server>
• jdbc:edbc://<host>:<port>/<database>
You must supply the portions of the URL shown between angle brackets and remove the angle brackets.
Default: jdbc:hsqldb:hsql://localhost:<port#>/<db_instance name>.
Table 39: XA
Description
The fully-qualified name of the javax.sql.XADataSource
implementation class. The supported classes are:
Y
The maximum number of database connections to allocate.
The minimum value that can be specified is 0.
Default: 10.
Description
Time to wait for a successful database connection. If the JDBC driver does not support connection timeouts, the Y
Y N
Login Timeout
(ms) value of this field is ignored. Only JDBC drivers that support connection timeouts use this configuration field. Most JDBC drivers support connection timeouts.
Default: 30000 (30 seconds).
(TIBCO Business Studio only) Indicate whether the application demarcates transaction boundaries. If N
Y N
Supports Transactions
unchecked, the application does not demarcate transaction boundaries and all SQL statements are autocommitted.
If checked, the application demarcates transaction boundaries.
Indicate how the credentials required to authenticate to a server are provided:
N Y
Y Login Credentials
• Username + Password - Provide inline username and password credentials. When selected, the Username and Password fields are activated.
• Identity Provider - Provide username and password credentials encapsulated in an identity provider resource.
When selected, the Identity Provider field is activated.
The username used to authenticate connections to the server.
N Y
N Username
The user's password used to authenticate connections to the server.
(Administrator only) For superusers, passwords display encrypted. For non-superusers, the password doesn't N
Y N
Password
display even if it was set when it was created. If you have permission to edit the password, you can specify a new value and save. If you edit other fields, the old value for the password field is retained. If you want to set an empty value as password, click the link Set Blank Password.
The name of the Identity Providerresource template used to authenticate the user.
Y Y
N Identity Provider
SSL
Enable SSL connections. When checked, the SSL properties display.
The name of an SSL Client Providerresource template.
Y Y
N SSL Client Provider
(Administrator only) Invokes a wizard to import certificates from an SSL-enabled server, optionally create an SSL Client N
N N
Configure SSL
Provider resource template, and configure the trust store of the newly created or an existing SSL Client Provider with the imported certificates. When you complete the wizard, the SSL Client Provider field is filled in.
Advanced
Properties to configure the connection between the JDBC resource and a specific type of host.
N N
Y Host Type Properties
Indicates whether the driver requires a commit to be performed before enabling auto-commit on a connection.
N N
Y Commit Before
This should be (and is, by default) set to false for compliant drivers to avoid extraneous commits to the database.
Default: false.
Auto Commit
The class used by the resource adapter to judge if an exception is fatal to the connection. That is, whether the N
N Y
Exception Sorter
Class connection pool should discard the connection from the
pool, since it is no longer reusable. As the name implies, the default SQLState08ExceptionsAreFatalSorter treats SQL State 8 exceptions as fatal (connection errors). All other exceptions do not result in any connection pool action (but of course are passed up to the application for it to react as it wishes). The class must implement
org.tranql.connector.ExceptionSorter. Default:
com.tibco.amf.sharedresource.runtime.tibcohost.jdbc.SQLState08ExceptionsAreFatalSorter. Maximum number of connections in the pool.
Default: 20.
Minimum number of connections in the pool.
Default: 5.
The length of time a requestor will wait for a connection when the pool is at maximum.
Default: 60000 ms.
N N
Y Pool
Blocking
Description
The length of time after which idle connections are closed.
Default: 5 min.
N
The size of the cache containing prepared statements. The size should correspond to the number of JDBC statements you expect your application to reuse.
Default: 0; that is, the cache is disabled.
N
Table 40: Direct
Description
Properties to configure connections to a database driver.
The properties are vendor specific.
N Y
N Connection Properties Table 41: XA
Description
Properties to configure connections to a data source. The properties are vendor specific.
N
Transactions on page 155