# tMomInput

メッセージ指向ミドルウェア(MOM)システムのキューからメッセージをフェッチし、次のコンポーネントに渡します。

tMomInputではMOMサーバー経由の非同期通信を設定できます。

詳細は、[https://help.talend.com/r/ja-JP/8.0/studio-user-guide/messaging-brokers-supported-by-talend-messaging-components](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/messaging-brokers-supported-by-talend-messaging-components)をご覧ください。

## tMomInputの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtMomInputを設定するために使われます。

標準のtMomInputコンポーネントは、インターネットファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Use existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用する場合は、このチェックボックスを選択して、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。<br><br>ジョブに親ジョブと子ジョブが含まれている場合、[Component List] (コンポーネントリスト)には同じジョブレベルの接続コンポーネントのみが表示されます。 |
| [Keep Listening] (リスニングの継続) | このチェックボックスをオンにすると、MOMサーバーで新しいメッセージをリッスンし、フェッチし続けます。<br><br>このチェックボックスは [MQ server] (MQサーバー)リストから[ActiveMQ]または[WebSphere MQ]が選択されており、[receive number of messages] (受信メッセージ数)チェックボックスが選択されている場合は表示されません。 |
| [Sleeping time (in sec)] (スリープ時間: 秒) | 次のメッセージを受信するタイムアウト間隔(秒)を指定します。<br><br>このフィールドは、以下のいずれかの状況で利用できます:<br><br><ul> <li> <p> <span>[MQ server] (MQサーバー)</span>リストから<span>[JBoss Messaging] (JBoss メッセージング)</span>が選択され、<span>[Keep Listening] (リスニングの継続)</span>チェックボックスが選択されている場合。</p> </li> <li> <p> <span>[ActiveMQ]</span>が<span>[MQ server] (MQサーバー)</span>リストから選択され、<span>[Keep Listening] (リスニングの継続)</span>チェックボックスがオフになっている場合。</p> </li> <li> <p> <span>[ActiveMQ]</span>が<span>[MQ server] (MQサーバー)</span>リストから選択され、<span>[receive number of messages] (受信メッセージ数)</span>および<span>[Timeout for receiver] (レシーバーのタイムアウト)</span>チェックボックスが選択されている場合。</p> </li> </ul> |
| [receive number of messages] (受信メッセージ数) | このチェックボックスをオンにすると、受信できるメッセージの最大数を設定できます。<br><br>このチェックボックスは、[MQ server] (MQサーバー)リストから[ActiveMQ]または[WebSphere MQ]が選択されていて、[Keep Listening] (リスニングの継続)チェックボックスが選択されていない場合に使用できます。 |
| [maximum messages] (最大メッセージ数) | 受信できるメッセージの最大数を入力します。<br><br>このフィールドは[receive number of messages] (メッセージ数の受信)チェックボックスが選択されている場合にのみ使用できます。 |
| [Timeout for receiver] (レシーバーのタイムアウト) | このチェックボックスをオンにすると、[Sleeping time (in sec)] (スリープ時間: 秒)フィールドで受信者のタイムアウト間隔を指定できます。<br><br>このチェックボックスは、[receive number of messages] (メッセージ数の受信)チェックボックスが選択されている場合にのみ使用できます。 |
| [Failover] (フェイルオーバー) | このチェックボックスをオンにすると、ActiveMQフェイルオーバー転送が使用されます。フェイルオーバー転送の詳細は、[フェイルオーバー転送リファレンス](http://activemq.apache.org/failover-transport-reference.html)をご覧ください。<br><br>このチェックボックスは、[MQ server] (MQサーバー)リストから[ActiveMQ]が選択されていて、[Static Discovery] (スタティック検出)チェックボックスが選択されていない場合にのみ使用可能です。 |
| [Static Discovery] (スタティック検出) | このチェックボックスをオンにすると、ActiveMQスタティック転送検出メカニズムが使用されます。スタティック転送についての詳細は、[スタティック転送リファレンス](http://activemq.apache.org/static-transport-reference.html)をご覧ください。<br><br>このチェックボックスは、[MQ server] (MQサーバー)リストから[ActiveMQ]が選択され、[Failover] (フェイルオーバー)チェックボックスが選択されていない場合にのみ使用可能です。 |
| [URI parameters] (URIパラメーター) | URIパラメーターを入力します。<br><br>このフィールドは[Failover] (フェイルオーバー)または[Static Discovery] (スタティック検出)チェックボックスが選択されている場合にのみ使用できます。 |
| [MQ server] (MQサーバー) | リストから接続するMQサーバーのタイプ[ActiveMQ]、[JBoss Messaging]、または[WebSphere MQ]を選択します。選択したサーバータイプによって、必要なパラメーターが若干異なります。 |
| [Use SSL Transport] (SSL転送を使用) | このチェックボックスをオンにすると、ActiveMQ SSL転送を使用できます。SSL転送の詳細は、[SSL転送リファレンス](http://activemq.apache.org/ssl-transport-reference.html)をご覧ください。<br><br>このチェックボックスは[MQ server] (MQサーバー)リストから[ActiveMQ]が選択されている場合にのみ使用可能です。 |
| [Host] (ホスト) | MQサーバーのホスト名またはIPアドレスを入力します。 |
| [Port] (ポート) | MQサーバーのリスニングポートを入力します。 |
| [Username] (ユーザー名)と[Password] (パスワード) | ユーザー認証情報を入力します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Channel] (チャネル) | 接続を確立するチャネルの名前を指定します。デフォルト値は*DC.SVRCONN*になります。<br><br>このフィールドは[MQ server] (MQサーバー)リストから[WebSphere MQ]が選択されている場合にのみ使用可能です。 |
| [Message From] (メッセージ送信元) | サーバーによって予期される通りにメッセージソースを入力します。 これには、queue/Aやtopic/testtopicのように、ソースのタイプと名前が含まれている必要があります。<br><br>このフィールドでは大文字と小文字が区別されます。<br><br>このフィールドは[MQ server] (MQサーバー)のリストから[ActiveMQ]または[JBoss Messaging]が選択されている場合にのみ使用できます。 |
| [Message Type] (メッセージタイプ) | メッセージタイプ[Topic] (トピック)または[Queue] (キュー)のいずれかを選択します。<br><br>このフィールドは[MQ server] (MQサーバー)のリストから[ActiveMQ]または[JBoss Messaging]が選択されている場合にのみ使用できます。 |
| [Message Body Type] (メッセージ本文タイプ) | [Text Message] (テキストメッセージ)、[Bytes Message] (バイトメッセージ)または[Map Message] (マップメッセージ)のメッセージ本文タイプを選択します。 |
| [Schema] (スキーマ)と[Edit Schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。<br><br>tMomInputを使用する場合、スキーマは[From]および[Message]という2つのカラムで設定されます。カラム名はそれぞれ読み取り専用です。 |
| QueueManager | 接続を確立するキューマネージャーの名前を指定します。<br><br>このフィールドは[MQ server] (MQサーバー)リストから[WebSphere MQ]が選択されている場合にのみ使用可能です。 |
| [MessageQueue] | メッセージキューイングアプリケーションでメッセージを書き込むことができるメッセージキューの名前を入力します。<br><br>このフィールドは[MQ server] (MQサーバー)リストから[WebSphere MQ]が選択されている場合にのみ使用可能です。 |
| [Is using message id to fetch] (メッセージIDを使用してフェッチ) | このチェックボックスをオンにすると、IDに基づいてメッセージを取得できます。<br><br>このチェックボックスは、[Message Body Type] (メッセージ本文タイプ)リストから[Text Message] (テキストメッセージ)または[Bytes Message] (バイトメッセージ)が選択されている場合にのみ使用できます。 |
| [Commit (delete message after read from the queue)] (コミット: キューから読み取り後にメッセージを削除) | このチェックボックスをオンにすると、キューから各メッセージを読み取った後で強制的にコミットできます。<br><br>このチェックボックスは、[MQ server] (MQサーバー)のリストから[WebSphere MQ]が選択されていて、[Advanced settings] (詳細設定)ビューの[Browse message] (メッセージの参照)チェックボックスがオフになっている場合にのみ使用できます。 |
| [Backout messages to input queue] (入力キューへのメッセージのバックアウト) | このチェックボックスをオンにすると、メッセージを読み取った後でキューに再び戻されます。<br><br>このチェックボックスと[Advanced settings] (詳細設定)ビューの[Browse message] (メッセージの参照)チェックボックスを使用すると、キューからメッセージに手を加えることなく読み取ることができます。詳細は、https://publib.boulder.ibm.com/iseries/v5r2/ic2924/books/csqzaw07.pdfをご覧ください。<br><br>このチェックボックスは[MQ server] (MQサーバー)のリストから[WebSphere MQ]が選択され、[Keep Listening] (リスニングの継続)、[Commit (delete message after read from the queue)] (コミット:キューからの読み取り後にメッセージを削除)、および[Browse message] (メッセージの参照)チェックボックスがオフになっている場合にのみ使用可能です。 |
| [Backout messages to backout queue (when backoutCount of message reach the threshold value)] (バックアウトキューへのメッセージのバックアウト: メッセージのbackoutCountがしきい値に達した場合) | このチェックボックスをオンにすると、バックアウトカウントがWebsphere MQサーバーのキューのプロパティの設定済みしきい値に到達した場合に、メッセージをWebsphere MQマネージャーで定義されているバックアウトキューにバックアウトできます。<br><br>このチェックボックスは[MQ server] (MQサーバー)のリストから[WebSphere MQ]が選択され、[Keep Listening] (リスニングの継続)、[Commit (delete message after read from the queue)] (コミット:キューからの読み取り後にメッセージを削除)、および[Browse message] (メッセージの参照)チェックボックスがオフになっている場合にのみ使用可能です。 |
| [Set Transacted] (トランザクションの設定) | このチェックボックスをオンにすると、セッションを取引できます。このパラメーターの詳細は、https://publib.boulder.ibm.com/iseries/v5r2/ic2924/books/csqzaw07.pdfをご覧ください。<br><br>情報メモ注:<br><br>このチェックボックスをオンにすると、tMomInputの[Advanced settings] (詳細設定)ビューの[Acknowledgement Mode] (確認応答モード)リストの設定は無視されます。<br><br>このチェックボックスは[MQ server] (MQサーバー)リストから[ActiveMQ]が選択されている場合にのみ使用可能です。 |
| [start server] (サーバーを起動) | このチェックボックスをオンにすると、ActiveMQサーバーを強制的に起動できます。<br><br>このチェックボックスは[MQ server] (MQサーバー)リストから[ActiveMQ]が選択されている場合にのみ使用可能です。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Additional options] (その他のオプション) | テーブルに追加の転送オプションを定義します。このテーブルは[Basic settings] (基本設定)ビューの[Failover] (フェイルオーバー)または[Static Discovery] (スタティック検出)チェックボックスをオンにした場合にのみ使用できます。<br><br><ul> <li> <p> <span>[Option name] (オプション名)</span>: オプションの名前。</p> </li> <li> <p> <span>[Option value] (オプション値)</span>: オプションの値。</p> </li> </ul><br><br>たとえば、[Option name] (オプション名)フィールドに*maxReconnectAttempts*と入力し、[Option value] (オプション値)フィールドに*0*を指定すると、フェイルオーバーモードで使用可能なサーバーがない場合には接続の再試行は試行されません。<br><br>フェイルオーバー転送オプションの詳細は、[フェイルオーバー転送リファレンス](http://activemq.apache.org/failover-transport-reference.html)をご覧ください。<br><br>スタティック検出転送オプションの詳細は、[スタティック転送リファレンス](http://activemq.apache.org/static-transport-reference.html)をご覧ください。 |
| [Acknowledgement Mode] (受信確認モード) | リストから受信確認モードを選択して、クライアントが受け取ったメッセージを確認することを示します:<br><br>[Auto Acknowledge] (自動確認): この確認応答モードでは、受信の呼び出しからメッセージが正しく返されたか、正しく返されたメッセージを処理するために呼び出されたメッセージリスナーのいずれかに対して、クライアントは自動的にメッセージの確認応答を行います。<br><br>[Client Acknowledge] (クライアント確認応答): この確認応答モードでは、クライアントはメッセージの確認応答メソッドを呼び出してメッセージを確認します。<br><br>[Dups OK Acknowledge] (Dups OK確認応答): この確認応答モードでは、配信メッセージの応答を遅延させるようにセッションに指示します。<br><br>Jmsヘッダーの使用方法は、https://publib.boulder.ibm.com/iseries/v5r2/ic2924/books/csqzaw07.pdfをご覧ください。<br><br>情報メモ注:<br><br>tMomOutputの[Set Transacted] (トランザクションの設定)チェックボックスが選択されている場合、[Acknowledgement Mode] (確認応答モード)は無視されます。このチェックボックスは、MQサーバーが[ActiveMQ]または[JBoss Messaging]の場合に有効になります。 |
| [Get Jms Header] (Jmsヘッダーの取得) | このチェックボックスをオンにすると、JmsフィールドからMQシリーズへのマッピングフィールドを使用してJmsヘッダーを受信できます。このチェックボックスをオンにすると、[Parameters] (パラメーター)テーブルのプラスボタンをクリックして、追加される行にJmsヘッダーと対応する参照カラム名を指定できます。Jmsヘッダーの使用方法は、https://publib.boulder.ibm.com/iseries/v5r2/ic2924/books/csqzaw07.pdfをご覧ください。<br><br>情報メモ注:<br><br>このチェックボックスは、MQサーバーが[ActiveMQ]または[JBoss Messaging]の場合に有効になります。 |
| [Get Jms Properties] (Jmsプロパティの取得) | このチェックボックスをオンにすると、MQMDフィールドにマッピングされたJmsプロパティを受け取ることができます。このチェックボックスをオンにすると、[Parameters] (パラメーター)テーブルのプラスボタンをクリックして、追加される行にプロパティ名、プロパティタイプ、参照カラム名を指定できます。Jmsプロパティの使用方法は、https://publib.boulder.ibm.com/iseries/v5r2/ic2924/books/csqzaw07.pdfをご覧ください。<br><br>([MQ Server] (MQサーバー)のリストで[ActiveMQ]または[JBoss Messaging]が選択されている場合に使用できます)。 |
| [Browse message] (メッセージの参照) | このチェックボックスをオンにすると、[Basic settings] (基本設定)ビューで[Commit (delete message after read from the queue)] (コミット: キューからのメッセージの削除)チェックボックスおよび[Backout messages to input queue] (入力キューへのメッセージのバックアウト)チェックボックスを使用不可にし、キューを開いてメッセージを参照します。<br><br>情報メモ注:<br><br>このチェックボックスおよび[Basic settings] (基本設定)ビューの[Backout messages to input queue] (入力キューにメッセージをバックアウト)チェックボックスを使用すると、キューからメッセージに手を加えることなく読み取ることができます。[Browse message] (メッセージの参照)チェックボックスは、MQサーバーがWebSphere MQで[Backout messages to input queue] (入力キューへのバックアウトメッセージ)チェックボックスがオフになっている場合にのみ表示されます。詳細は、http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0m0/index.jsp?topic=%2Fcom.ibm.mq.java.doc%2Fcom%2Fibm%2Fmq%2FMQC.html/をご覧ください。 |
| [Get MQMD Fields] (MQMDフィールドの取得) | このチェックボックスをオンにすると、[Parameters] (パラメーター)テーブルにMQMD(message queuing message descriptor)の新規フィールドを追加し、1つ以上のメッセージ記述子を設定できます。<br><br>[Field Name] (フィールド名): リストから1つ以上のメッセージ記述子を選択してメッセージのヘッダー情報を取得します。<br><br>[Reference Column Name] (参照カラム名): メッセージのヘッダーおよびプロパティの情報<br><br>詳細は、http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0m0/index.jsp?topic=%2Fcom.ibm.mq.csqzak.doc%2Ffr13040\_.htm/をご覧ください。<br><br>([MQ Server] (MQサーバー)のリストで [WebSphere MQ]が選択されている場合に使用できます)。 |
| [Include Header] (ヘッダーを含める) | このチェックボックスをオンにすると、メッセージのヘッダーを指定できます:<br><br>[MQRFH2 fixed Portion] (MQRFH2固定部分): このチェックボックスをオンにすると、プラスボタンをクリックして1つ以上の行を追加し、MQRFH2ヘッダーの固定部分に必要な[Version] (バージョン)、[Encoding] (エンコード)、[Format] (フォーマット)、[Flags] (フラグ)、NameValueCCSID、およびCodedCharSetIdを指定できます。<br><br>[MCD folder] (MCDフォルダー): このチェックボックスをオンにすると、プラスボタンをクリックして1つまたは複数の行を追加し、メッセージの形式を記述するプロパティのフィールドと参照カラム名を指定できます。<br><br>[JMS folder] (JMSフォルダー): このチェックボックスをオンにすると、プラスボタンをクリックして1つ以上の行を追加し、JMSヘッダーフィールドおよびJMSXというプロパティーの転送のためのフィールドと参照カラム名を指定できます。<br><br>[USR folder] (USRフォルダー): このチェックボックスをオンにすると、プラスボタンをクリックして1つ以上の行を追加し、メッセージに関連付けられたアプリケーション定義のプロパティの転送のためのフィールドと参照カラム名を指定します。<br><br>MQRFH2ヘッダーの詳細は、http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp?topic=%2Fcom.ibm.etools.mft.doc%2Faq06920\_.htmをご覧ください。<br><br>[MQ Server] (MQサーバー)リストで[WebSphere MQ]が選択されている場合に使用できます。 |
| [Set Cipher Suite] (Cipher Suiteの設定) | このチェックボックスをオンにすると、WebSphere MQ SSLで使用するCipher Suiteを指定できるCipher Suiteリストを有効にできます。<br><br>Cipher Suiteの詳細は、[CipherSpecsおよびIBM WebSphere MQによりサポートされる同等のCipherSuites](https://www.ibm.com/support/knowledgecenter/SSFKSJ_7.1.0/com.ibm.mq.doc/ja34740_.htm)をご覧ください。<br><br>[MQ Server] (MQサーバー)リストで[WebSphere MQ]が選択されている場合に使用できます。 |
| [Custom Cipher Suite] (カスタムCipher Suite) | このチェックボックスをオンにすると、Cipher Suiteをカスタマイズできます。<br><br>[IBM Cipher Mappings] (IBM暗号マッピング): IBM Java Cipher SuiteからIBM MQ Cipher Specのマッピングで使用します。<br><br>[Oracle Cipher Mappings] (Oracleの暗号マッピング): Oracle Cipher SuiteからIBM MQ Cipher Specのマッピングで使用します。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>NB\_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、通常、開始コンポーネントとして使用されます。これは出力コンポーネントにリンクする必要があります。 |
| [Dynamic settings] (ダイナミック設定) | [+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブで計画されている複数の接続からMQ Server接続をダイナミックに選択します。<br><br>[Dynamic settings] (ダイナミック設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている時のみ利用可能です。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。<br><br>ダイナミックパラメーターの定義法を示すユースケースについては、[コンテキストベースのダイナミック接続によってデータベースからデータを読み取り](https://help.qlik.com/talend/r/ja-JP/8.0/components/defining-context-groups/reading-data-from-databases-through-context-based-dynamic-connections)と、[ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取り](https://help.qlik.com/talend/r/ja-JP/8.0/components/context/reading-data-from-different-mysql-databases-using-dynamically-loaded-connection-parameters)をご覧ください。ダイナミック設定とコンテキスト変数の詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)と[コンテキストグループを作成し、その中でコンテキスト変数を定義](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/creating-context-group-and-define-context-variables-in-it)をご覧ください。 |
| 制限事項 | 関連するActiveMQ、JBoss Messaging、またはWebsphere MQサーバーが起動していることを確認します。<br><br>このコンポーネントでは、関連するjarファイルのインストールが必要です。 |

**関連概念**

[MOMサーバー経由の非同期通信](https://help.qlik.com/talend/ja-JP/components/8.0/mom/tmomoutput-tmominput-tlogrow-trowgenerator-asynchronous-communication-via-mom-server-standard-component-this)

[XMLファイルをMOMサーバー経由で送信する](https://help.qlik.com/talend/ja-JP/components/8.0/mom/tmomoutput-tmominput-tfileinputxml-tlogrow-transmitting-xml-files-via-mom-server-standard-component-this)