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
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 |