適用対象: Azure Logic Apps (従量課金 + 標準)
IBM メインフレーム アプリは通常、3270 エミュレーターを介して実行されます。 Azure Logic Apps の従量課金ワークフローと標準ワークフローから IBM メインフレーム アプリにアクセスして実行するには、 IBM 3270 コネクタを使用します。 IBM メインフレーム アプリを Azure、Microsoft、およびその他のアプリ、サービス、システムと統合する自動化されたワークフローを作成できます。 コネクタは、TN3270 プロトコルを使用して IBM メインフレームと通信します。 IBM 3270 コネクタは、21Vianet が運用する Azure Government と Microsoft Azure を除くすべての Azure Logic Apps リージョンで使用できます。
このハウツー ガイドでは、 IBM 3270 コネクタに関する次の側面について説明します。
- Azure Logic Apps で IBM 3270 コネクタを使用する理由
- IBM 3270 コネクタで 3270 画面駆動型アプリを実行する方法
- IBM 3270 コネクタを使用するための前提条件とセットアップ
- ワークフローに IBM 3270 コネクタ アクションを追加する手順
このコネクタを使用する理由
IBM メインフレーム上のアプリにアクセスするには、通常、 緑色の画面と呼ばれる 3270 ターミナル エミュレーターを使用します。 このメソッドは時間テストの方法ですが、制限があります。 Host Integration Server (HIS) は、これらのアプリを直接操作するのに役立ちますが、画面とビジネス ロジックを分離できない場合があります。 または、ホスト アプリケーションの動作に関する情報がなくなった可能性があります。
これらのシナリオを拡張するために、Azure Logic Apps の IBM 3270 コネクタは 3270 デザイン ツールと連携します。 デザイン ツールを使用して、特定のタスクに使用されるホスト画面を記録または キャプチャし、メインフレーム アプリを使用してそのタスクのナビゲーション フローを定義し、そのタスクの入力パラメーターと出力パラメーターを持つメソッドを定義します。 デザイン ツールは、その情報を、ワークフローでアクションを実行するときに 3270 コネクタが使用するメタデータに変換します。
まず、3270 デザイン ツールからメタデータ ファイルを生成します。 次に、そのファイルをマップ成果物として、Standard ロジック アプリ リソースまたは従量課金ロジック アプリのリンクされた統合アカウントに追加します。 こうすることで、 IBM 3270 コネクタ アクションを追加するときに、ワークフローからアプリのメタデータにアクセスできます。
コネクタは、ロジック アプリ リソース (Standard) または統合アカウント (従量課金) からメタデータ ファイルを読み取り、3270 画面のナビゲーションを処理し、ワークフローの 3270 コネクタで使用するパラメーターを動的に提示します。 その後、ホスト アプリケーションにデータを提供できます。 コネクタは結果をワークフローに返します。 その結果、レガシ アプリを Azure、Microsoft、Azure Logic Apps がサポートするその他のアプリ、サービス、システムと統合できます。
コネクタに関するテクニカル リファレンス
IBM 3270 コネクタのバージョンは、 ロジック アプリの種類とホスト環境に基づいて異なります。
| ロジック アプリ | 環境 | 接続のバージョン |
|---|---|---|
| 消費 | マルチテナント Azure Logic Apps | マネージド コネクタ。 デザイナーの [エンタープライズ ] ラベルの下に表示されます。 このコネクタでは、1 つのアクションのみが提供され、トリガーは提供されません。 詳細については、 IBM 3270 マネージド・コネクター・リファレンスを参照してください。 |
| 標準 | シングルテナントの Azure Logic Apps と、Windows プランのみの App Service Environment v3 (ASE v3) | マネージド コネクタ。コネクタ ギャラリーの 共有 フィルターの下に表示され、組み込みの サービス プロバイダー ベース のコネクタが、コネクタ ギャラリーの 組み込み フィルターの下に表示されます。 組み込みバージョンには次のような違いがあります。 - 組み込みコネクタでは、統合アカウントではなく、標準ロジック アプリ リソースに HIDX ファイルをアップロードする必要があります。 - 組み込みのコネクタは、接続文字列を使用して 3270 サーバーに直接接続し、Azure 仮想ネットワークにアクセスできます。 - 組み込みバージョンでは、転送中のデータの TLS 暗号化、操作のメッセージ エンコード、Azure 仮想ネットワーク統合を使用したサーバー認証がサポートされています。 詳しくは、次のドキュメントをご覧ください。 - IBM 3270 マネージド コネクタ リファレンス - IBM 3270 組み込みコネクタリファレンス |
組み込みコネクタ リファレンス
次のセクションでは、IBM 3270 コネクタの操作について説明します。現在、次のアクションのみが含まれています。
ナビゲーション プランを実行する
| パラメーター | 必須 | タイプ | 説明 |
|---|---|---|---|
| HIDX 名 | イエス | 糸 | 使用する 3270 HIDX ファイルを選択します。 |
| メソッド名 | イエス | 糸 | 使用する HIDX ファイル内のメソッドを選択します。 |
| 高度なパラメーター | いいえ | 場合により異なる | この一覧は、選択したメソッドで使用する他のパラメーターを追加できるように、メソッドを選択した後に表示されます。 使用できるパラメーターは、HIDX ファイルと選択した方法によって異なります。 |
この操作には、メソッドを選択した後に表示される高度なパラメーターも含まれ、選択したメソッドを選択して使用できます。 これらのパラメーターは、HIDX ファイルと選択する方法によって異なります。
[前提条件]
Azure アカウントとサブスクリプション。 無料の Azure アカウントを取得します。
3270 画面駆動型アプリをホストする TN3270 サーバーへのアクセス。
3270 画面駆動型アプリを実行するために IBM 3270 コネクタに必要なメタデータを提供するホスト統合デザイナー XML (HIDX) ファイル。
この HIDX ファイルを作成するには、 3270 デザイン ツールをダウンロードしてインストールします。 唯一の前提条件は Microsoft .NET Framework 4.8 です。
このツールは、3270 コネクタ アクションとして追加して実行するアプリ内のタスクの画面、ナビゲーション パス、メソッド、およびパラメーターを記録するのに役立ちます。 このツールは、3270 画面駆動型アプリを実行するためにコネクタに必要なメタデータを提供する Host Integration Designer XML (HIDX) ファイルを生成します。
このツールをダウンロードしてインストールしたら、TN3270 ホスト サーバーに接続し、必要なメタデータ成果物を設計して、HIDX ファイルを生成します。 詳細については、「 3270 アプリケーションのメタデータ成果物の設計」を参照してください。
3270 画面駆動型アプリを実行する Standard または従量課金ロジック アプリのリソースとワークフロー。
IBM 3270 コネクタにはトリガーがないため、 繰り返し トリガーや 要求 トリガーなど、任意のトリガーを使用してワークフローを開始します。 その後、3270 コネクタアクションを追加できます。
統合アカウント。使用する 3270 コネクタのバージョンに基づいて必要です。 この Azure リソースを使用して、B2B 成果物を一元的に格納します。 たとえば、取引先、契約、マップ、スキーマ、特定のワークフロー アクションで使用する証明書などがあります。
Workflow 説明 Standard - 3270 組み込みコネクタ: HIDX ファイルを Standard ロジック アプリ リソースにアップロードします。
- 3270 マネージド コネクタ: HIDX ファイルを Standard ロジック アプリ リソースまたは リンクされた統合アカウントにアップロードします。従量課金 3270 マネージド コネクタ: リンクされた統合アカウントに HIDX ファイルをアップロードします。 詳細については、「 HIDX ファイルのアップロード」を参照してください。
HIDX ファイルをアップロードする
ワークフローで HIDX ファイルを使用するには、次の手順に従います。
HIDX ファイルを保存したフォルダーに移動し、ファイルをコピーします。
Azure portal で、コネクタのバージョンに基づいて次の手順を選択します。
3270 組み込みコネクタ: HIDX ファイルを Standard ロジック アプリ リソースにアップロードします。
3270 マネージド コネクタ:
リンクされた統合アカウントに HIDX ファイルをアップロードします。 マップの種類として HIDX を選択していることを確認します。
次に、ワークフローに IBM 3270 アクション を追加します。
このガイドの後半で、 初めて IBM 3270 コネクタ アクションをワークフローに追加すると、ワークフローとメインフレーム システムの間に接続を作成するように求められます。 接続を作成したら、以前に追加した HIDX ファイル、実行するメソッド、および使用するパラメーターを選択できます。
IBM 3270 アクションを追加する
標準ロジック アプリ ワークフローでは、IBM 3270 マネージド コネクタと IBM 3270 組み込みコネクタを使用できます。 従量課金ロジック アプリ ワークフローでは、IBM 3270 マネージド コネクタのみを使用できます。 バージョンごとに異なるアクションがあります。 従量課金と Standard のどちらのロジック アプリ ワークフローを使用しているかに基づいて、対応する手順に従ってください。
Azure portal で、Standard ロジック アプリ リソースとワークフローを開きます。
ワークフローにトリガーがない場合は、 一般的な手順 に従って、シナリオに適したトリガーを追加します。
この例では、HTTP 要求を受信したときにという名前の要求トリガーを続行します。
一般的な手順に従って、ナビゲーション 計画の実行という名前の IBM 3270 組み込みコネクタ アクションを追加します。
接続ウィンドウが表示されたら、次のパラメーター値を入力します。
パラメーター 必須 価値 説明 接続名 イエス < コネクション名> 接続の名前。 コード ページ いいえ < code-page> テキストの変換に使用するホストのコード ページ番号。 この値を空白のままにすると、コネクタは既定値として 37を使用します。デバイスタイプ いいえ < IBM-terminal-model> エミュレートする IBM 端末のモデル名または番号。 この値を空白のままにすると、コネクタは既定値を使用します。 ログ例外画面 いいえ True または False 画面ナビゲーション中にエラーが発生した場合は、ホスト画面をログに記録します。 論理ユニット名 いいえ < logical-unit-name> ホストから要求する特定の論理ユニット名。 ポート番号 いいえ < TN3270-server-port> TN3270 サーバーによって使用されるポート。 この値を空白のままにすると、コネクタは既定値として 23を使用します。サーバー イエス < TN3270-server-name> TN3270 サービスのサーバー名。 タイムアウト いいえ < timeout-seconds> 画面の待機中のタイムアウト時間 (秒)。 TLS を使用する いいえ オンまたはオフ TLS 暗号化を有効または無効にします。 TN3270 サーバー証明書の検証 いいえ オンまたはオフ サーバーの証明書の検証を有効または無効にします。 例えば次が挙げられます。
完了したら、[ 新規作成] を選択します。
アクション情報ボックスが表示されたら、必要なパラメーター値を入力します。
パラメーター 必須 価値 説明 HIDX 名 イエス < HIDX-file-name> 使用する 3270 HIDX ファイルを選択します。 メソッド名 イエス < method-name> 使用する HIDX ファイル内のメソッドを選択します。 メソッドを選択すると、[ 新しいパラメーターの追加] 一覧が表示され、そのメソッドで使用するパラメーターを選択できます。 例えば次が挙げられます。
HIDX ファイルを選択する
メソッドを選択する
ワークフローを保存します。 デザイナー のツール バーで、[ 保存] を選択します。
ワークフローのテスト
ワークフローを手動で実行するには、デザイナーのツール バーの [ 実行 ] メニューから [ 実行] を選択します。
ワークフローの実行が完了すると、実行履歴が表示されます。 成功した操作ではチェック マークが表示され、失敗した操作では感嘆符 (!) が表示されます。
各操作の入力と出力を表示するには、その操作を選択します。
生の入力を確認するには、[ 生の入力を表示] を選択します。
生出力を確認するには、[ 未加工の出力を表示] を選択します。