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 namePurpose
MQeAdminMsgAn abstract class that acts as the base class for all administration messages
MQeAdminQueueAdminMsgProvides support for administering the administration queue
MQeConnectionAdminMsgProvides support for administering connections between queue managers
MQeHomeServerQueueAdminMsgProvides support for administering home-server queues
MQeQueueAdminMsgProvides support for administering local queues
MQeQueueMangerAdminMsgProvides support for administering queue managers
MQeRemoteQueueAdminMsgProvides support for administering remote queues
MQeStoreAndForwardQueueAdminMsgProvides support for administering store-and-forward queues
MQeCommunicationsListenerAdminMsgProvides 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 codebase, 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 codebase can respond correctly to all administration messages but the native administration API is usually used for local administration.

Parent topic: Configuring with messages