Configuration event message format

Configuration events are PCF messages of standard Advanced Message Security format.

Possible values for the MQMD message descriptor can be found in Event message MQMD (message descriptor). Here are selected MQMD values:
Format = MQFMT_EVENT
Peristence = MQPER_PERSISTENCE_AS_Q_DEF
PutApplType = MQAT_QMGR           //for both CLI and command server

Message buffer consist of MQCFH structure and the parameter structure that follows it. Possible MQCFH values can be found in Event message MQCFH (PCF header).

Here are selected MQCFH values:
Type = MQCFT_EVENT
Command = MQCMD_CONFIG_EVENT
MsgSeqNumber = 1 or 2          // 2 will be in case of Change Object event
Control = MQCFC_LAST or MQCFC_NOT_LAST     //MQCFC_NOT_LAST will be in case of 1 Change Object event
ParameterCount = reflects number of PCF parameters following MQCFH
CompCode = MQCC_WARNING
Reason = one of {MQRC_CONFIG_CREATE_OBJECT, MQRC_CONFIG_CHANGE_OBJECT, MQRC_CONFIG_DELETE_OBJECT}

The parameters following MQCFH are:

    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 MD of the command message).
    Identifier: MQCACF_EVENT_USER_ID
    Data type: MQCFST.
    Maximum length: MQ_USER_ID_LENGTH.
    Returned: Always.

    SecurityId

    Description: Value of MQMD.AccountingToken in case of command server message or Windows SID for local command.
    Identifier: MQBACF_EVENT_SECURITY_ID
    Data type: MQCBS.
    Maximum length: MQ_SECURITY_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 - command line.

      MQEVO_MSG
      Command message from the IBM MQ Explorer plugin.

    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 MD of the event message).
    Identifier: MQCACF_EVENT_Q_MGR
    Data type: MQCFST
    Maximum length: MQ_Q_MGR_NAME_LENGTH
    Returned: Always.

    ObjectType

    Description: Object type.
    Identifier: MQIACF_OBJECT_TYPE
    Data type: MQCFIN
    Value:

      MQOT_PROT_POLICY
      Advanced Message Security protection policy. 1019 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.

    Returned: Always.

    PolicyName

    Description: The Advanced Message Security policy name.
    Identifier: MQCA_POLICY_NAME.
    Data type: MQCFST.
    Value: 2112 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Maximum length: MQ_OBJECT_NAME_LENGTH.
    Returned: Always.

    PolicyVersion

    Description: The Advanced Message Security policy version.
    Identifier: MQIA_POLICY_VERSION
    Data type: MQCFIN
    Value 238 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Returned: Always

    TolerateFlag

    Description: The Advanced Message Security policy toleration flag.
    Identifier: MQIA_TOLERATE_UNPROTECTED
    Data type: MQCFIN
    Value 235 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Returned: Always.

    SignatureAlgorithm

    Description: The Advanced Message Security policy signature algorithm.
    Identifier: MQIA_SIGNATURE_ALGORITHM
    Data type: MQCFIN
    Value: 236 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Returned: Whenever there is a signature algorithm defined in the Advanced Message Security policy

    EncryptionAlgorithm

    Description: The Advanced Message Security policy encryption algorithm.
    Identifier: MQIA_ENCRYPTION_ALGORITHM
    Data type: MQCFIN
    Value: 237 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Returned: Whenever there is an encryption algorithm defined in the IBM MQ policy

    SignerDNs

    Description: Subject DistinguishedName of allowed signers.
    Identifier: MQCA_SIGNER_DN
    Data type: MQCFSL
    Value: 2113 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Maximum length: Longest signer DN in the policy, but no longer then MQ_DISTINGUISHED_NAME_LENGTH
    Returned: Whenever defined in IBM MQ policy.

    RecipientDNs

    Description: Subject DistinguishedName of allowed signers.
    Identifier: MQCA_RECIPIENT_DN
    Data type: MQCFSL
    Value: 2114 - a numeric value defined in IBM MQ 8.0 or in the cmqc.h file.
    Maximum length: Longest recipient DN in the policy, but no longer then MQ_DISTINGUISHED_NAME_LENGTH.
    Returned: Whenever defined in IBM MQ policy.

Parent topic: Command and configuration events