JMS Connection Factory

A JMS Connection Factory creates an outbound connection to a JMS server.

Property Editable? Required? Accepts SVars? Description
Connection Factory JNDI Name Y Y Y JNDI name of the JMS Connection Factory that points to a particular queue or topic.
Maximum Pool Size Y Y Y (Optional) This property is available when creating a new JMS Connection Factory Resource Template. It can also be updated for an existing JMS Connection Factory Resource Template.

If no value is specified, the default value for Maximum Pool Size is 20. You can override the default value using the property com.tibco.amf.sharedresource.jms.connection.pool.maxsize in SystemNode.tra. The value can be specified in the TRA file as follows: 

java.property.com.tibco.amf.sharedresource.jms.connection.pool.maxsize=<new_value>

and also using the TIBCO ActiveMatrix Administrator UI:

  • property: com.tibco.amf.sharedresource.jms.connection.pool.maxsize
  • value: <new_value>

When you change the Maximum Pool Size of an existing Resource Template, the UI prompts you to reinstall all Resource Instances of that Resource Template. After the Resource Instances are re-installed, the new value of Maximum Pool Size is applied to runtime.

The SystemNode should be restarted after setting the Maximum Pool Size property.

NOTE: While creating a resource template, the value provided using the UI or CLI (via attribute maxPoolSize) takes precedence over the value specified in the SystemNode TRA file. The maxPoolSize attribute can be specified as follows. Refer to the <TIBCO_HOME>/administrator/<version_number>/samples/jmssr_data.xml configuration file for details.

<ResourceTemplate xsi:type="amxdata_jmsssr:JNDIConnectionFactoryResourceTemplate" name="NewJndiConnectionFactorySharedResource" jndiName="GenericConnectionFactory" jndiConnectionConfigurationName="NewJndiConnectionConfigurationSharedResource" description="JndiConnectionFactory" xa="false" maxPoolSize="20">

JNDI Connection Configuration Y Y N The name of a JNDI Connection Configuration resource.
Note: You can use a substitution variable for JNDI connection configuration in the JMS Connection Factory resource template in TIBCO ActiveMatrix Administrator.

Security

Property Required? Editable? Accepts SVars? Description
Enable Authentication N N N (Administrator UI only) Enable server authentication. When checked, the authentication properties: Login Credentials, Username, and Password are displayed. The Enable Authentication property is only available in the Administrator UI.

Default: Unchecked.

Login Credentials Y Y N Indicate how the credentials required to authenticate to a server are provided:
  • None
  • 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.

    Default: None

Username N Y N Username used to authenticate connections to the server.
Password N Y N User's password used to authenticate connections to the server.

(Administrator only) For superusers, passwords display encrypted. For non-superusers, the password doesn't 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.

Identity Provider N Y N Name of the Identity Provider resource used to authenticate the user.
Enable SSL

Y Y N Enable SSL connections. When checked, the SSL properties display.

Default: Unchecked.

SSL Client Provider

Y Y N The name of an SSL Client Provider resource.