+

Search Tips | Advanced Search

Configuration events

Configuration events are notifications that are generated when an object is created, changed, or deleted, and can also be generated by explicit requests.

See Control configuration, command, and logger events for information on how you turn on events.

Configuration events notify you about changes to the attributes of an object. There are four types of configuration events:

  • Create object events
  • Change object events
  • Delete object events
  • Refresh object events

The event data contains the following information:

    Origin information
    comprises the queue manager from where the change was made, the ID of the user that made the change, and how the change came about, for example by a console command.

    Context information
    a replica of the context information in the message data from the command message.

    Context information is included in the event data only when the command was entered as a message on the SYSTEM.COMMAND.INPUT queue.

    Object identity
    comprises the name, type and disposition of the object.

    Object attributes
    comprises the values of all the attributes in the object.

The event is a message in PCF format. For more information, see:

In the case of change object events, a before message and an after message are produced. They have the following fields in common, so that we can identify matching messages:

  • The same correlation ID
  • In the PCF header:

    • The before message header has MsgSeqNumber': 1, 'Control': 'NOT_LAST'
    • The after message header has MsgSeqNumber': 2, 'Control': 'LAST'

Every configuration event message that is generated is placed on the queue SYSTEM.ADMIN.CONFIG.EVENT.

  • Configuration event generation
    Use this page to view the commands that cause configuration events to be generated and to understand the circumstances in which configuration events are not generated
  • Configuration event usage
    Use this page to view how we can use configuration events to obtain information about the system, and to understand the factors, such as CMDSCOPE, that can affect your use of configuration events.
  • Refresh Object configuration event
    The Refresh Object configuration event is different from the other configuration events, because it occurs only when explicitly requested.

Parent topic: Event monitoring


Related concepts


Related reference


Related information

Last updated: 2020-10-04