Administering messaging resources

The administration of WebSphere MQ Everyplace resources such as queue managers and queues is performed using specialized WebSphere MQ Everyplace messages. Using messages allows administration to be performed locally or remotely.

Figure 12. WebSphere MQ Everyplace administration

top

Before you can administer a queue manager or its resources, you must start the queue manager and configure an administration queue on it. The administration queue's role is to process administration messages in the sequence that they arrive on the queue. Only one request is processed at a time. The queue can be created using the mqeQueueManagerConfigure_defineDefaultAdminQueue() function of the MQeQueueManagerConfigure class. The name of the queue is AdminQ and applications can refer to it using the constant MQE_ADMIN_QUEUE_NAME.

A typical administration application instantiates a subclass of MQeAdminMsg, configures it with the required administration request, and passes it to the AdminQ on the target queue manager. If the application wishes to know the outcome of the action, a reply can be requested. When the request has been processed the result of the request is returned in a message to the reply-to queue and queue manager specified in the request message.

The reply can be sent to any queue manager or queue but you can configure a default reply-to that is used solely for administration reply messages. This default queue is created using the mqeQueueManagerConfigure_defineDefaultAdminReplyQueue() function of the MQeQueueManagerConfigure class. The name of the queue is AdminReplyQ and applications can refer to it using the constant MQE_ADMIN_REPLY_QUEUE_NAME

The administration queue does not understand how to perform administration of individual resources. This knowledge is encapsulated in each resource and its corresponding administration message. The following messages are provided for administration of WebSphere MQ Everyplace resources:

Table 2. Administration messages

Message name purpose
MQe_AdminMsg an abstract class that acts as the base class for all administration messages
MQe_AdminQueueAdminMsg provides support for administering the administration queue
MQe_ConnectionAdminMsg provides support for administering connections between queue managers
MQe_HomeServerQueueAdminMsg provides support for administering home-server queues
MQe_QueueAdminMsg provides support for administering local queues
MQe_QueueMangerAdminMsg provides support for administering queue managers
MQe_RemoteQueueAdminMsg provides support for administering remote queues
MQe_StoreAndForwardQueueAdminMsg provides support for administering store-and-forward queues


© IBM Corporation 2000, 2003. All Rights Reserved