ManageEngine® Applications Manager

IBM WebSphere MQ

Monitored Parameters

IBM WebSphere MQ servers are monitored based on the attributes such as listener stats, channel monitoring, etc. and the different web applications and EJB deployed in the server. You can also monitor the operation of the queue managers through event logs. The monitoring details of IBM WebSphere MQ server are represented graphically that helps to understand the parameters with ease. You can also configure thresholds to the attributes monitored by the server based on these details.

Availability tab, gives the Availability history for the past 24 hours or 30 days. Performance tab gives the Health Status and events for the past 24 hours or 30 days. List view enables you to perform bulk admin configurations. Click on the individual monitors listed, to view the following information.

The WebSphere MQ server attributes monitored are classified under the following tabs in Applications Manager:

Monitor Information
Performance Overview
Queues
Channels
Listeners
Services
Event Log
Configuration

Monitor Information

Parameter	Description
Name	The Display name of the Monitor
Health	Represents the health status
Last Polled at	Time at which the previous poll had started
Next Poll at	Time at which the next poll has been scheduled
Availability	Shows the current status of the server - available or not available.

Performance Overview

Parameter	Description
Name	The Display name of the monitor
Health	Represents the health status
Command Server Status	Specifies the status the command server. It used to check whether the command server on the target queue manager is running or not
Channel Initiator Status	Specifies the status the channel initiator. It used to check whether the channel initiator on the target queue manager is running or not
Active Connections	The current number of connections to the queue manager.
Graphical View of Events Count	Count of events occurred in the below category in last data collection. Queue Manager Channel Performance Configuration Command Logger

Queues

Parameter	Description
Queue Name	Name of the Queue
Current Depth	Current queue depth.
% of Queue Occupied	Percentage of Queue Depth occupied against the max Queue Depth.
Open Input Count	Open input count (parameter identifier: MQIA_OPEN_INPUT_COUNT).
Open Output Count	Open output count (parameter identifier: MQIA_OPEN_OUTPUT_COUNT)
Health	Health of the Queue based on all the above attributes
Queue Usage Graph	Graphical view queue depth percentage against the max Queue Depth
% of Queue Free	Percentage of Queue Depth free against the max Queue Depth
Uncommitted Messages	It indicates whether there are any uncommitted changes (puts and gets) pending for the queue. YES - There are uncommitted changes pending. NO - There are no uncommitted changes pending.
Oldest Message Age	The age, in seconds, of the oldest message on the queue.
Latency	The interval, in seconds, between messages being put on the queue and then being destructively read.
Trigger Control	It indicates whether the triggering on the queue enabled or not. On triggering enabled for this queue. Off triggering not enabled for this queue.

Channels

Parameter	Description
Channel Name	Name of the Channel
Status	Status of the channel - running
Bytes Sent	Number of bytes sent
Bytes Received	Number of bytes Received
Buffers Sent	Number of buffers sent
Buffers Received	Number of buffers Received
Availability	Availability of Channel,based on the status attribute.If the status of the channle is RUNNING then it is considered to be available .If the channel is in other states then it is considered to be down.
Health	Health of the Channel based on all the above attributes
Compression Time	The amount of time per message, displayed in milliseconds, spent during compression or decompression.
Compression Rate	Rate of compression achieved in percentage.

Listeners

Parameter	Description
Listener Name	Specifies the name of the listener
Status	The current status of the listener. The value can be: Initializing Running Stopping
Session Count	The number of sessions that the listener can use. This is valid only on Windows.
Backlog	The number of concurrent connection requests that the listener supports.
Health	Health of the Listener based on all the above attributes

Services

Parameter	Description
Name	Name of the service
Mode	Specifies on which mode the service was started Manual - The service is not to be started automatically or stopped automatically. It is to be controlled by user command. Queue Manager - The service is to be started and stopped at the same time as the queue manager is started and stopped Queue Manager Start - The service is to be started at the same time as the queue manager is started, but is not request to stop when the queue manager is stopped.
Type	Type of the service Server - Only one instance of the service can be executed at a time Command - Multiple instances of the service can be started
Start Time	Specifies at which time the service was started.It is applicable only for Server type of service
Alteration Time	Specified at which time the service configuration was last altered.
Status	Status of the service: Starting Running Stopped It is applicable only for the server type of service

Event Log

WebSphere MQ events provide information about errors, warnings, and other significant occurrences in a queue manager. You can monitor the operation of the queue managers by analyzing these events. When an event occurs, the queue manager puts an event message on the appropriate event queue. The event message contains information about the event.

Search Options :

We have provided the On-demand event search with multiple search options in 'Event Log' tab. You can also export the event search result to PDF.

Event Category
From Date
To Date
Event Type
Any keyword in the event message

Note:

All the messages in the event queue will be cleared when you restart the queue manager.
If the event queue reaches the max depth limit then the further events will not be stored in the queue. So set the threshold for '% of Queue Occupied' property for the event queues to avoid loss of event message.
All the events are not enabled by default. You can check the enabled or disabled events in the Event Log tab of the MQ monitor details page. Events can be enabled using MQSC commands.
Enable only necessary events. Because it will slightly affect the performance of the queue manager. Check the following link to control events: http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp?topic=%2Fcom.ibm.mq.csqzax.doc%2Fmo10670_.htm
Currently, we are only displaying the count of events occurred in each category. We do not have the option to monitor the events.

Events & Corresponding Queues

Events	Queues
SYSTEM.ADMIN.QMGR.EVENT	Local, Remote, Inhibit, Authority, Start & Stop
SYSTEM.ADMIN.CHANNEL.EVENT	IMS Bridge, Channel, SSL
SYSTEM.ADMIN.PERFM.EVENT	Performance
SYSTEM.ADMIN.CONFIG.EVENT	Configuration
SYSTEM.ADMIN.COMMAND.EVENT	Command
SYSTEM.ADMIN.LOGGER.EVENT	Logger

Event Categories:

Events

Queues

Start and Stop Events

Event Name	Identifier	Reason Code
Queue Manager Active	MQRC_Q_MGR_ACTIVE	2222
Queue Manager Not Active	MQRC_Q_MGR_NOT_ACTIVE	2223

Performance Events

Event Name	Identifier	Reason Code
Queue Depth High	MQRC_Q_DEPTH_HIGH	2224
Queue Depth Low	MQRC_Q_DEPTH_LOW	2225
Queue Full	MQRC_Q_FULL	2053
Queue Service Interval High	MQRC_Q_SERVICE_INTERVAL_HIGH	2226
Queue Service Interval OK	MQRC_Q_SERVICE_INTERVAL_OK	2227

Configuration Events

Event Name	Identifier	Reason Code
Change Object	MQRC_CONFIG_CHANGE_OBJECT	2368
Create Object	MQRC_CONFIG_CREATE_OBJECT	2367
Delete Object	MQRC_CONFIG_DELETE_OBJECT	2369
Refresh Object	MQRC_CONFIG_REFRESH_OBJECT	2370

Channel Auto Definition Events

DISABLED

Channel Events

Event Name	Identifier	Reason Code
Channel Activated	MQRC_CHANNEL_ACTIVATED	2295
Channel Auto-Definition Error	MQRC_CHANNEL_AUTO_DEF_ERROR	2234
Channel Auto-Definition OK	MQRC_CHANNEL_AUTO_DEF_OK	2233
Channel Blocked	MQRC_CHANNEL_BLOCKED	2577
Channel Conversion Error	MQRC_CHANNEL_CONV_ERROR	2284
Channel Not Activated	MQRC_CHANNEL_NOT_ACTIVATED	2296
Channel Not Available	MQRC_CHANNEL_NOT_AVAILABLE	2537
Channel Started	MQRC_CHANNEL_STARTED	2282
Channel Stopped	MQRC_CHANNEL_STOPPED	2283
Channel Stopped By User	MQRC_CHANNEL_STOPPED_BY_USER	2279

Command Events

Event Name	Identifier	Reason Code
MQSC command is executed	MQRC_COMMAND_MQSC	2412
PCF command is executed	MQRC_COMMAND_PCF	2413

SSL Events

Event Name	Identifier	Reason Code
Channel SSL Error	MQRC_CHANNEL_SSL_ERROR	2371
Channel SSL Warning	MQRC_CHANNEL_SSL_WARNING	2552

Remote Events

Event Name	Identifier	Reason Code
Default Transmission Queue Type Error	MQRC_DEF_XMIT_Q_TYPE_ERROR	2198
Default Transmission Queue Usage Error	MQRC_DEF_XMIT_Q_USAGE_ERROR	2199
Queue Type Error	MQRC_Q_TYPE_ERROR	2057
Remote Queue Name Error	MQRC_REMOTE_Q_NAME_ERROR	2184
Transmission Queue Type Error	MQRC_XMIT_Q_TYPE_ERROR	2091
Transmission Queue Usage Error	MQRC_XMIT_Q_USAGE_ERROR	2092
Unknown Default Transmission Queue	MQRC_UNKNOWN_DEF_XMIT_Q	2197
Unknown Remote Queue Manager	MQRC_UNKNOWN_REMOTE_Q_MGR	2087
Unknown Transmission Queue	MQRC_UNKNOWN_XMIT_Q	2196

Authority Events

Event Name	Identifier	Reason Code
Not Authorized Type	MQRC_NOT_AUTHORIZED	2035

Inhibit Events

Event Name	Identifier	Reason Code
Get Inhibited	MQRC_GET_INHIBITED	2016
Put Inhibited	MQRC_PUT_INHIBITED	2051

Logger Events

Event Name	Identifier	Reason Code
Logger Status	MQRC_LOGGER_STATUS	2411

Local Events

Event Name	Identifier	Reason Code
Alias Base Queue Type Error	MQRC_ALIAS_BASE_Q_TYPE_ERROR	2001
Unknown Alias Base Queue	MQRC_UNKOWN_ALIAS_BASE_Q	2082
Unknown Object Name	MQRC_UNKNOWN_OBJECT_NAME	2085

Bridge Events

Event Name	Identifier	Reason Code
Bridge Started	MQRC_BRIDGE_STARTED	2125
Bridge Stopped	MQRC_BRIDGE_STOPPED	2126

Configuration

Parameter	Description
Name	The Display name of the Monitor
Queue Manager	Name of the Queue Manager
Command Queue	Name of the Command Input Queue
Dead Letter Queue	Name of the Dead Letter Queue
Transmission Queue	Name of the Transmission Queue
Max length of Message	Specifies length of the longest message that the queue manager can handle
Max Number of Handles	Specifies the maximum number of open handles that any one task can use concurrently
Max Uncommitted Messages	Specifies the maximum number of uncommitted messages that can exist within a unit of work.
Max Trigger Interval	Specifies the time interval (in milliseconds) used to restrict the number of trigger messages
Platform	The operating system on which the queue manager is running
Version	Version number of the queue manager

You can also compare the values between the various attributes.

See Also

Creating New Monitor - IBM WebSphere MQ

IBM WebSphere Message Broker Monitoring

<< Prev	Home	Next >>
WebLogic Integration Servers		IBM WebSphere Message Broker