How to enable WebSphere MQ events

Process Events enable the processing of WebSphere MQ events of various types. These events correspond to events WebSphere MQ places on the SYSTEM.ADMIN.QMGR.EVENT, SYSTEM.ADMIN.CHANNEL.EVENT, SYSTEM.ADMIN.CONFIG.EVENT, and SYSTEM.ADMIN.LOGGER.EVENT queues. For events to be generated and placed onto these system queues, the respective events must be enabled for the queue manager for which events are required. This can be done from the Events tab of the Properties view for the queue manager.

In some instances, WebSphere MQ puts multiple event types onto an event queue. The supported event types are mapped to the system event queues as shown below:

  • SYSTEM.ADMIN.QMGR.EVENT receives Authority Events (not available on z/OS), Inhibit Events, Local Events, Remote Events, and Start/Stop Events (not available on z/OS for initial queue manager start)
  • SYSTEM.ADMIN.CHANNEL.EVENT receives Channel Events, SSL Events and Bridge Events (available on z/OS only)
  • SYSTEM.ADMIN.CONFIG.EVENT receives Configuration Events
  • SYSTEM.ADMIN.LOGGER.EVENT receives Logger Events (not available on z/OS)

Event messages on the SYSTEM.ADMIN.COMMAND.EVENT, SYSTEM.ADMIN.PERFM.EVENT, and SYSTEM.ADMIN.PUBSUB.EVENT event queues are not processed.

Related topics

Defining-events-triggers-and-actions

What-are-events-and-how-to-define-them

What-are-actions-and-how-to-define-them

You can use agentpref to enable events:

agentpref --host <AgentHostname) --port <QpeaPort> --set "WebSphere MQ Monitor" ProcessChannelMQEvents true
 agentpref --host <AgentHostname) --port <QpeaPort> --set "WebSphere MQ Monitor" ProcessConfigMQEvents true
 agentpref --host <AgentHostname) --port <QpeaPort> --set "WebSphere MQ Monitor" ProcessLoggerMQEvents true
 agentpref --host <AgentHostname) --port <QpeaPort> --set "WebSphere MQ Monitor" ProcessQMgrMQEvents true

where:

--host is the hostname of the agent machine where QPEA is running (required unless specified in an eaapi.ini file or agent on the same machine).
--port is the port number for QPEA (optional, defaults to 2612 or as specified in an eaapi.ini file).

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*