本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS Mainframe Modernization 在 Amazon EC2 上与 Control-M 集成
本节介绍 Control-M 如何集成并支持在 EC2 实例上部署的自定义 AWS 大型机现代化运行时环境中运行的批处理作业。如果您正在实施带有 Micro Focus 的完全托管的 AWS Replatform 运行时环境，请参阅[与 Control-M 的托管 AWS Mainframe Modernization 集成](aws-mainframe-modernization-managed.md)部分。
本节假设以下先决条件：
+ 一个活跃的 AWS 账户。
+ 将在其中创建 EC2 实例的虚拟私有云 (VPC)。
+ 大型机应用程序在 EC2 实例上的 AWS Replatform 和 Micro Focus 环境中迁移和运行，并且支持具有多个已定义批处理任务的 Micro Focus 运行时引擎。在本试点中，请按照使用 [Micro Focus 重塑平台应用程序中的说明进行](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html)操作。该文档包括有关在 Amazon EC2 上配置和操作带有 Micro Focus 的 AWS Replatform 运行时环境的所有任务和其他信息。
以下主题涵盖了 Control-M 和带有 Micro Focus 的 AWS Replatform 环境之间集成所需的设置：
+ [部署 Control-M和Micro Focus资源](deploy-resources-environment.md)
+ [创建 Control-M 连接配置文件](create-control-m-connection-profile.md)
+ [在 Control-M 规划中创建作业和计划](create-jobs-schedules-control-m-planning.md)
+ [使用 “监控” 在 Control-M 中管理作业运行](monitor.md)
# 部署 Control-M和Micro Focus资源
将 AWS 大型机现代化与 Control-M 集成的前两个步骤是部署 Control-M 代理，然后在代理上部署插件。第三步是在 Control-M 应用程序集成器中部署作业类型。
## 在 EC2 实例上部署 Control-M 代理
在 Amazon EC2 运行时环境中使用带有 Micro Focus 的自定义 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 插件
插件为 Control-M 编排的应用程序和服务提供集成和支持。
插件部署是一种很少发生的活动。如果您已经有要使用的现有插件，请跳过此步骤并创建连接配置文件。
在 Amazon EC2 上，带有 Micro Focus 的 AWS Mainframe Modernization Replatform 服务公开了 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 应用程序集成器中部署 AWS Mainframe Modernization 作业类型
作业类型部署通常是一次性活动。如果您已有要使用的现有作业类型，请跳过此步骤，并继续[创建连接配置文件](create-control-m-connection-profile.md)的下一步。
git 存储库中提供了示例作业类型 [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai)。要部署作业类型，必须使用[应用程序集成器](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm)执行以下步骤：
+ 克隆 [aws-mainframe-modernization-controlm-in](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) tegrati `AIJOB.ctmai` on GitHub 存储库并将文件下载到应用程序集成商可以访问的文件系统位置。
+ 登录 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 连接配置文件
连接配置文件定义了应用程序特定实例的连接属性和安全凭证。每个连接配置文件可以被多个作业引用。您可以为应用程序和凭证的每种独特组合创建单独的配置文件。
要定义连接配置文件，您可以使用 Control-M Web 界面的[配置域](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 repo 的文件`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 规划中创建作业和计划
现在，您已经部署了插件和 Micro Focus 连接的连接配置文件，就可以开始创建和运行作业了。
每个 Control-M for Micro Focus 作业都由一组属性组成，分为四个部分。每个部分可以有许多属性。以下列表显示了一些比较常用的属性。
+ 常规：
+ 作业名称
+ 作业所属的应用程序和子应用程序
+ 要提交的 JCL
+ 指向现场提供的操作文档的链接
+ 调度：
+ 该作业符合运行资格的月份和天数
+ 日历，例如企业会计期、节假日或其他无法通过算法定义的特殊日期
+ 时间窗口
+ 循环行为，例如每小时跑一次
+ 先决条件
+ 上游依赖项（通常是作业，必须成功完成此作业后才能运行）
+ 可能需要的资源
+ 可能需要的用户操作
+ Control-M 在作业完成后执行的操作：
+ 确定作业成功还是失败（通常基于作业的完成代码，但您可以覆盖该设置以使用输出文本或检查特定状态）
+ 失败或成功通知，如电子邮件
+ 下游依赖项的发布状态
与连接配置文件一样，可以[使用 Control-M Web 创建和部署作业，也可以使用 [JSON 编写](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html)并使用 Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) Automation API 进行部署。
以下部分介绍了一些常见的工作流场景：
+ [使用工作流程启动作业](initiate-jobs.md)
+ [按计划频率自动运行作业](automate-jobs.md)
# 使用工作流程启动作业
创建名为工作流的作业流。工作流中的作业与成功完成先前作业的依赖项相互关联。
## 使用 Control-M Web
要从 Control-M 用户界面启动作业，请执行以下操作：
1. 在“规划域”中，添加一个新的工作区。这将打开一个包含空文件夹对象的画布。
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](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob)-M 文档。在本试点中，对五个作业重复步骤 2—4，将每个作业命名为 “”。`aws-mf-job1` `aws-mf-job5`
1. 要将这些作业连接到所需的流程中，请选择作业对象下方的条件三角形，然后将其拖动到下一个作业上。例如，选择下面的条件三角形`aws-mf-job1`，然后将其拖动到上`aws-mf-job2`。此操作使`aws-mf-job1`之成为的前身`aws-mf-job2`。默认情况下，现在`aws-mf-job1`必须成功完成`aws-mf-job2`才有资格运行。
下图显示了基本作业流的 Control-M 规划视图。
![\[工作流程图，其属性位于右侧窗格中。\]](http://docs.aws.amazon.com/zh_cn/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png)
*图片由 BMC Software, Inc.©2022 提供*
## 使用 JSON
同样的流程可以用 JSON 编码。在 GitHub repo 中，示例代码位于文件`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 自动化 API：
```
ctm deploy Folder-Custom-M2-Replatform.json
```
# 按计划频率自动运行作业
使用您在前面步骤中创建的流，可以添加基本调度和运行时调度。
+ 基本计划定义了作业有资格运行的日期（例如，每个工作日，仅在工作日、月末或季度末）。您可以在 “计划” 选项卡上设置基本日[程安排](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm)。
+ 运行时调度决定了作业在符合运行条件的当天何时运行（例如，在前置任务完成之后、每小时、在指定的资源可用之后，或者仅在手动确认之后）。
您可以在 “调度” 部分定义一些运行时调**度**，在 “**先决条件**” 部分定义其他运行时计划。
# 监控作业
您可以在 Control-M Monitoring 域和 M [icro Focus Enterprise Server Common Web 管理用户界](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html)面中监控和验证作业。
## Control-M 监控
可以在 Control-M 监控域中监控作业提交和运行。默认情况下， AWS Mainframe Modernization 服务作业将与所有其他 Control-M 工作一起显示。如果您只想查看没有任何其他工作负载（或任何其他筛选要求）的 AWS Mainframe Modernization 服务作业，则可以创建 Viewpoint。
视点不仅显示作业信息，还显示与上游和下游依赖项的关系。此外，如果您的工作流程包括 AWS Mainframe Modernization 和其他类型的 Control-M 作业，则可以在监控域中查看和管理整个流程。
您可以通过访问 Control-M 文档中[监控的 “视点” 部分](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm)来执行详细步骤。
以下屏幕截图显示了两个工作流的输出。在左侧，工作流已成功完成，五个作业均为绿色。在右侧，工作流仅部分成功，因为`aws-mf-job3`返回**了 “失败**” 状态，而工作流则停`aws-mf-job5`在那里，处于 “**等待计划**” 状态。
![\[左侧为工作流程图，在右侧窗格的 “输出” 选项卡上监视输出。\]](http://docs.aws.amazon.com/zh_cn/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png)
*图片由 BMC Software, Inc.©2022 提供*