IBM メインframes 上の IMS プログラムを Azure Logic Apps の標準ワークフローと統合する
適用対象: Azure Logic Apps (Standard)
Azure Logic Apps の標準ワークフローから Information Management System (IMS) システム上の IBM メインframe アプリにアクセスして実行するには、IMS Program Call 組み込みのサービス プロバイダー ベースのコネクタを使用できます。 IMS は、トランザクション・プログラム (TP) モニターに統合トランザクション・マネージャー (TM) および階層データベースを提供します。 このコネクターは、IMS TM ネットワーク・コンポーネントである IMS Connect を使用して IBM IMS トランザクション・プログラムと通信します。 このコンポーネントは、1 つ以上の TCP/IP クライアントと 1 つ以上の IMS システムとの間で、IMS システムに対して高パフォーマンス通信を提供します。 IMS コネクタは、21Vianet が運営する Azure Government と Microsoft Azure を除くすべての Azure Logic Apps リージョンで使用できます。
このハウツー ガイドでは、IMS コネクタに関する次の側面について説明します。
Azure Logic Apps で IMS コネクタを使用する理由
IMS コネクタを使用するための前提条件とセットアップ
標準ロジック アプリ ワークフローに IMS コネクタ アクションを追加する手順
このコネクタを使用する理由
IMS システムは、メインフレームで実行される最初のミッション クリティカルなシステムの 1 つでした。 Microsoft Host Integration Server (HIS) は、IMS Connect と APPC LU6.2 の 2 つのモデルに従って、IMS システムへの接続を提供します。 お客様は、HIS トランザクション インテグレーター (TI) を使用して、長年にわたって IMS システムをオンプレミスの Windows と統合してきました。 IMS プログラム呼び出しコネクターは、IMS Connect モデルを使用して、TCP/IP を介して IMS トランザクション・プログラムと対話します。
次の図は、IMS コネクタが IBM メインframe システムとやり取りする方法を示しています。
これらのハイブリッド クラウド シナリオを拡張するために、Standard ワークフローの IMS コネクタは HIS Designer for Logic Apps と連携します。このデザイナーを使用して、メインframe トランザクション プログラムのプログラム定義またはプログラム マップを作成できます。 このタスクでは、HIS デザイナーはその情報を、ワークフローでアクションを実行するときに IMS コネクタが使用するメタデータに変換します。
HIS デザイナーからホスト統合デザイナー XML (HIDX) ファイルとしてメタデータ ファイルを生成した後、そのファイルをマップ成果物として Standard ロジック アプリ リソースに追加できます。 これにより、IMS コネクタ アクションを追加するときに、ワークフローからアプリのメタデータにアクセスできます。 コネクタは、ロジック アプリ リソースからメタデータ ファイルを読み取り、ワークフロー内の IMS コネクタで使用するパラメーターを動的に提示します。 その後、ホスト アプリケーションにパラメーターを指定すると、コネクタによってワークフローに結果が返されます。 その結果、レガシ アプリを、Azure Logic Apps でサポートされている Azure、Microsoft、その他のアプリ、サービス、システムと統合できます。
コネクタに関するテクニカル リファレンス
次のセクションでは、IMS コネクタの操作について説明します。現在、次のアクションのみが含まれています。
IMS プログラムを呼び出す
| パラメーター | 必須 | タイプ | 説明 |
|---|---|---|---|
| HIDX 名 | はい | String | 使用する IMS HIDX ファイルを選択します。 |
| メソッド名 | はい | String | 使用する HIDX ファイル内のメソッドを選択します。 |
| 高度なパラメーター | いいえ | 場合により異なる | この一覧は、選択したメソッドで使用する他のパラメーターを追加できるように、メソッドを選択した後に表示されます。 使用できるパラメーターは、HIDX ファイルと選択した方法によって異なります。 |
この操作には、メソッドを選択した後に表示される高度なパラメーターも含まれ、選択したメソッドを選択して使用できます。 これらのパラメーターは、HIDX ファイルと選択する方法によって異なります。
制限事項
現時点では、このコネクタでは、統合アカウントではなく、HIDX ファイルを Standard ロジック アプリ リソースに直接アップロードする必要があります。
前提条件
Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。
IMS システムをホストするメインフレームへのアクセス
メインフレーム プログラムを実行するために IMS プログラム呼び出しコネクタに必要なメタデータを提供するホスト統合デザイナー XML (HIDX) ファイル。
この HIDX ファイルを作成するには、 AZURE Logic Apps 用 HIS デザイナーをダウンロードしてインストールします。 唯一の前提条件は Microsoft .NET Framework 4.8 です。
メインフレーム プログラムを呼び出すには、ワークフローでメインフレーム プログラムの型、パラメーター、および戻り値を理解する必要があります。 IMS コネクタはプロセスとデータ変換を管理します。これは、ワークフローから メインframe プログラムへの入力データの提供と、メインframe プログラムから生成された出力データをワークフローに送信するために必要です。 コネクタには、表形式のデータ定義とコード ページ変換も用意されています。 このプロセスでは、Azure Logic Apps では、この情報をメタデータとして指定する必要があります。
このメタデータを作成するには、LOGIC Apps 用 HIS デザイナーを使用します。 このツールを使用すると、ワークフローで使用できるメソッド、パラメーター、および戻り値を手動で作成できます。 このツールを使用すると、この情報を提供する COBOL または RPG プログラム定義 (コピーブック) をインポートすることもできます。
このツールは、コネクタに必要なメタデータを提供する Host Integration Designer XML (HIDX) ファイルを生成します。 HIS を使用している場合は、TI デザイナーを使用して HIDX ファイルを作成できます。
IMS システムとの統合に使用する標準ロジック アプリ ワークフロー
IMS コネクタにはトリガーがないため、繰り返しトリガーや要求トリガーなど、任意のトリガーを使用してワークフローを開始します。 その後、IMS コネクター・アクションを追加できます。 開始するには、Standard ロジック アプリ リソースに空のワークフローを作成します。
メタデータの定義と生成
Azure Logic Apps 用 HIS デザイナーをダウンロードしてインストールした後、次の手順に従って メタデータ成果物から HIDX ファイルを生成します。
HIDX ファイルをアップロードする
ワークフローで HIDX ファイルを使用するには、次の手順に従います。
HIDX ファイルを保存したフォルダーに移動し、ファイルをコピーします。
Azure portal で、HIDX ファイルをマップとして Standard ロジック アプリ リソースにアップロードします。
このガイドの後半で、初めて IMS プログラム呼び出しコネクタ アクションをワークフローに追加すると、ワークフローとメインフレーム システム間の接続を作成するように求められます。 接続を作成した後は、前に追加した HIDX ファイル、実行するメソッド、および使用するパラメーターを選択できます。
IMS アクションを追加する
Azure portal で、Standard ロジック アプリ リソースとワークフローをデザイナーで開きます。
ワークフローを開始するためのトリガーをまだ追加していない場合は、 次の一般的な手順に従って、必要なトリガーを追加します。
この例では、HTTP 要求の受信時という名前の要求トリガーを続行します。
IMS コネクター・アクションを追加するには、以下の一般的な手順に従って、IMS プログラム呼び出し組み込みコネクター・アクション 「IMS プログラムの呼び出し」という名前を追加します。
接続の詳細ウィンドウが表示されたら、次の情報を入力します。
パラメーター 必須 値 説明 Connection Name はい <connection-name> 接続の名前 IMS システム ID はい <IMS-system-ID> IMS Connect モデルが着信要求を送信する IMS システムの名前 ITOC Exit Name いいえ <ITOC-exit-name> IMS が着信要求を処理するために使用する出口ルーチンの名前 MFS Mod Name いいえ <MFS-Mod-Name> 送信 IMS メッセージ出力記述子に関連付けられている名前 HWSO1 セキュリティ出口を使用する いいえ True または False サーバーは HWSO1 セキュリティー出口を使用します。 サーバー証明書の共通名 いいえ <server-cert-common-name> 使用するトランスポート セキュリティ層 (TLS) 証明書の名前 コード ページ いいえ <code-page> テキストの変換に使用するコード ページ番号 パスワード いいえ <password> 接続認証用の省略可能なユーザー パスワード [ポート番号] はい <port-number> 接続認証に使用するポート番号 [サーバー名] はい <server-name> サーバー名 タイムアウト いいえ <タイムアウト> サーバーからの応答を待機している間のタイムアウト時間 (秒) ユーザー名 いいえ <user-Name> 接続認証の省略可能なユーザー名 TLS を使用する いいえ True または False トランスポート セキュリティ層 (TLS) を使用して接続をセキュリティで保護します。 サーバー証明書の検証 いいえ True または False サーバーの証明書を検証します。 次に例を示します。
完了したら、[新規作成] を選択します。
アクションの詳細ウィンドウが表示されたら、[パラメーター] セクションで、必要な情報を入力します。
パラメーター 必須 値 説明 HIDX 名 はい <HIDX-file-name> 使用する IMS HIDX ファイルを選択します。 メソッド名 はい <method-name> 使用する HIDX ファイル内のメソッドを選択します。 高度なパラメーター いいえ 場合により異なる この一覧は、選択したメソッドで使用する他のパラメーターを追加できるように、メソッドを選択した後に表示されます。 使用できるパラメーターは、HIDX ファイルと選択した方法によって異なります。 次に例を示します。
HIDX ファイルと方法を選択する
高度なパラメーターを選択する
完了したら、ワークフローを保存します。 デザイナー のツール バーで、[保存] を選択 します。
ワークフローのテスト
ワークフローを実行するには、ワークフロー メニューの [概要] を選択します。 [概要] ツール バーで、[実行]>[実行] の順に選びます。
ワークフローの実行が完了すると、ワークフローの実行履歴が表示されます。 成功した手順ではチェックマークが表示され、失敗した手順では感嘆符 (!) が表示されます。
各ステップの入力と出力を確認するには、そのステップを展開します。
出力を確認するには、[未加工出力の表示] を選択します。