Azure Logic Apps の Standard ワークフロー用の IBM メインフレームからホスト ファイルを解析して生成する

適用対象: Azure Logic Apps (Standard)

Azure Logic Apps の Standard ワークフローから新しい IBM ホスト ファイルと i シリーズ物理ファイルを解析して生成するには、 IBM Host File 組み込みのサービス プロバイダー ベースのコネクタを使用できます。 メインフレーム システムが導入されて以来、開発者はユビキタス ホスト ファイルを使用して、ミッション クリティカルなシステムの豊富なデータを格納していました。 このコネクタは IBM メインフレームまたはミッドレンジ システムにアクセスする必要はありませんが、ホスト ファイルを Standard ワークフローで使用できるようにする必要があります。 ファイルは、FTP、Azure Blob Storage、Host Integration Server、またはパートナー ソフトウェア アプライアンスを使用して使用できます。 IBM ホスト ファイル コネクタは、21Vianet が運営する Azure Government と Microsoft Azure を除くすべての Azure Logic Apps リージョンで使用できます。

このハウツー ガイドでは、 IBM ホスト ファイル コネクタに関する次の側面について説明します。

• Azure Logic Apps で IBM ホスト ファイル コネクタを使用するシナリオ
• IBM ホスト ファイル コネクタを使用するための前提条件とセットアップ
• IBM Host File コネクタ アクションを Standard ロジック アプリ ワークフローに追加する手順

コネクタの使用シナリオを確認する

IBM メインフレームでは、オペレーティング・システム内の特殊なコンポーネントである アクセス・メソッドがファイル処理を処理します。 1970 年代には、Virtual Storage Access Method (VSAM) が構築され、IBM メインフレームで最も広く使用されているアクセス方法となりました。 VSAM には、エントリ シーケンスのデータセット、キー順のデータセット、相対レコード データセットなど、特定の種類のファイルが用意されています。

現在の市場では、ホスト ファイルに直接接続してデータ操作を実行する複数のソリューションが提供されています。 多くのソリューションでは、メインフレーム システムにソフトウェアをインストールする必要があります。 このオプションは一部のお客様に適していますが、メインフレーム システムでのフットプリントの拡大を避けたいユーザーもいます。

Microsoft Host Integration Server (HIS) はホスト ファイル用のマネージド アダプターを提供し、メインフレームにソフトウェアをインストールする必要はありません。 ただし、HIS では IBM Distributed File Manager (DFM) メインフレーム サブシステムを有効にする必要があります。これには論理ユニット (LU) プロトコル 6.2 が必要です。 このマネージド プロバイダーでは、DFM へのアクセスを提供する HIS システム ネットワーク アーキテクチャ (SNA) ゲートウェイを構成する必要もあります。

ほとんどの場合、マネージド プロバイダーは通常のデータ プロバイダーとして動作します。 ホスト ファイル システムに接続し、コマンドを実行し、データを取得できます。 このオプションは一部のお客様にとって優れた代替手段ですが、 IBM Host File コネクタでは、AZURE Logic Apps の Standard ワークフローに対して IBM ホスト ファイルをバイナリ形式で使用できるようにする必要があります。 この要件により、ソリューションの複雑さが軽減され、任意のツールを使用して、ホスト ファイル内のデータにアクセスして管理できます。 標準ワークフローでトリガーを使用してファイルを読み取ることができる場所でホスト ファイルを使用できるようにすると、 IBM Host File コネクタ操作でファイルを解析できます。

SQL Server や Azure Cosmos DB などのメインフレーム環境でデータベースにアクセスして使用することに関心があるお客様のために、 IBM Host File コネクタは、JSON 形式でホスト ファイルを生成する機能を提供します。 この方法を使用すると、選択したクラウド データベース内のホスト ファイルを使用し、データをホスト ファイルとしてメインフレームまたはミッドレンジ環境に送り返すことができます。

次の図は、Azure Logic Apps の IBM Host File コネクタが他のシステムと対話して、ホスト ファイルコンテンツの読み取り、解析、生成を行う方法を示しています。

ハイブリッド クラウド シナリオを拡張するために、 IBM Host File コネクタは HIS Designer for Logic Apps と連携します。これを使用して、メインフレーム ホスト ファイルの データ定義 または データ マップ を作成できます。 このタスクでは、HIS デザイナーは、ワークフローでアクションを実行するために IBM Host File コネクタが使用するメタデータにデータを変換します。 コネクタはデータ型変換を実行します。この変換は、先行するワークフロー操作から入力を受け取り、後続のワークフロー アクションで使用するために出力を送信するために必要です。 コネクタには、表形式のデータ定義とコード ページ変換も用意されています。

HIS デザイナーからホスト統合デザイナー XML (HIDX) ファイルとしてメタデータ ファイルを生成した後、そのファイルをマップ成果物として Standard ロジック アプリ リソースに追加できます。 この方法では、 IBM Host File コネクタ アクションを追加するときに、ワークフローからアプリのメタデータにアクセスできます。 コネクタは、ロジック アプリ リソースからメタデータ ファイルを読み取り、ワークフロー内の IBM Host File コネクタ アクションで使用するバイナリ ファイルの構造を動的に提示します。

コネクタに関するテクニカル リファレンス

このセクションでは、 IBM ホスト・ファイル・ コネクターで使用可能な操作について説明します。 現在、2 つのアクションがサポートされています: ホスト ファイルコンテンツの解析 と ホストファイルコンテンツの生成。

[ホスト ファイル コンテンツの解析] アクション

次の表は、[ ホスト ファイル コンテンツの解析 ] アクションのパラメーターをまとめたものです。

パラメーター	必須	タイプ	Description
HIDX 名前	イエス	String	使用するメインフレーム ホスト ファイル HIDX ファイルを選択します。
スキーマ名	イエス	String	使用する HIDX ファイル内のホスト ファイル スキーマを選択します。
バイナリ コンテンツ	イエス	Binary	メインフレームから抽出された固定長レコードを含むバイナリ データを選択します。

ホスト ファイル コンテンツの生成アクション

次の表は、[ ホスト ファイル コンテンツの生成 ] アクションのパラメーターをまとめたものです。

パラメーター	必須	タイプ	Description
HIDX 名前	イエス	String	使用するメインフレーム ホスト ファイル HIDX ファイルを選択します。
スキーマ名	イエス	String	使用する HIDX ファイル内のホスト ファイル スキーマを選択します。
行数	イエス	JSON	配列または個々の行を選択します。 データ オブジェクト全体を JSON 形式で入力するには、[ 配列全体を入力するに切り替える ] オプションを選択できます。

[前提条件]

• Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。

• ホスト・ファイル・データ構造を認識するために IBM Host File コネクタに必要なメタデータを提供するホスト統合デザイナー XML (HIDX) ファイル。

  この HIDX ファイルを作成するには、 AZURE Logic Apps 用 HIS デザイナーをダウンロードしてインストールします。 唯一の前提条件は Microsoft .NET Framework 4.8 です。

  ホスト ファイルを効果的に解析して生成するには、ワークフローでホスト ファイルのメタデータを理解する必要があります。 ただし、ホスト ファイルとデータベース テーブルの主な違いとして、ホスト ファイルにはデータ構造を記述するメタデータがありません。 このメタデータを作成するには、 LOGIC Apps 用 HIS デザイナーを使用します。 このツールを使用すると、ワークフローで使用するホスト ファイル構造を手動で作成できます。 これらのデータ構造を提供する COBOL 定義 (コピーブック) をインポートすることもできます。

  このツールは、コネクタがホスト ファイルのデータ構造を認識するために必要なメタデータを提供するホスト統合デザイナー XML (HIDX) ファイルを生成します。 HIS を使用する場合は、HIS トランザクション インテグレーター (TI) デザイナーを使用して HIDX ファイルを作成できます。

• ホスト ファイルを解析または生成する標準ロジック アプリ ワークフロー。

  IBM ホスト ファイル コネクタにはトリガーがないため、繰り返しトリガーや Azure Blob Storage トリガーなど、トリガーを使用してワークフローを開始します。 その後、 IBM ホスト・ファイル・コネクター・アクションを 追加できます。 開始するには、Standard ロジック アプリ リソースに空のワークフローを作成します。

制限事項

現時点では、このコネクタでは、統合アカウントではなく、HIDX ファイルを Standard ロジック アプリ リソースに直接アップロードする必要があります。

メタデータの定義と生成

Azure Logic Apps 用 HIS デザイナーをダウンロードしてインストールした後、 次の手順に従ってメタデータ成果物から HIDX ファイルを生成します。

HIDX ファイルをアップロードする

ワークフローで HIDX ファイルを使用するには、次の手順に従います。

1. HIDX ファイルを保存したフォルダーに移動し、ファイルをコピーします。

2. Azure portal で、HIDX ファイルをマップとして Standard ロジック アプリ リソースにアップロードします。

3. 次のセクションに進み、IBM Host File アクションをワークフローに追加します。

このガイドの後半で、[ ホスト ファイル コンテンツの解析 ] アクションを初めてワークフローに追加すると、接続の作成を求めるメッセージが表示されます。 接続を作成したら、以前に追加した HIDX ファイル、スキーマ、および使用するパラメーターを選択できます。

[ホスト ファイル コンテンツの解析] アクションを追加する

次の手順に従って、[ホスト ファイル コンテンツの解析] アクションを追加します。

1. Azure portal で、Standard ロジック アプリ リソースとワークフローをデザイナーで開きます。

2. ワークフローを開始するトリガーがない場合は、 次の一般的な手順に従って、必要なトリガーを追加します。

   この例では、BLOB の追加または更新時という名前の Azure Blob Storage 組み込みのサービス プロバイダー ベースのトリガーを引き続き使用します。

   

3. 追加または更新された BLOB からコンテンツを取得するには、次の一般的な手順に従って、BLOB コンテンツの読み取りという名前の Azure Blob Storage 組み込みコネクタ アクションを追加します。

4. 以下の一般的な手順に従って、ホスト・ファイル・コンテンツの解析という名前の IBM ホスト・ファイル組み込みコネクター・アクションを追加します。

5. 接続の詳細ウィンドウが表示されたら、次の情報を入力します。

   パラメーター	必須	価値	Description
   接続名	イエス	< 接続名>	接続の名前。
   コード ページ	いいえ	< code-page>	テキストの変換に使用するコード ページ番号。
   iSeries から	いいえ	< mf-iseries>	ファイルが i シリーズ サーバーから生成されるかどうかを指定します。

   例えば次が挙げられます。

   

6. 完了したら、[新規作成] を選択 します。

7. アクションの詳細ウィンドウが表示されたら、[ パラメーター ] セクションで、必要な情報を入力します。

   パラメーター	必須	価値	Description
   HIDX 名前	イエス	< HIDX-file-name>	使用するメインフレーム ホスト ファイル HIDX ファイルを選択します。
   スキーマ名	イエス	< schema-name>	使用する HIDX ファイル内のスキーマを選択します。
   バイナリ コンテンツ	イエス	< バイナリコンテンツ>	ホストから抽出された固定長レコードを含むバイナリ データを選択します。

   たとえば、次の図は、VISUAL Studio と、HIS Designer for Logic Apps の CUSTOMER テーブルと CUSTOMER_RECORD スキーマを含むサンプル ホスト ファイル (HIDX) を示しています。

   

   1. HIDX ファイルの値を使用して 、HIDX 名 と スキーマ名 を構成します。

      

   2. バイナリ コンテンツの場合は、動的コンテンツ リスト (稲妻アイコン) を選択し、[読み取り BLOB アクションコンテンツからの応答] オプションを選択します。

      

      完全な [ホスト ファイル コンテンツの解析] アクションは、次の例のようになります。

      

   3. 次に、結果を処理する別のアクションを追加します。

      この例では、 次の一般的な手順に従って、ファイル転送プロトコル (FTP) サーバーにファイルを作成するアクションを追加します。

      

8. 完了したら、ワークフローを保存します。 デザイナーのツール バーで、 [保存] を選択します。

ワークフローのテスト

次の手順に従って、ワークフローが期待どおりに実行されていることを確認します。

1. ワークフローを実行するには、デザイナーのツール バーの [ 実行>実行] を選択します。

   ワークフローの実行が完了すると、ワークフローの実行履歴が表示されます。 成功した手順ではチェック マークが表示され、失敗した手順では感嘆符 (!) が表示されます。

2. 各ステップの入力と出力を確認するには、そのステップを展開します。

3. 出力を確認するには、[ 未加工の出力を表示] を選択します。

ホスト ファイル コンテンツの生成アクションを追加する

ホスト ファイル コンテンツの生成アクションを追加するには、次の手順に従います。

1. Azure portal で、Standard ロジック アプリ リソースとワークフローをデザイナーで開きます。

2. ワークフローを開始するトリガーがない場合は、 次の一般的な手順に従って、必要なトリガーを追加します。

   この例では、BLOB の追加または更新時という名前の Azure Blob Storage 組み込みのサービス プロバイダー ベースのトリガーを引き続き使用します。

   

3. 追加または更新された BLOB からコンテンツを取得するには、次の一般的な手順に従って、BLOB コンテンツの読み取りという名前の Azure Blob Storage 組み込みコネクタ アクションを追加します。

4. 次の一般的な手順に従って、ホスト ファイル コンテンツの生成という名前の IBM Host File 組み込みコネクタ アクションを追加します。

5. 接続の詳細ウィンドウが表示されたら、次の情報を入力します。

   パラメーター	必須	価値	Description
   接続名	イエス	< 接続名>	接続の名前。
   コード ページ	いいえ	< code-page>	テキストの変換に使用するコード ページ番号。
   iSeries から	いいえ	< mf-iseries>	ファイルが i シリーズ サーバーから生成されるかどうかを指定します。

   例えば次が挙げられます。

   

6. 完了したら、[新規作成] を選択 します。

7. アクションの詳細ウィンドウが表示されたら、[ パラメーター ] セクションで、必要な情報を入力します。

   パラメーター	必須	価値	Description
   HIDX 名前	イエス	< HIDX-file-name>	使用するメインフレーム ホスト ファイル HIDX ファイルの名前を指定します。
   スキーマ名	イエス	< schema-name>	使用する HIDX ファイル内のスキーマの名前を指定します。
   行数	イエス	< 行>	IBM 形式に変換するレコードの配列を指定します。 前のワークフロー操作の出力を選択するには、次の手順に従います。 1.[行] ボックス内を選択し、動的コンテンツ オプション (稲妻) を選択します。 2. 動的コンテンツリストから、前のアクションからの出力を選択します。 たとえば、Read blob content セクションで、読み取りアクションのコンテンツからの応答を選択します。 ヒント: JSON 形式でデータ オブジェクト全体を入力するには、[ 配列全体を入力するに切り替える ] オプションを選択します。

   たとえば、次の図は、ロジック アプリ用 HIS デザイナーのサンプル HIDX ファイルを含む Visual Studio を示しています。

   

   1. HIDX ファイルの値を使用して 、HIDX 名 と スキーマ名 を構成します。

      

   2. [行]>"行項目 - 1" フィールドでは、動的コンテンツ リスト (稲妻アイコン) を選択し、[読み取り BLOB アクション コンテンツからの応答] オプションを選択します。

      

      完全な ホスト ファイル コンテンツの生成 アクションは、次の例のようになります。

      

   3. 次に、結果を処理する別のアクションを追加します。

      この例では、 次の一般的な手順に従って、ファイル転送プロトコル (FTP) サーバーにファイルを作成するアクションを追加します。

      

8. 完了したら、ワークフローを保存します。 デザイナーのツール バーで、 [保存] を選択します。

ワークフローのテスト

次の手順に従って、ワークフローが期待どおりに実行されていることを確認します。

1. ワークフローを実行するには、デザイナーのツール バーの [ 実行>実行] を選択します。

   ワークフローの実行が完了すると、ワークフローの実行履歴が表示されます。 成功した手順ではチェック マークが表示され、失敗した手順では感嘆符 (!) が表示されます。

2. 各ステップの入力と出力を確認するには、そのステップを展開します。

3. 出力を確認するには、[ 未加工の出力を表示] を選択します。

関連コンテンツ

• Azure Logic Apps でワークフローの状態を確認し、実行履歴を表示し、アラートを設定する
• Azure Logic Apps でワークフローの正常性とパフォーマンスのメトリックを表示する
• Azure Logic Apps でのワークフローの診断データの監視と収集
• Azure Logic Apps の標準ワークフロー用 Application Insights で拡張テレメトリを有効にして表示する