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.