putOptionsRecord

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 を設定します。

表 1. WebSphere MQ Put Message Options レコード (MQPMO) の構造
フィールド 説明
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 の資料を参照してください。


フィードバック