FileInput ノード

FileInput ノードを使用して、ファイルから読み取ったメッセージを処理します。

目的

1 つのファイルから 1 つ以上のメッセージを読み込むことが可能で、各メッセージは別々のフロー・トランザクションとして伝搬されます。 1 つのメッセージ・フロー・トランザクションを生成するファイルの部分をレコードと呼びます。 ファイルは、1 つのレコードまたは一連のレコードにすることができます。 ノードのプロパティーは、1 つのファイルで FileInput ノードがレコードを判別する方法を指定します。

FileInput ノードはパレットの「ファイル」ドロワーに入っていて、IBM® Integration Toolkit 内では次のアイコンによって表されます。

FileInput ノード・アイコン

メッセージ構造

FileInput ノードは、次のメッセージ・ドメインのメッセージを処理します。
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

FileInput ノードがメッセージを伝搬するとき、情報は LocalEnvironment.File メッセージ・ツリーに格納されます。 入力ファイルが空の場合は、空のメッセージが伝搬します (ただし、有効であることが条件です)。 以下の表では、LocalEnvironment.File message ツリー構造をリストします。 エレメントには、現行レコードに関するデータが入っています。

エレメント名 エレメント・データ・タイプ 説明
Directory CHARACTER ブローカーのファイル・システムで使用される形式の、入力ディレクトリーの絶対ディレクトリー・パス。 例えば、Windows システムでは、これはドライブ名接頭部 (C: など) で始まります。
Name CHARACTER ファイル名と拡張子。
LastModified TIMESTAMP ファイルの最終変更日時。
TimeStamp CHARACTER 入力ノードでファイルの処理が開始された協定世界時 (UTC) ゾーンの日時。データ・タイプは文字ストリングです。 タイム・スタンプが組み込まれる場合、このデータは、アーカイブ・ファイル名およびバックアウト・ファイル名を作成するときに使用されるストリングになります。
以下のエレメントには、現行レコードに関するデータが入っています。
Offset INTEGER ファイル内でのレコードの開始。 最初のレコードはオフセット 0 から開始します。Offset が End of Data メッセージ・ツリーの一部である場合、この値は入力ファイルの長さになります。
Record INTEGER ファイル内のレコードの番号。 最初のレコードはレコード番号 1 になります。Record が End of Data メッセージ・ツリーの一部である場合、この値は、レコード数になります。
Delimiter CHARACTER 「区切り」が「レコード検出」に指定されている場合に、特定のレコードとその前のレコードを切り離すために使用される文字。 最初のレコードはヌルの区切り文字を持っています。 Delimiter が End of Data メッセージ・ツリーの一部である場合、この値は最後のレコード (ある場合) の後に続く区切り文字になります。
IsEmpty BOOLEAN メッセージ・フローから伝搬されるレコードが空かどうか。 現行レコードが空の場合、IsEmpty を TRUE に設定します。 IsEmpty が End of Data メッセージ・ツリーの一部である場合、このプロパティーは常に TRUE に設定します。

メッセージ・フロー内でのこのノードの使用

FileInput ノードは、ファイルに入ったメッセージを受け入れる必要のあるどのメッセージ・フローにおいても使用できます。 このノードの使用法については、以下のサンプルも参考になります。

サンプルに関する情報は、IBM Integration Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、IBM Integration Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。

FTP を使用するようにファイル・ノードを構成した場合、リモート FTP サーバーに直接接続する代わりに、ネットワークでファイル・ノードを FTP プロキシー・サーバーに接続する必要がある場合があります。 ファイル・ノードをどのように構成して FTP プロキシーを使用するかは、プロキシーが要求をどう処理するかによって異なります。 一部の FTP プロキシーの場合、mqsisetdbparms コマンドで作成した、ログオン資格情報の中のターゲット FTP サーバーの情報をエンコードする必要があります。 例えば、一部の FTP プロキシーは次の値をサポートしています。
Username: FtpTargetHostUsername@ProxyUserName@TargetFtpHostname 
Password: TargetFtpUserPassword@ProxyUserPassword
別のエンコードが必要なプロキシーもあれば、外部構成が必要なプロキシー、またはファイル・ノードでは使用できないプロキシーもあります。

FileInput ノードの構成

FileInput ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。 値を入力する必要のある (デフォルト値が定義されていないプロパティー) すべての必須プロパティーには、アスタリスクが表示されます。

以下のように、FileInput ノードを構成します。

  1. オプション: 「説明」タブで、簡略説明、詳細説明、あるいはその両方を入力します。 このタブで、ノードを名前変更することもできます。
  2. 「基本」タブで、FileInputノードにより処理されるディレクトリーとファイルを、重複ファイルが検出された場合の処理も含めて入力します。
    • 「入力ディレクトリー」では、FileInput ノードがファイルを取得する先のディレクトリーを指定します。 絶対または相対のどちらかのディレクトリー・パスとして、ディレクトリーを指定します。 ディレクトリー・パスを相対パスにすると、それは、環境変数 MQSI_FILENODES_ROOT_DIRECTORY に指定されているディレクトリーをベースとします。 Windows システムでの例は C:¥fileinput です。 UNIX システムでの例は /var/fileinput です。

      FileInput ノードは、入力ファイルの処理中、それらを保持しロックするために、指定の入力ディレクトリーに mqsitransitin サブディレクトリーを作成します。 この入力ディレクトリー内でファイルを処理する実行グループが除去された場合、 mqsitransitin サブディレクトリーを調べて、 一部だけ処理されたファイルや未処理のファイルがないかを確認してください。 そのようなファイルがあれば、それを入力ディレクトリーに戻し入れることにより (そして実行グループ UUID 接頭部をファイル名から除去することにより)、異なる実行グループによる処理を可能にします。 mqsitransitin サブディレクトリーの詳細については、複数のファイル・ノードが同じディレクトリー内のファイルへのアクセスを共有する方法を参照してください。

    • 入力ディレクトリーの下のディレクトリー構造内にあるファイルを処理する場合は、「ローカル・サブディレクトリーを含める」を選択します。 ブローカーは、指定される最上位ディレクトリーへのアクセス権限がなければなりません。ブローカーに、特定のサブディレクトリーへのアクセス権限がないと、そのサブディレクトリーは検索されず、ユーザー・トレースにメッセージが書き込まれます。 ファイルはその存続期間に応じて処理されます。すなわち、最も古いファイルが、ディレクトリー構造内のどこにあるかに関わらず、最初に処理されます。 ファイルを処理するか無視するかは第 1 にファイル名またはパターンにより決定され、第 2 にファイル除外パターンにより決定されます。

      「ローカル・サブディレクトリーを含める」プロパティーと「リモート転送」プロパティーの両方を選択すると、ローカル・システムのサブディレクトリーのみで、処理するファイルが検索されます。 それに対して、リモート・システム上では、指定された最上位ディレクトリーのみで、処理するファイルが検索されます。

    • 「ファイル名またはパターン」では、ファイル名のパターンを指定します。 それは、ファイル名であるか、またはファイル名に一致する文字シーケンス (パターン) です。 パターンとは、以下のワイルドカード文字のうちの少なくとも 1 つを使用しているシーケンスのことです。
      ワイルドカード文字 説明 例
      * ゼロ個以上の文字の任意のシーケンス *.xml は拡張子が xml のすべてのファイル名に一致します。
      ? 任意の 1 文字 f??????.csv は、文字 f と、その後に続く 6 文字とその後のシーケンス .csv から成るすべてのファイル名に一致します。
      ファイルが処理されるのは、そのファイルの名前がパターンと一致した場合です。

      ワイルドカード文字を組み込んだファイル名パターンを指定すると、FileInput ノードは、ファイル名の中でワイルドカードに一致する文字とすべての中間文字を LocalEnvironment.Wildcard.WildcardMatch エレメントにコピーします。 詳しくは、ファイル名パターンを参照してください。

    • 「ファイル除外パターン」には、処理から除外するファイル名のパターンを指定します。 ファイル名、またはファイル名に一致する文字シーケンス (パターン) を指定します。 パターンとは、『ワイルドカード文字』で説明しているワイルドカード文字のうちの少なくとも 1 つを含むシーケンスのことです。 あるファイルを処理から除外するには、そのファイルの名前がパターンと一致する必要があります。
    • 「正常処理時のアクション」を選択し、ファイルが正常に処理された後に FileInput ノードで行うアクションを指定します。 アクションとしては、ソース・ファイルをアーカイブ・サブディレクトリーに移動したり、ファイル名にタイム・スタンプを追加してアーカイブ・サブディレクトリーにファイルを移動したり、あるいはファイルを削除したりすることができます。
      • 「アーカイブ・サブディレクトリーに移動」を選択すると、ソース・ファイルは入力ディレクトリーのアーカイブ・サブディレクトリーに移動されます。 サブディレクトリーの名前は mqsiarchive になります。 例えば、入力ディレクトリーが /var/fileinput であれば、アーカイブ・サブディレクトリーの絶対パスは /var/fileinput/mqsiarchive になります。 このディレクトリーが存在しない場合は、ブローカーは、そこへのファイルの移動を最初に試みたときに、ディレクトリーを作成します。
      • 「タイム・スタンプを追加し、アーカイブ・サブディレクトリーに移動」を選択すると、現在の日時がファイル名に追加されてから、ファイルは mqsiarchive に移動されます。
      • 「削除」を選択すると、ファイルは、処理の正常完了後に削除されます。
      ユーザー・トレースが稼働中の場合、FileInput ノードは、ファイルの処理ごとにメッセージをユーザー・トレースに書き込みます。
    • アーカイブ・サブディレクトリー内のファイルを、処理が正常に完了した同名のファイルに置き換えるには、「重複するアーカイブ・ファイルを置き換える」を選択します。 このオプションを設定しなかった場合に、アーカイブ・サブディレクトリー内に同名のファイルが存在すると、ノードは、処理が正常に完了したファイルの移動を試みたときに、例外をスローします。
  3. 「入力メッセージの構文解析」タブで、ノードが着信メッセージの構文解析方法を決定するときに使用するプロパティーの値を設定します。
    • 「メッセージ・ドメイン」では、提供されたリストから、使用するパーサーの名前を選択します。 デフォルトは BLOB です。 以下のオプションの中から選択することができます。
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      状況により、ユーザー定義のパーサーを指定することもできます。
    • 検証モードで DFDL パーサー、MRM パーサー、または XMLNSC パーサーを使用している場合、リストから関連した「メッセージ・モデル」を選択します。 メッセージ・ドメインとして MRM または XMLNSC を選択すると、使用可能なメッセージ・セットがこのリストに取り込まれます。 メッセージ・ドメインとして DFDL を選択すると、使用可能な DFDL スキーマ・ファイルが取り込まれます。
    • DFDL パーサーまたは MRM パーサーを使用する場合は、「メッセージ」のリストから、適切なメッセージ・タイプを選択します。 このリストには、選択したメッセージ・モデルで定義されたメッセージが取り込まれます。
    • MRM パーサーを使用する場合は、「物理形式」のリストから、メッセージの形式を選択します。 このリストには、このメッセージ・モデル用に定義されたすべての物理形式が掲載されます。
    • 「メッセージ・コード化文字セット ID」で、メッセージ・コード化文字セット ID を指定します。
    • メッセージ・エンコードを「メッセージ・エンコード」のリストから選択するか、または数値のエンコード値を指定します。 エンコードの詳細については、データ変換を参照してください。
  4. 「パーサー・オプション」サブタブで以下のようにします。
    • 「解析のタイミング」は、デフォルトによって、「要求時」に設定されます。これにより、メッセージの構文解析が遅延されます。 メッセージ全体の構文をすぐに解析する場合は、このプロパティーを「即時」または「完全」に設定します。 詳細については、要求時の構文解析を参照してください。
    • XMLNSC パーサーを使用する場合、XMLNSC パーサーの稼働方法を指定するプロパティーの値を設定します。 詳しくは、XMLNSC ドメインでのメッセージの操作を参照してください。
  5. 「ポーリング」タブで、「ポーリング間隔」の値を入力します。 このプロパティーは、処理するファイルを見つけるために FileInput ノードがファイル・システムにアクセスする頻度を制御します。

    フローの開始時点のディレクトリーの最初のスキャンの後、FileInput ノードは、入力パターンに一致するファイルがディレクトリーに入っていないことが検出されるたびに、このプロパティーで定義されている期間待機します。 その結果、FileInput ノードが継続的にファイル・システムにアクセスしてシステム・リソースを大量に消費する必要はなくなります。

    このプロパティーに設定する値が小さければ小さいほど、FileInput ノードは、入力ディレクトリー中にあるファイルをより速やかに発見することができます。 ただし、値が小さければ、システム・リソースの消費は多くなります。 値を大きくすれば、システム・リソースの使用量は軽減されますが、処理するファイルを FileInput ノードが発見するのが遅れるという犠牲を払います。

    作業の統制をとる手段として、あるいは処理のスケジュールを立てる手段として、このプロパティーを使用しないでください。 FileInput ノードで、選択した期間中だけ入力ディレクトリーをモニターするには、それに適した時点でメッセージ・フローを開始および停止してください。

    「リモート転送」プロパティーを選択し、「FTP」タブで「スキャン遅延」プロパティーを設定すると、「スキャン遅延」に設定した値によって、「ポーリング間隔」に設定されている値が指定変更されます。

  6. 「再試行」タブを使用して、メッセージ・フローが失敗したときに再試行処理がどのように実行されるかを定義します。
    • 「再試行メカニズム」は、フローに障害が起きた場合にとるべきアクションを決定します。
      • ノードが再試行を行わないで障害を報告するようにするには、Failure を選択します。
      • 状況が続く場合に、ノードで再試行してから障害を報告するには、「短い再試行」を選択します。 再試行する回数は、「再試行しきい値」に指定します。
      • ノードがまず、再試行を行う回数として「再試行しきい値」の値を使用して再試行するようにするには、「短い再試行と長い再試行」を選択します。 「再試行しきい値」の値に達した後も状況が持続する場合、ノードは次に「長い再試行間隔」の値を間隔として使用して試行を繰り返します。
    • 「再試行しきい値」プロパティーの値を指定します。 「再試行メカニズム」プロパティーを「短い再試行」または「短い再試行と長い再試行」のいずれかに設定した場合に、ノードがフロー・トランザクションを再試行する回数です。
    • 「短い再試行間隔」プロパティーの値を指定します。 短い再試行から次の短い再試行まで待機する秒単位の時間です。
    • 「長い再試行間隔」プロパティーの値を指定します。 これは、メッセージの正常完了、メッセージ・フローの停止、またはメッセージ・フローの再デプロイまでの、長い再試行から次の長い再試行まで待機する時間です。 ブローカー・プロパティー MinLongRetryInterval は、「長い再試行間隔」に指定できる最小値を定義します。 値が最小値よりも小さい場合は、ブローカーの値が使用されます。
    • 「障害を起こしたファイルに対する処置」プロパティーの値を指定して、ノードが入力ファイルの内容を処理しようとしたときに、その試行がすべて失敗した後に入力ファイルをどうするのかを指定します。
      • バックアウト・サブディレクトリーに移動する。 そのファイルを入力ディレクトリーのバックアウト・サブディレクトリーに移動します。 このサブディレクトリーの名前は mqsibackout です。 入力ディレクトリーが /var/fileinput である場合、バックアウト・サブディレクトリーの絶対パスは /var/fileinput/mqsibackout です。 このサブディレクトリーが存在しない場合は、ブローカーは、そこへのファイルの移動を最初に試みたときに、このサブディレクトリーを作成します。 このサブディレクトリーへのファイルの移動が失敗した場合、その原因はおそらく、同一名のファイルがそこに存在していたからです。ノードは、現在の日時をそのファイル名に追加して、そのファイルの移動をもう一度試みます。 この 2 回目の試行も失敗すると、ノードは処理を停止します。 メッセージ BIP3331 および BIP3325 が発行されます。 メッセージ・フローの再始動を試みる前に、サブディレクトリーまたはファイルの問題を解決してください。
      • 削除。 ファイルは、処理の失敗後に削除されます。
      • タイム・スタンプを追加し、バックアウト・サブディレクトリーに移動する。 現在の日時がファイル名に追加されてから、ファイルはバックアウト・サブディレクトリーに移動されます。
  7. 「レコードとエレメント」タブを使用して、各ファイルをレコードとして解釈する方法を指定します。
    • 「レコード検出」プロパティーを使用して、それぞれがメッセージを 1 つずつ生成する複数のレコードにファイルを分割する方法を指定します。 以下のオプションの中から選択します。
      • 「ファイル全体」は、ファイル全体を 1 つのレコードにすることを指定します。ファイルのサイズは 100 MB に制限されます。
      • 「固定長」は、各レコードは固定バイト数の長さであることを指定します。 ファイル内のおそらくは短い最後のレコードを除き、各レコードには、「長さ」プロパティーに指定されているバイト数が入っています。「長さ」に指定された値は、1 バイトから 100 MB までの範囲内である必要があります。デフォルトは 80 バイトです。
      • 処理しているレコードが、DOS または UNIX の行終了によって、または一連のユーザー定義区切りバイトによって分離または終了されている場合は、「区切り」を選択します。 区切り文字および区切り文字タイプを「区切り文字」および「区切り文字タイプ」プロパティーに指定します。 レコードの長さは 100 MB に制限されます。
      • メッセージ・ドメインで指定されたパーサーによって逐次認識された 1 つ以上のレコードのシーケンスがファイルに存在する場合は、「構文解析されたレコード・シーケンス」を選択します。 ノードは、認識された各レコードを別々のメッセージとして伝搬します。 「レコード検出」オプションを選択する場合、「メッセージ・ドメイン」に指定するパーサーは、XMLNSC または MRM (CWF または TDS のどちらかの物理形式) でなければなりません。
    • 「レコード検出」に「解析済みレコード・シーケンス」を指定すると、FileInput ノードは、レコード長を判別も制限もしません。 メッセージ・フロー中の下流のノードは、レコード長の判別や、長いレコードの処理を試みることがあります。 このようなやり方で大きなレコードを処理するつもりの場合、ブローカーに十分なメモリーがあることを確認しておいてください。 使用可能メモリーを最大限に活用するために、Large Messaging サンプルで説明されているフロー技法を使用しなければならない場合もあります。

    • 「レコード検出」に「区切り」を指定した場合、「区切り文字」を使用して、使用する区切り文字を指定します。 以下から選択できます。
      • DOS または UNIX の行終了。これは、UNIX システムでは改行文字 (<LF>、X'0A') を指定し、Windows システムでは復帰文字とその後に続く改行文字 (<CR><LF>, X'0D0A') を指定します。 ブローカーが稼働しているシステムが何であっても、ノードは、これらのストリングを両方とも区切り文字として扱います。 両者が同じファイル中にある場合、ノードは両者とも区切り文字と認識します。 ノードは、z/OS® システム上では「改行」バイトである X'15' を認識しません。したがって、z/OS システムの EBCDIC ファイルのような、EBCDIC 改行を使ってコーディングされた入力ファイルの場合は、このプロパティーにはカスタム区切り文字の値を指定し、「カスタム区切り文字」プロパティーには 15 の値を指定します。
      • カスタム区切り文字。これは、「カスタム区切り文字」での一連のバイトの指定を可能にします。
    • 「カスタム区切り文字」では、「区切り文字」プロパティーに「カスタム区切り文字」が設定されている場合に使用する 1 つ以上の区切り文字バイトを指定します。 16 進数字の偶数ストリングでこの値を指定します。 デフォルトは X'0A' であり、ストリングの最大長は 16 バイトです (32 桁の 16 進数字で表されます)。
    • 「レコード検出」に「区切り」を指定した場合、「区切り文字タイプ」を使用して、区切り文字タイプを指定します。 使用できる値は以下のとおりです。
      • 中置。 この値を選択すると、各区切り文字によって 2 つのレコードが区切られます。 ファイルが区切り文字で終了する場合、最後の区切り文字の後に続く長さゼロのファイル内容は、データが入っていなくても、やはりメッセージとして伝搬されます。
      • 後置。 この値を指定すると、各区切り文字によってレコードが終了します。 ファイルが区切り文字で終了する場合、区切り文字より後の空のレコードは伝搬されません。 ファイルが区切り文字で終了しない場合、そのファイルの最終バイトの後に区切り文字が続いているものとしてファイルは処理されます。 「後置」がデフォルト値です。
    • FileInput ノードでは、入力ファイルで区切り文字が出現するたびに、それによって各レコードが分離 (中置) または終了 (後置) されるとみなされます。 ファイルが区切り文字で開始する場合は、ノードはその区切り文字の前の (ゼロの長さの) ファイル内容をレコードとして扱い、空のレコードをフローに伝搬します。 区切り文字が伝搬されるメッセージに含まれることはありません。
  8. 「妥当性検査」タブを使用して、事前定義メッセージ用のメッセージ・セットに基づいた妥当性検査を提供します。 妥当性検査の詳細については、メッセージの妥当性検査を参照してください。 このタブを完成させる方法の詳細は、「妥当性検査」タブのプロパティーを参照してください。
  9. ノードで以下のプロパティーを使用して FTP サーバーまたは SFTP サーバーからファイルを読み取るには、「FTP」タブの「リモート転送」プロパティーを選択します。
    • 「転送プロトコル」で、リモート・ファイル転送に使用するプロトコルを指定します。 指定できる値は FTP および SFTP です。
    • 「リモート・サーバーおよびポート」で、使用する FTP または SFTP サーバーの IP アドレスとポート番号を入力します。 以下のいずれかの構文を使用します。
      • IP_address_or_URL
      • IP_address_or_URL:port_number
      IPv6 フォーマットの IP アドレスを指定する場合、以下の例のとおり、必ず大括弧で囲んでください。
      • [12a::13bd:24cd]
      • [12a::13bd:24cd]:123。ただし 123 は、ポート番号です。
      FTP を使用する場合にポート番号を指定しなければ、21 が使用されます。 SFTP を使用中にポート番号を指定しない場合、ポート番号 22 が想定されます。 ただし FtpServer 構成可能サービスが定義されている場合、その構成可能サービスの名前をこのフィールドに入力することができます。 FtpServer 構成可能サービス定義と、このタブ上のプロパティーがどのように対話するかの詳細は、FtpServer 構成可能サービスのプロパティーを参照してください。
    • 「セキュリティー ID」で、mqsisetdbparms コマンドを使って定義されたセキュリティー ID の名前を指定します。 FTP または SFTP サーバーへのログオンに使用するユーザー ID およびパスワードは、この定義から取得します。 この定義の名前には、接頭部 ftp:: が付いている必要があります。 このプロパティーの値は、FtpServer 構成可能サービスの securityIdentity プロパティーの値 (設定されている場合) によって指定変更されます。
    • 「サーバー・ディレクトリー」では、ファイルの転送元の FTP または SFTP サーバー内のディレクトリーを指定します。 デフォルトは、ピリオド (.)です。 これは、ログオン後のデフォルト・ディレクトリーを意味します。 相対パスを指定すると、FTP または SFTP のログオン後のデフォルト・ディレクトリーに基づくディレクトリーになります。 パスの構文が、FTP または SFTP サーバー内のファイル・システム標準に準拠するよう気を付けてください。 このプロパティーの値は、FtpServer 構成可能サービスの remoteDirectory プロパティーの値 (設定されている場合) によって指定変更されます。

      「リモート転送」プロパティーと「ローカル・サブディレクトリーを含める」プロパティーの両方を選択すると、ローカル・システムのサブディレクトリーのみで、処理するファイルが検索されます。 それに対して、リモート・システム上では、指定された最上位ディレクトリーのみで、処理するファイルが検索されます。

    • 「転送モード」では、ファイルの転送方法を指定します。 ファイル内容を変換しない場合は、「バイナリー」を選択します。 ファイルを ASCII として伝送する場合は、「ASCII」を選択します。 このプロパティーの値は、FtpServer 構成可能サービスの transferMode プロパティーの値 (設定されている場合) によって指定変更されます。

      このプロパティーは、 リモート転送用のプロトコルに FTP が選択されている場合のみ有効です。 プロトコルに SFTP を指定すると、「転送モード」プロパティーは無視され、バイナリー・エンコードが使用されます。

    • 「スキャン遅延」では、ディレクトリー・スキャン間の遅延を秒数で指定します。 デフォルトは 60 秒です。 このプロパティーに設定した値は、「リモート転送」プロパティーが選択されている場合、「ポーリング」タブのポーリング間隔に設定した値を指定変更します。 このプロパティーの値は、FtpServer 構成可能サービスの scanDelay プロパティーの値 (設定されている場合) によって指定変更されます。
  10. 「トランザクション」タブで、トランザクション・モードを設定します。 ファイル操作はすべて非トランザクションですが、この入力ノード上のトランザクション・モードによって、フロー内の残りのノードを同期点の下で実行するかどうかが決まります。 フロー更新がトランザクションとして扱われるようにする (可能な場合) には、「はい」を選択し、トランザクションとして扱われないようにするには「いいえ」を選択します。 このプロパティーのデフォルトは「いいえ」です。
  11. オプション: 「インスタンス」 タブで、ノードで使用できるその他のインスタンス (スレッド) を制御するプロパティーの値を設定します。 詳細については、構成可能な「メッセージ・フロー」プロパティーを参照してください。

ターミナルおよびプロパティー

FileInput ノードのターミナルについては、次の表に説明されています。

ターミナル 説明
Failure Out ターミナルにメッセージが伝搬される前にエラーが起きた場合、メッセージのルーティング先となる出力ターミナル。 「妥当性検査」プロパティーを使って妥当性検査が行われるように指定していた場合でも、このターミナルに伝搬されたメッセージは妥当性検査されません。
Out 入力ファイルからメッセージが正常に抽出された場合に、メッセージがルーティングされる先の出力ターミナル。 入力ノード内でエラーが起こらなかった場合、外部リソースから受信されるメッセージは常にこの Out ターミナルにまず送信されます。
End of Data ファイル内のすべてのメッセージの処理完了後の、End of Data メッセージのルーティング先の出力ターミナル。 End of Data メッセージ・フロー・トランザクションが開始されるのは、このターミナルが接続されている場合のみです。
Catch 例外がダウンストリームでスローされ、ノードによってキャッチされた場合に、メッセージがルーティングされる出力ターミナル。 例外がキャッチされるのは、このターミナルが接続されている場合のみです。

以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。

「説明」 プロパティー:

プロパティー M C デフォルト 説明
ノード名 いいえ いいえ FileInput ノードの名前。
簡略説明 いいえ いいえ なし ノードの簡単な説明
詳細説明 いいえ いいえ なし メッセージ・フロー内のノードの目的を説明するテキスト

「基本」 プロパティー:

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
入力ディレクトリー はい はい なし 処理される入力ファイルが入っているディレクトリーのパス。 ブローカーからアクセスできるファイル・システムのディレクトリーでなければなりません。 入力ディレクトリーが存在しない場合、全くファイルは処理されません。 FileInput ノードは、「スキャン遅延」プロパティーで定義されている間隔で、入力ディレクトリーが存在することを検査します。 ファイルを FTP または SFTP で処理している場合であっても、入力ディレクトリーが存在しなければなりません。

FileInput ノードは、指定の入力ディレクトリーに mqsitransitin サブディレクトリーを作成します。 mqsitransitin サブディレクトリーは、入力ファイルの処理中にそれを保留にしてロックします。 この入力ディレクトリー内でファイルを処理する実行グループが除去された場合、 mqsitransitin サブディレクトリーを調べて、 一部だけ処理されたファイルや未処理のファイルがないかを確認してください。 そのようなファイルがあれば、それを入力ディレクトリーに戻し入れることにより (そして実行グループ UUID 接頭部をファイル名から除去することにより)、 異なる実行グループによる処理を可能にします。

inputDirectory
ローカル・サブディレクトリーを含める はい はい False 指定された入力ディレクトリーのすべてのサブディレクトリーでも、処理するファイルを検索する必要があるかどうかを指定します。 このプロパティーと「リモート転送」プロパティーを選択すると、リモート・システム上で指定した最上位ディレクトリーでのみ、ファイルが検索されます。 recursiveDirectories
ファイル名またはパターン はい はい * 入力ディレクトリーにある 1 つ以上の処理対象ファイルを識別するファイル名またはストリング。 オプションでワイルドカード文字 (* または ?) を含めることができます。 filenamePattern
ファイル除外パターン いいえ はい なし 処理から除外するファイルを指定する、オプションのワイルドカード文字 (* および ?) を含む単純ストリング。 excludePattern
正常処理時のアクション はい いいえ 削除 コンテンツの処理が正常に行われた後、ノードがファイルに対して実行するアクション。 有効なオプションは、以下のとおりです。
  • アーカイブ・サブディレクトリーに移動する
  • タイム・スタンプを追加し、アーカイブ・サブディレクトリーに移動する
  • 削除
 
重複するアーカイブ・ファイルを置き換える はい いいえ 選択されていない このプロパティーは、ノードが既存のアーカイブ・ファイルを同じ名前の入力ファイルで置き換えるかどうかを制御します。 これが適用されるのは、「正常処理時のアクション」が「削除」でない場合のみです。  

FileInput ノードの「入力メッセージの構文解析」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
メッセージ・ドメイン いいえ いいえ BLOB メッセージの構文解析に使用されるドメイン。 フィールドがブランクの場合、デフォルトは BLOB になります。
メッセージ・モデル いいえ いいえ 選択されていない メッセージが定義されているメッセージ・モデル・スキーマ・ファイルの名前またはロケーション。 このリストには、選択したメッセージ・ドメインに使用可能なすべてのメッセージ・モデル・スキーマ・ファイルが取り込まれます。
メッセージ いいえ いいえ 選択されていない データの文書全体をモデル化し、メッセージ・モデル・スキーマ・ファイル内に含まれているグローバル・エレメントの名前またはロケーション。 このリストには、選択したメッセージ・モデルで定義された、利用可能なすべてのメッセージが取り込まれます。
物理形式 いいえ いいえ 選択されていない メッセージの物理フォーマットの名前。 MRM または IDOC パーサーを使用する場合は、リストから着信メッセージの物理形式を選択します。 このリストには、選択されたメッセージ・モデル用に定義したすべての物理形式が含まれます。 「メッセージ・ドメイン」プロパティーを DataObject に設定した場合、このプロパティーを XML または SAP ALE IDoc に設定できます。 外部ソースからのビット・ストリームを構文解析してメッセージ・ツリーを生成する必要がある場合には、このプロパティーを SAP ALE IDoc に設定してください。
メッセージ・コード化文字セット ID はい いいえ ブローカー・システム・デフォルト 読み取られるファイルのバイトを解釈するのに使用されるコード化文字セットの ID。 mqsiapplybaroverride のコマンド・プロパティーは messageCodedCharSetIdProperty です。
メッセージ・エンコード はい いいえ ブローカー・システム指定 読み取られるファイルのバイトを解釈するのに使用される数字およびラージ文字のエンコード・スキーム。 有効な値は、「ブローカー・システム指定」または数値のエンコード値です。 エンコードの詳細については、データ変換を参照してください。 mqsiapplybaroverride のコマンド・プロパティーは messageEncodingProperty です。

「パーサー・オプション」 プロパティー:

プロパティー M C デフォルト 説明
構文解析のタイミング いいえ いいえ 要求時 このプロパティーは、入力メッセージを構文解析する時を制御します。 有効な値は以下のとおりです。
  • 要求時
  • 即時
  • 完了

このプロパティーに関する詳しい説明については、要求時の構文解析を参照してください。

XML スキーマ・データ・タイプを使用してツリーを構築する いいえ いいえ 選択されていない このプロパティーは、メッセージ・ツリー内の構文エレメントが、XML スキーマから取得されたデータ・タイプを持つかどうかを制御します。
XMLNSC コンパクト・パーサーを XMLNS ドメインに使用 いいえ いいえ 選択されていない XMLNS ドメイン内のメッセージに XMLNSC コンパクト・パーサーを使用するかどうかを指定します。 このプロパティーを設定すると、以下のいずれかの項目が XMLNS である場合、出力ターミナルに接続されているノードの XMLNSC の下にメッセージ・データが表示されます。
  • 入力 MQRFH2 ヘッダー。
  • 「入力メッセージの構文解析」プロパティーの「メッセージ・ドメイン」。
混合内容の保存 いいえ いいえ 選択されていない このプロパティーは、XMLNSC パーサーが入力メッセージ内の混合テキスト用に、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、混合テキスト用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、混合テキストは無視されて、エレメントは作成されません。
コメントの保存 いいえ いいえ 選択されていない XMLNSC パーサーが、入力メッセージ内のコメント用に、メッセージ・ツリーにエレメントを作成するかどうかを指定します。 チェック・ボックスを選択すると、コメント用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、コメントは無視されて、エレメントは作成されません。
処理命令の保存 いいえ いいえ 選択されていない このプロパティーは、XMLNSC パーサーが入力メッセージ内の処理命令のために、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、処理命令用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、処理命令は無視されて、エレメントは作成されません。
不透明エレメント いいえ いいえ ブランク XMLNSC パーサーによって不透明解析される入力メッセージ内のエレメントのリストを指定するときに、このプロパティーを使用します。 不透明解析が実行されるのは、妥当性検査が使用不可に設定されている場合のみ (つまり、「妥当性検査」が「なし」の場合) です。妥当性検査が使用可能な場合、「不透明エレメント」で指定される項目は無視されます。

「ポーリング」 プロパティー:

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
ポーリング間隔 (秒数) はい はい 5 秒単位のポーリング間隔。 waitInterval

「再試行」 プロパティー:

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
再試行メカニズム はい いいえ 失敗 ノードがフローの障害をどのように処理するかを示します。 有効なオプションは、以下のとおりです。
  • 失敗
  • 短い再試行
  • 短い再試行と長い再試行
 
再試行しきい値 はい はい 0 「再試行メカニズム」プロパティー値が「短い再試行」である場合に、フロー・トランザクションを再試行する回数。 retryThreshold
短い再試行間隔 いいえ はい 0 「再試行しきい値」プロパティーがゼロでない場合の各再試行間の秒単位の間隔。 shortRetryInterval
長い再試行間隔 いいえ はい 300 「再試行メカニズム」プロパティーが「短い再試行と長い再試行」で、再試行しきい値に達した場合の、再試行間の間隔。 longRetryInterval
ファイル失敗時のアクション はい はい バックアウト・サブディレクトリーに移動する 入力ファイルの内容を処理するための試行がすべて失敗した場合に、ノードが入力ファイルに対して実施するアクション。 有効なオプションは、以下のとおりです。
  • バックアウト・サブディレクトリーに移動する
  • 削除
  • タイム・スタンプを追加し、バックアウト・サブディレクトリーに移動する
 

「レコードとエレメント」 プロパティー:

プロパティー M C デフォルト 説明
レコード検出 はい いいえ ファイル全体 入力ファイル内のレコードを特定するために使用される仕組み。 有効なオプションは、以下のとおりです。
  • ファイル全体

    このプロパティーを「ファイル全体」に設定する場合、2 GB より大きいファイルはサポートされていません。

  • 固定長
  • 区切り
  • 解析済みレコード・シーケンス
長さ はい いいえ 80 レコード検出に「固定長」が選択されたときの各レコードのバイト単位の長さ。
区切り文字 はい いいえ DOS または UNIX の行終了 「区切り」レコード検出が選択されたときに、各レコードを分離または終了する区切り文字バイトのタイプ。 有効なオプションは、以下のとおりです。
  • DOS または UNIX の行終了
  • カスタム区切り文字
カスタム区切り文字 いいえ いいえ   「区切り」レコード検出および「カスタム区切り文字」が選択されたときの、16 進数で表される区切り文字バイト。 「区切り文字」プロパティーを「カスタム区切り文字」に設定した場合のみ、このプロパティーは必須です。
区切り文字タイプ はい いいえ 後置 「区切り」レコード検出が選択されたときの区切り文字の位置。 有効なオプションは、以下のとおりです。
  • 後置
  • 中置
「区切り文字」プロパティーを「カスタム区切り文字」に設定しない限り、このプロパティーは無視されます。
最初のレコードをスキップ はい いいえ FALSE ファイル内の最初のレコードをスキップします。 FileInput ノードはファイル内の最初のレコードを読み取りますが、そのレコードを Out ターミナルに伝搬しません。 2 番目のレコード以降は、通常の方式で伝搬されます。 最初のレコードが処理不要なヘッダーの場合には、このオプションを使用します。 ファイル全体を使用する場合には、このオプションは適切ではありません。

「妥当性検査」 プロパティー:

これらのプロパティーの詳細については、妥当性検査プロパティーを参照してください。

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
妥当性検査 いいえ はい なし このプロパティーは、妥当性検査を行うかどうかを制御します。 有効な値は以下のとおりです。
  • なし
  • 内容と値
  • 内容
validateMaster
失敗時の処置 いいえ いいえ 例外 このプロパティーは、妥当性検査が失敗した場合の動作を制御します。 有効な値は以下のとおりです。
  • ユーザー・トレース
  • ローカル・エラー・ログ
  • 例外
  • 例外リスト
 

「FTP」 プロパティー:

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
リモート転送 いいえ はい 選択されていない このプロパティーは、ノードが「FTP」タブにリストされたリモート・ファイル転送プロパティーを使用して、FTP または SFTP サーバーのいずれかからファイルを読み取るかどうかを定義します。 このプロパティーと「ローカル・サブディレクトリーを含める」プロパティーを選択すると、リモート・システム上で指定した最上位ディレクトリーでのみ、ファイルが検索されます。 fileFtp
転送プロトコル いいえ はい FTP このプロパティーは、リモート転送に使用するプロトコルを指定します。 有効な値は以下のとおりです。
  • FTP
  • SFTP
remoteTransferType
リモート・サーバーおよびポート いいえ はい なし このプロパティーは、以下の以下のいずれかの値を持つことができます。
  • リモート FTP サーバーまたはリモート SFTP サーバーの IP アドレスまたは名前 (およびオプションとしてポート番号)。例: ftp.server.com:21、sftp.server.com:22
  • タイプ type FtpServer の構成可能サービスの名前
構成可能サービス名を指定した場合、その構成可能サービスによって、FTP タブ上のその他のリモート転送プロパティーのいずれかまたはすべてを指定変更できます。
fileFtpServer
セキュリティー ID いいえ はい   FTP または SFTP サーバーにアクセスするために使用するユーザー識別の名前。 このプロパティーは、FtpServer 構成可能サービス内の securityIdentity プロパティー (設定されている場合) によって指定変更されます。 fileFtpUser
サーバー・ディレクトリー いいえ はい "." ファイルの転送元の FTP または SFTP サーバー上のディレクトリー。 このプロパティーを相対パスとして指定すると、ログオン後のホーム・ディレクトリーに対して相対的になります。 このプロパティーは、FtpServer 構成可能サービス内の remoteDirectory プロパティー (設定されている場合) によって指定変更されます。 fileFtpDirectory
転送モード いいえ いいえ バイナリー ファイル・データの転送用の FTP 転送モード。 このプロパティーは、 リモート転送用のプロトコルに FTP が選択されている場合のみ有効です。 有効な値は以下のとおりです。
  • バイナリー
  • ASCII
このプロパティーは、FtpServer 構成可能サービス内の transferMode プロパティー (設定されている場合) によって指定変更されます。

リモート転送のプロトコルに SFTP を指定すると、「転送モード」プロパティーは無視され、バイナリー・エンコードが使用されます。

 
スキャン遅延 いいえ はい 60 リモート・ディレクトリー・スキャン間の秒単位の遅延。 このプロパティーは、「リモート転送」プロパティーの選択時に「ポーリング間隔」に設定した値を指定変更します。 このプロパティーは、FtpServer 構成可能サービス内の scanDelay プロパティー (設定されている場合) によって指定変更されます。  

「トランザクション」 プロパティー:

プロパティー M C デフォルト 説明
トランザクション・モード いいえ はい いいえ この入力ノード上のトランザクション・モードによって、フロー内の残りのノードが同期点の下で実行されるかどうかが決まります。 有効なオプションは、以下のとおりです。
  • はい
  • いいえ
「インスタンス」 プロパティー。 これらのプロパティーの詳細については、構成可能な「メッセージ・フロー」プロパティーを参照してください。
プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
追加インスタンス・プール いいえ はい メッセージ・フローに関連付けられたプールの使用 追加インスタンスの取得元のプール。
  • 「メッセージ・フローに関連付けられたプールの使用」 を選択すると、メッセージ・フロー・プールから追加インスタンスが取得されます。
  • 「ノードに関連付けられたプールの使用」を選択すると、追加インスタンスは「追加インスタンス」プロパティーで指定された数値をもとに、ノードの追加インスタンスから割り当てられます。
componentLevel
追加インスタンス いいえ はい 0 「追加インスタンス・プール」プロパティーが「ノードに関連付けられたプールの使用」に設定されている場合に、ノードが開始できる追加インスタンスの数。 additionalInstances
ノードのモニター・プロパティーが、次の表に説明されています。
プロパティー M C デフォルト 説明
イベント いいえ いいえ なし ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。

「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        最終更新:
        
        最終更新: 2013-05-21 11:10:50


参照トピック参照トピック | バージョン 9.0.0.0 | ac55150_