Chat now with support
Chat with Support

Foglight for IBM WebSphere MQ 5.5.5.9 - Installation Guide

Queue manager events

To set queue manager event properties:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select the instance of the MQ Agent whose properties you want to modify and click Edit Properties.
3
Locate the Event Settings properties.
4
Select the Queue Manager Events option: True or False.
•
Select True if you want the MQ Agent to monitor queue manager events. Otherwise, select False.
5
Select the Consume Queue Manager Event Message option: True or False.
 
* 
NOTE: This agent property requires a get permission on this queue. This permission is set on the IBM WebSphere MQ Server.
•
Select True if you want the MQ Agent to remove events from the SYSTEM.ADMIN.QMGR.EVENT queue as they are read.
or
•
Select False if you want the MQ Agent to retain queue manager events in the SYSTEM.ADMIN.QMGR.EVENT queue as they are read.
When this option is set to False, the MQ Agent does not consume any events in event queues. With no other means to remove event messages from the event queues, the event queues become full, and the corresponding event collection does not work.
6
Select the queue manager event list that you want to use from the Queue Manager Event List.
7
Optional — Clone the selected queue manager event list.
a
Click the Clone button to the right of Queue Manager Event List.
b
In the dialog box that opens, type a name for the cloned list.
8
Update the cloned list.
a
Click the Edit button to the right of Queue Manager Event List.
A dialog box opens, listing the available queue manager events, and indicating if they are enabled. The MQ Agent includes the following queue manager events:
 
Table 8. Queue manager events
Queue Manager Event
Description
Alias Base Queue Type Error
The specified alias queue is not a local queue, or in a local definition of a remote queue.
Default Transmission Queue Type Error
The specified remote queue cannot be found on the destination queue manager, so the local queue manager attempted to use the default transmission queue. However, although there is a queue defined by the DefXmitQName queue-manager attribute, it is not a local queue.
Default Transmission Queue Usage Error
The specified remote queue cannot be found on the destination queue manager, so the local queue manager attempted to use the default transmission queue. However, the queue defined by the DefXmitQName queue-manager attribute does not have a Usage attribute of MQUS_TRANSMISSION.
Get Inhibited
MQGET calls are currently inhibited for the queue.
Not Authorized
Indicates unauthorized access to application resources, such as an application trying to open a queue for which it does not have the required authority, or a command being issued from a user ID that does not have the required authority.
Put Inhibited
MQPUT and MQPUT1 calls are currently inhibited for the queue.
Queue Manager Active
A queue manager became active.
Queue Manager Not Active
A queue manager was requested to stop.
Queue Type Error
The ObjectQMgrName field specifies the local definition of a remote queue (in order to specify a queue-manager alias). In that local definition, the RemoteQMgrName attribute is the name of the local queue manager. However, the ObjectName field specifies the name of a model queue on the local queue manager.
Remote Queue Name Error
A local definition of a remote queue (or an alias to one) was specified, but the RemoteQName attribute in the remote queue definition is blank, or the ObjectQMgrName field in the object descriptor is not blank and does not contain the name of the local queue manager, but the ObjectName field is blank.
Transmission Queue Type Error
The ObjectName or ObjectQMgrName field in the object descriptor specifies the name of a local definition of a remote queue but either XmitQName is not blank and specifies a remote queue, or it is blank and RemoteQMgrName specifies a remote queue.
Transmission Queue Usage Error
A message is to be sent to a remote queue manager, but one of the following occurred:
•
ObjectQMgrName specifies the name of a local queue, but it does not have a Usage attribute of MQUS_TRANSMISSION.
•
ObjectName or ObjectQMgrName in the object descriptor specifies the name of a local definition of a remote queue and either XmitQName is not blank but specifies a queue that does not have a Usage attribute of MQUS_TRANSMISSION, or XmitQName is blank and RemoteQMgrName specifies a queue that does not have a Usage attribute of MQUS_TRANSMISSION.
•
The queue name is resolved through a cell directory, and the remote queue manager name obtained from the cell directory is the name of a local queue, but it does not have a Usage attribute of MQUS_TRANSMISSION.
Unknown Alias Base Queue
The BaseObjectName in the specified alias queue is not recognized as a queue or topic name.
Unknown Default Transmission Queue
The specified remote queue cannot be found on the destination queue manager, so the local queue manager attempted to use the default transmission queue. However, the queue defined by the DefXmitQName queue-manager attribute is not the name of a locally-defined queue.
Unknown Object Name
The ObjectName in the object descriptor is not recognized as the specified object type.
Unknown Remote Queue Manager
Placing a message on a remote queue failed due to an unresolved queue name.
Unknown Transmission Queue
Placing a message on a remote queue failed due to an unresolved queue name. The XmitQName attribute of the definition is not blank and not the name of a locally-defined queue.
b
In the dialog box, click Add Row to add an entry.
For each row, define the following values:
Queue Manager Event: Type the name of the queue manager event.
Monitor: Select the check box to enable the monitoring of this event, or clear the check box to disable monitoring.
c
Click Save Changes in the dialog box. The dialog box closes.
9
In the display area, click Save.
10
To set the agent manager statistic event options, see Statistics events properties.
Otherwise, click Back to Agent Status and activate the MQ Agent, as described in Activating MQ Agent instances and starting data collection .

Statistics events properties

Use the Statistics Events agent property to set the statistics events and reset the queue.
To set the statistics events property:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select the instance of the MQ Agent whose properties you want to modify and click Edit Properties.
3
Locate the Statistics Events property.
4
Select the Consume Statistics Event Message option: True or False.
 
* 
NOTE: This agent property requires a get permission on this queue. This permission is set on the IBM WebSphere MQ Server.
•
Select True if you want the MQ Agent to remove statistics events from the SYSTEM.ADMIN.STATISTICS.EVENT queue as they are read.
or
•
Select False if you want the MQ Agent to retain statistics events in the SYSTEM.ADMIN.STATISTICS.EVENT queue as they are read.
When this option is set to False, the MQ Agent does not consume any statistic messages in event queues. With no other means to remove event messages from the event queues, the event queues become full, and the corresponding event collection does not work.
5
Click Save.
6
To set the agent monitoring of listeners, see Listener monitoring property.
Otherwise, click Back to Agent Status and activate the MQ Agent, as described in Activating MQ Agent instances and starting data collection .

Listener monitoring property

Use the Miscellaneous agent properties to set the monitoring of the listeners.
 
* 
IMPORTANT: The MQ Agent can discover and monitor listener processes. However, no dashboards are currently available to view this data.
To set miscellaneous properties:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select the instance of the MQ Agent whose properties you want to modify and click Edit Properties.
3
Locate the Miscellaneous property.
4
Select the Monitor Listeners option: True or False.
•
Select True to enable the monitoring of the listeners. Otherwise, select False.
5
Click Save.
6
To set the batch query size and frequency, see Advanced (batch) properties.
Otherwise, return to the Agent Status page and activate the MQ Agent, as described in Activating MQ Agent instances and starting data collection .

Advanced (batch) properties

Use the Advanced Settings agent properties to specify the rate at which the MQ Agent polls the MQ Server, and the size of the batch it reads.
To set the advanced (batch) settings properties:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select the instance of the MQ Agent whose properties you want to modify and click Edit Properties.
3
Locate the Advanced Settings properties.
4
In the Batch Inquiry Delay Interval (milliseconds) box, type a value for the amount of time the MQ Agent should wait between successive queries of the MQ Server. The default value is 300 milliseconds.
5
In the Batch Inquiry Size (Queues, Channels) box, type a value for the number of objects to query at one time. The default is ten.
6
Click Save.
7
To set the sample frequency for data collection, see Data collection scheduler property.
Otherwise, click Back to Agent Status and activate the MQ Agent, as described in Activating MQ Agent instances and starting data collection .
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating