Creates a new MQQueue object and associates it with this MQQueueManager object by setting the queue's connection reference property. It sets the Name, OpenOptions, DynamicQueueName, and AlternateUserId properties of the MQQueue object to the values provided, and attempts to open it.
If the open is unsuccessful the call fails. An error event is raised against the object, the object's ReasonCode and CompletionCode are set, and the MQSession ReasonCode and CompletionCode are set.
The DynamicQueueName, QueueManagerName, and AlternateUserId parameters are optional and default to "".
The OpenOption MQOO_INQUIRE should be specified in addition to other options if queue properties are to be read.
Do not set the QueueManagerName, or set it to "" if the queue to be opened is local. Otherwise, it should be set to the name of the remote queue manager that owns the queue, and an attempt is made to open a local definition of the remote queue. See the WebSphere MQ Application Programming Guide for more information on remote queue name resolution and queue manager aliasing.
If the Name property is set to a model queue name, specify the name of the dynamic queue to be created in the DynamicQueueName$ parameter. If the value provided in the DynamicQueueName$ parameter is "", the value set into the queue object and used on the open call is "AMQ.*". See the WebSphere MQ Application Programming Guide for more information on naming dynamic queues.
MQQueueManager class.
set queue = MQQueueManager.AccessQueue(Name$, OpenOptions&,QueueManagerName$, DynamicQueueName$, AlternateUserId$)
Name$
String. Name of WebSphere MQ queue.
OpenOptions:
Long. Options
to be used when queue is opened. See the WebSphere MQ Application Programming Reference.
QueueManagerName$
String. Name
of the queue manager that owns the queue to be opened. A value of "" implies
the queue manager is local.
DynamicQueueName$
String. The
name assigned to the dynamic queue at the time the queue is opened when the
Name$ parameter specifies a model queue.
AlternateUserId$
String. The
alternate user ID used to validate access when opening the queue.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
aqm |