You must specify at least one of the following options:
See below for details of these options; other options can be specified as required. If more than one option is required, the values can be:
Combinations that are not valid are noted; all other combinations are valid. Only options that are applicable to the type of object specified by ObjDesc are allowed (see Table 80).
Access options: The following options control the type of operations that can be performed on the object:
The queue is opened for use with subsequent MQGET calls. The type of access is either shared or exclusive, depending on the value of the DefInputOpenOption queue attribute; see Attributes for queues for details.
This option is valid only for local, alias, and model queues; it is not valid for remote queues, distribution lists, and objects that are not queues.
The queue is opened for use with subsequent MQGET calls. The call can succeed if the queue is currently open by this or another application with MQOO_INPUT_SHARED, but fails with reason code MQRC_OBJECT_IN_USE if the queue is currently open with MQOO_INPUT_EXCLUSIVE.
This option is valid only for local, alias, and model queues; it is not valid for remote queues, distribution lists, and objects that are not queues.
The queue is opened for use with subsequent MQGET calls. The call fails with reason code MQRC_OBJECT_IN_USE if the queue is currently open by this or another application for input of any type (MQOO_INPUT_SHARED or MQOO_INPUT_EXCLUSIVE).
This option is valid only for local, alias, and model queues; it is not valid for remote queues, distribution lists, and objects that are not queues.
The following notes apply to these options:
The queue is opened for use with subsequent MQGET calls with one of the following options:
This is allowed even if the queue is currently open for MQOO_INPUT_EXCLUSIVE. An MQOPEN call with the MQOO_BROWSE option establishes a browse cursor, and positions it logically before the first message on the queue; see MQGMO - Options field for further information.
This option is valid only for local, alias, and model queues; it is not valid for remote queues, distribution lists, and objects that are not queues. It is also not valid if ObjectQMgrName is the name of a queue manager alias; this is true even if the value of the RemoteQMgrName attribute in the local definition of a remote queue used for queue-manager aliasing is the name of the local queue manager.
The queue is opened for use with subsequent MQPUT calls.
An MQOPEN call with this option can succeed even if the InhibitPut queue attribute is set to MQQA_PUT_INHIBITED (although subsequent MQPUT calls will fail while the attribute is set to this value).
This option is valid for all types of queue, including distribution lists.
The queue, namelist, process definition, or queue manager is opened for use with subsequent MQINQ calls.
This option is valid for all types of object other than distribution lists. It is not valid if ObjectQMgrName is the name of a queue manager alias; this is true even if the value of the RemoteQMgrName attribute in the local definition of a remote queue used for queue-manager aliasing is the name of the local queue manager.
The queue is opened for use with subsequent MQSET calls.
This option is valid for all types of queue other than distribution lists. It is not valid if ObjectQMgrName is the name of a local definition of a remote queue; this is true even if the value of the RemoteQMgrName attribute in the local definition of a remote queue used for queue-manager aliasing is the name of the local queue manager.
Binding options: The following options apply when the object being opened is a cluster queue; these options control the binding of the queue handle to a particular instance of the cluster queue:
This option is valid only for queues, and affects only cluster queues. If specified for a queue that is not a cluster queue, the option is ignored.
If MQOO_BROWSE or one of the MQOO_INPUT_* options is specified for a cluster queue, the queue manager is forced to select the local instance of the cluster queue. As a result, the binding of the queue handle is fixed, even if MQOO_BIND_NOT_FIXED is specified.
If MQOO_INQUIRE is specified with MQOO_BIND_NOT_FIXED, successive MQINQ calls using that handle might inquire different instances of the cluster queue, although usually all the instances have the same attribute values.
MQOO_BIND_NOT_FIXED is valid only for queues, and affects only cluster queues. If specified for a queue that is not a cluster queue, the option is ignored.
MQOO_BIND_AS_Q_DEF is the default if neither MQOO_BIND_ON_OPEN nor MQOO_BIND_NOT_FIXED is specified.
MQOO_BIND_AS_Q_DEF aids program documentation. It is not intended that this option be used with either of the other two bind options, but because its value is zero such use cannot be detected.
Context options: The following options control the processing of message context:
This context information can be passed to a message that is subsequently put on a queue using the MQPUT or MQPUT1 calls. See the MQPMO_PASS_IDENTITY_CONTEXT and MQPMO_PASS_ALL_CONTEXT options described in MQPMO - Put-message options.
Until a message has been successfully retrieved, context cannot be passed to a message being put on a queue.
A message retrieved using one of the MQGMO_BROWSE_* browse options does not have its context information saved (although the context fields in the MsgDesc parameter are set after a browse).
This option is valid only for local, alias, and model queues; it is not valid for remote queues, distribution lists, and objects that are not queues. One of the MQOO_INPUT_* options must be specified.
The MQOO_OUTPUT option must be specified.
This option is valid for all types of queue, including distribution lists.
This option implies MQOO_PASS_IDENTITY_CONTEXT, which need not therefore be specified. The MQOO_OUTPUT option must be specified.
This option is valid for all types of queue, including distribution lists.
This option implies MQOO_PASS_IDENTITY_CONTEXT, which need not therefore be specified. The MQOO_OUTPUT option must be specified.
This option is valid for all types of queue, including distribution lists.
This option implies the following options, which need not therefore be specified:
The MQOO_OUTPUT option must be specified.
This option is valid for all types of queue, including distribution lists.
Other options: The following options control authorization checking, what happens when the queue manager is quiescing, and whether to resolve the local queue name:
This option is valid for all types of object.
On z/OS, for a CICS or IMS application, this option also forces the MQOPEN call to fail if the connection is in quiescing state.
This option is valid for all types of object.
For information about client channels see the WebSphere MQ Clients book.
The local queue is always returned when either a local, alias, or model queue is opened, but this is not the case when, for example, a remote queue or a non-local cluster queue is opened without the MQOO_RESOLVE_LOCAL_Q option; the ResolvedQName and ResolvedQMgrName are filled with the RemoteQName and RemoteQMgrName found in the remote queue definition, or similarly with the chosen remote cluster queue.
If you specify MQOO_RESOLVE_LOCAL_Q when opening, for example, a remote queue, ResolvedQName is the transmission queue to which messages will be put. The ResolvedQMgrName is filled with the name of the local queue manager hosting the transmission queue.
If you are authorized for browse, input, or output on a queue, you have the required authority to specify this flag on the MQOPEN call. No special authority is needed.
This option is valid only for queues and queue managers.
Option | Alias
(note 1) |
Local and Model | Remote | Nonlocal Cluster | Distribution list |
---|---|---|---|---|---|
MQOO_INPUT_AS_Q_DEF | Yes | Yes | No | No | No |
MQOO_INPUT_SHARED | Yes | Yes | No | No | No |
MQOO_INPUT_EXCLUSIVE | Yes | Yes | No | No | No |
MQOO_BROWSE | Yes | Yes | No | No | No |
MQOO_OUTPUT | Yes | Yes | Yes | Yes | Yes |
MQOO_INQUIRE | Yes | Yes | Note 2 | Yes | No |
MQOO_SET | Yes | Yes | Note 2 | No | No |
MQOO_BIND_ON_OPEN (note 3) | Yes | Yes | Yes | Yes | Yes |
MQOO_BIND_NOT_FIXED (note 3) | Yes | Yes | Yes | Yes | Yes |
MQOO_BIND_AS_Q_DEF (note 3) | Yes | Yes | Yes | Yes | Yes |
MQOO_SAVE_ALL_CONTEXT | Yes | Yes | No | No | No |
MQOO_PASS_IDENTITY_CONTEXT | Yes | Yes | Yes | Yes | Yes |
MQOO_PASS_ALL_CONTEXT | Yes | Yes | Yes | Yes | Yes |
MQOO_SET_IDENTITY_CONTEXT | Yes | Yes | Yes | Yes | Yes |
MQOO_SET_ALL_CONTEXT | Yes | Yes | Yes | Yes | Yes |
MQOO_ALTERNATE_USER_AUTHORITY | Yes | Yes | Yes | Yes | Yes |
MQOO_FAIL_IF_QUIESCING | Yes | Yes | Yes | Yes | Yes |
MQOO_RESOLVE_LOCAL_Q | Yes | Yes | Yes | Yes | No |
Notes:
|
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
js02681 |