翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Control-M とのマネージド AWS Mainframe Modernization 型統合
このセクションでは、Control-M が Micro Focus ランタイムエンジンでデプロイされたマネージド AWS Mainframe Modernization 環境で実行されるバッチジョブと統合され、サポートされる方法について説明します。Amazon EC2 で Micro Focus によるカスタム AWS Replatform 環境を実装する場合は、[AWS Mainframe Modernization Amazon EC2 での Control-M との統合](aws-mainframe-modernization-ec2.md)」セクションを参照してください。
このセクションでは、以下の前提条件を前提としています。
+ アクティブ AWS アカウント。
+ メインフレームアプリケーションは、複数のバッチジョブが定義された Micro Focus マネージドランタイム環境の AWS Replatform に移行され、実行されます。
+ このパイロット版では、BankDemo サンプルアプリケーションが に設定されています AWS Mainframe Modernization。セットアップ手順については、[「チュートリアル: Micro Focus のマネージドランタイム](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html)」を参照してください。
以下のトピックでは、さまざまなタイプの統合ワークフローの Control-M Scheduler と AWS Mainframe Modernization 環境の統合に必要なstep-by-stepのセットアップについて説明します。
+ [Control-M リソースをデプロイする](deploy-control-m-resources.md)
+ [AWS Mainframe Modernization 用の Control-M 接続プロファイルを作成する](connection-profile.md)
+ [Control-M Planning でジョブとスケジュールを作成する](jobs-schedules-control-m.md)
+ [ジョブのモニタリング](monitor-jobs.md)
# Control-M リソースをデプロイする
AWS Mainframe Modernization を Control-M と統合する最初の 2 つのステップは、プラグインとジョブタイプをデプロイすることです。
## AWS Mainframe Modernization Control-M プラグインをデプロイする
プラグインは、Control-M がオーケストレーションするアプリケーションとサービスの統合とサポートを提供します。マネージド AWS Mainframe Modernization サービスの場合は、プラグインをデプロイします AWS Mainframe Modernization 。
プラグインデプロイは低頻度のアクティビティです。プラグインを初めてインストールする場合は、[Control-M ドキュメント](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html)の手順に従ってください。使用する既存のプラグインがある場合は、このステップをスキップして接続[プロファイルを作成します](connection-profile.md)。
## Control-M Application Integrator で AWS Mainframe Modernization ジョブタイプをデプロイする
ジョブタイプのデプロイは、通常 1 回限りのアクティビティです。使用する既存のジョブタイプがある場合は、この手順をスキップし、次の[接続プロファイルの作成](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)を使用して次の手順を実行する必要があります。
1. [aws-mainframe-modernization-controlm-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) GitHub リポジトリのクローンを作成し、Application Integrator がアクセスできる`AIJOB.ctmai`ファイルシステムの場所にファイルをダウンロードします。
1. Application Integrator にログインします。
1. **[ホーム]** タブで **[ファイルからジョブタイプをインポート]** を選択し、`AIJOB.ctmai` の場所を選択します。
1. 提供されているサンプルに変更を加える場合は、Application Integrator の知識が必要です。
1. [Control-M のドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm)の指示に従い、ジョブタイプをデプロイします。
# の Control-M 接続プロファイルを作成する AWS Mainframe Modernization
接続プロファイルは、アプリケーションの特定のインスタンスの接続属性とセキュリティ認証情報を定義します。各接続プロファイルは複数のジョブから参照できます。アプリケーションと認証情報の組み合わせごとに個別のプロファイルを作成できます。
[接続プロファイルを定義する](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm)には、Control-M ウェブインターフェイス**の設定**ドメインで使用できるグラフィカルユーザーインターフェイス (GUI) を使用するか、[JSON](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) を使用できます。 AWS Mainframe Modernization プラグインの接続プロファイルの詳細については、[Control-M ドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters)を参照してください。
次のコードは、JSON を使用する例です。
```
{
"MANAGED-M2-REPLATFORM": {
"Type": "ConnectionProfile:AWS Mainframe Modernization",
"Mainframe Modernization URL": "https://m2.{{AwsRegion}}.amazonaws.com",
"Connection Timeout": "30",
"AWS Region": "us-west-2",
"Authentication": "NoSecret",
"IAM Role": "--- IAM Role name ---",
"AWS Logs URL": "https://logs.{{AwsRegion}}.amazonaws.com",
"Description": "",
"Centralized": true
}
}
```
この例に似た JSON ファイルを作成し、[Control-M Automation API デプロイサービスを使用してデプロイ](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html)します。たとえば、JSON コードが という名前のファイルに保存されている場合`cp-MANAGED-M2-REPLATFORM.json`、この接続プロファイルをデプロイする `ctm` CLI 構文は次のとおりです。
```
ctm deploy cp-MANAGED-M2-REPLATFORM.json
```
Control-M Automation API からのレスポンスは次のようになります。
```
[
{
"deploymentFile": "cp-Managed-M2-REPLATFORM.json",
"deploymentState": "DEPLOYED_CONNECTION_PROFILES",
"deploymentStatus": "ENDED_OK",
"successfulFoldersCount": 0,
"successfulSmartFoldersCount": 0,
"successfulSubFoldersCount": 0,
"successfulJobsCount": 0,
"successfulConnectionProfilesCount": 1,
"successfulDriversCount": 0,
"isDeployDescriptorValid": false,
"deployedConnectionProfiles": [
"MANAGED-M2-REPLATFORM"
]
}
]
```
# Control-M Planning でジョブとスケジュールを作成する
これで、AWS 接続用のジョブタイプと接続プロファイルがデプロイされたので、ジョブの作成と実行を開始できます。
各 AWS Mainframe Modernization サービスジョブは、4 つのセクションの一連の属性で構成されます。各セクションには多数の属性があります。次のリストは、より一般的に使用される属性の一部を示しています。
+ 全般:
+ ジョブの名前
+ ジョブが属するアプリケーションおよびサブアプリケーション
+ 送信する JCL
+ ドキュメントへのリンク
+ スケジューリング:
+ このジョブを実行できる月日
+ ビジネス会計期間、祝日、またはアルゴリズムで定義できないその他の特別な日付などのカレンダー
+ 時間枠
+ 周期的行動
+ 前提条件:
+ アップストリームの依存関係 (通常は、正常に完了しなければ実行できないジョブ)
+ 必要になる可能性のあるリソース
+ 必要になる可能性のあるユーザーアクション
+ ジョブの完了時に Control-M が実行するアクション:
+ ジョブの成功または失敗の判断 (通常はジョブの完了コードに基づきますが、出力テキストを使用するか、特定のステータスをチェックするようにその設定を上書きできます)
+ 失敗または成功の通知 (E メールなど)
+ ダウンストリームの依存関係の公開状況
接続プロファイルと同様、ジョブも [GUI](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 を使用して作成およびデプロイできます。
以下のセクションでは、いくつかの一般的なワークフローシナリオについて説明します。
+ [以前のジョブのステータスコードに基づいてジョブを開始する](status-code.md)
+ [スケジュールされた頻度でジョブ実行を自動化する](scheduled.md)
+ [基本ジョブはイベントに基づいて実行される](event-based.md)
# 以前のジョブのステータスに基づいてジョブを開始する
ワークフローと呼ばれるジョブのフローを作成します。ワークフロー内のジョブは、前のジョブが正常に完了すると依存関係と相互に連結されます。
## Control-M ウェブ GUI の使用
Control-M ユーザーインターフェイスからジョブを開始するには、次の手順を実行します。
1. **Planning** ドメインで、新しい **Workspace** を追加します。これにより、空のフォルダーオブジェクトを含むキャンバスが開きます。
1. AWS Mainframe Modernization ジョブタイプ (指定されたジョブタイプテンプレートを使用している場合は [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json) と呼ばれます) を選択し、フォルダにドラッグします。
1. ジョブタイプの色が緑色に変わったら、ドロップします。右側のペインには、**全般**、**スケジュール**、**前提条件**、**アクション**のセクションがあります。ジョブを作成するには、[Control-M ドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm)の標準手順を参照してください。
1. 次に、**ジョブタイプを設定するには、ジョブ名**の値が必要です。**ジョブ名の**値は、コンソールの AWS Mainframe Modernization **アプリケーション**定義画面で、または [ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html) を実行して確認できます。このパイロットでは、複数のジョブに対してステップ 2～4 を繰り返し、それぞれに任意の名前を付けます。名前の例は、`CBANK`、`CURRENCY`、I`NVFUNDS`、`BROKERAGE`、`RISKMGMT`、および です`BANK-SERVICE-Managed-M2`。
1. これらのジョブを必要なフローに接続するには、ジョブオブジェクトの下にある条件三角形を選択し、次のジョブにドラッグします。たとえば、 で条件三角形を選択し`CBANK`、 にドラッグします`CURRENCY`。このアクションは `CBANK` の前身になります`CURRENCY`。デフォルトでは、CURRENCY の実行対象になる前に、 が正常に完了`CBANK`する必要があります。
次のスクリーンショットは、基本的なジョブフローの Control-M Planning ビューを示しています。
![\[左側のジョブフローと右側のプロパティ。\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png)
画像提供: BMC Software, Inc. ©2022
## JSON の使用
同じフローを JSON でコーディングできます。
```
{
"Defaults": {
"Application": "AWSM2",
"SubApplication": "Replatform-Managed",
"Job": {
"Host": "ctm-worker",
"Output": {}
}
},
"jog-managed-m2": {
"Type": "Folder",
"ControlmServer": "psctm",
"OrderMethod": "Manual",
"SiteStandard": "_z_DemoBusinessFlows",
"CBANK": {
"Type": "Job:AWS Mainframe Modernization",
"ConnectionProfile": "MANAGED-M2-REPLATFORM",
"JCL Name": "iefbr14",
"Retrieve CloudWatch Logs": "checked",
"Action": "Start Batch Job",
"Application Version": "1"
},
"CURRENCY": {
"Type": "Job:AWS Mainframe Modernization",
"ConnectionProfile": "MANAGED-M2-REPLATFORM",
"JCL Name": "iefbr14",
"Retrieve CloudWatch Logs": "checked",
"Action": "Start Batch Job",
"Application Version": "1"
},
"BROKERAGE": {
"Type": "Job:AWS Mainframe Modernization",
"ConnectionProfile": "MANAGED-M2-REPLATFORM",
"JCL Name": "iefbr14",
"Retrieve CloudWatch Logs": "checked",
"Action": "Start Batch Job",
"Application Version": "1"
},
"INVFUNDS": {
"Type": "Job:AWS Mainframe Modernization",
"ConnectionProfile": "MANAGED-M2-REPLATFORM",
"JCL Name": "iefbr14",
"Retrieve CloudWatch Logs": "checked",
"Action": "Start Batch Job",
"Application Version": "1"
},
"RISKMGMT": {
"Type": "Job:AWS Mainframe Modernization",
"ConnectionProfile": "MANAGED-M2-REPLATFORM",
"JCL Name": "iefbr14",
"Retrieve CloudWatch Logs": "checked",
"Action": "Start Batch Job",
"Application Version": "1"
},
"BANK-SERVICE-Managed-M2": {
"Type": "Job:SLAManagement",
"ServiceName": "Bank Service - Managed M2",
"RunAs": "ctmagent",
"CompleteBy": {
"Time": "12:00",
"Days": "0"
}
},
"leftbranch": {
"Type": "Flow",
"Sequence": [
"CURRENCY",
"RISKMGMT",
"BANK-SERVICE-Managed-M2"
]
},
"middlebranch": {
"Type": "Flow",
"Sequence": [
"CBANK",
"CURRENCY",
"INVFUNDS",
"BANK-SERVICE-Managed-M2"
]
},
"rightbranch": {
"Type": "Flow",
"Sequence": [
"CURRENCY",
"BROKERAGE",
"BANK-SERVICE-Managed-M2"
]
}
}
}
```
このフローをデプロイするには、デプロイサービスを使用します。
```
ctm deploy folder-MANAGED-M2-REPLATFORM.json
```
# スケジュールされた頻度でジョブ実行を自動化する
前のステップで作成したフローを使用して、基本スケジュールとランタイムスケジュールを追加できます。
+ 基本スケジュールでは、ジョブを実行できる日 (平日、稼働日のみ、月末、四半期末など) を定義します。
+ ランタイムスケジューリングは、ジョブが実行可能な日にいつ実行されるかを決定します (たとえば、1 時間ごと、指定されたリソースが利用可能になった後、または手動確認の後のみ）。
基本スケジュールとランタイムスケジュールは、**[スケジューリング]** タブで設定できます。
# 基本ジョブはイベントに基づいて実行される
Control-M Managed File Transfer (MFT) は、FTP/SFTP クライアントおよびサーバーとして機能し、ローカルホストとリモートホスト間のファイルの監視や転送に使用できます。File Transfer ジョブの定義に関する詳細は、[Control-M のドキュメント](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm)を参照してください。
このパイロットでは、File Transfer ジョブを使用して、`bmc-poc-bucket` という名前の S3 バケット内の `/bmcfile` フォルダーにある、拡張子が .poc のファイルのファイル作成イベントを監視します。このイベントが発生すると、Control-M ジョブが開始され、次のジョブが実行されます。オプションで、バケット名を含むフルパスを渡すことができます。
# ジョブのモニタリング
Control-M Monitoring ドメイン内および を通じてジョブの処理をモニタリングおよび検証できるため AWS マネジメントコンソール、両方のプラットフォームで包括的な監視と検証を行うことができます。
## Control-M Monitoring
ジョブの送信と実行は、Control-M Monitoring Domain で監視できます。デフォルトでは、 AWS Mainframe Modernization サービスジョブは他のすべての Control-M 作業と一緒に表示されます。他のワークロード (またはその他のフィルタリング要件) がない AWS Mainframe Modernization サービスジョブのみを表示する場合は、*ビューポイント*を作成できます。
Viewpoint には、ジョブ情報だけではなく、上流と下流の依存関係も表示されます。さらに、ワークフローに AWS Mainframe Modernization およびその他の Control-M ジョブタイプが含まれている場合は、モニタリングドメインでフロー全体を表示および管理できます。
詳細な手順については、Control-M ドキュメントの[「モニタリング」の「Viewpoints」セクション](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm)を参照してください。
次のスクリーンショットは、2 つのワークフローの出力を示しています。左側では、ワークフローが正常に完了し、すべてのジョブが緑色で表示されます。右側では、ジョブが赤色で示されている**失敗**ステータスを`CURRRENCY`返したため、ワークフローは部分的にしか成功しません。ワークフローはそこで停止し、残りのジョブは**待機スケジュール**状態のままになります。
![\[左側のワークフロー、右側のジョブプロパティの図。\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png)
画像提供: BMC Software, Inc. ©2022
## コンソールでのモニタリング
ジョブとログ情報を表示するには AWS、 にサインインし AWS マネジメントコンソール、 [AWS Mainframe Modernization コンソール](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications)に移動します。
![\[AWS Mainframe Modernization コンソールにリストされているジョブとステータス。\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png)
このビューには、依存関係や AWS Mainframe Modernization サービスによって管理されていないワークロードは含まれません。