• Print
  • Share

IBM MQ

  • Updated on 18 Oct 2018
  • 3 minutes to read
  • Contributors

In this section, we will take a detailed look at how to monitor IBM MQ. Monitoring a queue involves creating the rules for settings the alert thresholds. With BizTalk360, you can monitor the health of the queue as well as other parameters associated with the queue. The other parameters include Current Queue Depth, Backout queue Depth, Current Queue usage, Backout Queue Usage and Message Age.

  • Log into BizTalk360
  • Click 'Monitoring' on top of the left Navigation menu
  • Click the expand button against the Manage Mapping and select Queues
  • Select the Alarm name (see Creating an alarm) from the drop down which you would like to associate the queue for monitoring
  • Click the IBM MQ tab to automatically list out all the Send Ports/Receive Locations which are using the MQSC adapter or the MQSeries adapter

BizTalk360-Monitoring-Queues-IBM-MQ.png

  • To configure a particular queue, click the Config icon at the most right column of the grid

IBM_grid.png

  • If you are using MQSC Adapter, BizTalk360 will automatically fetch all the details from the BizTalk admin console
  • If you are using MQSeries adapter, then you will need to manually enter Channel Name, Connection Name, User Id, and Password
  • Create the rules for threshold alerts under the queue configuration

IBM_Properties.png

While creating a rule in Queue monitoring, You can add up to 5 conditions for alert thresholds based on your needs. For each condition you add, you can create 2 sub-conditions (AND/OR).

  • Click Save Configuration to create monitoring for the Queue

In-depth look at Queue Monitoring Rules screen in BizTalk360

In this section, we will take a deep dive into the Queue Monitoring Rules screen to understand the functionality of every option and control present on the screen.

IBM_OptionScreen.png

  • Queue Manager Name - This option specifies the Queue Manager name that is responsible for transferring data to another queue manager via message channels. It’s a logical container for the message queue.
  • Queue Name - This option specifies the message queue name
  • Channel Name - This option specifies the channel name which is responsible for communicating between two queue managers. IBM MQ uses message channels to transfer messages between queue managers.
  • Connection Name - This attribute is the communication connection identifier
  • Transport Type - Currently BizTalk360 support TCP type only
  • User ID - The name of the user which has the authority to perform any operation on the queue. While creating a user in Computer Management, use a name with less than 8 characters
  • Password - User password
  • SSL Cipher Specification - Every MQ Channel definition includes the SSLCIPH attribute. The value is a string with a maximum length of 32 characters. SSL Cipher specification is optionally
  • SSL Peer Name - Peer name specifies the SSL Peer Name used on the channel. The SSL Peer attribute is used to check the Distinguished Name (DN) of the certificate from the peer queue manager or client at the other end of an IBM® WebSphere® MQ channel
  • Message Age Units - This metric configuration allows you to choose the time parameter (Day/Hour/Minutes/Seconds) for finding the duration of existing messages in the queue

Editing the Monitoring Rules

BizTalk360 allows users to modify the configured rules from the monitor results blade. The system doesn’t allow the users to edit the Queue Manager name and Queue name but allows to edit other properties and the rule conditions associated with the queue. For instance, the user wants to add a sub-condition to the existing rule condition.

Follow the steps as shown below to edit the rule information.

  • Click the Edit icon button against the queue you wish to edit.
  • Click the Configure Threshold button in the Monitor Results blade.
  • Edit the rules as per your requirements. In this case, you can click the icon at the end of the condition to add an operator.
  • Select the operator and enter the values.
  • Click Save Configuration to save monitoring for the Queue