The administration queue

Before you can administer a queue manager (or its resources) using admin messages, you must start the queue manager and configure an admin queue on it. The admin queue's role is to process admin messages in the sequence that they arrive on the queue. Only one request is processed at a time.

Java™

In Java, the queue can be created using the defineDefaultAdminQueue() method of the MQeQueueManagerConfigure class. The name of the queue is AdminQ and applications can refer to it using the constant MQe.Admin_Queue_Name.

C

In the native code base, an admin queue is created using the following API:
MQeAdminQParms params = ADMIN_Q_INIT_VAL;
rc = mqeAdministrator_AdminQueue_create(hAdmin, // handle to MQeAdministrator
         pExceptBlock, // handle to an exception block 
         hQueueName, // the name of the queue to be created
         hQueueQMgrName, // the name of the queue's
              //owning queue manager
         &params); // pointer to structure
              // for configuring the
              // queue of type MQeAdminQParms,

 

In particular, the constant string handle MQE_ADMIN_QUEUE_NAME can be used as the admin queue name. This is the equivalent of the constant MQe.Admin_Queue_Name in the Java code base.

The params structure can be initialized to contain default values for all admin queue properties. The structure also contains an opFlags bit mask element that must be used to indicate which properties have been set to a value other than the default value. The above example accepts all of the default values, as specified using the ADMIN_Q_INIT_VAL constant.


Terms of use | WebSphere software

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