MQGMO - 読み取りメッセージ・オプション

この値は、グループに属しているメッセージが 1 つしかない場合にも戻されます。

このオプションは、取り出されるメッセージのメッセージ ID が MQGET 呼び出しのMSGDSCパラメーターのMDMIDフィールドの値と一致していなければならないことを指定します。 これは、適用される他の一致 (例えば、相関 ID) に加えて一致している必要があります。

このオプションを指定しない場合、MSGDSCパラメーターのMDMIDフィールドは無視され、すべてのメッセージ ID が一致します。

このオプションは、取り出されるメッセージの相関 ID が MQGET 呼び出しのMSGDSCパラメーター内のMDCIDフィールドの値と一致していなければならないことを指定します。 これは、適用される他の一致 (例えば、メッセージ ID) に加えて一致している必要があります。

このオプションを指定しない場合、MSGDSCパラメーターのMDCIDフィールドは無視され、すべての相関 ID が一致します。

このオプションは、取り出されるメッセージのグループ ID が MQGET 呼び出しのMSGDSCパラメーターのMDGIDフィールドの値と一致していなければならないことを指定します。 これは、適用される他の一致 (例えば、相関 ID) に加えて一致している必要があります。

このオプションを指定しない場合、MSGDSCパラメーターのMDGIDフィールドは無視され、すべてのグループ ID が一致します。

このオプションは、取り出されるメッセージのメッセージ・シーケンス番号が、MQGET 呼び出しのMSGDSCパラメーターのMDSEQフィールドの値と一致している必要があることを指定します。 これは、適用される他の一致 (例えば、グループ ID) に加えて一致している必要があります。

このオプションを指定しない場合、MSGDSCパラメーターのMDSEQフィールドは無視され、すべてのメッセージ・シーケンス番号が一致します。

このオプションは、取り出されるメッセージのオフセットが MQGET 呼び出しのMSGDSCパラメーターのMDOFFフィールドの値と一致していなければならないことを指定します。 これは、適用される他の一致 (例えば、メッセージ・シーケンス番号) に加えて一致している必要があります。

このオプションを指定しない場合、MSGDSCパラメーターのMDOFFフィールドは無視され、すべてのオフセットが一致します。

このオプションを指定すると、戻すメッセージの選択時にどの一致も使用されません。したがって、キューに入っているメッセージがすべて取り出せるようになります (ただし、GMAMSA、GMASGA、および GMCMPM オプションで制御できます)。

MONONE は、プログラム文書化を支援するために定義されています。 このオプションは、他の MO* オプションと組み合わせて使用するオプションではありません。ただし、このオプションの値はゼロと等価なため、他のオプションと組み合わせて使用しても、エラーとして検出されることはありません。

アプリケーションは、適切なメッセージが到着するまで待機します。 アプリケーションが待機する最大時間は、GMWIに指定されています。

MQGET 要求が禁止されているか、MQGET 要求が待機中に禁止になる場合は、キューに適切なメッセージがあるかどうかにかかわらず、待機状態は取り消され、呼び出しは CCFAIL で完了し、理由コード RC2016 が戻ります。

このオプションは、GMBRWF オプションまたは GMBRWN オプションと共に使用することができます。

複数のアプリケーションが同じ共有キューで待機している場合、該当するメッセージが到着した時に活動化されるアプリケーション (1 つ以上) については、このセクションで後述します。

• 1 つ以上の非ブラウズの MQGET 呼び出しが待機しているが、ブラウズの MQGET 呼び出しは待機していない場合は、1 つが活動化されます。
• 1 つ以上のブラウズの MQGET 呼び出しが待機しているが、非ブラウズの MQGET 呼び出しは待機していないという場合は、すべてが活動化されます。
• 1 つ以上の非ブラウズの MQGET 呼び出し、および 1 つ以上のブラウズの MQGET 呼び出しが待機しているという場合は、1 つの非ブラウズの MQGET 呼び出しが活動化されますが、ブラウズの MQGET 呼び出しについては、一切活動化されない、一部活動化される、あるいはすべてが活動化されるかのいずれかになります。 (活動化されるブラウズの MQGET 呼び出しの数は、オペレーティング・システムのスケジューリングの考慮事項と、その他の要素によって決まるため、予測することができません。)

1. 特定のメッセージによってのみ満たすことができる特定の get-wait 要求。例えば、特定のMDMIDまたはMDCID (あるいはその両方) を持つ要求。
2. どのメッセージによっても満たすことができる一般的な get-wait 要求。

GMBRWC または GMMUC を指定した場合、GMWT は無視され、エラーは発生しません。

適切なメッセージを使用できない場合、アプリケーションは待機しません。 これは、GMWT オプションの反対で、プログラム文書化を支援するために定義されています。 いずれも指定されていないときは、これがデフォルト値になります。

このオプションを指定すると、キュー・マネージャーが静止状態にある場合、MQGET 呼び出しが強制的に失敗します。

この要求は、通常の作業単位プロトコルの中で操作することです。 メッセージには、他のアプリケーションでは使用できないものとしてマークが付けられますが、作業単位がコミットされたときにのみ、キューから削除されます。 作業単位がバックアウトされると、メッセージは再び使用可能になります。

このオプションまたは GMNSYP が指定されていない場合、読み取り要求は作業単位内にありません。

この要求は、通常の作業単位プロトコルの外部で動作することになります。 メッセージは即時にキューから削除されます（ブラウザー要求の場合を除く）。 作業単位をバックアウトすることによって、メッセージを再度使用可能にすることはできません。

GMBRWF または GMBRWN が指定されている場合は、このオプションが想定されます。

このオプションと GMSYP が指定されていない場合、取得要求は作業単位内にはありません。

OOBRW オプションを指定してキューを開くと、キュー上の最初のメッセージの前に、ブラウズ・カーソルが置かれ、論理的に位置付けられます。 GMBRWF、 GMBRWN、または GMBRWC オプションを指定して後続の MQGET 呼び出しを使用すると、キューからメッセージを非破壊的に取り出すことができます。 ブラウズ・カーソルは、キュー上のメッセージ内の位置にマークを付け、 GMBRWN の次の MQGET 呼び出しで適切なメッセージが検索されるようにします。

GMBRWF を指定した MQGET 呼び出しは、ブラウズ・カーソルの直前の位置が無視されます。 メッセージ記述子に指定された条件を満たすキュー上の最初のメッセージが検索されます。 メッセージはキューに残り、ブラウズ・カーソルはこのメッセージの上に置かれます。

この呼び出しの後、ブラウズ・カーソルは、戻されたメッセージ上に置かれます。 GMBRWN を指定した次の MQGET 呼び出しの前にメッセージがキューから除去された場合、ブラウズ・カーソルは、メッセージが占めていたキュー内の位置にあります。ただし、その位置が空になっている場合でも、その位置には変わりません。

次に、 GMMUC オプションを非ブラウズの MQGET 呼び出しで使用して、キューからメッセージを除去することができます。

ブラウズ・カーソルは、同じHOBJハンドルを使用する非ブラウズ MQGET 呼び出しによって移動されません。 また、CCFAIL の完了コードまたは理由コードを戻すブラウズ MQGET 呼び出しによっても移動されません。RC2080.

GMLK オプションをこのオプションと一緒に指定すると、ブラウズされたメッセージがロックされるようになります。

GMBRWF は、グループ内のメッセージの処理および論理メッセージのセグメントを制御する GM* および MO* オプションと、任意の有効な組み合わせを使用して指定することができます。

GMLOGO が指定されている場合、メッセージは論理順序でブラウズされます。 このオプションを省略すると、メッセージは物理的な順序で参照されます。 GMBRWF を指定すると、論理順序と物理順序を切り替えることができますが、後続の GMBRWN を使用する MQGET 呼び出しでは、 GMBRWF を指定した最新のキュー・ハンドルと同じ順序でキューをブラウズする必要があります。

キュー・マネージャーがキュー上のメッセージをブラウズする MQGET 呼び出し用に保持するグループおよびセグメント情報は、キューからメッセージを除去する MQGET 呼び出しのためにキュー・マネージャーが保持するグループとセグメント情報とは分離されます。 GMBRWF を指定した場合，キューマネージャはブラウズのためのグループとセグメント情報を無視して，あたかも現在のグループと現在の論理メッセージがないかのようにキューをスキャンします。 MQGET 呼び出しが成功すると (完了コード CCOK または CCWARN)、ブラウズ用のグループおよびセグメント情報は、戻されたメッセージの情報に設定されます。呼び出しが失敗すると、ブラウズ用のグループおよびセグメント情報は、呼び出しが行われる前のままです。

ブラウズ・カーソルは、 MQGET 呼び出しで指定された選択基準を満たすキュー上の次のメッセージに進みます。 メッセージはアプリケーションに戻されますが、キューに残ります。

ブラウズのためにキューがオープンされた後、ハンドルを使用する最初のブラウズ呼び出しは、 GMBRWF オプションまたは GMBRWN オプションを指定しているかどうかに関係なく、同じ効果があります。

GMBRWN を指定した次の MQGET 呼び出しが発行される前にメッセージがキューから除去された場合、ブラウズ・カーソルは、メッセージが占めていたキュー内の位置が空であっても、論理的にその位置に留まります。

キューのMsgDeliverySequenceが MSPRIO であり、ブラウズ・カーソルによって現在指し示されているものより高い優先順位のメッセージがキューに到着した場合、そのメッセージは GMBRWN を使用するキューの現行スイープ中には検出されません。 そのメッセージは、GMBRWF で (またはキューの再オープンによって) ブラウズ・カーソルをリセットしないと、検出されません。

その後、必要に応じて非ブラウズ MQGET 呼び出しで GMMUC オプションを使用することにより、キューからメッセージを削除することができます。

ブラウズ・カーソルは、同じHOBJハンドルを使用する非ブラウズ MQGET 呼び出しによって移動されません。

GMLK オプションをこのオプションと一緒に指定すると、ブラウズされたメッセージがロックされるようになります。

GMBRWN は、論理メッセージのグループおよびセグメントでのメッセージ処理を制御する GM* および MO* オプションの有効な任意の組み合わせで指定することができます。

GMLOGO が指定されている場合、メッセージは論理順序でブラウズされます。 このオプションを省略すると、メッセージは物理的な順序で参照されます。 GMBRWF を指定すると、論理順序と物理順序を切り替えることができますが、後続の GMBRWN を使用する MQGET 呼び出しでは、 GMBRWF を指定した最新のキュー・ハンドルと同じ順序でキューをブラウズする必要があります。 この条件が満たされないと、呼び出しは失敗し、理由コード RC2259 が戻ります。

MQGET 呼び出しでキューに入っているメッセージをブラウズするためにキュー・マネージャーが保持しているグループおよびセグメント情報は、MQGET 呼び出しでキューからメッセージを除去するために保持しているグループおよびセグメント情報とは異なります。

このオプションを指定すると、ブラウズ・カーソルが指すメッセージは、MQGMO の GMMOフィールドに指定された MO* オプションに関係なく、非破壊的に取り出されます。

ブラウズ・カーソルが指すメッセージは、GMBRWF または GMBRWN のいずれかのオプションを使用して最後に検索されたものです。 このキューがオープンされてから、このキューに対しこれらの呼び出しのいずれも発行されなかった場合、またはブラウズ・カーソルが指すメッセージが破壊されて取り出された場合、呼び出しは失敗します。

ブラウズ・カーソルの位置は、この呼び出しでは変更されません。

次に、 GMMUC オプションを非ブラウズの MQGET 呼び出しで使用して、キューからメッセージを除去することができます。

ブラウズ・カーソルは、同じHOBJハンドルを使用する非ブラウズ MQGET 呼び出しによって移動されません。 また、完了コード CCFAIL または理由コード RC2080 を戻すブラウズ MQGET 呼び出しによって移動することもありません。

GMCMPM が GMBRWC と共に指定されている場合、ブラウズ・カーソルは MQMD 内のMDOFFフィールドがゼロのメッセージを識別する必要があります。 この条件が満たされない場合、呼び出しは失敗し、理由コードが戻ります。RC2246.

MQGET 呼び出しでキューに入っているメッセージをブラウズするためにキュー・マネージャーが保持しているグループおよびセグメント情報は、MQGET 呼び出しでキューからメッセージを除去するために保持しているグループおよびセグメント情報とは異なります。

このオプションを指定すると、MQGMO のGMMOフィールドに指定された MO* オプションに関係なく、ブラウズ・カーソルが指すメッセージが取り出されます。 メッセージはキューから削除されます。

ブラウズ・カーソルが指すメッセージは、GMBRWF または GMBRWN のいずれかのオプションを使用して最後に検索されたものです。

GMCMPM が GMMUC とともに指定されている場合、ブラウズ・カーソルは、MQMD 内のMDOFFフィールドがゼロであるメッセージを識別する必要があります。 この条件が満たされない場合、呼び出しは失敗し、理由コードが戻ります。RC2246.

ロックされたメッセージは常にブラウズ・カーソルのもとにあり、後で GMMUC オプションを指定した MQGET 呼び出しを発行するとキューから除去できます。 キュー・ハンドルを使用する他の MQGET 呼び出し (例えば、ロックされたメッセージのメッセージ ID を指定した呼び出し) でも、メッセージを削除できます。

呼び出しが完了コード CCFAIL または CCWARN を理由コード RC2080 と共に戻した場合、メッセージはロックされません。

アンロックされるメッセージは、GMLK オプションを指定した MQGET 呼び出しにより前もってロックされていなければなりません。 このハンドルに対してロックされたメッセージがない場合、呼び出しは CCWARN で完了し、RC2209.

GMUNLK が指定されている場合、MSGDSC、BUFLEN、BUFFER、およびDATLENパラメーターは検査も変更もされません。 BUFFERにメッセージは返されません。

(最初にロック要求を出すために OOBRW が必要ですが) このオプションを指定するのに特別なオープン・オプションは必要ありません。

このオプションは、データがBUFFERパラメーターにコピーされる前に、MQGET 呼び出しのMSGDSCパラメーターに指定されたMDCSIおよびMDENC値に準拠するように、メッセージ内のアプリケーション・データを変換することを要求します。

キュー・マネージャーが変換を実行する形式名のリストについては、 MQMD-メッセージ記述子 で説明されている MDFMT フィールドを参照してください。

セグメント化された論理メッセージは、同じ非ヌル・グループ ID (MQMD のMDGIDフィールド) を持つ複数の物理メッセージと、同じメッセージ・シーケンス番号 (MQMD のMDSEQフィールド) で構成されます。 セグメントは、セグメント・オフセット (MQMD のMDOFFフィールド) の固有の値によって区別されます。この値は、論理メッセージ内のデータの先頭からの物理メッセージ内のデータのオフセットを示します。 各セグメントは 1 つの物理メッセージなので、論理メッセージ内のセグメントには通常、それぞれ固有のメッセージ ID があります。

セグメント化されていない論理メッセージにも、送信側のアプリケーションでセグメント化が許可されている場合は、NULL でないグループ ID があります。ただし、この場合、そのグループ ID を持つのは、論理メッセージが 1 つのメッセージ・グループに属していないと、1 つの物理メッセージのみです。 論理メッセージが 1 つのメッセージ・グループに属していない場合、送信側のアプリケーションによってセグメント化が禁止されている論理メッセージのグループ ID はヌルとなります (GINONE)。

このオプションにより、キュー・ハンドルに対する連続した MQGET 呼び出しに対して、戻されるメッセージの順序を制御します。 有効に活用するには、必ずそれぞれの呼び出しごとにこのオプションを指定してください。

キュー・ハンドルに対する連続した MQGET 呼び出しで GMLOGO を指定すると、グループ内のメッセージはそのメッセージ順序番号に指定された順序で戻され、論理メッセージのセグメントはそのセグメント・オフセットに指定された順序で戻されます。 この順序は、これらのメッセージやセグメントのキューでの出現順序とは異なる場合があります。

必要な順序でメッセージを戻すように、キュー・マネージャーが、連続した MQGET 呼び出し間でのグループおよびセグメント情報を保持します。 この情報により、キュー・ハンドルに対する現行のメッセージ・グループと現行の論理メッセージ、グループおよび論理メッセージ内の現行の位置、およびメッセージが 1 つの作業単位内で取り出されているかどうかが特定されます。 キュー・マネージャーがこの情報を保持するので、アプリケーションでは、それぞれの MQGET 呼び出しの前にグループおよびセグメント情報を設定する必要はありません。 具体的には、アプリケーションが MQMD のMDGID、MDSEQ、および MDOFFフィールドを設定する必要がないことを意味します。 ただし、アプリケーションでは、それぞれの呼び出しに GMSYP オプションまたは GMNSYP オプションのいずれかを正しく設定する必要があります。

キューの中に複数のメッセージ・グループが存在し、戻されるのに適格である場合、それらのグループが戻される順序は、各グループ内の最初の論理メッセージの最初のセグメントがキューの中のどの位置にあるかによって決定されます (つまり、メッセージ順序番号が 1、オフセットが 0 の物理メッセージにより、適格なグループが戻される順序が決定されます)。

GMLOGO を指定した場合には、MQGET 呼び出しで提供された MQGMO が GMVER2 より下位であったり、MQMD が MDVER2 より下位であったりしてはなりません。 この条件が満たされない場合、呼び出しは失敗し、理由コードが戻ります。RC2256またはRC2257、必要に応じて。

キュー・ハンドルに対する連続した MQGET 呼び出しで GMLOGO を指定しないと、メッセージ・グループに属していなくても、また論理メッセージのセグメントでなくてもメッセージは戻されます。 これにより、あるグループ内のメッセージや論理メッセージのセグメントが正しくない順序で戻されたり、他のグループ内のメッセージ、他の論理メッセージのセグメント、またはグループにも属さずセグメントでもないメッセージとが混在したりする場合があります。 この場合、連続する MQGET 呼び出しによって戻される特定のメッセージは、それらの呼び出しで指定された MO* オプションによって制御されます (これらのオプションの詳細については、 MQGMO-メッセージ読み取りオプション で説明されている GMMO フィールドを参照してください)。

この手法を用いると、システム障害が発生した後に、メッセージ・グループまたは論理メッセージを途中から再開することができます。 システムの再始動時に、アプリケーションは、MDGID、MDSEQ、MDOFF、およびGMMOフィールドを適切な値に設定し、GMLOGO を指定せずに、必要に応じて GMSYP または GMNSYP を設定した MQGET 呼び出しを発行することができます。 この呼び出しが成功した場合、キュー・マネージャーはグループとセグメントの情報を保存し、そのキュー・ハンドルを使用する後続の MQGET 呼び出しで通常どおり GMLOGO を指定できます。

単にメッセージおよびセグメントを論理順序で取り出すアプリケーションでは、最も簡単に使えるオプション GMLOGO を指定するようにしてください。 このオプションを指定すると、キュー・マネージャーがグループおよびセグメント情報を管理するので、アプリケーションでこの情報を管理する必要はなくなります。 しかし、GMLOGO オプションで提供される制御以外の制御が必要となる特殊なアプリケーションもあります。このようなアプリケーションでは、このオプションを指定しないようにしてください。 これを行う場合、アプリケーションは、それぞれの MQGET 呼び出しの前に、MQMD 内の MDMID、MDCID、MDGID、MDSEQ、およびMDOFFフィールド、および MQGMO 内のGMMO内の MO* オプションが正しく設定されていることを確認する必要があります。

例えば、受信した物理メッセージがグループに属していなくても、また論理メッセージのセグメントでなくても、そのメッセージを転送するアプリケーションでは、GMLOGO を指定しないようにしてください。 これは、送信側のキュー・マネージャーと受信側のキュー・マネージャーの間にパスがいくつもあるような複雑なネットワークの場合に、物理メッセージが正しくない順序で到着することがあるからです。 GMLOGO およびこれに対応する MQPUT 呼び出し上の PMLOGO を両方とも指定しないようにすると、転送側のアプリケーションでは、論理順序で次にあるメッセージが到着するのを待たなくても、それぞれの物理メッセージの到着と同時にそのメッセージを取り出し転送することができます。

GMLOGO は、その他の GM* オプションと組み合わせても、また状況に応じて各種 MO* オプションと組み合わせても指定できます。

このオプションを指定すると、完全な論理メッセージのみを MQGET 呼び出しで戻すことができます。 論理メッセージがセグメント化されていると、キュー・マネージャーはそれらのセグメントの再組み立てを行い、完全な論理メッセージをアプリケーションに戻します。論理メッセージがセグメント化されていたことは、それを受け取るアプリケーションには分かりません。

このオプションを使用するには、完全なメッセージを収容できるバッファーがアプリケーションに提供されているか、GMATM オプションがアプリケーションに指定されている必要があります。

セグメント化されたメッセージがキューに入っていても、セグメントのいくつかが足りない (ネットワーク内が混雑していてまだ到着していないことが考えられる) 場合、GMCMPM を指定していると、完全でない論理メッセージに属しているセグメントが取り出されることはありません。 ただし、これらのメッセージ・セグメントは引き続きCurrentQDepthキュー属性の値に寄与します。これは、CurrentQDepthがゼロより大きい場合でも、検索可能な論理メッセージが存在しない可能性があることを意味します。

非持続メッセージの場合、キュー・マネージャーが再組み立てを実行するのに、1 つの作業単位が使用可能になっている必要はありません。

1 つのセグメントであるそれぞれの物理メッセージには、固有のメッセージ記述子があります。 単一の論理メッセージを構成するセグメントの場合、メッセージ記述子内のほとんどのフィールドは、論理メッセージ内のすべてのセグメントで同じです。通常、論理メッセージ内のセグメント間で異なるのは、MDMID、MDOFF、および MDMFLフィールドのみです。 ただし、セグメントが中間キュー・マネージャーの送達不能キューの中にある場合、DLQ ハンドラーは GMCONV オプションを指定してメッセージを検索するため、そのセグメントの文字セットまたはエンコードが変えられてしまう可能性があります。 それで、この途中で DLQ ハンドラーがセグメントの送信に成功した場合、そのセグメントが最終的に宛先キュー・マネージャーに到着した時点で、そのセグメントの文字セットまたはエンコードは論理メッセージ内の他のセグメントと異なっていることがあります。

MDCSI、MDENC、または両方のフィールドが異なるセグメントで構成される論理メッセージを、キュー・マネージャーが単一の論理メッセージに再組み立てすることはできません。 代わりに、キュー・マネージャーは、同じ文字セット ID とエンコードを持つ論理メッセージの先頭にある最初の数個の連続セグメントを再アセンブルして返します。MQGET 呼び出しは、完了コード CCWARN と理由コードで完了します。RC2243またはRC2244、必要に応じて。 これは、GMCONV が指定されていてもいなくても実行されます。 残りのセグメントを取り出すには、アプリケーションで GMCMPM オプションを指定せずに MQGET 呼び出しを再発行する必要があります。これによって、セグメントが 1 つずつ取り出せるようになります。 GMLOGO を使用すれば、残りのセグメントを順番に取り出すことができます。

セグメントの書き込みを行うアプリケーションでは、メッセージ記述子内の他のフィールドに、セグメント間で異なる値を設定できます。 しかし、受信側のアプリケーションで論理メッセージの取り出しに GMCMPM が使用されている場合は、これを実行しても利点はありません。 キュー・マネージャーは、論理メッセージの再組み立て時に、最初のセグメントのメッセージ記述子からの値をメッセージ記述子に戻します。唯一の例外はMDMFLフィールドで、再組み立てされたメッセージが唯一のセグメントであることを示すためにキュー・マネージャーが設定します。

GMCMPM をレポート・メッセージ用に指定すると、キュー・マネージャーは特殊な処理を実行します。 キュー・マネージャーは、キューをチェックして、論理メッセージ内のさまざまなセグメントに関連するそのレポート・タイプのすべてのレポート・メッセージがキュー上に存在しているかどうかを確認します。 入っている場合には、GMCMPM を指定することでそれらのメッセージを 1 つのメッセージとして取り出すことができます。 これには、セグメント化をサポートしているキュー・マネージャーまたは MCA を使用してレポート・メッセージを生成するか、発信側のアプリケーションで 100 バイト以上のメッセージ・データを要求する必要があります (つまり、RO*D または RO*F オプションの該当する方を指定する必要があります)。 1 つのセグメントに入るアプリケーション・データの一部に欠落があると、戻されるレポート・メッセージでは、足りないバイト分はヌルで置き換えられます。

GMCMPM を GMMUC または GMBRWC と一緒に指定する場合、MQMD のMDOFFフィールドの値が 0 のメッセージにブラウズ・カーソルを置く必要があります。 この条件が満たされない場合、呼び出しは失敗し、理由コードが戻ります。RC2246.

GMCMPM は、GMASGA に暗黙的に含まれているため指定する必要はありません。

GMCMPM は、GMPSYP 以外の GM* オプションおよび MOOFFS 以外の MO* オプションと組み合わせて指定できます。

このオプションを指定すると、グループ内のメッセージがすべて使用可能な場合に限り、そのグループ内のメッセージを取得できるようになります。 メッセージ・グループがキューに入っていても、メッセージのいくつかが足りない (ネットワーク内が混雑していてまだ到着していないことが考えられる) 場合、GMAMSA を指定していると、完全でないグループに属しているメッセージが取り出されることはありません。 ただし、これらのメッセージは引き続きCurrentQDepthキュー属性の値に寄与します。これは、CurrentQDepthがゼロより大きい場合でも、検索可能なメッセージ・グループが存在しない可能性があることを意味します。 検索できるメッセージが他にない場合は、理由コードRC2033指定された待機間隔 (ある場合) が経過した後に返されます。

GMAMSA を指定した MQGET 呼び出しが正常に完了するということは、MQGET 呼び出しが発行された時点で、グループ内のすべてのメッセージがキュー上にあるという意味です。 ただし、その場合も、他のアプリケーションがグループからメッセージを 除去することができます (グループは、グループ内の最初のメッセージを取り出したアプリケーションに 対してロックされません)。

このオプションを指定しないと、不完全なグループに属しているメッセージが取り出されることがあります。

GMAMSA は GMASGA を暗黙的に含んでいるため、指定する必要はありません。

GMAMSA は、他のすべての GM* オプションおよびすべての MO* オプションと組み合わせて指定できます。

このオプションを指定すると、論理メッセージ内のセグメントがすべて使用可能な場合に限り、その論理メッセージ内のセグメントを取得できるようになります。 セグメント化されたメッセージがキューに入っていても、セグメントのいくつかが足りない (ネットワーク内が混雑していてまだ到着していないことが考えられる) 場合、GMASGA を指定していると、完全でない論理メッセージに属しているセグメントが取り出されることはありません。 ただし、これらのセグメントは引き続きCurrentQDepthキュー属性の値に寄与します。これは、CurrentQDepthがゼロより大きい場合でも、検索可能な論理メッセージが存在しない可能性があることを意味します。 検索できるメッセージが他にない場合は、理由コードRC2033指定された待機間隔 (ある場合) が経過した後に返されます。

このオプションを指定しないと、論理メッセージが不完全な場合でも、メッセージ・セグメントが取得されることがあります。

GMCMPM および GMASGA を両方とも指定している場合は、すべてのセグメントを取り出す前に、まずそれらを使用可能にする必要があります。前者のみの場合は、完全なメッセージが戻され、後者のみの場合は、セグメントを 1 つずつ取り出すことができます。

GMASGA をレポート・メッセージ用に指定すると、キュー・マネージャーは特殊な処理を実行します。 キュー・マネージャーは、キューをチェックして、完全な論理メッセージを構成しているそれぞれのセグメントに対して少なくとも 1 つのレポート・メッセージが入っているかどうかを確認します。 入っている場合は、GMASGA 条件は満たされます。 しかし、キュー・マネージャーは、キューに入っているレポート・メッセージのタイプはチェックしないので、論理メッセージのセグメントに対応したレポート・メッセージにはさまざまなタイプのレポートが混在している可能性があります。 結果として、GMASGA が成功しても、GMCMPM が成功するとは限りません。 ある論理メッセージのセグメントについてさまざまなレポート・タイプが混在している場合には、これらのレポート・メッセージは 1 つずつ取得する必要があります。

GMASGA は、他のすべての GM* オプションおよびすべての MO* オプションと組み合わせて指定できます。

この値は、他のオプションが指定されなかったことを示すために使用できます。すべてのオプションはデフォルト値を取ります。 GMNONE は、プログラムの文書化をサポートするために定義します。したがって、このオプションは、他のオプションと同時に使用するためのものではありません。しかしこのオプションの値はゼロのため、他のオプションと同時に使用してもそれを検出できません。

この値は、論理メッセージを構成しているセグメントが 1 つしかない場合にも戻されます。

値は、フィールドの長さについては 2 進ゼロです。