Creating accounts

Create a new IBM® MQ account for IBM MQ connector.

1. Select your project.
2. Click Connectors. You get a list of available connectors.
3. Search for the Available connectors using the search bar.
   • Click Search.
   • Type IBM MQ.
   • Click IBM MQ connector.
4. Provide details in the Account page of the Add account page.
   • In the Name field, specify a name for the account.
   • In the Description field, provide a short description of the account.
5. Provide details in the Basic configuration section.
   • In the Host name field, specify the name of the system on which the IBM MQ queue manager is installed. Alternatively, you can specify the IP address instead of the hostname in this field. The field is important for a remote connection.
   • In the Queue manager name field, specify the name of a queue manager to which you want to connect. The queue manager’s name is case-sensitive and must match the name as on the IBM MQ queue manager. The field is important for a remote connection.
   • In the TCP/IP port field, specify the port number where the IBM MQ queue manager listens for client requests.
   • In the Queue name(s) field, specify the name of the queue from which you want to send and receive messages. You can specify more than one queue name in this field separated by a space.

     Specifying multiple queues allows the Put action to broadcast a message to every queue in the list. However, the list of queue names cannot contain the name of a model queue. The Get, Peek, and Put With Acknowledgementactions use the first queue name in the list.

   • In the User idfield, specify the ID to connect to the secured queue manager.
   • Server connection channel - The name of the server connection channel that is assigned to a connection to the server from the client. The field is important for a remote connection.
     Note: The value for server connection channel is case-sensitive. Maximum characters - 20.
   • In the Passwordfield, specify the password for the user ID to connect to the secured queue manager.
   • In the CCSID field, specify IBM’s Coded Character Set Identifiers (CCSID), an alpha-numeric value that specifies the code page of the character-encoding scheme that the webMethods Integration Server wants to use. The CCSID specified for a remote connection is used only while connecting to the remote queue manager. The field is a mandatory field. For valid CCSID values, see IBM MQ server documentation..
   • In the Encoding field, provide the value that specifies the numeric-encoding scheme that webMethods Integration Server requests to use. The encoding that is specified for a remote connection is used only while connecting to the remote queue manager. The default is 00273 - Native. The field is a mandatory field.
   • In the Cache overridden connections field, specify an IBM MQ connector to enable or disable caching of overridden action connections at runtime. When you override the action's connection parameters at runtime, the IBM MQ connector creates a new connection with the updated parameters. The connection that is created is cached to enhance performance but might sporadically result in many open connections. To avoid many open connections, set the parameters:
     • true- Enables internal caching of overridden connections. true is the default value.
     • false- Disables internal caching of overridden connections.
   • Transactional- The transaction type you want to enable that selects how the connector must handle the transaction before disconnecting.

     The following are the two types of Transactional mode -

     • COMMIT- Commits the transaction before disconnecting. COMMIT is the default value.
     • ROLLBACK- Rolls back the transaction before disconnecting.
6. Provide details in the Advanced configuration section.
   • In the Truststore aliasfield, specify the alias for the truststore file.
   • In the Keystore alias field, specify the alias for the keystore file.
   • In the Cipher specifications field, specify the cipher specifications that you can use with the IBM MQ queue manager. The default value is TLS_RSA_WITH_AES_128_CBC_SHA256.
7. Click Next.
8. Provide details in the Advanced settings page of the Add account page to configure connection pooling manually.
   Enable connection pooling - By default, the Enable connection pooling is False. Slide the toggle to True to enable manual configuration of connection pooling settings.

   Minimum pool size

   The minimum number of connection objects that remain in the connection pool anytime. When the connector creates the pool, it creates this number of connections. The default value is 1.

   Maximum pool size

   The maximum number of connection objects that can exist in the connection pool. When the connection pool reaches its maximum number of connections, the connector reuses any idle connections in the pool. Or, when all connections are active, it waits for a connection to become available. The default value is 10.

   Block timeout (ms)

   The length of time in milliseconds IBM MQ waits to obtain a connection with the IBM MQ server before it times out and returns an error. The default value is 1000.

   Expire timeout (ms)

   The length of time in milliseconds that an inactive connection can remain in the pool before it is closed and removed from the pool. For example, to specify 10 seconds, specify 10000. Enter 0 to specify no timeout. The default value is 1000.

   Note: IBM MQ connector does not violate the Minimum Connections parameter. These connections remain in the pool regardless of how long they are idle.

9. Click Next.
10. Verify the connection details.