Configuration event message format
Configuration events are PCF messages of standard IBM® MQ 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
- IBM MQ 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 IBM MQ 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 IBM MQ 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 IBM MQ 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 IBM MQ 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 IBM MQ Advanced Message Security policy EncryptionAlgorithm-
Description: The IBM MQ 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.