Refresh object

Event name: Refresh object.
Reason code in MQCFH: MQRC_CONFIG_REFRESH_OBJECT (2370, X'942').
Refresh queue manager configuration.
Event description: A REFRESH QMGR command specifying TYPE (CONFIGEV) was issued.
Event type: Configuration.
Platforms: All.
Event queue: SYSTEM.ADMIN.CONFIG.EVENT.
Note: The REFRESH QMGR command can produce many configuration events; one event is generated for each object that is selected by the command.


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.
    Data type: MQCFST.
    Maximum length: MQ_USER_ID_LENGTH.
    Returned: Always.

    EventOrigin

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

      MQEVO_CONSOLE
      Console command.

      MQEVO_INIT
      Initialization input data set command.

      MQEVO_INTERNAL
      Directly by queue manager.

      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.
    Data type: 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.
    Data type: 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.
    Data type: 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.
    Data type: 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.
    Data type: 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.
    Data type: MQCFST.
    Maximum length: MQ_APPL_ORIGIN_DATA_LENGTH.
    Returned: Only if EventOrigin is MQEVO_MSG.

    ObjectType

    Description: Object type:
    Identifier: MQIACF_OBJECT_TYPE.
    Data type: 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.

    Data type: MQCFST.
    Maximum length: MQ_OBJECT_NAME_LENGTH.
    Returned: Always

    Disposition

    Description: Object disposition:
    Identifier: MQIA_QSG_DISP.
    Data type: 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