Create the appropriate administration message

The administration queue does not know how to perform administration of individual resources. This information is encapsulated in each resource and its corresponding message.

Java™

In Java, there is a hierarchy of administration message types. For certain operations, the exact type of administration message is required. For example, to create a Home Server 'queue' you need a Home Server Queue administration message. For other operations, a more general administration message is appropriate. For example, to enquire upon a home server queue, you can use a queue administration message or a remote queue administration message. If in doubt, use the exact type of administration message.

The following messages are provided for administration of MQe resources:
Table 1. Administration messages
Message name Purpose
MQeAdminMsg An abstract class that acts as the base class for all administration messages
MQeAdminQueueAdminMsg Provides support for administering the administration queue
MQeConnectionAdminMsg Provides support for administering connections between queue managers
MQeHomeServerQueueAdminMsg Provides support for administering home-server queues
MQeQueueAdminMsg Provides support for administering local queues
MQeQueueMangerAdminMsg Provides support for administering queue managers
MQeRemoteQueueAdminMsg Provides support for administering remote queues
MQeStoreAndForwardQueueAdminMsg Provides support for administering store-and-forward queues
MQeCommunicationsListenerAdminMsg Provides support for administering communications listeners

These base administration messages are provided in the com.ibm.mqe.administration package. Other types or resource can be managed by subclassifying either MQeAdminMsg or one of the existing administration messages. For instance, an additional administration message for managing the MQ bridge is provided in the com.ibm.mqe.mqbridge package.

C

In the C code base, all messages are MQeFields instances. This applies to admin messages, and the admin message types are distinguished by a special field inserted into the fields object. You need to create an admin message of the appropriate type from new, inserting all of the required fields. Alternatively, for local administration, use the native administration API. The native code base can respond correctly to all administration messages but the native administration API is usually used for local administration.


Terms of use | WebSphere software

(c) Copyright IBM Corporation 2004, 2005. All rights reserved.