JNDI Connection Configuration

A JNDI Connection Configuration resource template provides a JNDI connection to look up a JMS server.

General

Property Editable? Required? Accepts SVars? Description
JNDI Provider Y Y N The provider to use for JNDI lookup:
  • TIBCO EMS
  • Progress SonicMQ
  • IBM MQ
  • Custom - Used for custom JNDI providers.

The Initial Context Factory field is populated based on the JNDI provider selected. SSL lookup is only available for the TIBCO EMS provider.

Default: TIBCO EMS.

Initial Context Factory Y Y Y Initial context factory to be used for the JNDI lookup. The value for Initial Context Factory is set based on the JNDI provider selected:
  • TIBCO EMS - com.tibco.tibjms.naming.TibjmsInitialContextFactory value is populated
  • Progress SonicMQ - the com.sonicsw.jndi.mfcontext.MFContextFactory value is populated
  • IBM MQ -
    • com.sun.jndi.ldap.LdapCtxFactory for the JNDI lookup in LDAP. Pair this value with the Naming Provider URL: ldap://<ldap_url>.
    • com.sun.jndi.fscontext.RefFSContextFactory for the JNDI lookup in a file system. Pair this value with the Naming Provider URL: file:<url_ of_bindings_file>.
  • Custom provider - Specify the custom initial context factory value.

Default: com.tibco.tibjms.naming.TibjmsInitialContextFactory

Provider URL Y Y Y Provider URL of the JNDI server. The value for Naming Provider URL is set based on the JNDI provider selected:
  • TIBCO EMS - tibjmsnaming://<host>:<port>
  • Progress SonicMQ - tcp://<host>:<port>
  • IBM MQ -
    • ldap://<ldap_url> for the JNDI lookup in LDAP. Example: ldap://mymachine.tibco.com:2076/dc=tibco,dc=com. Pair this value with the Initial Context Factory: com.sun.jndi.ldap.LdapCtxFactory.
    • file:<url_ of_bindings_file> for the JNDI lookup in a file system. Example: file:/D:/Program Files/IBM/fileBinding. Pair this value with the Initial Context Factory: com.sun.jndi.fscontext.RefFSContextFactory.
  • Custom - specify the custom provider URL.

Default: tibjmsnaming://<host>:<port>.

The Naming Provider URL is validated using recommendation of the "Uniform Resource Identifiers (URI): Generic Syntax" [RFC2396] standard for the TIBCO EMS, Progress SonicMQ and IBM MQ JNDI provider.

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 Y The name of an SSL Client Provider resource.

Advanced

A list of properties used for JNDI lookup.
Application Properties
Property Description
Name Name of the property.
Type Type of the property. One of: string, boolean, byte, short, char, int, long, float, or double.
Value Property value.

Default: Depends on value of 'Type'.

You can set a property value to a literal or a substitution variable.