ODMN (48-byte character string)
Object queue manager name.
This is the name of the queue manager
on which the ODON object is defined. The characters that
are valid in the name are the same as those for ODON (see
above). A name that is entirely blank up to the first null character or the
end of the field denotes the queue manager to which the application is connected
(the local queue manager).
The following points apply to the types of object indicated:
- If ODOT is OTNLST, OTPRO, or OTQM, ODMN must
be blank or the name of the local queue manager.
- If ODON is the name of a model queue, the queue manager
creates a dynamic queue with the attributes of the model queue, and returns
in the ODMN field the name of the queue manager on which
the queue is created; this is the name of the local queue manager. A model
queue can be specified only on the MQOPEN call; a model
queue is not valid on the MQPUT1 call.
- If ODON is the name of a cluster queue, and ODMN is blank, the actual destination of messages sent using the
queue handle returned by the MQOPEN call is chosen by
the queue manager (or cluster workload exit, if one is installed) as follows:
- If OOBNDO is specified, the queue manager selects a particular instance
of the cluster queue during the processing of the MQOPEN call, and all messages put using this queue handle are sent to that
instance.
- If OOBNDN is specified, the queue manager may choose a different instance
of the destination queue (residing on a different queue manager in the cluster)
for each successive MQPUT call that uses this queue
handle.
If the application needs to send a message to a specific instance of a cluster queue (that is, a queue instance that
resides on a particular queue manager in the cluster), the application should
specify the name of that queue manager in the ODMN field.
This forces the local queue manager to send the message to the specified destination
queue manager.
- If ODON is the name of a shared queue that is
owned by a remote queue-sharing group (that is, a queue-sharing group to which
the local queue manger does not belong), ODMN should be the name of the queue-sharing group. The name of
a queue manager that belongs to that group is also valid, but this is not
recommended as it may cause the message to be delayed if that particular queue
manager is not available when the message arrives at the queue-sharing group.
- If the object being opened is a distribution list (that is, ODREC is greater than zero), ODMN must be blank
or the null string. If this condition is not satisfied, the call fails with
reason code RC2153.
This is an input/output field for the MQOPEN call
when ODON is the name of a model queue, and an input-only
field in all other cases. The length of this field is given by LNQMN. The
initial value of this field is 48 blank characters.