WMQ.Send Message

メッセージング > WebSphere MQ との接続 > コンポーネントプログラム

メッセージキューにメッセージを送信します。

パラメータ

説明

Queue Handle

数値(18)/入力:オープンされたキューのハンドル値です。

Message

BLOB/入力:メッセージデータ を含んだバッファ形式の BLOB。[SetTextIntoBuffer]プログラムを使用することで文字項目をバッファ形式に変換できます。

Buffer Identifier index

数値(4)/入力:

  • 0 の場合、メッセージは、BLOB内になければなりません。

  • 0 より大きい場合、メッセージ構造と値はメモリテーブル(バッファテーブル)にあることになり、この値がインデックスになります。

詳細は、「バッファテーブル」を参照してください。

Transacted Msg

論理値/入力:「True」 の場合、メッセージはトランザクションの一部です。トランザクションがオープンされていない場合は、WMQ が自動的に開始します。

Message type

数値(1)/入力:メッセージのタイプを指定します。

  • 0 …… メッセージ(MQ データグラム)

  • 1 …… リクエスト

  • 2 …… 応答

コンポーネントは、指定された 送信タイプに従ってメッセージを送ります。このパラメータは、パブリッシュでは無効です。

Broadcast This Message

論理値/入力:キューのハンドルが送信されない場合(すなわち 0 の場合)、この値は「True」 にしなければなりません。その場合、同じメッセージが、ブロードキャスト用にオープンしている全てのキューに送信されます。詳細は、 [Open Destination]の[Participate in Broadcast]パラメータを参照してください。キューハンドルが送信され、値が「True」 の場合、エラーが作成されます。キュー送信されず、値が「False」 の場合、やはりエラーが作成されます。

Retain

 論理値/入力:指定できる値は以下の通りです。

  • False …… メッセージは将来のサブスクライバ用に保存されません。

  • True …… メッセージは将来のサブスクライバ用に保存されます。

このパラメータは、パブリッシュのみ有効です。

Correlation ID

BLOB/入出力(オプション):リクエスト メッセージの相関関係を確認します。共有されたキューにおける特定のサブスクライバのために サブスクリプションを確認します。

指定できる最大サイズは、24バイトです。

Message ID

BLOB/入出力(オプション):このパラメータはメッセージ ID を返します。メッセージ IDが送信された場合、呼出しアプリケーションは ID を管理しなければなりません。

指定できる最大サイズは、24バイトです。

Reply 2 Queue Manager

文字(48)/入力(オプション):応答が送信されるキューマネージャの名前。このパラメータは、リクエスト とパブリッシングのみ有効です。

Reply 2 Queue Name

文字(48)/入力(オプション):応答が送信されるキューの名前。送信タイプリクエスト とパブリッシングのみ有効です。

Message Format

数値(2)/入力(オプション):メッセージの書式を指定します。以下の値を指定します。

  • 0 …… フォーマットなし(デフォルト)

  • 1 …… MQ Series が変換を実行(MQSTR)

  • 2 …… Admin (MQADMIN)

  • 3 …… CHANNEL_COMPLETED (MQCHCOM)

  • 4 …… Dead letter header (MQDEAD)

  • 5 …… Trigger (MQTRIG)

  • 6 …… XMIT_Q_Header (MQXMIT)

 

戻り値

数値(17):処理が成功した場合 0、失敗した場合は負の数(エラーコード)が返ります。