DefPriority (MQLONG)

This is the default priority for messages on the queue. This applies if MQPRI_PRIORITY_AS_Q_DEF is specified in the message descriptor when the message is put on the queue.

Local Model Alias Remote Cluster
X X X X X
If there is more than one definition in the queue-name resolution path, the default priority for the message is taken from the value of this attribute in the first definition in the path at the time of the put operation. This could be:

  • An alias queue
  • A local queue
  • A local definition of a remote queue
  • A queue manager alias
  • A transmission queue (for example, the DefXmitQName queue)
The way in which a message is placed on a queue depends on the value of the queue's MsgDeliverySequence attribute:

  • If the MsgDeliverySequence attribute is MQMDS_PRIORITY, the logical position at which a message is placed on the queue depends on the value of the Priority field in the message descriptor.
  • If the MsgDeliverySequence attribute is MQMDS_FIFO, messages are placed on the queue as though they had a priority equal to the DefPriority of the resolved queue, regardless of the value of the Priority field in the message descriptor. However, the Priority field retains the value specified by the application that put the message. See MsgDeliverySequence attribute for more information.

Priorities are in the range zero (lowest) through MaxPriority (highest); see MaxPriority attribute.

To determine the value of this attribute, use the MQIA_DEF_PRIORITY selector with the MQINQ call.