Change object

Event name: Change object.
Reason code in MQCFH: MQRC_CONFIG_CHANGE_OBJECT (2368, X'940').
Existing object changed.
Event description: An ALTER or DEFINE REPLACE command or an MQSET call was issued that successfully changed an existing object.
Event type: Configuration.
Platforms: All.
Event queue: SYSTEM.ADMIN.CONFIG.EVENT.
Note: Two event messages are generated for the change object event. The first has the object attribute values before the change, the second has the attribute values after the change.


Event data

    EventUserId

    Description: The user ID that issued the command or call that generated the event. (This is the same user ID that is used to check the authority to issue the command or call; for commands received from a queue, this is also the user identifier (UserIdentifier) from the MQMD of the command message).
    Identifier: MQCACF_EVENT_USER_ID.
    Datatype: MQCFST.
    Maximum length: MQ_USER_ID_LENGTH.
    Returned: Always.

    EventOrigin

    Description: The origin of the action causing the event.
    Identifier: MQIACF_EVENT_ORIGIN.
    Datatype: MQCFIN.
    Values:

      MQEVO_CONSOLE
      Console command.

      MQEVO_INIT
      Initialization input data set command.

      MQEVO_INTERNAL
      Directly by queue manager.

      MQEVO_MQSET
      MQSET call.

      MQEVO_MSG
      Command message on SYSTEM.COMMAND.INPUT.

      MQEVO_OTHER
      None of the above.

    Returned: Always.

    EventQMgr

    Description: The queue manager where the command or call was entered. (The queue manager where the command is executed and that generates the event is in the MQMD of the event message).
    Identifier: MQCACF_EVENT_Q_MGR.
    Datatype: MQCFST.
    Maximum length: MQ_Q_MGR_NAME_LENGTH.
    Returned: Always.

    EventAccountingToken

    Description: For commands received as a message (MQEVO_MSG), the accounting token (AccountingToken) from the MQMD of the command message.
    Identifier: MQBACF_EVENT_ACCOUNTING_TOKEN.
    Datatype: MQCFBS.
    Maximum length: MQ_ACCOUNTING_TOKEN_LENGTH.
    Returned: Only if EventOrigin is MQEVO_MSG.

    EventApplIdentity

    Description: For commands received as a message (MQEVO_MSG), application identity data (ApplIdentityData) from the MQMD of the command message.
    Identifier: MQCACF_EVENT_APPL_IDENTITY.
    Datatype: MQCFST.
    Maximum length: MQ_APPL_IDENTITY_DATA_LENGTH.
    Returned: Only if EventOrigin is MQEVO_MSG.

    EventApplType

    Description: For commands received as a message (MQEVO_MSG), the type of application (PutApplType) from the MQMD of the command message.
    Identifier: MQIACF_EVENT_APPL_TYPE.
    Datatype: MQCFIN.
    Returned: Only if EventOrigin is MQEVO_MSG.

    EventApplName

    Description: For commands received as a message (MQEVO_MSG), the name of the application (PutApplName) from the MQMD of the command message.
    Identifier: MQCACF_EVENT_APPL_NAME.
    Datatype: MQCFST.
    Maximum length: MQ_APPL_NAME_LENGTH.
    Returned: Only if EventOrigin is MQEVO_MSG.

    EventApplOrigin

    Description: For commands received as a message (MQEVO_MSG), the application origin data (ApplOriginData) from the MQMD of the command message.
    Identifier: MQCACF_EVENT_APPL_ORIGIN.
    Datatype: MQCFST.
    Maximum length: MQ_APPL_ORIGIN_DATA_LENGTH.
    Returned: Only if EventOrigin is MQEVO_MSG.

    ObjectType

    Description: Object type:
    Identifier: MQIACF_OBJECT_TYPE.
    Datatype: MQCFIN.
    Values:

      MQOT_CHANNEL
      Channel.

      MQOT_CHLAUTH
      Channel authentication record.

      MQOT_NAMELIST
      Namelist.

      MQOT_NONE
      No object.

      MQOT_PROCESS
      Process.

      MQOT_Q
      Queue.

      MQOT_Q_MGR
      Queue manager.

      MQOT_STORAGE_CLASS
      Storage class.

      MQOT_AUTH_INFO
      Authentication information.

      MQOT_CF_STRUC
      CF structure.

      MQOT_TOPIC
      Topic.

      MQOT_COMM_INFO
      Communication information.

      MQOT_LISTENER
      Channel Listener.

    Returned: Always.

    ObjectName

    Description: Object name:
    Identifier : Identifier will be according to object type.

    • MQCACH_CHANNEL_NAME
    • MQCA_NAMELIST_NAME
    • MQCA_PROCESS_NAME
    • MQCA_Q_NAME
    • MQCA_Q_MGR_NAME
    • MQCA_STORAGE_CLASS
    • MQCA_AUTH_INFO_NAME
    • MQCA_CF_STRUC_NAME
    • MQCA_TOPIC_NAME
    • MQCA_COMM_INFO_NAME
    • MQCACH_LISTENER_NAME

    Note: MQCACH_CHANNEL_NAME can also be used for channel authentication.

    Datatype: MQCFST.
    Maximum length: MQ_OBJECT_NAME_LENGTH.
    Returned: Always

    Disposition

    Description: Object disposition:
    Identifier: MQIA_QSG_DISP.
    Datatype: MQCFIN.
    Values:

      MQQSGD_Q_MGR
      Object resides on page set of queue manager.

      MQQSGD_SHARED
      Object resides in shared repository and messages are shared in coupling facility.

      MQQSGD_GROUP
      Object resides in shared repository.

      MQQSGD_COPY
      Object resides on page set of queue manager and is a local copy of a GROUP object.

    Returned: Always, except for queue manager and CF structure objects.


Object attributes

A parameter structure is returned for each attribute of the object. The attributes returned depend on the object type. For more information see Object attributes for event data.

Parent topic: Event message descriptions