

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Mainframe Modernization Amazon EC2 と Control-M の統合
<a name="aws-mainframe-modernization-ec2"></a>

このセクションでは、Control-M が EC2 インスタンスにデプロイされたカスタム AWS Mainframe Modernization ランタイム環境で実行されるバッチジョブと統合され、サポートされる方法について説明します。Micro Focus ランタイム環境でフルマネージド AWS Replatform を実装する場合は、[「Managed AWS Mainframe Modernization integration with Control-M](aws-mainframe-modernization-managed.md)」セクションを参照してください。

このセクションでは、以下の前提条件を前提としています。
+ アクティブな AWS アカウント。
+ EC2 インスタンスが作成される Virtual Private Cloud (VPC)。
+ メインフレームアプリケーションはEC2 インスタンスの Micro Focus 環境を備えた AWS Replatform で移行および実行され、複数の定義済みバッチジョブを持つ Micro Focus ランタイムエンジンをサポートしています。このパイロット版については、[「アプリケーションを Micro Focus でリプラットフォームする](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html)」の手順に従います。このドキュメントには、Amazon EC2 での Micro Focus ランタイム環境を使用した AWS Replatform の設定と運用に関するすべてのタスクと追加情報が含まれています。

以下のトピックでは、Control-M と AWS Replatform と Micro Focus 環境の統合に必要なセットアップについて説明します。
+ [Control-M および Micro Focus リソースをデプロイする](deploy-resources-environment.md)
+ [Control-M 接続プロファイルを作成する](create-control-m-connection-profile.md)
+ [Control-M Planning でジョブとスケジュールを作成する](create-jobs-schedules-control-m-planning.md)
+ [Monitoring を使用して Control-M でジョブ実行を管理する](monitor.md)

# Control-M および Micro Focus リソースをデプロイする
<a name="deploy-resources-environment"></a>

AWS Mainframe Modernization を Control-M と統合する最初の 2 つのステップは、Control-M エージェントをデプロイし、エージェントにプラグインをデプロイすることです。3 番目のステップは、Control-M Application Integrator にジョブタイプをデプロイすることです。

## EC2 インスタンスに Control-M エージェントをデプロイする
<a name="deploy-agent"></a>

Micro Focus on Amazon EC2 ランタイム環境でカスタム AWS Replatform を使用する場合、 `MFBSIFJCL`ユーティリティが呼び出されます。ユーティリティは、 から Micro Focus Enterprise Server オファーを使用して起動されたホストで動作します AWS Marketplace。`MFBSIFJCL` ユーティリティを実行するには、そのホストに Control-M エージェントもデプロイする必要があります。手順については、[Control-M のドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm)を参照してください。

**注記**  
必要なインストールメディアは、[BMC 電子製品ダウンロードサイト](https://www.bmc.com/support/resources/product-downloads.html)からダウンロードできます。

## Control-M エージェントに Micro Focus プラグインをデプロイする
<a name="deploy-plug-in"></a>

プラグインは、Control-M がオーケストレーションするアプリケーションとサービスの統合とサポートを提供します。

プラグインデプロイは低頻度のアクティビティです。使用する既存のプラグインが既にある場合は、このステップをスキップして接続プロファイルを作成します。

Amazon EC2 では、 AWS Mainframe Modernization Replatform with Micro Focus サービスは Micro Focus エンジンを公開します。統合するために AWS Mainframe Modernization、Control-M は Micro Focus プラグインを使用します。詳細については、[Control-M ドキュメント](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html)を参照してください。

このプラグインは、Micro Focus Enterprise Server が実行されているホストにインストールされている エージェントにデプロイする必要があります。

## Control-M Application Integrator で AWS Mainframe Modernization ジョブタイプをデプロイする
<a name="application-integrator"></a>

ジョブタイプのデプロイは、通常 1 回限りのアクティビティです。使用する既存のジョブタイプがある場合は、この手順をスキップし、次の[接続プロファイルの作成](create-control-m-connection-profile.md)に移ります。

サンプルジョブタイプ [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) は、Git リポジトリで提供されています。ジョブタイプをデプロイするには、[Application Integrator ](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm)を使用して次のステップを実行する必要があります。
+ [aws-mainframe-modernization-controlm-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) GitHub リポジトリのクローンを作成し、Application Integrator がアクセスできる`AIJOB.ctmai` ファイルシステムの場所にファイルをダウンロードします。
+ Application Integrator にログインします。
+ **[ホーム]** タブで **[ファイルからジョブタイプをインポート]** を選択し、`AIM2JOB.ctmai` の場所を選択します。
+ 提供されているサンプルに変更を加える場合は、Application Integrator の知識が必要です。
+ [Control-M のドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm)の指示に従い、ジョブタイプをデプロイします。

# Control-M 接続プロファイルを作成する
<a name="create-control-m-connection-profile"></a>

接続プロファイルは、アプリケーションの特定のインスタンスの接続属性とセキュリティ認証情報を定義します。各接続プロファイルは複数のジョブから参照できます。アプリケーションと認証情報の組み合わせごとに個別のプロファイルを作成できます。

接続プロファイルを定義するには、Control-M ウェブインターフェイス[の設定ドメイン](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm)を使用するか、JSON を使用できます。次のコードは、JSON を使用する例です。

```
{
  "MICROFOCUS-WINDOWS": {

  "Type": "ConnectionProfile:Micro Focus Windows",
  "Centralized": true,
  "Description": "Micro Focus on Windows Connection Profile - file locations refer to the Enterprise Server host", "MFBSI Config Path": "C:\\microfocus\\ES\\mfbsi\\MFWIN\\mfbsi.cfg",
  "MFBSI Directory Path": "c:\\microfocus\\es\\mfbsi\\MFWIN",
  "Runtime Environment": "\"C:\\Program Files (x86)\\Micro Focus\\Enterprise Developer\\createenv.bat\"", "Run As": "dbauser",
  "RunAs-Pass": "*****"
  }
}
```

サンプルコードは、GitHub リポジトリ`ConnectionProfile-Custom-M2-Replatform.json`の ファイルにあります。コードをデプロイするには、Control-M Automation API デプロイサービスを使用します。

```
ctm deploy ConnectionProfile-Custom-M2-Replatform.json
```

Control-M Automation API からのレスポンスは次のようになります。

```
[ 
 {
    "deploymentFile": "cp-JOG-MF-WINDOWS.json", 
    "deploymentState": "DEPLOYED_CONNECTION_PROFILES", 
    "deploymentStatus": "ENDED_OK", 
    "successfulFoldersCount": 0, 
    "successfulSmartFoldersCount": 0, 
    "successfulSubFoldersCount": 0,
    "successfulJobsCount": 0, 
    "successfulConnectionProfilesCount": 1, 
    "successfulDriversCount": 0, 
    "isDeployDescriptorValid": false, 
    "deployedConnectionProfiles": [ " MICROFOCUS-WINDOWS " ]
  }
]
```

# Control-M Planning でジョブとスケジュールを作成する
<a name="create-jobs-schedules-control-m-planning"></a>

Micro Focus 接続用のプラグインと接続プロファイルがデプロイされたので、ジョブの作成と実行を開始できます。

Control-M for Micro Focus の各ジョブは、4 つのセクションの一連の属性で構成されます。各セクションには多数の属性があります。次のリストは、より一般的に使用される属性の一部を示しています。
+ 全般:
  + ジョブの名前
  + ジョブが属するアプリケーションおよびサブアプリケーション
  + 送信する JCL
  + サイト提供の運用ドキュメントへのリンク
+ スケジューリング:
  + このジョブを実行できる月日
  + ビジネス会計期間、祝日、またはアルゴリズムで定義できないその他の特別な日付などのカレンダー
  + 時間枠
  + 1 時間ごとの実行などの周期的な動作
+ 前提条件
  + アップストリームの依存関係 (通常は、正常に完了しなければ実行できないジョブ)
  + 必要になる可能性のあるリソース
  + 必要になる可能性のあるユーザーアクション
+ ジョブの完了時に Control-M が実行するアクション:
  + ジョブの成功または失敗の判断 (通常はジョブの完了コードに基づきますが、出力テキストを使用するか、特定のステータスをチェックするようにその設定を上書きできます)
  + 失敗または成功の通知 (E メールなど)
  + ダウンストリームの依存関係の公開状況

接続プロファイルと同様に、ジョブは [Control-M Web を使用して](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm)作成およびデプロイするか、[JSON で記述](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html)し、Control-M Automation API を使用してデプロイできます。

以下のセクションでは、いくつかの一般的なワークフローシナリオについて説明します。
+ [ワークフローを使用してジョブを開始する](initiate-jobs.md)
+ [スケジュールされた頻度でジョブ実行を自動化する](automate-jobs.md)

# ワークフローを使用してジョブを開始する
<a name="initiate-jobs"></a>

ワークフローと呼ばれるジョブのフローを作成します。ワークフロー内のジョブは、前のジョブが正常に完了すると依存関係と相互に連結されます。

## Control-M Web の使用
<a name="control-m-web"></a>

Control-M ユーザーインターフェイスからジョブを開始するには、次の手順を実行します。

1. Planning Domain に新しいワークスペースを追加します。これにより、空のフォルダーオブジェクトを含むキャンバスが開きます。

1. メニューバーで、**ジョブの追加**を選択し、Micro Focus Windows または Micro Focus Linux ジョブを選択し、フォルダの顔にドラッグします。

1. ジョブの色が緑色に変わったら、ドロップします。右側のペインには、**全般**、**スケジュール、****前提条件**、**アクション**のセクションがあります。ジョブを作成するには、[Control-M ドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm)の標準手順を参照してください。

1. Control-M for Micro Focus ジョブを構築する手順については、[Control-M ドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob)を参照してください。このパイロットでは、5 つのジョブに対してステップ 2～4 を繰り返し、それぞれを から `aws-mf-job1`に命名します`aws-mf-job5`。

1. これらのジョブを必要なフローに接続するには、ジョブオブジェクトの下にある条件三角形を選択し、次のジョブにドラッグします。たとえば、 の下にある条件三角形を選択し`aws-mf-job1`、 にドラッグします`aws-mf-job2`。このアクションは `aws-mf-job1` の前身になります`aws-mf-job2`。デフォルトでは、 を実行する`aws-mf-job2`前に が正常に完了`aws-mf-job1`する必要があります。

次の図は、基本的なジョブフローの Control-M Planning ビューを示しています。



![\[ワークフロー図。右側のペインにプロパティがあります。\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png)


画像提供: BMC Software, Inc. ©2022

## JSON の使用
<a name="json"></a>

同じフローを JSON でコーディングできます。GitHub リポジトリでは、サンプルコードは ファイル にあります`Folder-Custom-M2-Replatform.json`。

```
{
  "aws-custom-m2": {
    "Type": "Folder",
    "ControlmServer": "psctm",
    "OrderMethod": "Manual",
    "Application": "AWSM2",
    "SubApplication": "Replatform-Custom",
    "aws-mf-job1": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job2": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job3": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job4": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job5": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "leftbranch": {
      "Type": "Flow",
      "Sequence": [
        "aws-mf-job1",
        "aws-mf-job2",
        "aws-mf-job3",
        "aws-mf-job5"
      ]
    },
    "rightbranch": {
      "Type": "Flow",
      "Sequence": [
        "aws-mf-job2",
        "aws-mf-job4",
        "aws-mf-job5"
      ]
    }
  }
}
```

このフローをデプロイするには、Control-M Automation API を使用します。

```
ctm deploy Folder-Custom-M2-Replatform.json
```

# スケジュールされた頻度でジョブ実行を自動化する
<a name="automate-jobs"></a>

前のステップで作成したフローを使用して、基本スケジュールとランタイムスケジュールを追加できます。
+ 基本スケジューリングは、ジョブの実行対象となる曜日を定義します (例えば、平日、営業日、月末、四半期末のみ）。基本的なスケジューリングは、[スケジューリング](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm)タブで設定できます。
+ ランタイムスケジューリングは、実行可能な日にジョブが実行されるタイミングを決定します (たとえば、以前のジョブが完了した後、1 時間ごと、指定されたリソースが利用可能になった後、または手動確認の後のみ）。

ランタイムスケジューリングは**、「スケジューリング**」セクションで定義し、**「前提条件**」セクションで定義できます。

# ジョブのモニタリング
<a name="monitor"></a>

Control-M Monitoring ドメインと [Micro Focus Enterprise Server Common Web Administration ユーザーインターフェイス](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html)でジョブをモニタリングおよび検証できます。

## Control-M Monitoring
<a name="monitoring"></a>

ジョブの送信と実行は、Control-M Monitoring Domain で監視できます。デフォルトでは、 AWS Mainframe Modernization サービスジョブは他のすべての Control-M 作業と一緒に表示されます。他のワークロード (またはその他のフィルタリング要件) がない AWS Mainframe Modernization サービスジョブのみを表示する場合は、Viewpoint を作成できます。

Viewpoint には、ジョブ情報だけではなく、上流と下流の依存関係も表示されます。さらに、ワークフローに AWS Mainframe Modernization およびその他のタイプの Control-M ジョブが含まれている場合は、モニタリングドメインでフロー全体を表示および管理できます。

Control-M ドキュメントの[「モニタリング」の「Viewpoints」セクション](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm)にアクセスして、詳細なステップを実行できます。

次のスクリーンショットは、2 つのワークフローの出力を示しています。左側では、ワークフローは正常に完了し、5 つのジョブすべてが緑色で表示されています。右側では、ワークフローが部分的にしか成功しません。 は**失敗**ステータスを`aws-mf-job3`返し、ワークフローはそこで停止し、**待機スケジュール**状態のまま`aws-mf-job5`になります。



![\[左側のワークフロー図。右側のペインの出力タブの出力をモニタリングします。\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png)


画像提供: BMC Software, Inc. ©2022