MQSC アダプターは、アプリケーションで使用するために MQSeries に固有のコンテキスト・プロパティーのセットを提供します。 これらのプロパティは、パイプライン コンポーネント、オーケストレーション、およびフィルター式で使用できます。 プログラムから簡単にアクセスできるように、MQMD、MQXQH、MQCIH、MQIIH ヘッダー構造には、これらのコンテキスト・プロパティーを使用して直接アクセスできます。
MQSC アダプターでは、他のすべての MQSeries ヘッダー構造 (例: MQRFH) がサポートされています。 ただし、これらのヘッダーにアクセスするには、カスタム パイプライン コンポーネントを使用して行い、メッセージの本文から取得する必要があります。 送信メッセージで設定する場合、パイプライン コンポーネントはメッセージが正しく構築されていることを確認する役割を担います。
MQSC アダプターにバインドされている送信ポート宛てのメッセージに MQSeries コンテキスト・プロパティーを割り当てるには、メッセージ割り当て演算子を使用し、MQSeries 名前空間で使用可能なコンテキスト・プロパティーの 1 つを指定します。
MQSeries MQMD_UserIdentifier プロパティの設定例を次に示します。
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
IBM MQSeries SDK に含まれている C プログラミング言語ヘッダー・ファイルから列挙値を取得する必要があります。 これらのファイルは、Program Files\IBM\WebSphere MQ\Tools\c\include フォルダーにあります。 これらのファイルは、MQSeries コンテキスト・プロパティー値の設定または読み取り時に使用する値を定義します。
16 進数の文字列値は、バイナリ値を表す文字列です。 0x などのプレフィックスはありません。 0 ~ 9 の数字と、"a" から "f" または "A" から "F" までの文字が含まれます。 アダプターは、その中の空白を無視します。
これらのプロパティーの詳細については、WebSphere MQ の資料を参照してください。