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. The values for these properties are to be specified and configured 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 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.

Begin figure description. IMS TM Resource Adapter Version 12 and later. End figure description. With Version 12 and later, 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 The security authorization facility (SAF) group name.
hostName IMS Connect host name.
password SAF password.
portNumber IMS Connect port number.
queueNames 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 The time delay in milliseconds before the IMS TM resource adapter tries to check on the availability of the data store.
retryLimit 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.

Begin figure description. IMS TM Resource Adapter Version 11 Begin figure description. IMS TM Resource Adapter Version 12 For Version 11.3.1 and Version 12 and later, when the retryLimit value is set to -1, the IMS TM resource adapter will retry indefinitely to reconnect to IMS Connect if the backend IMS Connect or IMS data store is restarted.

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 week.
SSLKeyStoreName

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 The password for the keystore for TCP/IP SSL communications.
SSLTrustStoreName 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.
userName SAF user name.

Feedback