本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS Mainframe Modernization 在 Amazon EC2 上與 Control-M 整合
本節說明 Control-M 如何與部署在 EC2 執行個體上的自訂 AWS Mainframe Modernization 執行期環境中執行的批次任務整合並提供支援。如果您要使用 Micro Focus 執行時間環境實作全受管 AWS Replatform，請參閱[受管與 Control-M 的 AWS Mainframe Modernization 整合](aws-mainframe-modernization-managed.md)一節。
本節假設下列先決條件：
+ 作用中的 AWS 帳戶
+ 虛擬私有雲端 (VPC)，其中將建立 EC2 執行個體。
+ 大型主機應用程式會在 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)
+ [使用監控在 Control-M 中管理任務執行](monitor.md)
# 部署 Control-M 和 Micro Focus 資源
整合 AWS Mainframe Modernization 與 Control-M 的前兩個步驟是部署 Control-M Agent，然後在 Agent 上部署外掛程式。第三個步驟是在 Control-M 應用程式整合器中部署任務類型。
## 在 EC2 執行個體上部署 Control-M 代理程式
搭配 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 Electronic Product Download 網站下載](https://www.bmc.com/support/resources/product-downloads.html)必要的安裝媒體。
## 在 Control-M Agent 上部署 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-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) GitHub 儲存庫，並將`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 連線設定檔
連線設定檔定義應用程式特定執行個體的連線屬性和安全憑證。每個連線設定檔都可以被多個作業參考。您可以為應用程式和憑證的每個唯一組合建立不同的設定檔。
若要定義連線設定檔，您可以使用 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 儲存庫`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 中建立作業和排程
現在您已部署 外掛程式和 Micro Focus 連線的連線設定檔，您可以開始建立和執行任務。
每個 Control-M for Micro Focus 任務都由一組屬性組成，分為四個部分。每個部分都可以具有許多屬性。下列清單顯示一些較常用的屬性。
+ 一般：
+ 作業名稱
+ 作業所屬的應用程式和子應用程式
+ 要提交的 JCL
+ 網站提供的操作文件連結
+ 排程：
+ 此作業有資格執行的月份和天數
+ 行事曆，例如商業會計期間、假日或其他無法以演算法定義的特殊日期
+ 時段
+ 循環行為，例如每小時執行一次
+ 先決條件
+ 上游相依性 (通常為作業，必須先成功完成此作業才有資格執行)
+ 可能需要的資源
+ 可能需要的使用者動作
+ Control-M 完成作業後執行的動作：
+ 確定任務成功或失敗 （通常根據任務的完成代碼，但您可以覆寫該設定，以使用輸出文字或檢查特定狀態）
+ 失敗或成功的通知，例如電子郵件
+ 下游相依性的發佈狀態
如同連線設定檔，任務可以使用 [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)
# 使用工作流程啟動任務
建立稱為工作流程的作業流程。在成功完成先前作業後，工作流程中的作業與相依性相互關聯。
## 使用 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-M 文件](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob)。對於此試驗，請對五個任務重複步驟 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 Planning 檢視。
![\[工作流程圖，具有右側窗格中的屬性。\]](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png)
*影像由 BMC Software, Inc. 提供 ©2022*
## 使用 JSON
相同的流程可以 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
```
# 以排定的頻率自動執行作業
使用您在先前步驟中建立的流程，您可以新增基本和執行期排程。
+ 基本排程會定義任務符合執行資格的天數 （例如，每個工作日、僅限工作日、月底或季末）。您可以在排程索引標籤上設定基本[排程](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm)。
+ 執行時間排程會決定任務在符合執行資格的當天執行的時間 （例如，前一任務完成後、每小時、指定資源可用後，或僅在手動確認後）。
您可以在排程區段中**定義一些執行時間排程，在先決條件區段中定義其他執行時間排程**。 ****
# 監控作業
您可以在 Control-M 監控網域和 [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 監控
您可以在 Control-M 監控域中監控作業提交和執行。根據預設， AWS Mainframe Modernization 服務任務將與所有其他 Control-M 工作一起顯示。如果只想查看沒有任何其他工作負載 （或任何其他篩選需求） AWS Mainframe Modernization 的服務任務，您可以建立檢視點。
視點不僅顯示作業資訊，還顯示與上游和下游相依性的關係。此外，如果您的工作流程包含 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_tw/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png)
*影像由 BMC Software, Inc. 提供 ©2022*