Configuration events

Configuration events are generated when a configuration event is requested explicitly, or automatically when an object is created, modified, or deleted.

A configuration event message contains information about the attributes of an object. For example, a configuration event message is generated if a namelist object is created, and contains information about the attributes of the namelist object.

The event messages for configuration events are put on the SYSTEM.ADMIN.CONFIG.EVENT queue.

Configuration events work in the following way:

• An audit trail of changes to the queue manager configuration is kept by means of event messages, which are written to the SYSTEM.ADMIN.CONFIG.EVENT queue. We can enable these events to be written by means of the CONFIGEV parameter on the ALTER QMGR command.
• These events are generated when a DEFINE, ALTER or DELETE command acts upon an object, or an MQSET call is used.
• We can create a base-line picture of the current queue manager configuration by using the REFRESH QMGR TYPE(CONFIGEV) command, which will create an event message for every object in the queue manager. Note that since this could be a time consuming operation, if you have many objects, we can break the task down into smaller sets of objects using the NAME and OBJECT qualifiers on the command.
• The event message records one of four possible Reasons:
  • MQRC_CONFIG_CHANGE_OBJECT
  • MQRC_CONFIG_CREATE_OBJECT
  • MQRC_CONFIG_DELETE_OBJECT
  • MQRC_CONFIG_REFRESH_OBJECT

  MQRC_CONFIG_CHANGE_OBJECT, MQRC_CONFIG_CREATE_OBJECT or MQRC_CONFIG_DELETE_OBJECT occur for the respective MQSC or PCF commands that you might issue upon an object.

  MQRC_CONFIG_REFRESH_OBJECT occurs for those event messages written, when creating the base-line picture.

There are four types of configuration event:

Create object events

Create object events are generated when an object is created. The event message contains the following event data: Create object.

Change object events

Change object events are generated when an object is changed. The event message contains the following event data: Change object.

Delete object events

Delete object events are generated when an object is deleted. The event message contains the following event data: Delete object.

Refresh object events

Refresh object events are generated by an explicit request to refresh. The event message contains the following event data: Refresh object.

Parent topic: Event types