IMSActivationSpec property configuration for message-driven beans

The values of the properties of the IMSActivationSpec object describe the inbound communication from IMS to be used by message-driven beans.

You must configure an instance of the IMSActivationSpec object when you deploy a message-drive bean in order for the IMS TM resource adapter to communicate with IMS Connect for retrieving and responding to synchronous callout messages.

The following table describes the properties for the IMSActivationSpec object, the implementation of the J2C activation specification in IMS TM resource adapter. Specify and configure the values for these properties by using the administrative console in WebSphere® Application Server.

Properties in the J2C activation specification that are not listed in the following table are not supported by the IMS TM resource adapter.

Table 1. Properties for the IMSActivationSpec object
Propertiesk	Description
dataStoreName	Specifies the IMS data store name. The name must match the ID parameter of the Datastore statement that is specified in the IMS Connect configuration member when IMS Connect is installed. It also serves as the XCF member name for IMS during cross-system coupling facility (XCF) communications between IMS Connect and OTMA. The data store name can be a comma-separated list of data store names, enabling one instance of the IMSActivationSpec class to pull callout messages from more than one IMS data store.
groupName	Specifies the security authorization facility (SAF) group name.
hostName	Specifies the IMS Connect host name.
password	Specifies the SAF password.
portNumber	Specifies the IMS Connect port number.
queueNames	Specifies a comma-delimited list of IMS OTMA tpipe names for the callout (synchronous or asynchronous) messages. Queue names must be 1 to 8 alphanumeric characters (A-Z, 0-9, @, #, $).
retryInterval	Specifies the time delay in milliseconds before the IMS TM resource adapter tries to check on the availability of the data store.
retryLimit	Specifies the maximum number of times the IMS TM resource adapter will attempt to reconnect to IMS Connect if a connection is lost due to IMS Connect or IMS data store availability issues.
SSLEnabled	Instructs the IMS TM resource adapter to create a Secure Sockets Layer (SSL) socket connection to IMS Connect by using the specified host name and port number in the IMSActivationSpec object. This property is valid for TCP/IP connections only.
SSLEncryptionType	Specifies the SSL encryption type. Valid values are `strong` and `weak`.
SSLKeyStoreName	Specifies the name, including the full file path, of the keystore for TCP/IP SSL communications. Private keys and their associated public key certificates are stored in password-protected databases called keystores. Trusted certificates can also be stored in the keystore, and the truststore property can either be empty or could point to the keystore file. An example of a keystore name is c:\keystore\MyKeystore.ks. The file can have other file extensions.
SSLKeyStorePassword	Specifies the password for the keystore for TCP/IP SSL communications.
SSLTrustStoreName	Specifies the name, including the full path, of the keystore file that contains security credentials (certificates) for TCP/IP SSL communications. A value for the SSLTrustStoreName property is not mandatory if a keystore is used. A truststore file is a key database file that contains public keys or certificates. Private keys can also be stored in the truststore, and the keystore property can either be empty or could point to the truststore file. An example of a truststore name is c:\keystore\MyTruststore.ks. The file can have other file extensions.
SSLTrustStorePassword	The password for the truststore for TCP/IP SSL communications.
connectionPoolEnabled	Specifies whether to enable connection pooling. true Enables IMS TM Resource Adapter to create a connection pool for synchronous callout responses that are sent back to IMS. false Disables connection pooling. IMS TM Resource Adapter creates and then discards a new connection whenever a synchronous callout response is sent. The default value is `false` (for compatibility with earlier versions of IMS TM Resource Adapter).
durationOfIdleConnections	Specifies the number of minutes that a connection in the connection pool can remain idle before it is cleaned up at the next cleanup interval. The default value is `0`, which causes an idle connection to be cleaned up immediately. This property is ignored if the connectionPoolEnabled property is `false`.
maxConnections	Specifies the maximum number of connections that the connection pool can hold. If the pool is full, all new connections are discarded. The default value is `1`. This property is ignored if the connectionPoolEnabled property is `false`.
poolCleanupFrequency	Specifies the cleanup interval (in minutes) for idle connections in the connection pool. The default value is `20`. This property is ignored if the connectionPoolEnabled property is `false`.
sendOnlyWithAck	Specifies whether to enable the send-only-with-acknowledgment protocol. true Enables the protocol. IMS TM Resource Adapter receives an acknowledgment from IMS when IMS receives a synchronous callout response message. false Disables the protocol. The default value is `false` (for compatibility with earlier versions of IMS TM Resource Adapter).
userName	SAF user name.