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.
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.
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 ¶ms); // 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.