Configure IBM MQ
Use the service port type IBM MQ to connect to IBM MQ queues or topics. For more information on JMS queues and topics, see chapter "Run JMS messages".
To use IBM MQ, you have to install the IBM MQ Client Library on the workstation on which the OSV environment runs (see chapter "Supported technologies".) |
You can specify the following attributes for your IBM MQ service port:
Attribute |
Description |
---|---|
Type |
Select Queue or Topic. Queues represent a one-to-one messaging pattern, while topics allow one-to-many messaging. |
Name |
Enter the name of the queue/topic you want to connect to. |
Host |
Enter the name of the workstation that hosts the broker. You must specify the correct host name and port to start the OSV environment. |
Manager |
Specify the name of the manager that manages the queue or topic. |
Channel |
Enter the name of the channel that transfers the messages. |
Username |
Enter your user name, to connect to queues/topics that require authentication. |
Password |
Enter your password, to connect to queues/topics that require authentication. |
MessageType |
Specify what type of message is either pushed to or pulled from the queue/topic. You can select Jms Text Message or Jms Byte Message. |
JMS Support |
Define whether the client type is JMS or native IBM MQ. You can select IBM MQ with JMS or IBM MQ with Native WMQ. |
Selector |
Define a selector to filter the headers and properties of incoming JMS messages. This enables you to receive only JMS messages that match your filter criteria. This JMS-specific selector is a string that contains an expression based on a subset of the SQL92 conditional expression syntax. For instance, you can use the selector JMSMessageID = 'ID:123:1:2:1:1' to filter the message headers for this message ID. For further details on selectors, refer to the IBM MQ documentation. |
Cipher Spec |
To enable encrypted communication (SSL), enter your combination of encryption algorithm and message authentication code algorithm. Example: ECDHE_ECDSA_AES_128_CBC_SHA256. |
Cipher Suite |
To enable encrypted communication (SSL), enter your suite of cryptographic algorithms. Example: SSL_RSA_WITH_RC4_128_MD5. |
Peer Name |
To enable encrypted communication (SSL), enter a string that contains the peer name. The peer name is the distinguished name of the certificate from the peer queue manager or client. |
Key Repository |
To enable encrypted communication (SSL), enter the file path to your key repository without file extension. |
Certificate Stores |
To enable encrypted communication (SSL), enter the URL of the certificate store server. If you use multiple certificate store servers, enter the URLs separated by comma. |
Port |
Specify the port used to access the broker. |
UnprocessableMessages |
Define how to handle messages in a queue that can no longer be processed by a client. This applies only to queues. Delete: If a client cannot process a message, this message is deleted. Keep: If a client cannot process a message, this message is kept and processed by another client. |
IBM MQ service port