メッセージ書き込み(MQPUT)処理

オペレーション名

メッセージ書き込み(MQPUT)

機能概要

メッセージ書き込み(MQPUT)処理は、指定されたキューにメッセージを書き込みます。

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

プロパティ

必須設定
項目名 必須/省略可 変数の使用 説明 備考
接続先 必須 使用不可 グローバルデータリソースに登録されている接続先を設定します。
グローバルリソースの設定方法については「グローバルリソースのプロパティ」を参照してください。
  • [追加]:
    新規にグローバルリソースを追加します。
  • [一覧の編集]:
    「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
 
キュー名 必須 使用可 指定されたリソース(キューマネージャ)に対するキュー名を入力します。  
メッセージモード選択 省略可 使用不可 メッセージをどのように扱うかを選択します。
  • [テキストデータとして扱う(フォーマットなし)]:(デフォルト)
    テキストフォーマットを使用しません。Mapper上は「message」というスキーマが生成されます。
  • [テキストデータとして扱う(フォーマット使用)]:
    テキストフォーマットを指定することができます。フォーマットが指定されない場合は、「message」というスキーマが生成されます。
  • [バイナリデータとして扱う]:
    テキストフォーマットを使用しません。BASE64デコードされた値を出力します。
 
フォーマット 省略可 使用不可 テキストフォーマットを指定します。
テキストフォーマットの使用方法は「テキストフォーマット」をご覧ください。
  • [追加]:
    新規にフォーマットを追加します。
  • [一覧の編集]:
    「リソース一覧の編集」画面にて、フォーマットの設定を編集することができます。
 
プロパティアクション
項目名 必須/省略可 変数の使用 説明 備考
接続テスト - 使用不可 指定された[接続先][キュー名]でキューへの接続を試みます。
  • [メッセージモード選択]で、[テキストデータとして扱う(フォーマット使用)]を選択した場合、有効になります。

MQMDデフォルト設定

下記項目はMapperでも指定することができます。Mapperで指定した場合はその値が、画面項目よりも優先されます。

各パラメータに設定できる項目はWebSphere MQのマニュアルを参照してください。
項目を指定する場合の具体的な数値については、「 WebSphere MQ6.0 MQC 」を参照してください。

項目名 必須/省略可 利用の使用 説明 制限事項
メッセージID 省略可 使用可 指定したIDを持つメッセージのみを取得します。
[相関ID][グループID]と組み合わせて使用することもできます。
  • 指定された文字列をMS932でバイトに変換した値が指定されます。
メッセージ種別 必須 使用可 メッセージの種類を指定します。  
相関ID 選択 使用可 指定したIDを持つメッセージのみを取得します。
[メッセージID]、[グループID]と組み合わせて使用することもできます。
  • 指定された文字列をMS932でバイトに変換した値が指定されます。
永続性 必須 使用可 永続性を指定します。
 
有効期限(1/10秒) 省略可 使用可 有効期限を指定します。
 
優先度 必須 使用可 優先度を指定します。
 
文字コードセット 必須 使用可 文字コードセットを指定します。
 
リプライキューマネージャ名 省略可 使用可 リプライキューマネージャ名指定します。
 
リプライキュー名 省略可 使用可 リプライキュー名を指定します。
 
レポート 省略可 使用可 レポートを指定します。
 

MQMD拡張設定(1)

下記項目は設定拡張チェックボックスにチェックがされている場合に指定することができます。
下記項目はMapperでも指定することができます。Mapperで指定した場合はその値が、画面項目よりも優先されます。

各パラメータに設定できる項目はWebSphere MQのマニュアルを参照してください。
項目を指定する場合の具体的な数値については、「 WebSphere MQ6.0 MQC 」を参照してください。

項目名 必須/省略可 利用の使用 説明 制限事項
グループID 省略可 使用可 指定したIDを持つメッセージを取得します。
[メッセージID][相関ID]と組み合わせて使用することもできます。
  • 指定された文字列をMS932でバイトに変換した値が指定されます。
メッセージフラグ 省略可 使用可 メッセージフラグを指定します。  
フィードバック 省略可 使用可 フィードバックを指定します。  
エンコード 省略可 使用可 エンコードを指定します。  
フォーマット 省略可 使用可 フォーマットを指定します。  
順序番号 省略可 使用可 順序番号を指定します。  
オフセット 省略可 使用可 オフセットを指定します。  
メッセージ長 省略可 使用可 メッセージ長を指定します。  

MQMD拡張設定(2)

下記項目は設定拡張チェックボックスにチェックがされている場合に指定することができます。
下記項目が一つでも指定された場合は指定以外の項目については空白がキューに格納され、
何も指定しない場合は自動生成された値がキューに格納されます。
下記項目はMapperでも指定することができます。Mapperで指定した場合はその値が、画面項目よりも優先されます。

各パラメータに設定できる項目はWebSphere MQのマニュアルを参照してください。
項目を指定する場合の具体的な数値については、「 WebSphere MQ6.0 MQC 」を参照してください。

項目名 必須/省略可 利用の使用 説明 制限事項
ユーザー識別 省略可 使用可 ユーザー識別を指定します。  
会計方法 省略可 使用可 会計方法を指定します。
  • 指定された文字列をMS932でバイトに変換した値が指定されます。
アプリケーションタイプ 省略可 使用可 アプリケーションタイプを指定します。  
アプリケーション名 省略可 使用可 アプリケーション名を指定します。  
日付[yyyy/MM/dd] 省略可 使用可 日付を指定します。  
時刻[HH:mm:ss] 省略可 使用可 時刻を指定します。  
アプリケーション起点データ 省略可 使用可 アプリケーション起点データを指定します。  
アプリケーション識別データ 省略可 使用可 アプリケーション識別データを指定します。  

オプション

項目名 必須/省略可 変数の使用 説明 備考
フォーマットサイズを超えるメッセージはエラーとする 省略可 使用不可 取得したメッセージのサイズが、フォーマットで指定した各項目のサイズを超えた場合、エラーとして処理を中断します。
取得したメッセージのサイズが、フォーマットで指定した各項目のサイズより少ない場合は、スペースでパディングされ処理は続行されます。
  • [チェックあり]:
    メッセージのサイズが[項目のサイズ]で指定したサイズを超える場合、エラーを発生させます。

  • [チェックなし]:(デフォルト)
    メッセージのサイズが[項目のサイズ]で指定したサイズを超える場合、オーバーしたデータを切り捨て、エラーを発生させません。
  • [必須設定]タブの[メッセージモード選択][テキストデータとして扱う(フォーマット使用)]を選択した場合、有効となります。

コメント

項目名 必須/省略可 変数の使用 説明 備考
コメント 省略可 使用不可 このアダプタの簡単な説明を記述することができます。
説明を記述すると、仕様書に反映させることができます。
 

スキーマ

入力スキーマ

書き込むメッセージごとにメッセージのメタ情報(MQMD)を設定することができます。

<?xml version="1.0" encoding="UTF-8" ?>
<table>
  <row>
    <column>messageId</column>
    <column>messageType</column>
    <column>correlationId</column>
    <column>persistence</column>
    <column>expiry</column>
    <column>priority</column>
    <column>characterSet</column>
    <column>replyToQMgrName</column>
    <column>replyToQName</column>
    <column>report</column>
    <column>feedback</column>
    <column>backoutCount</column>
    <column>encoding</column>
    <column>format</column>
    <column>groupID</column>
    <column>msgSeqNumber</column>
    <column>offset</column>
    <column>msgFlags</column>
    <column>originalLength</column>
    <column>userIdentifier</column>
    <column>accountingToken</column>
    <column>applIdentityData</column>
    <column>putApplType</column>
    <column>putApplName</column>
    <column>applOriginData</column>
    <column>putDateTime</column>
    <column>message</column>
	:
  </row>
  <row>
    :
  </row>
</table>
スキーマ項目名 説明
messageId メッセージIDを指定します。
メッセージIDは文字コード MS932 でバイトに変換された値を使用します。
messageType メッセージの種類を指定します。
correlationId 相関IDを指定します。
メッセージIDと組み合わせて使用することもできます。
相関IDは文字コード MS932 でバイトに変換された値を使用します。
persistence 永続性を指定します。
expiry 有効期限を指定します。
priority 優先度を指定します。
characterSet 文字コードセットを指定します。
replyToQMgrName リプライキューマネージャ名指定します。
replyToQName リプライキュー名を指定します。
report レポートを指定します。
feedback フィードバックを指定します。
backoutCount バックアウトカウントを指定します。
encoding 数値エンコードを指定します。
format フォーマットを指定します。
groupID グループIDを指定します。
グループIDは文字コード MS932 でバイトに変換された値を使用します。
メッセージIDと相関IDと組み合わせて使用することもできます。
msgSeqNumber メッセージの順序番号を指定します。
offset メデータのオフセットを指定します。
msgFlags メッセージフラグを指定します。
originalLength メッセージ長を指定します。
userIdentifier ユーザー識別を指定します。
accountingToken 会計方法を指定します。
指定された文字列をMS932でバイトに変換した値を使用します。
applIdentityData アプリケーション識別データを指定します。
putApplType アプリケーションタイプを指定します。
putApplName アプリケーション名を指定します。
applOriginData アプリケーション起点データを指定します。
putDateTime 書き込み日時を指定します。
message メッセージを指定します。
このカラムは、テキストフォーマットの指定数分出力されます。

各項目の詳細な情報については、WebSphere MQのマニュアルを参照してください。

出力スキーマ

ありません。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。
詳細については、「スキーマ編集」を参照してください。

トランザクション

トランザクションをサポートしています。

PSPスクリプトでの使用について

PSPスクリプトでは使用できません。

使用できるコンポーネント変数

利用できるコンポーネント変数名 説明 備考
count キューから取得したメッセージの件数を返します。
  • 実行中にエラーが発生した場合は、件数は「null」となります。
completion_code 完了コードを返します。完了コードの詳細はWebSphere MQのマニュアルを参照してください。
  • 正常終了時には「0」となります。
reason_code 理由コードを返します。理由コードの詳細はWebSphere MQのマニュアルを参照してください。
  • 正常終了時には「0」となります。
message_category エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。
  • デフォルト値はnullです。
message_code エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。
  • デフォルト値はnullです。
message_level エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。
  • デフォルト値はnullです。
error_type エラー発生時、発生したエラーの種類が格納されます。
  • デフォルト値はnullです。
  • エラーの種類は、以下のような形式となります。
    例:「java.io.FileNotFoundException」
  • DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_message エラー発生時、発生したエラーのメッセージが格納されます。
  • デフォルト値はnullです。
  • DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_trace エラー発生時、発生したエラーのトレース情報が格納されます。
  • デフォルト値はnullです。
  • DataSpider Servistaのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

主な例外

例外名 原因 対策
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[]
[接続先]が指定されていません。 [接続先]を指定してください。
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]
[接続先]で選択されたリソース定義が見つかりません。 [接続先]で指定したグローバルリソースを確認してください。
MQException
WebSphere MQの処理で発生したエラーです。
完了コード、理由コードがログに出力されます。それぞれのコードの詳細については、WebSphere MQのマニュアルを参照してください。 完了コード、理由コードがログに出力されます。それぞれのコードの詳細については、WebSphere MQのマニュアルを参照してください。
FormatResourceException
フォーマットエラーです。
WebSphere MQのメッセージや、Mapperからのデータがフォーマットで指定したサイズを超えていた場合に出力されます。
このエラーは、[オプション]タブの[フォーマットサイズを超えるメッセージはエラーとする]にチェックを入れた場合のみ出力されます。
フォーマットを確認してください。
NoClassDefFoundError
com/ibm/mq/MQException
ライブラリが正しくインストールされていない場合に出力されます。 必要なライブラリはこちらで確認することができます。
java.lang.UnsatisfiedLinkError 複数バージョンのWebSphere MQに対しバインド接続をした場合に発生します。 バインド接続するWebSphere MQを1つにしてください。もしくは、クライアント接続を使用してください。