putOptionsRecord プロパティーは、 メッセージ・キューへの書き込みを制御するオプションを WebSphere® MQ システムに渡すために使用できるレコード変数を識別します。
このプロパティーが識別するレコード変数は、BasicRecord に基づきます。
EGL プログラムは、WebSphere MQ MQPUT 関数を呼び出して、メッセージ・キュー・レコードの add ステートメントを実装します。 WebSphere MQ Put Message Options (MQPMO) 構造は、 MQPUT 呼び出しにおけるパラメーターです。
putOptionsRecord プロパティーを指定しないと、 EGL は自動的にデフォルトの MQPMO 構造を作成し、 includeMsgInTransaction プロパティーを基にして OPTIONS フィールドの MQGMO_SYNCPOINT または MQGMO_NO_SYNCPOINT を設定します。
| フィールド | 型 | 説明 |
|---|---|---|
| STRUCID | CHAR(4) | 構造の識別子 |
| VERSION | INT | 構造のバージョン番号 |
| OPTIONS | INT | MQPUT または MQPUT1 のオプション |
| TIMEOUT | INT | 予約済み |
| CONTEXT | INT | 入力キューのオブジェクト処理 |
| KNOWNDESTCOUNT | INT | ローカル・キューに送られるメッセージの数 |
| UNKNOWNDESTCOUNT | INT | リモート・キューに送られるメッセージの数 |
| INVALIDDESTCOUNT | INT | 送信できなかったメッセージの数 |
| RESOLVEDQNAME | CHAR(48) | 宛先キューの名前 |
| RESOLVEDQMGRNAME | CHAR(48) | 宛先キュー・マネージャーの名前 |
| RECSPRESENT | INT | 存在する put メッセージまたは応答レコードの数 |
| PUTMSGRECFIELDS | INT | 現在の MQPMR フィールドのフラグ |
| PUTMSGRECOFFSET | INT | MQPMO 内の put メッセージ・レコードのオフセット |
| RESPONSERECOFFSET | INT | MQPMO 内の応答レコードのオフセット |
| PUTMSGRECPTR | INT | 最初の put メッセージ・レコードのアドレス |
| RESPONSERECPTR | INT | 最初の応答レコードのアドレス |
putOptionsRecord プロパティーを使用して、 MQPMO を指定したり、または MQPMO に基づいて独自の変数を指定したりできます。キューにアクセスする前に、 MQPMO レコード変数内のフィールドを初期化および設定するようにプログラムをコーディングします。EGL は、 デフォルトの構造に代えて、ユーザーの MQPMO 構造を使用します。
オプション・レコードについて詳しくは、MQRecord のオプション・レコードを参照してください。 WebSphere MQ 定数 (例えば、MQGMO_SYNCPOINT など) の完全なリストについては、 WebSphere MQ の資料を参照してください。