IBM MQ configuration properties

Sending transmittal messages to the DTA is done by using either Connect:Direct® or IBM MQ Notification. IBM MQ can be used to send notification messages when IBM MQ Notification is not configured. The Gateway Server can be configured to receive X9.37 files from a IBM MQ queue. For more information about configuring IBM MQ Notification, see IBM MQ for Notification Configuration Properties.

If the IBM MQ queue manager is configured for SSL connections, use the mqKeyStore, mqKeyStorePassword, and mqTrustStore properties to specify the SSL encryption algorithm to use and the location of the key and truststore files.

The IBM MQ connectivity is configured by using the properties in the following table.
Table 1. IBM MQ configuration properties
Property name Values or example Description
mqQmgrName FTM.QMANAGER The name of the IBM MQ queue manager.
mqUserId userid The user ID to use to access the IBM MQ queue manager and queue. The user ID is required only if the queue is defined to need a user ID and password to access it.
mqPassword Password The password to use to access the IBM MQ queue manager and queue. The password is required only if the queue is defined to need a user ID and password to access it.
mqSendQueue BANK_TO_DTA The name of the IBM MQ queue to use to send transmittal messages.
mqReceiveQueue DTA_TO_BANK The name of the IBM MQ queue to use to receive transmittal messages.
mqX937RcvQueue X9.37_RCV The name of the IBM MQ queue to use to receive incoming X9.37 files.
Note: This option does not apply to DTA and is not the same as mqReceiveQueue.
mqKeyStore c:/keys/mqkey.jks The fully qualified name of the file that contains the keystore.
mqKeyStoreFormat PKCS12 The format of keystore file. The values that can be used are JKS or PKCS12. The default value is PKCS12.
mqKeyStorePassword password The password that is used to access the keystore.
mqTrustStore c:/keys/mqkey.jks The fully qualified name of the file that contains the truststore.
mqTrustStoreFormat PKCS12 The format of truststore file. The values that can be used are JKS or PKCS12. The default value is PKCS12.
mqTrustStorePassword password The password that is used to access the truststore.
mqMaxUncommittedMsgs 1000 The maximum number of uncommitted IBM MQ messages that can exist within a unit of work. When large transmissions are processed, this property is used to prevent the number of messages that are placed on a Transaction Server queue from exceeding the maximum. The default value for this property is 1000.

Set this value to the same value as the IBM MQ maxUncommittedMsgs property that is configured for the queue manager. For more information, see the IBM MQ documentation.
The following table shows the values of cipher suite name that can be used. The cipher suite name corresponds to the cipher specifications name that is specified in the IBM MQ SSL configuration.
Table 2. Cipher suite names to use for the cipher specifications
Cipher specifications name Cipher suite name
NULL_MD5 SSL_RSA_WITH_NULL_MD5
NULL_SHA SSL_RSA_WITH_NULL_SHA
RC4_MD5_EXPORT SSL_RSA_EXPORT_WITH_RC4_40_MD5
RC4_MD5_US SSL_RSA_WITH_RC4_128_MD5
RC4_SHA_US SSL_RSA_WITH_RC4_128_SHA
RC2_MD5_EXPORT SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5
DES_SHA_EXPORT SSL_RSA_WITH_DES_CBC_SHA
RC4_56_SHA_EXPORT1024 SSL_RSA_EXPORT1024_WITH_RC4_56_SHA
DES_SHA_EXPORT1024 SSL_RSA_EXPORT1024_WITH_DES_CBC_SHA
TRIPLE_DES_SHA_US SSL_RSA_WITH_3DES_EDE_CBC_SHA

Configuring the client channel definition table (CCDT) file to connect to IBM MQ

All application pods connect to IBM MQ by using a JSON formatted CCDT file that is called mq-ccdt.json. This JSON file contains the following parameters.
  • The channel name.
  • Client-connection-related parameters such as the host name, port number, and the queueManager name.
  • Transmission security parameters such as the cipherSpecification.
This JSON file cannot be edited, but you can use a configmap to configure values for all these parameters except the channel name.

Add your values for IBM MQ to the ftm-mq-<ftm-instance>-ccdt-config configmap in Red Hat® OpenShift®. The FTM operator uses the contents of this configmap to update the mq-ccdt.json file.