MaxQDepth (MQLONG)
This is the defined upper limit for the number of physical messages that can exist on the queue at any one time.
Local | Model | Alias | Remote | Cluster |
---|---|---|---|---|
X | X |
An attempt to put a message on a queue that already contains MaxQDepth messages fails with reason code MQRC_Q_FULL.
Unit-of-work processing and the segmentation of messages can both cause the actual number of physical messages on the queue to exceed MaxQDepth. However, this does not affect the retrievability of the messages; all messages on the queue can be retrieved using the MQGET call.
The value of this attribute is zero or greater. The upper limit is determined by the environment:- On AIX , HP-UX, z/OS®, Solaris, Linux , and Windows, the value cannot exceed 999 999 999.
- On IBM® i, the value cannot exceed 640 000.
To determine the value of this attribute, use the MQIA_MAX_Q_DEPTH selector with the MQINQ call.