FileInput ノードを使用して、リモート FTP サーバーまたはリモート SFTP サーバー上のディレクトリーのファイルを読み取ってから、そのファイルの内容をベースとするメッセージを伝搬します。
始める前に:この例は、
メッセージ・フローの入力としてローカル・ファイルを使用するで説明した例の延長であり、メッセージ・フローでの
FileInput ノードの使用法について説明しています。
説明では、
Windows オペレーティング・システムを使用中であり、
FileInput ノードを含むメッセージ・フローを作成したことを前提にしています。 他に以下のリソースが必要です。
- 必要なノード・プロパティーを FileInput ノード上で設定します。 以下の表は、設定する必要のある FileInput ノード・プロパティー、プロパティーが表示されるタブ、プロパティーが必須かどうか、および必要な値を要約しています。
| タブ |
プロパティー |
値 |
| 基本 |
入力ディレクトリー |
C:¥FileInput¥TestDir 入力ディレクトリーが存在しない場合、ファイルを FTP または SFTP を介して処理している場合であっても、ファイルは全く処理されません。
|
| ファイル名またはパターン |
test_input1.xml |
| 正常処理時のアクション |
アーカイブ・サブディレクトリーに移動する |
| 重複するアーカイブ・ファイルを置き換える |
選択されている |
| 入力メッセージの解析 |
メッセージ・ドメイン |
XMLNSC |
| メッセージ・モデル |
xml1 |
| ポーリング |
ポーリング間隔 |
3 |
| 再試行 |
ファイル失敗時のアクション |
タイム・スタンプを追加し、バックアウト・サブディレクトリーに移動する |
| レコードとエレメント |
レコード検出 |
区切り |
| 区切り文字 |
DOS または UNIX の行終了 |
| 区切り文字タイプ |
後置 |
| FTP |
リモート転送 |
選択されている |
| 転送プロトコル |
FTP または SFTP |
| リモート・サーバーおよびポート |
ftpserver.hursley.abc.com |
| セキュリティー ID |
myidentity |
| サーバー・ディレクトリー |
/ftpfileinput |
| 転送モード |
ASCII (FTP 用のみ) |
| スキャン遅延 |
45 |
FTP サーバーまたは SFTP サーバーのリソースに対して他の値を使用していた場合、その値を入力します。ここで使用する設定は、メッセージ・フローの入力としてローカル・ファイルを使用するの例で使用したものと同一です。ただし、「リモート転送」プロパティーが選択されて、「FTP」タブ上にプロパティーがある点が異なります。
「リモート転送」プロパティーをクリアすると、ノードは、メッセージ・フローの入力としてローカル・ファイルを使用するの例の場合と同じ動作をします。「FTP」タブのプロパティーは設定されたままになりますが、無視されます。
- メッセージ・フローをブローカーにデプロイします。デプロイを参照してください。
これらのステップを実行すると、以下のアクションが起きます。
- ファイル test_input1.xml が、FTP サーバーまたは SFTP サーバーのディレクトリー (/ftpfileinput) から、ローカル・ディレクトリー (C:¥FileInput¥TestDir) に転送されます。このファイルは、FTP サーバーまたは SFTP サーバーのディレクトリーから削除されます。
- FileInput ノードは、「レコードとエレメント」タブのプロパティーで定義されているとおりに、DOS または UNIX の行終了で終了しているレコードを検出して、それぞれのレコードごとにメッセージを作成します。このノードは、Out ターミナルに接続されているメッセージ・フローに以下の 3 つのメッセージを伝搬します。
- End of Data ターミナルにノードが接続されている場合、このファイル中の最後のレコードが処理された後、End of Data メッセージが伝搬されます。
- 処理が完了すると、ファイル test_input1.xml は mqsiarchive サブディレクトリー C:¥FileInput¥TestDir¥mqsiarchive に移動されます。test_input1.xml という名前のファイルが mqsiarchive サブディレクトリー内に存在する場合、そのファイルは上書きされます。
- メッセージ・フローに障害が起きた場合、FileInput ノードのプロパティーに設定されている値に従って、再試行処理が試みられます。
このタスク例では、タイム・スタンプがファイル名に追加され、ファイルは mqsibackout ディレクトリーに移動されます。その場合のファイルのパスは、C:¥FileInput¥TestDir¥mqsibackout¥20070928_150234_171021_test_input1.xml となります。
FTP サイドでエラーが生じ、アクセスが拒否されたと報告された場合、0 バイトのファイルが作成され、mqsibackout ディレクトリーに移動されます。失敗したすべての FTP 試行について、mqsibackout ディレクトリーに 0 バイトのファイルが作成されます。
「リモート転送」プロパティーを選択したので、45 秒の FTP スキャン遅延によって、3 秒間のポーリング間隔が指定変更されます。
詳しくは、ファイルをレコードに分離する方法の制御を参照してください。ここでは、FileInput ノードの「レコード検出」、「区切り文字」、および「区切り文字タイプ」プロパティーに、他の値の組み合わせを指定した場合の結果について説明されています。
以下のサンプルも、このノードの使用方法を示します。
サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。