WaitInterval (MQLONG)

MQGET 呼び出しで適切なメッセージ (つまり、MQGET 呼び出しの MsgDesc パラメーターで指定した選択基準を満たすメッセージ) が到着するまで待機するおよその時間をミリ秒で表します。

重要: 適切なメッセージがすぐに使用可能な場合は、待機も遅延もありません。

詳細については、 MQMD-メッセージ記述子で説明されている MsgId フィールドを参照してください。この時間が経過しても、適切なメッセージが到着しなかった場合、呼び出しは完了し、MQCC_FAILED と理由コード MQRC_NO_MSG_AVAILABLE が戻ります。

z/OS®では、MQGET 呼び出しが実際に待機する期間は、システム・ロードおよび作業スケジューリングの考慮事項の影響を受け、 WaitInterval に指定された値と WaitIntervalより約 100 ミリ秒大きい値の間で異なる可能性があります。

WaitInterval は、MQGMO_WAIT または MQGMO_SET_SIGNAL オプションと組み合わせて使用します。これらのオプションがどちらも指定されていないときは、これは無視されます。これらのうちのいずれかが指定されている場合は、WaitInterval は、ゼロ以上であるか、または次の特別な値でなければなりません。

MQWI_UNLIMITED: 無制限の待機間隔。

このフィールドの初期値は0です。