The IBM MQ Monitor listens to a MQ Queue/Topic and then invokes an Event in Clarify when new messages are added to the Queue. The Event then executes a Business Process, receiving the message content as the payload.
How to create and configure
- Select File | New | IBM MQ Monitor from the main menu.
- Provide the Source folder, Package, and Name (if not already done so).
- Click Finish. An editor appears.
- Select or create the Event that the Monitor will launch. Place your cursor in the Event field and select from a list of existing Events. To create an Event, click the hyper-linked Event field label.
Note: Events use Event parameters to capture and hold information about the source data, and then transfer that information to Business Process parameters. Minimally, every Event contains the payload. All Clarify interface objects (File, Database, and Email Monitors, Message Filters, and Adapters) use this payload to transport source data into Clarify.
Host Name/IP: Enter the Host Name/IP of the IBM MQ Installation.
Port: Enter the Port of the IBM MQ Installation. Default is 1414.
Username: Enter username created as part of installation, if required for connection. Otherwise leave blank.
Password: Enter password created as part of installation, if required for connection. Otherwise leave blank.
Read MQMD Headers (checkbox): This enables the Monitor to read the MQMD headers which includes the JMS_IBM_MQMD_ApplIdentityData header. Note: For more information about this ApplIdentityData, please refer to ApplIdentityData
Queue Manager Name: Enter name of the Queue Manager. Every Queue should belong to a Manager. For example, QM1.
Channel Name: Enter the name of the Channel (created upon initial install)
Destination Type: Select Queue or Topic.
Destination Name: Enter the name of the Queue or Topic to which you are connecting to. This Destination Name has to be set to one of the Queue/Topic configured in the IBM MQ server.
Application Name: Optional. Enter the name of the Application. For example, you may wish to label a connection.
Starting the IBM MQ Monitor
IBM MQ Monitors are not enabled by default. They must be manually started once promoted to a server. These steps takes place in the Admin Console | Resource Monitors view. The Local Test or remote Server must be started.
From the Resource Monitor section, select the Monitor you wish to start and click Start ().
It's important to remember that these Monitors are deployed along with dependent objects. Always make sure the related objects exist and are complete before deploying a Monitor. A good practice is to make your Monitor one of the last objects you create.Enter the following details in the Settings view of the editor, based on the configuration of your IBM MQ installation.
Under the Resource Monitor Types section, select IBM MQ Monitor. All deployed Monitors appear in the Resource Monitors section. Any monitor that has already been started has a green indicator, while red indicators show that a monitor is not started.