Input ノード

このトピックには、以下のセクションが含まれています。

目的

Input ノードは、組み込みメッセージ・フロー (サブフロー) に in ターミナルを提供します。 サブフローは、メッセージ・フロー・ノードのシーケンスによって表せる、共通のタスクのために使用できます。 たとえば、サブフローを作成して、ループ・カウンターを増減したり、複数のメッセージ・フローで共通のエラー処理を提供したりできます。

サブフローに in ターミナルを提供するには Input ノードを使用する必要があり、標準入力ノード (MQInput などの組み込み入力ノード、またはユーザー定義入力ノード) を使用することはできません。

サブフローを Input ノードで開始した場合には、Output ノードを含め、任意のメッセージ・フロー・ノードの任意の in ターミナルに接続できます。

1 つのサブフローに 1 つ以上の Input ノードを組み込むことができます。 組み込んだ各ノードは、メッセージをサブフローに導入できるターミナルを提供します。 複数のノードを組み込んだ場合、メッセージがサブフローで処理される順序を予測することはできません。

ワークベンチでは、Input ノードは次のアイコンで表されます。

Input ノード・アイコン

サブフローを選択してメッセージ・フローに組み込むと、そのサブフローはアイコンで表されます。

Subflow ノード・アイコン

サブフローをメッセージ・フローに組み込むと、このアイコンはサブフローに組み込むそれぞれの Input ノードのターミナルを表示し、ターミナルの名前 (アイコンにマウス・ポインターを合わせると表示される) は Input ノードのそのインスタンス名と一致します。 Input ノードには、メッセージ・フローのサブフロー・ノードで対応するターミナルを使用する際に容易に認識できるような意味のある名前を付けます。

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

このノードが使用される方法に関しては、次のサンプルを参照してください。

Input ノードの構成

Input ノードのインスタンスをメッセージ・フローに入れると、Input ノードを構成することができます。 エディター・ビューでノードを右クリックして、「プロパティー (Properties)」を選択します。 ノードの基本プロパティーが表示されます。

値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。

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

  1. 簡略説明または詳細説明 (あるいはその両方) を入力するには、プロパティー・ダイアログ・ナビゲーターの「説明 (Description)」を選択します。
  2. 「適用」をクリックすると、プロパティー・ダイアログを閉じずに Input ノードが変更されます。 「OK」をクリックすると、変更を適用してプロパティー・ダイアログを閉じます。

    「キャンセル (Cancel)」をクリックすると、ダイアログを閉じてプロパティーの変更をすべて破棄します。

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

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

ターミナル 説明
Out メッセージをサブフローに送達する入力ターミナル。

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

Input ノードの「説明 (Description)」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
簡略説明 (Short Description) いいえ いいえ   ノードの簡単な説明
詳細説明 (Long Description) いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト

関連概念
メッセージ・フロー

関連タスク
使用するノードの決定
サブフローの使用

関連資料
MQInput ノード
Output ノード