Home

 

MaxQDepth (MQLONG)

Local	Model	Alias	Remote	Cluster
Yes	Yes	No	No	No

This is the defined upper limit for the number of physical messages that can exist on the queue at any one time. 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 i5/OS, the value cannot exceed 640 000.

Note:

The storage space available to the queue might be exhausted even if there are fewer than MaxQDepth messages on the queue.

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

 

Home