IBM i での MQMD (メッセージ記述子)

アカウンティング・トークン。

これは、メッセージの ID コンテキスト の一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDACC を指定すると、アプリケーションは、メッセージの結果として行われた作業に適切な課金を行うことができます。 キュー・マネージャーはこの情報をビット・ストリングとして処理し、その内容は検査しません。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに PMSETI または PMSETA が指定されていれば、これは入出力フィールドです。 PMSETI または PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDACC が入ります。 これは、メッセージが保存される場合に保持される MDACC の値です (保存パブリケーションについて詳しくは、 IBM i での MQPMO (メッセージ書き込みオプション) の PMRET の説明を参照してください) が、メッセージがサブスクライバーにパブリケーションとして送信されるときに MDACC として使用されることはありません。サブスクライバーに送信されるすべてのパブリケーションで MDACC をオーバーライドする値を提供するためです。 メッセージにコンテキストがない場合、フィールドは完全に 2 進ゼロになります。

これは、MQGET 呼び出しの出力フィールドです。

このフィールドは、キュー・マネージャーの文字セットに基づいた変換の対象ではありません。このフィールドは、文字ストリングとしてではなく、ビット・ストリングとして扱われます。

キュー・マネージャーは、フィールドにある情報については、何も処理しません。 アプリケーションは、会計の目的で情報を使用する場合に、情報を解釈する必要があります。

このフィールドの長さは、LNACCT で指定されます。 このフィールドの初期値は ACNONE です。

ID に関連するアプリケーション・データ。

これは、メッセージの ID コンテキスト の一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDAID は、アプリケーション・スイートによって定義される情報で、メッセージやその発信元に関する追加の情報を提供するために使用することができます。 キュー・マネージャーはこの情報を文字データとして扱いますが、そのフォーマットの定義はしません。 キュー・マネージャーは、この情報を生成するときに、全体をブランクにします。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに PMSETI または PMSETA が指定されていれば、これは入出力フィールドです。 ヌル文字がある場合は、ヌル文字およびその後に続く文字は、キュー・マネージャーによってブランクに変換されます。 PMSETI または PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDAID が入ります。 これは、メッセージが保存された場合 (保存パブリケーションについて詳しくは、PMRET の説明を参照してください)、そのメッセージと共に保持された MDAID の値になりますが、メッセージがパブリケーションとしてサブスクライバーに送信された場合には MDAID として使用されません。これは、サブスクライバーが提供する値が、サブスクライバーに送信されるすべてのパブリケーションにおいて MDAID をオーバーライドするためです。 メッセージがコンテキストを持っていない場合、フィールドは完全にブランクになります。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの長さは LNAIDD によって指定されます。 このフィールドの初期値は 32 個のブランク文字です。

発生元に関係するアプリケーション・データ。

これは、メッセージの起点コンテキストの一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDAOD は、アプリケーション・スイートにより定義される情報で、メッセージの発信元についての追加情報を提供するのに使用できます。 例えば、ID データが信頼 できるかどうかを示すために、適切なユーザー権限で実行されているアプリケーションにより設定 が可能です。

キュー・マネージャーはこの情報を文字データとして扱いますが、そのフォーマットの定義はしません。 キュー・マネージャーは、この情報を生成するときに、全体をブランクにします。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに または PMSETA が指定されていれば、これは入出力フィールドです。 フィールド内でヌル文字より後の情報はすべて破棄されます。 ヌル文字およびその後に続く文字は、キュー・マネージャーによってブランクに変換されます。 PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDAOD が入ります。 これは、メッセージが保存された場合 (保存パブリケーションについて詳しくは、PMRET の説明を参照してください)、そのメッセージと共に保持された MDAOD の値になりますが、メッセージがパブリケーションとしてサブスクライバーに送信された場合には MDAOD として使用されません。これは、サブスクライバーが提供する値が、サブスクライバーに送信されるすべてのパブリケーションにおいて MDAOD をオーバーライドするためです。 メッセージがコンテキストを持っていない場合、フィールドは完全にブランクになります。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの長さは LNAORD によって指定されます。 このフィールドの初期値は 4 個のブランク文字です。

バックアウトのカウンター。

これは、メッセージが、作業単位の一部として MQGET 呼び出しから事前に戻されて、その後バックアウトされた回数のカウントです。 メッセージの内容に基づいて処理エラーを検出する際に、アプリケーションへの補助機能として提供されます。 カウントには、GMBRW* オプションのいずれかを指定する MQGET 呼び出しは含まれません。

このカウントの正確度は、 HardenGetBackout キュー属性の影響を受けます。 キューの属性を参照してください。

これは、MQGET 呼び出しの出力フィールドです。 MQPUT および MQPUT1 呼び出しでは、無視されます。 このフィールドの初期値は 0 です。

相関 ID。

これは、バイト・ストリングで、1 つのメッセージを別のメッセージと関連付けたり、メッセージをアプリケーションが実行している他の作業と関連付けたりするために、アプリケーションによって使用できます。 相関 ID はメッセージの永続的なプロパティーであり、キュー・マネージャーを再始動しても保持されます。 相関 ID は文字ストリングではなくバイト・ストリングであるため、あるキュー・マネージャーから別のキュー・マネージャーにメッセージが転送され、文字セットが異なっていても、相関 ID は変換されません。

MQPUT 呼び出しおよび MQPUT1 呼び出しの場合、アプリケーションは任意の値を指定できます。 キュー・マネージャーはこの値をメッセージと一緒に送信し、メッセージの取得要求を出したアプリケーションに配信します。

アプリケーションで PMNCID を指定した場合、キュー・マネージャーは固有の相関 ID を生成します。この相関 ID は、メッセージと共に送信されるほか、MQPUT 呼び出しまたは MQPUT1 呼び出しからの出力で送信側アプリケーションに返されます。

生成されたこの相関 ID がメッセージと共に保持されるのは、MQSUB 呼び出しで渡される MQSD の SDCID フィールドで CINONE を指定するサブスクライバーに、メッセージがパブリケーションとして送信されるときに、メッセージが保存され、相関 ID として使用される場合です。

保存パブリケーションについて詳しくは、 IBM i を参照してください。

キュー・マネージャーまたはメッセージ・チャネル・エージェントは、レポート・メッセージを生成するとき、元のメッセージの MDREP フィールド、すなわち、ROCMTC または ROPCI のいずれかによって指定された方法で MDCID フィールドを設定します。 レポート・メッセージを生成するアプリケーションも、上記の指定を行います。

MQGET 呼び出しの場合、MDCID は、キューから取得する特定のメッセージを選択するために使用できる 5 つのフィールドの 1 つです。 このフィールドに値を指定する方法の詳細については、MDMID フィールドを参照してください。

相関 ID として CINONE を指定すると、MOCORI を指定しなかった場合と同じ結果になります。つまり、すべての相関 ID が一致することになります。

GMMUC オプションが MQGET 呼び出しの GMO パラメーターで指定されている場合、このフィールドは無視されます。

MQGET 呼び出しから戻った時点で、MDCID フィールドには、返されたメッセージ (それがある場合) の相関 ID が設定されます。

MQGET 呼び出しの場合、これは入出力フィールドです。 MQPUT および MQPUT1 呼び出しでは、PMNCID を指定しなかった場合は入力フィールド、PMNCID を指定した場合は出力フィールドです。 このフィールドの長さは、LNCID で指定されます。 このフィールドの初期値は CINONE です。

これは、メッセージにある文字データの文字セット ID を指定します。

MQPUT 呼び出しおよび MQPUT1 呼び出しで、キュー・マネージャーは、メッセージと一緒に送信された MQMD 内の値 CSQM および CSINHT を前述のように変更しますが、MQPUT 呼び出しまたは MQPUT1 呼び出しで指定された MQMD は変更しません。 指定された値について、それ以外の検査は行われません。

メッセージを検索するアプリケーションは、このフィールドとアプリケーションの予期する値とを比較することが必要です。値が異なる場合、アプリケーションは、メッセージ内の文字データを変換することが必要になる場合があります。

GMCONV オプションが MQGET 呼び出しで指定されている場合、このフィールドは入出力フィールドです。 アプリケーションが指定した値は、必要に応じてメッセージ・データを変換しなければならないコード化文字セット ID の値です。 変換が正しく行われるか、変換が不要であれば、この値は変更されません (ただし、値 CSQM または CSINHT は、実際の値に変換されます)。 変換が失敗したときは、MQGET 呼び出しの後の値は、アプリケーションに戻されるメッセージのうち変換されなかったメッセージのコード化文字セット ID を表しています。

それ以外の場合、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は CSQM です。

メッセージ・データの数値エンコード。

ここでは、メッセージ内の数値データの数値エンコードを指定します。これは、MQMD 構造体自体の数値データには適用されません。 数値エンコード方式では、2 進整数、パック 10 進整数、および浮動小数点数の表記が定義されています。

メッセージを書き込んだアプリケーションは、通常 ENNAT を指定する必要があります。 メッセージを検索するアプリケーションは、このフィールドと値 ENNAT を比較することが必要です。値が異なる場合、アプリケーションは、メッセージ内の数値データを変換することが必要になる場合があります。 GMCONV オプションを使用すると、MQGET 呼び出しの処理の一部としてメッセージを変換することを キュー・マネージャーに要求できます。

GMCONV オプションが MQGET 呼び出しで指定されている場合、このフィールドは入出力フィールドです。 アプリケーションで指定する値は、必要に応じてメッセージ・データが変換された後のコードです。 変換が成功したか不要の場合、値は変化しません。 変換が失敗したときは、MQGET 呼び出しの後の値は、アプリケーションに戻された未変換メッセージのエンコードを表しています。

それ以外の場合、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は ENNAT です。

メッセージ存続期間。

これは、メッセージを書き込むアプリケーションで設定される時間で、10 分の 1 秒単位で表されます。 この時間が経過するまでに宛先キューからメッセージが除去されなかった場合、そのメッセージは廃棄の対象となります。

メッセージが宛先キューに存在した時間に応じて値は減少します。書き込みがリモート・キューに対するものであるとき、値は中間の伝送キューに存在した時間に対応します。 伝送にかなりの時間がかかった場合は、メッセージ・チャネル・エージェントがその時間に応じて減算する可能性もあります。 同様に、このメッセージを別のキューに送るアプリケーションも、長時間にわたってメッセージを保持した場合には、必要に応じて値を減分することがあります。 しかし、満了時間は概数として扱われるので、短い時間間隔の調節のためにこの値を減分する必要はありません。

アプリケーションが MQGET 呼び出しを用いてメッセージを取り出したとき、MDEXP フィールドは、元の有効期限の残りの時間を表します。

メッセージの有効期限を過ぎると、メッセージはキュー・マネージャーによって廃棄される対象となります。 このメッセージは、現在の実装では、ブラウズまたは非ブラウズ MQGET 呼び出しが行われると廃棄されます (まだ満了していなければメッセージが返されます)。 例えば、MQGMO の GMMO フィールドが MONONE に設定された 非ブラウズ MQGET 呼び出しが FIFO 方式のキューから読み取りを行う場合、満了していないメッセージが最初に出現するまで、満了したメッセージはすべて削除されます。 優先順位方式のキューで同じ呼び出しを発行した場合は、満了していない最初のメッセージより先にキューに到着した満了したメッセージのうち、優先順位が等しいメッセージとそれより優先順位が高いメッセージが廃棄されます。

ブラウズまたは非ブラウズのどちらの MQGET 呼び出しでも、満了したメッセージがアプリケーションに返されることはないので、MQGET 呼び出しが正常に終了した後、メッセージ記述子の MDEXP フィールドの値はゼロより大きいか、特殊値 EIULIM になります。

メッセージをリモート・キューに書き込む場合、メッセージは、宛先キューに到達する前の中間伝送キューにある間に満了してしまう (そして廃棄される) 可能性もあります。

メッセージが ROEXP* レポート・オプションのうちいずれかを指定した場合は、満了したメッセージが廃棄されるときにレポートが生成されます。 オプションがまったく指定されていない場合、そうしたレポートは生成されません。指定時間の経過後は、このメッセージは関係がなくなったと見なされます (後のメッセージに置き換わったと考えられるため)。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は EIULIM です。

フィードバックまたは理由コード。

レポート・メッセージを生成するアプリケーションでは、キュー・マネージャーまたはメッセージ・チャネル・エージェントが生成するレポート・メッセージをシミュレートしない場合は、システム範囲 (FBQUIT 以外) のフィードバック・コードを使用しないでください。

MQPUT または MQPUT1 呼び出しでは、指定される値は FBNONE であるか、またはその値がシステム範囲かアプリケーション範囲のいずれかになければなりません。 これは、MDMT の値には関係なく検査されます。

IMSブリッジ・フィードバック・コード: IMS ブリッジがゼロ以外の IMS-OTMA センス・コードを受け取ると、 IMS ブリッジはセンス・コードを 16 進数から 10 進数に変換し、値 FBIERR (300) を追加して、結果を応答メッセージの MDFB フィールドに入れます。 これにより、 IMS-OTMA エラーが発生したときに、フィードバック・コードの値が FBIFST (301) から FBILST (399) の範囲になります。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は FBNONE です。

メッセージ・データの形式名。

名前は、フィールドの長さまでブランクを埋め込む必要があります。あるいは、フィールドの終わりになる前に名前を終了させるためにヌル文字を使用します。ヌル文字およびそれに続く文字は、ブランクと見なされます。 名前の前または途中にはブランクを指定しないでください。 MQGET 呼び出しの場合は、キュー・マネージャーは、フィールドの長さまでブランクを埋め込んだ名前を戻します。

キュー・マネージャーは、名前が上述の推奨事項に準じているかどうかは検査しません。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの長さは LNFMT によって指定されます。 このフィールドの初期値は FMNONE です。

グループ ID。

MQPUT 呼び出しおよび MQPUT1 呼び出しへの入力時に、キュー・マネージャーは PMOPTで詳述されている値を使用します。 MQPUT 呼び出しおよび MQPUT1 呼び出しの出力時に、オープンされたオブジェクトが単一キューであり、配布リストではない場合、キュー・マネージャーはこのフィールドに、メッセージと共に送信された値を設定します。オープンされたオブジェクトが配布リストである場合、このフィールドの値は変わりません。 後者の場合、生成されたグループ ID をアプリケーションで認識するには、アプリケーションは PRGID フィールドのある MQPMR レコードを提供する必要があります。

MQGET 呼び出しへの入力では、キュー・マネージャーは 表 1 で詳述されている値を使用します。 MQGET 呼び出しの出力時に、キュー・マネージャーは、このフィールドに、取り出されたメッセージの値を設定します。

このフィールドの長さは、LNGID で指定されます。 このフィールドの初期値は GINONE です。 MDVER 値が MDVER2 未満の場合、このフィールドは無視されます。

メッセージ・フラグ。

セグメント化フラグ: メッセージが大きすぎてキューに入らない場合、メッセージをキューに書き込もうとすると通常は失敗します。 セグメント化とは、キュー・マネージャーまたはアプリケーションがメッセージをセグメントといういくつかの小さな単位に分割して、各セグメントを別個の物理メッセージとしてキューに入れるための手法を指します。 メッセージを取り出すアプリケーションは、セグメントを 1 つずつ取り出すか、またはキュー・マネージャーに対してセグメントを再組み立てして 1 つのメッセージにするよう要求することができます。後者の場合、メッセージは MQGET 呼び出しで返されます。 後者の方法を行うには、MQGET 呼び出しで GMCMPM オプションを指定して、メッセージ全体を収容できるだけの長さのバッファーを提供します。 (GMCMPM オプションについて詳しくは、 IBM i を参照してください。) メッセージのセグメント化は、送信側のキュー・マネージャー、中間キュー・マネージャー、または宛先キュー・マネージャーで実行できます。

このフラグは、MQPUT 呼び出しおよび MQPUT1 呼び出しでは入力フラグであり、MQGET 呼び出しでは出力フラグです。 後者の呼び出しの場合、キュー・マネージャーはこのフラグの値を MQGMO の GMSEG フィールドにも反映します。

このフラグの初期値は MFSEGI です。

これらのフラグは、MQPUT 呼び出し、および MQPUT1 呼び出しでは入力フラグであり、MQGET 呼び出しでは出力フラグです。 後者の呼び出しの場合、キュー・マネージャーはフラグの値を MQGMO の GMGST フィールドおよび GMSST フィールドにも反映します。

MDMFL フィールドはサブフィールドに分割されます。詳しくは、 IBM iを参照してください。

このフィールドの初期値は MFNONE です。 MDVER 値が MDVER2 未満の場合、このフィールドは無視されます。

メッセージ ID。

あるメッセージを他のメッセージと区別するために使用されるバイト・ストリングです。 2 つのメッセージが同じメッセージ ID を持つことは、キュー・マネージャーによって禁止されませんが、通常は避けてください。 メッセージ ID は、メッセージの永続的なプロパティーであり、キュー・マネージャーを再始動しても存続します。 メッセージ ID は、文字ストリングではなくバイト・ストリングなので、あるキュー・マネージャーから別のキュー・マネージャーへメッセージが流れても、文字セット間の変換は行われません。

MQPUT 呼び出しおよび MQPUT1 呼び出しの場合、MINONE または PMNMID がアプリケーションによって指定されていると、キュー・マネージャーは、メッセージが書き込まれるときに固有のメッセージ ID ¹ を生成し、それをメッセージと一緒に送信されるメッセージ記述子に入れます。 また、キュー・マネージャーは、送信側のアプリケーションに属するメッセージ記述子の中にこのメッセージ ID を返します。 アプリケーションは、この値を使用して、特定のメッセージに関する情報を記録し、アプリケーションの他の部分からの照会に応答することができます。

メッセージをトピックに書き込む場合、キュー・マネージャーは、パブリッシュされるメッセージごとに必要に応じて固有のメッセージ ID を生成します。 PMNMID がアプリケーションによって指定されている場合、キュー・マネージャーは固有のメッセージ ID を生成して出力に戻します。 MINONE がアプリケーションによって指定される場合、MQMD 内の MDMID フィールドの値は呼び出しからの戻り時に変更されません。

保存パブリケーションの詳細については、 PMOPT の PMRET の説明を参照してください。

メッセージを配布リストに書き込む場合は、キュー・マネージャーが必要に応じて固有のメッセージ ID を生成しますが、MINONE または PMNMID を指定したとしても、呼び出しからの戻り時に、MQMD の MDMID フィールドの値が変更されることはありません。 キュー・マネージャーが生成するメッセージ ID をアプリケーションで認識するには、アプリケーションは PRMID フィールドのある MQPMR レコードを提供する必要があります。

また、送信側のアプリケーションは、MINONE 以外の特定の値をメッセージ ID に指定することができます。これによって、キュー・マネージャーは固有のメッセージ ID の生成を停止します。 メッセージを転送するアプリケーションでは、この機能を使用して元のメッセージのメッセージ ID を伝搬することができます。

キュー・マネージャーまたはメッセージ・チャネル・エージェントは、レポート・メッセージを生成するとき、元のメッセージの MDREP フィールド、すなわち RONMI または ROPMI のいずれかによって指定された方法で MDMID フィールドを設定します。 レポート・メッセージを生成するアプリケーションも、上記の指定を行います。

通常は、選択基準を満たす最初 のメッセージがキューから戻されます。 ただし、GMBRWN を指定した場合は、選択基準を満たす次の メッセージが戻されます。このメッセージの走査は、現行カーソル位置の後 から開始されます。

さまざまな状況で選択基準がどのように使用されるかについて詳しくは、 表 1 を参照してください。

メッセージ ID として MINONE を指定すると、MOMSGI を指定しなかった場合と同じ結果になります。つまり、すべてのメッセージ ID が一致することになります。

GMMUC オプションが、MQGET 呼び出しの GMO パラメーターで指定されている場合、このフィールドは無視されます。

MQGET 呼び出しから戻ったとき、MDMID フィールドは、戻されたメッセージ (それがある場合) のメッセージ ID に設定されます。

これは、MQGET、MQPUT、および MQPUT1 呼び出しの入出力フィールドです。 このフィールドの長さは LNMID によって指定されます。 このフィールドの初期値は MINONE です。

メッセージ・タイプ。

システム範囲内にあるその他の値も、MQI の将来のバージョンで定義される可能性があります。定義後は、MQPUT および MQPUT1 呼び出しによって、エラーなしで受け入れられます。

MQPUT 呼び出しおよび MQPUT1 呼び出しでは、MDMT 値は、システム定義の範囲かアプリケーション定義の範囲内でなければなりません。この範囲内でない場合、呼び出しは理由コード RC2029 で失敗します。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は MTDGRM です。

論理メッセージの先頭を起点とする、物理メッセージ中のデータのオフセット。

物理メッセージのデータの (そのデータを一部として含んでいる) 論理メッセージの先頭からのオフセットをバイト単位で指定します。 このようなデータをセグメント といいます。 オフセットは、0 から 999 999 999 までの範囲です。 論理メッセージのセグメントでない物理メッセージのオフセット値は 0 です。

論理メッセージのセグメントに関するレポート・メッセージの場合は、MDOLN フィールドを使用して (OLUNDF 以外の値であること)、キュー・マネージャーが保存するセグメント情報の中のオフセット値を更新します。

MQGET 呼び出しへの入力では、キュー・マネージャーは 表 1 で詳述されている値を使用します。 MQGET 呼び出しの出力時に、キュー・マネージャーは、このフィールドに、取り出されたメッセージの値を設定します。

フィールドの初期値は、0 です。 MDVER 値が MDVER2 未満の場合、このフィールドは無視されます。

元のメッセージの長さ。

これは、セグメントとしての レポート・メッセージにのみ関連するフィールドです。 これは、レポート・メッセージが関連するメッセージ・セグメントの長さを指定します。セグメントが属する論理メッセージの長さやレポート・メッセージ内のデータの長さは指定しません。

これは、MQGET 呼び出し用の出力フィールドです。

このフィールドの初期値は OLUNDF です。 MDVER 値が MDVER2 未満の場合、このフィールドは無視されます。

メッセージを書き込むアプリケーションの名前。

これは、メッセージの起点コンテキストの一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDPAN の形式は、MDPAT の値によって決まります。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに または PMSETA が指定されていれば、これは入出力フィールドです。 フィールド内でヌル文字より後の情報はすべて破棄されます。 ヌル文字およびその後に続く文字は、キュー・マネージャーによってブランクに変換されます。 PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの長さは LNPAN によって指定されます。 このフィールドの初期値は 28 個のブランク文字です。

メッセージを書き込むアプリケーションのタイプ。

これは、メッセージの起点コンテキストの一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

アプリケーションの書き込みの結果として、キュー・マネージャーがこの情報を生成するとき、フィールドは、環境により求められる値に設定されます。 IBM iでは、 AT400; に設定されます。 IBM iでは、キュー・マネージャーが ATCICS を使用することはありません。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに または PMSETA が指定されていれば、これは入出力フィールドです。 PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDPAT が入ります。 これは、メッセージが保存された場合 (保存パブリケーションについて詳しくは、PMRET の説明を参照してください)、そのメッセージと共に保持された MDPAT の値になりますが、メッセージがパブリケーションとしてサブスクライバーに送信された場合には MDPAT として使用されません。これは、サブスクライバーが提供する値が、サブスクライバーに送信されるすべてのパブリケーションにおいて MDPAT をオーバーライドするためです。 メッセージにコンテキストがない場合、このフィールドは ATNCON に設定されます。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの初期値は ATNCON です。

メッセージが書き込まれた日付。

これは、メッセージの起点コンテキストの一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDPD と MDPT フィールドでは、グリニッジ標準時 (GMT) に正確に設定されているシステム・クロックに従って、GMT が使用されます。

メッセージが作業単位の一部として書き込まれた場合は、作業単位がコミットされた日付ではなく、メッセージが書き込まれた日付です。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに または PMSETA が指定されていれば、これは入出力フィールドです。 フィールドの内容は、キュー・マネージャーによって検査されませんが、フィールド内のヌル文字のあとにある情報はいずれも廃棄されます。 ヌル文字およびその後に続く文字は、キュー・マネージャーによってブランクに変換されます。 PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDPD が入ります。 これは、メッセージが保存された場合 (保存パブリケーションについて詳しくは、PMRET の説明を参照してください)、そのメッセージと共に保持された MDPD の値になりますが、メッセージがパブリケーションとしてサブスクライバーに送信された場合には MDPD として使用されません。これは、サブスクライバーが提供する値が、サブスクライバーに送信されるすべてのパブリケーションにおいて MDPD をオーバーライドするためです。 メッセージがコンテキストを持っていない場合、フィールドは完全にブランクになります。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの長さは LNPDAT によって指定されます。 このフィールドの初期値は 8 個のブランク文字です。

メッセージの持続性。

持続メッセージと非持続メッセージが同一キューにあっても構いません。

メッセージに応答する場合、アプリケーションは通常、応答メッセージに対して、要求メッセージの持続性を使用します。

MQGET 呼び出しの場合、戻り値は PEPER または PENPER のいずれかです。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は PEQDEF です。

メッセージの優先度。

ローカル・キュー・マネージャーでサポートされている最大の優先順位 (この最大値は MaxPriority キュー・マネージャー属性で指定される) より高い優先順位でメッセージが書き込まれた場合、メッセージはキュー・マネージャーで受け入れられますが、キュー・マネージャーの最大優先順位でキューに入れられます。MQPUT 呼び出しまたは MQPUT1 呼び出しの完了時には、CCWARN および理由コード RC2049 が出されます。 しかし、MDPRI フィールドの値は、メッセージを書き込んだアプリケーションが指定した値のままです。

メッセージに応答する場合は、アプリケーションは通常、応答メッセージに対して、要求メッセージの優先順位を使用します。 他の状況では、PRQDEF を設定しても、アプリケーションを変更することなく優先順位の調整を行うことができます。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は PRQDEF です。

メッセージが書き込まれた時間。

これは、メッセージの起点コンテキストの一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDPD と MDPT フィールドでは、グリニッジ標準時 (GMT) に正確に設定されているシステム・クロックに従って、GMT が使用されます。

メッセージが作業単位の一部として書き込まれた場合は、作業単位がコミットされた時刻ではなく、メッセージが書き込まれた時刻です。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに または PMSETA が指定されていれば、これは入出力フィールドです。 フィールドの内容は、キュー・マネージャーによって検査されませんが、フィールド内のヌル文字のあとにある情報はいずれも廃棄されます。 ヌル文字およびその後に続く文字は、キュー・マネージャーによってブランクに変換されます。 PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDPT 値が入ります。 これは、メッセージが保存された場合 (保存パブリケーションについて詳しくは、PMRET の説明を参照してください)、そのメッセージと共に保持された MDPT の値になりますが、メッセージがパブリケーションとしてサブスクライバーに送信された場合には MDPT として使用されません。これは、サブスクライバーが提供する値が、サブスクライバーに送信されるすべてのパブリケーションにおいて MDPT をオーバーライドするためです。 メッセージがコンテキストを持っていない場合、フィールドは完全にブランクになります。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの長さは LNPTIM によって指定されます。 このフィールドの初期値は 8 個のブランク文字です。

レポート・メッセージのオプション。

レポート・メッセージを受け取ったアプリケーションでは、MQMD の MDFB フィールドを調べることにより、報告が生成された理由を判別できます。詳細については、MDFB フィールドを参照してください。

メッセージをトピックに書き込むときにレポート・オプションを使用すると、ゼロ個以上のレポート・メッセージが生成され、アプリケーションに送信される可能性があります。 これは、パブリケーション・メッセージが、ゼロ個以上のサブスクライブ・アプリケーションに送信される可能性があるためです。

アクションの正常終了通知時および異常終了通知時、それぞれの条件の指定はアプリケーションが行います。 要求が一部実行された場合には PAN 報告ではなく NAN 報告を生成する (要求された場合) ことをお勧めします。 また、すべての可能な条件を、アクションの正常終了通知時と異常終了通知時の両方ではなく、いずれか一方に対応付けることをお勧めします。

要求に応答するサーバー、またはレポート・メッセージを生成するサーバーは、元のメッセージの中に ROPCI または ROPMI オプションが設定されていたかどうかを調べるようにしてください。 設定されていた場合、サーバーは、これらのオプションで説明されている処置を取るはずです。 いずれも設定されていない場合、サーバーは、対応するデフォルトの処置を取るはずです。

レポート・メッセージのメッセージ記述子の内容: キュー・マネージャーまたはメッセージ・チャネル・エージェント (MCA) は、レポート・メッセージを生成するとき、メッセージ記述子の中のフィールドを以下の値に設定してから、通常の方法でメッセージを書き込みます。

レポート・フィールドの分析: MDREP フィールドにはサブフィールドが含まれます。そのため、メッセージの送信側が特定のレポートを要求したかどうかを確認する必要があるアプリケーションは、 IBM iで説明されている手法のいずれかを使用する必要があります。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの初期値は RONONE です。

応答キュー・マネージャーの名前。

これは、応答メッセージまたはレポート・メッセージを送信されるキュー・マネージャーの名前です。 MDRQ は、このキュー・マネージャーで定義されるキューのローカル名です。

MDRM フィールドがブランクである場合、ローカル・キュー・マネージャーは、そのキュー定義自体の MDRQ 名を調べます。 この名前を持つリモート・キューのローカル定義が存在している場合は、伝送されたメッセージの中の MDRM 値が、リモート・キューの定義内の RemoteQMgrName 属性の値によって置換されます。受信側のアプリケーションがメッセージの MQGET 呼び出しを出すと、メッセージ記述子にこの値が返されます。 リモート・キューのローカル定義が存在しない場合、メッセージと共に伝送される MDRM は、ローカル・キュー・マネージャーの名前になります。

名前を指定するときは、末尾ブランクを付けることができます。最初のヌル文字およびその後に続く文字は、ブランクとして扱われます。 しかし、それ以外の場合は、名前がキューの命名規則を満たすかどうかを調べる検査は行われません。伝送されたメッセージ内の MDRM が置換される場合、このことは伝送された名前についても同様です。

応答先キューが必要でない場合は、MDRM フィールドをブランクに初期化してください (ただし、その検査はありません)。

MQGET 呼び出しの場合、キュー・マネージャーは、常にフィールドの長さまでブランクを埋め込んだ名前を返します。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの長さは LNQMN によって指定されます。 このフィールドの初期値は 48 個のブランク文字です。

応答キューの名前。

これは、メッセージ読み取り要求を発行したアプリケーションが送信する MTRPLY および MTRPRT メッセージの送信先のメッセージ・キューの名前です。 この名前は、MDRM で指定されているキュー・マネージャーで定義されているキューのローカル名です。 このキューをモデル・キューにすることはできません。ただし、送信側のキュー・マネージャーは、メッセージが書き込まれたときに、これについて確認はしません。

MQPUT および MQPUT1 呼び出しでは、MDMT フィールドに値 MTRQST がある場合、または MDREP フィールドによりいずれかのレポート・メッセージが要求される場合に、このフィールドをブランクにしてはなりません。 ただし、メッセージ・タイプにかかわらず、指定された値 (または置き換えられた値) が、メッセージの読み取り要求を発行したアプリケーションに渡されます。

MDRM フィールドがブランクの場合、ローカル・キュー・マネージャーは、独自のキュー定義内で MDRQ 名を探索します。 リモート・キューのローカル定義でこの名前が存在する場合、伝送されたメッセージの MDRQ の値は、リモート・キューの定義から取られた RemoteQName 属性値で置き換えられ、これらの値は受信側アプリケーションがメッセージの MQGET 呼び出しを発行する際にメッセージ記述子内に戻されます。 リモート・キューのローカル定義が存在しない場合、MDRQ は変更されません。

名前を指定するときは、末尾ブランクを付けることができます。最初のヌル文字およびその後に続く文字は、ブランクとして扱われます。 しかし、名前がそれ以外の点でキュー命名規則を満たすかどうかを調べる検査は行われません。MDRQ が伝送されたメッセージ中に再度挿入される場合も、伝送された名前は同様の扱いとなります。 必要に応じて名前が指定されたかどうかのみ検査されます。

応答先キューが必要でない場合は、MDRQ フィールドをブランクに初期化してください (ただし、その検査はありません)。

MQGET 呼び出しの場合、キュー・マネージャーは、常にフィールドの長さまでブランクを埋め込んだ名前を返します。

レポート・メッセージを必要とするメッセージを配布できず、指定されたキューにレポート・メッセージを配布することもできない場合は、元のメッセージとレポート・メッセージの両方が送達不能 (未配布メッセージ) キューに送られます。 IBM iで説明されている DeadLetterQName 属性を参照してください。

これは、MQGET 呼び出しでは出力フィールド、MQPUT および MQPUT1 呼び出しでは入力フィールドです。 このフィールドの長さは LNQN によって指定されます。 このフィールドの初期値は 48 個のブランク文字です。

グループ中の論理メッセージの順序番号。

順序番号は 1 から始まり、グループに新しい論理メッセージが追加されるたびに 1 つずつ大きくなり、最大で 999 999 999 です。 グループにまとめられていない物理メッセージの順序番号は 1 です。

MQGET 呼び出しへの入力では、キュー・マネージャーは 表 1 で詳述されている値を使用します。 MQGET 呼び出しの出力時に、キュー・マネージャーは、このフィールドに、取り出されたメッセージの値を設定します。

このフィールドの初期値は 1 です。 MDVER 値が MDVER2 未満の場合、このフィールドは無視されます。

構造体 ID

これは常に入力フィールドです。 このフィールドの初期値は MDSIDV です。

ユーザー ID。

これは、メッセージの ID コンテキスト の一部です。 メッセージ・コンテキストについて詳しくは、 メッセージ・コンテキスト および コンテキスト情報の制御を参照してください。

MDUID には、メッセージを発信したアプリケーションのユーザー ID を指定します。 キュー・マネージャーはこの情報を文字データとして扱いますが、そのフォーマットの定義はしません。

メッセージを受信した後、後続の MQOPEN または MQPUT1 呼び出しの OBJDSC パラメーターの ODAU フィールドで MDUID を使用することができます。これにより、オープンを実行するアプリケーションの代わりに、 MDUID ユーザーに対して許可検査が実行されます。

キュー・マネージャーは、MQPUT または MQPUT1 呼び出しについて この情報を生成する際、環境によって決定されるユーザー ID を使用します。

MQPUT および MQPUT1 呼び出しの場合、PMO パラメーターに PMSETI または PMSETA が指定されていれば、これは入出力フィールドです。 フィールド内でヌル文字より後の情報はすべて破棄されます。 ヌル文字およびその後に続く文字は、キュー・マネージャーによってブランクに変換されます。 PMSETI または PMSETA が指定されていない場合、入力においてこのフィールドは無視され、出力専用フィールドになります。

MQPUT または MQPUT1 呼び出しが正常に完了すると、メッセージがキューに書き込まれた場合、このフィールドには、そのメッセージと共に送信された MDUID が入ります。 これは、メッセージが保存された場合 (保存パブリケーションについて詳しくは、PMRET の説明を参照してください)、そのメッセージと共に保持された MDUID の値になりますが、メッセージがパブリケーションとしてサブスクライバーに送信された場合には MDUID として使用されません。これは、サブスクライバーが提供する値が、サブスクライバーに送信されるすべてのパブリケーションにおいて MDUID をオーバーライドするためです。 メッセージがコンテキストを持っていない場合、フィールドは完全にブランクになります。

これは、MQGET 呼び出しの出力フィールドです。 このフィールドの長さは LNUID によって指定されます。 このフィールドの初期値は 12 個のブランク文字です。

構造体のバージョン番号。

これは常に入力フィールドです。 このフィールドの初期値は MDVER1 です。