The Refresh Object configuration event

The Refresh Object configuration event is different from the other configuration events. The create, change, and delete events are generated by an MQSET call or by a command to change an object but the refresh object event occurs only when it is explicitly requested by the MQSC command, REFRESH QMGR, or its PCF equivalent.

The REFRESH QMGR command is different from all the other commands that generate configuration events. All the other commands apply to a particular object and generate a single configuration event for that object. The REFRESH QMGR command can produce many configuration event messages potentially representing every object definition stored by a queue manager. One event message is generated for each object that is selected.

The REFRESH QMGR command uses a combination of three selection criteria to filter the number of objects involved:

• Object Name

• Object Type

• Refresh Interval

If you specify none of the selection criteria on the REFRESH QMGR command, the default values are used for each selection criteria and a refresh configuration event message is generated for every object definition stored by the queue manager. This may well involve excessive processing time and event message generation. It is recommended to always use some selection criteria.

The REFRESH QMGR command that generates the refresh events can be used in the following situations:

• When configuration data is wanted about all or some of the objects in a system regardless of whether the objects have been recently manipulated, for example, when configuration events are first enabled.

  It is recommended to use several commands each with a different selection of objects, but such that all are included.

• If there has been an error in the SYSTEM.ADMIN.CONFIG.EVENT queue. In this circumstance, no configuration event messages are generated for Create, Change, or Delete events. When the error on the queue has been corrected, the Refresh Queue Manager command can be used to request the generation of event messages, which were lost whilst there was an error in the queue. In this situation it is recommended that you use the refresh selection criteria, with the refresh interval being the time for which the queue was unavailable.