Refresh Authority Record

Event name:

Reason code in MQCFH:

MQRC_CONFIG_REFRESH_OBJECT (2370, X'0942').
Refresh queue manager configuration - authority records.

Event description:

A REFRESH QMGR command specifying TYPE(CONFIGEV) was issued.

Event type:

Configuration

Platforms:

All except z/OS®.

Event queue:

SYSTEM.ADMIN.CONFIG.EVENT.

Note that the REFRESH QMGR command can produce many configuration events; one event is generated for each authority record that is selected by the command.

Event data

EventQMgr

Description:

The queue manager where the command or call was entered. That is, the queue manager where the command is processed and that generates the event is in the MQMD of the event message.

Identifier:

MQCACF_EVENT_Q_MGR

Data type:

MQCFST.

Maximum length:

MQ_Q_MGR_NAME_LENGTH.

Returned:

Always.

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 message descriptor 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 (runmqsc or setmqaut)
MQEVO_INTERNAL: Directly by queue manager
MQEVO_MSG: Command message on SYSTEM.ADMIN.COMMAND.QUEUE

Returned:

Always

EventAccountingToken

Description:

For commands received as a message (MQEVO_MSG), the accounting token (AccountingToken) from the message descriptor 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.

EventApplIdentity

Description:

For commands received as a message (MQEVO_MSG), application identity data (ApplIdentityData) from the message descriptor of the command message.

Identifier:

MQMQCACF_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 message descriptor of the command message.

Identifier:

MQIACF_EVENT_APPL_TYPE

Data type:

MQCFIN

Values:

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 message descriptor 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 message descriptor 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.

ObjectType

Description:

Object type

Identifier:

MQIACF_OBJECT_TYPE

Data type:

MQCFIN

Values:

MQOT_AUTH_REC

Returned:

Always

ProfileName

Description:

Object or generic profile name

Identifier:

MQCACF_AUTH_PROFILE_NAME

Data type:

MQCFST

Maximum length:

MQ_AUTH_PROFILE_NAME_LENGTH

Returned:

Always

Object attributes

A parameter structure is returned for each attribute of the object. The attributes returned depend on the object type. For more information see Object attributes for event data.