Change object

Event name:

Change object.

Reason code in MQCFH:

MQRC_CONFIG_CHANGE_OBJECT (2368, X'940').
Existing object changed.

Event description:

An ALTER or DEFINE REPLACE command or an MQSET call was issued that successfully changed an existing object.

Event type:

Configuration.

Platforms:

All.

Event queue:

SYSTEM.ADMIN.CONFIG.EVENT.

Note: Two event messages are generated for the change object event. The first has the object attribute values before the change, the second has the attribute values after the change.

Event data

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 MQMD of the command message).

Identifier:

MQCACF_EVENT_USER_ID.

Datatype:

MQCFST.

Maximum length:

MQ_USER_ID_LENGTH.

Returned:

Always.

EventOrigin

Description:

The origin of the action causing the event.

Identifier:

MQIACF_EVENT_ORIGIN.

Datatype:

MQCFIN.

Values:

MQEVO_CONSOLE: Console command.
MQEVO_INIT: Initialization input data set command.
MQEVO_INTERNAL: Directly by queue manager.
MQEVO_MQSET: MQSET call.
MQEVO_MSG: Command message on SYSTEM.COMMAND.INPUT.
MQEVO_OTHER: None of the above.

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 MQMD of the event message).

Identifier:

MQCACF_EVENT_Q_MGR.

Datatype:

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

Identifier:

MQBACF_EVENT_ACCOUNTING_TOKEN.

Datatype:

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

Identifier:

MQCACF_EVENT_APPL_IDENTITY.

Datatype:

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

Identifier:

MQIACF_EVENT_APPL_TYPE.

Datatype:

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

Identifier:

MQCACF_EVENT_APPL_NAME.

Datatype:

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

Identifier:

MQCACF_EVENT_APPL_ORIGIN.

Datatype:

MQCFST.

Maximum length:

MQ_APPL_ORIGIN_DATA_LENGTH.

Returned:

Only if EventOrigin is MQEVO_MSG.

ObjectType

Description:

Object type:

Identifier:

MQIACF_OBJECT_TYPE.

Datatype:

MQCFIN.

Values:

MQOT_CHANNEL: Channel.
MQOT_CHLAUTH: Channel authentication record.
MQOT_NAMELIST: Namelist.
MQOT_NONE: No object.
MQOT_PROCESS: Process.
MQOT_Q: Queue.
MQOT_Q_MGR: Queue manager.
MQOT_STORAGE_CLASS: Storage class.
MQOT_AUTH_INFO: Authentication information.
MQOT_CF_STRUC: CF structure.
MQOT_TOPIC: Topic.
MQOT_COMM_INFO: Communication information.
MQOT_LISTENER: Channel Listener.

Returned:

Always.

ObjectName

Description:

Object name:

Identifier :

Identifier will be according to object type.

MQCACH_CHANNEL_NAME
MQCA_NAMELIST_NAME
MQCA_PROCESS_NAME
MQCA_Q_NAME
MQCA_Q_MGR_NAME
MQCA_STORAGE_CLASS
MQCA_AUTH_INFO_NAME
MQCA_CF_STRUC_NAME
MQCA_TOPIC_NAME
MQCA_COMM_INFO_NAME
MQCACH_LISTENER_NAME

Note: MQCACH_CHANNEL_NAME can also be used for channel authentication.

Datatype:

MQCFST.

Maximum length:

MQ_OBJECT_NAME_LENGTH.

Returned:

Always

Disposition

Description:

Object disposition:

Identifier:

MQIA_QSG_DISP.

Datatype:

MQCFIN.

Values:

MQQSGD_Q_MGR: Object resides on page set of queue manager.
MQQSGD_SHARED: Object resides in shared repository and messages are shared in coupling facility.
MQQSGD_GROUP: Object resides in shared repository.
MQQSGD_COPY: Object resides on page set of queue manager and is a local copy of a GROUP object.

Returned:

Always, except for queue manager and CF structure objects.

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.