Configuring the IAP JMS Properties File

The iapjms.properties file contains all the configuration information for the IAPJMS process. The iapjms.properties file enables you to configure the following settings:

IAP JMS Properties File

Property

Description

IAPJMSConnect.InitialContextFactory

Defines the J2EE initial context factory to be used for all J2EE connections within the application.

IAPJMSConnect.InitialURL

Defines the initial context URL, if required.

IAPJMSConnect.SecurityPrinciple

Defines the username, if security is set in the InitialContextFactory. For more information, see Updating the IAP Security Principle and Credentials.

IAPJMSConnect.SecurityCredentials

Defines the password, if security is set in the InitialContextFactory. For more information, see Updating the IAP Security Principle and Credentials.

IAPJMSConnect.SecurityEncryption

Defines the encryption method used for the IAPJMSConnect.SecurityCredentials parameter. Valid values are:

• PLAIN - Plain text format (default)
• IPE - iPE proprietary encryption (this mechanism is used by the swconfig utility when writing the password)

For more information, see Updating the IAP Security Principle and Credentials.

IAPJMSConnect.TopicConnectionFactory

Defines where the JMS topic details are configured. If a topic cannot be looked up then the topic is dynamically created by the IAPJMS process, if possible.

IAPJMSConnect.TimeToLive

Defines the maximum time to live for the JMS messages in milliseconds. If the property is set to 0 the messages never time out. For more information, see the documentation supplied with your J2EE Application Server.

IAPJMSConnect.Priority

Defines the priority of the JMS message in the system. For more information, see the documentation supplied with your J2EE Application Server.

WQDJMSConnect.ListenerThreads

Defines the number of socket listener threads that are created when the IAPJMS process starts up.

Note: This property is not present in theiapjms.properties file by default. It should only be set on instructions from TIBCO Support.

WQDJMSConnect.ConnectionPoolSize

Each work queue is required to publish its messages on the same JMS connection to ensure that messages appear in the correct order. Therefore, the IAPJMS process keeps a pool of JMS connection caches and ensures that all messages from each unique work queue are sent using the same connection. The connection pool is created when the IAPJMS process starts up.

This property, therefore, defines the connection pool size, which is the maximum number of connections available for JMS publication. Each connection will always be used for all items for a single work queue.

Note: This property is not present in the iapjms.properties file by default. It should only be set on instructions from TIBCO Support.