General notes

Local queues, as the name suggests, are local to the owning queue manager. The name of a queue is formed from the target queue manager name, for a local queue this is the name of the queue manager that owns the queue and a unique name for the queue on that queue manager. These two components of a queue name have ASCII values. The method setName(String, String) can be used to set the QueueName and the owning QueueManagerName in the administration message.

Java

The simplest type of queue is a local queue, managed by class MQeQueueAdminMsg. For other types of queue there is a corresponding administration message that inherits from MQeQueueAdminMsg. The MQeQueueAdminMsg inherits from the MQeAdminMsg.

The following actions are applicable on queues:

Note:
For all administration messages, information relating to the destination queue manager must be set. This is referred to in the examples below as priming the administration message. The examples show how to create the administration message to achieve the require result. These messages need to then be sent, and the admin reply messages checked as required.

C

All administration is done via the administration API, which are of the form:

MQERETURN MQEPUBLISHED mqeAdministrator_queuetype_action();

Where action can be one of the following:

create
Create a queue

delete
Delete a queue

update
Update the properties of a queue

inquire
Inquire upon the properties of a queue

listAliasName
List all of the queue aliases

addAlias
Add a queue alias

removeAlias
Remove a queue alias

Queues can be of the following types:

For the create, update, and inquire calls, a structure is passed in as a parameter. There is a general structure for elements that are applicable to all queues. For more specialized forms of queues, such as home server queue, there are structures which are composed of a reference to the general structure plus additional information. For more information, refer to Administration using the administrator API.



© IBM Corporation 2002. All Rights Reserved