Options (MQLONG)
コールバック記述子構造体 - Options フィールド
以下に説明する 1 つ以上のオプションを指定できます。 複数のオプションを指定するには、値を加算する (同じ定数を複数回加算しない) か、ビット単位 OR 演算を使用して値を結合 (プログラミング言語でビット演算がサポートされる場合) します。
- MQCBDO_FAIL_IF_QUIESCING
- MQCB 呼び出しは、キュー・マネージャーが静止状態にあるときは失敗します。
z/OS®では、接続 ( CICS® または IMS アプリケーションの場合) が静止状態の場合にも、このオプションによって MQCB 呼び出しが強制的に失敗します。
MQCB 呼び出しで渡される MQGMO オプション内に MQGMO_FAIL_IF_QUIESCING を指定すると、これらの静止時にメッセージ・コンシューマーに対して通知が行われます。
制御オプション: 以下のオプションでは、コンシューマーの状態の変更時に、メッセージなしで、コールバック関数が呼び出されるかどうかを制御します。
- MQCBDO_REGISTER_CALL
- このコールバック関数は、呼び出しタイプ MQCBCT_REGISTER_CALL で呼び出されます。
- MQCBDO_START_CALL
- このコールバック関数は、呼び出しタイプ MQCBCT_START_CALL で呼び出されます。
- MQCBDO_STOP_CALL
- このコールバック関数は、呼び出しタイプ MQCBCT_STOP_CALL で呼び出されます。
- MQCBDO_DEREGISTER_CALL
- このコールバック関数は、呼び出しタイプ MQCBCT_DEREGISTER_CALL で呼び出されます。
- MQCBDO_EVENT_CALL
- このコールバック関数は、呼び出しタイプ MQCBCT_EVENT_CALL で呼び出されます。
- MQCBDO_MC_EVENT_CALL
- コールバック関数は、呼び出しタイプ MQCBCT_MC_EVENT_CALL で呼び出されます。
デフォルト・オプション: 上記のいずれのオプションも必要でない場合は、以下のオプションを使用します。
- MQCBDO_NONE
- この値は、他のオプションが指定されなかったことを示すために使用します。すべてのオプションはデフォルト値であるとみなされます。
MQCBDO_NONE は、プログラムの文書化を支援するために定義します。このオプションは、他のオプションと組み合わせて使用するオプションではありません。ただし、このオプションの値はゼロと等価なので、他のオプションと組み合わせて使用しても、エラーとして検出されることはありません。
これは入力フィールドです。 Options フィールドの初期値は、MQCBDO_NONE です。