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

These are defined in IBM MQ 8.0 cmqcfc.h

Returned:

Always.

CommandData contains PCF elements that comprised the PCF command.