IBM MQ Connector > IBM MQ connections > IBM MQ connection properties
  

IBM MQ connection properties

When you set up an IBM MQ connection, configure the connection properties.
The following table describes the IBM MQ connection properties:
Property
Description
Connection Name
Name of the connection.
Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
Maximum length is 255 characters.
Description
Description of the connection. Maximum length is 4000 characters.
Type
The IBM MQ connection type.
Runtime Environment
The name of the runtime environment where you want to run the tasks.
Select the Secure Agent from the list as the runtime environment.
Host
The machine that hosts the Queue Manager component.
Port
The port number that connects to the Queue Manager component.
User Name
The user name to connect to the connection channel of the Queue Manager component.
Don't specify the user name when the channel authentication of the Queue Manager component is not enabled.
Password
The password to connect to the connection channel of the Queue Manager component.
Don't specify the password when the channel authentication of the Queue Manager component is not enabled.
Queue Manager
The Queue Manager component from which queues need to be listed to send or receive messages.
Channel
The server-connection channel that connects to a queue in the Queue Manager.
If you don't enable the channel authentication of the Queue Manager component, the default user account for the IBM MQ service writes data to the target.
Code Page
The code page of the Queue Manager component that the Secure Agent uses to read from or write to IBM MQ.
Select one of the following code pages from the list:
  • - UTF-8
  • - UTF-16
  • - MS Windows Latin 1
Default is UTF-8.
SSL
Specifies whether the connection uses an SSL socket to connect to IBM MQ.
Default is disabled.
To use custom cipher suites for your SSL connection, see the Custom cipher suite for the SSL-enabled connection Knowledge Base article.
Truststore File Path
The path and file name of the truststore file that contains the SSL certificate to connect to IBM MQ.
Specify both the directory and file name in the following format:
/root/<folder name>/<truststore file name>.jks
Truststore Password
The password to access the truststore file that contains the SSL certificate.
Keystore File Path
The path and file name of the SSL keystore file that contains private keys and SSL certificates to establish a two-way secure communication with IBM MQ.
Specify both the directory and file name in the following format:
/root/<folder name>/<keystore file name>.jks
Note: To establish a two-way secure communication with IBM MQ, you also need to enter values in the Truststore File Path, Truststore Password, and Keystore Password fields.
Keystore Password
The password to access the keystore file that contains the SSL certificate.
Skip Metadata Fetch
Determines whether Data Integration bypasses retrieving and listing the IBM MQ queue names when you configure the source or target:
  • - If you enable the option, Data Integration bypasses retrieving and listing the IBM MQ queue names. Instead, a placeholder queue name displays in the object list when you configure the source or target, and requires you to specify the queue name for the source or target in the advanced runtime properties in the mapping.
  • - If you don’t enable the option, Data Integration retrieves and displays all available IBM MQ queue names in the object list when you configure the source or target in the mapping.
Default is disabled.