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.