Command event message format
Command event message consists of MQCFH structure and PCF parameters following it.
Here are selected MQCFH values:
Type = MQCFT_EVENT;
Command = MQCMD_COMMAND_EVENT;
MsgSeqNumber = 1;
Control = MQCFC_LAST;
ParameterCount = 2;
CompCode = MQCC_WARNING;
Reason = MQRC_COMMAND_PCF;
Note: ParameterCount value is two because there are always two parameters of MQCFGR type (group).
Each group consists of appropriate parameters. The event data consists of two groups, CommandContext
and CommandData.
CommandContext contains:- 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. - 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 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. - EventAccountingToken
-
Description: For commands received as a message (MQEVO_MSG), the accounting token (AccountingToken) from the MD 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. - EventIdentityData
-
Description: For commands received as a message (MQEVO_MSG), application identity data (ApplIdentityData) from the MD 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 MD 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 MD 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 MD 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. - Command
-
Description: The command code. Identifier: MQIACF_COMMAND. Data type: MQCFIN. Values: - MQCMD_INQUIRE_PROT_POLICY numeric value 205
- MQCMD_CREATE_PROT_POLICY numeric value 206
- MQCMD_DELETE_PROT_POLICY numeric value 207
- MQCMD_CHANGE_PROT_POLICY numeric value 208
Returned: Always.