Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS Mainframe Modernization Integrasi terkelola dengan Control-M
Bagian ini menjelaskan bagaimana Control-M terintegrasi dengan dan mendukung pekerjaan batch yang berjalan di AWS Mainframe Modernization lingkungan terkelola yang digunakan dengan mesin runtime Micro Focus. Jika Anda menerapkan AWS Replatform kustom dengan lingkungan Micro Focus di Amazon EC2, lihat [AWS Mainframe Modernization bagian Integrasi Amazon EC2 dengan Control-M di Amazon](aws-mainframe-modernization-ec2.md).
Bagian ini mengasumsikan prasyarat berikut:
+ Aktif Akun AWS.
+ Aplikasi mainframe dimigrasikan dan berjalan di AWS Replatform dengan lingkungan runtime terkelola Micro Focus dengan beberapa pekerjaan batch yang ditentukan.
+ Untuk pilot ini, BankDemo contoh aplikasi diatur di AWS Mainframe Modernization. Untuk petunjuk penyiapan, lihat [Tutorial: Managed Runtime for Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html).
Topik berikut menjelaskan step-by-step penyiapan yang diperlukan untuk integrasi antara Control-M Scheduler dan AWS Mainframe Modernization lingkungan untuk berbagai jenis alur kerja integrasi:
+ [Menyebarkan sumber daya Control-M](deploy-control-m-resources.md)
+ [Membuat profil koneksi Control-M untuk AWS Mainframe Modernization](connection-profile.md)
+ [Buat pekerjaan dan jadwal di Control-M Planning](jobs-schedules-control-m.md)
+ [Pantau pekerjaan](monitor-jobs.md)
# Menyebarkan sumber daya Control-M
Dua langkah pertama dalam mengintegrasikan AWS Mainframe Modernization dengan Control-M adalah menerapkan plug-in dan jenis pekerjaan.
## Menyebarkan plug-in AWS Mainframe Modernization Control-M
Plug-in menyediakan integrasi dan dukungan untuk aplikasi dan layanan yang diatur oleh Control-M. Untuk AWS Mainframe Modernization layanan terkelola, gunakan AWS Mainframe Modernization plug-in.
Penyebaran plug-in adalah aktivitas yang jarang terjadi. Jika menginstal plug-in untuk pertama kalinya, ikuti langkah-langkah dalam dokumentasi [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html). Jika Anda memiliki plug-in yang ingin Anda gunakan, lewati langkah ini, dan [buat profil koneksi](connection-profile.md).
## Menyebarkan jenis AWS Mainframe Modernization pekerjaan di Control-M Application Integrator
Penyebaran jenis pekerjaan biasanya merupakan aktivitas satu kali. Jika Anda sudah memiliki jenis pekerjaan yang ingin Anda gunakan, lewati langkah ini dan lanjutkan ke langkah berikutnya untuk [membuat profil koneksi](connection-profile.md).
Contoh jenis pekerjaan [aiJob.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) disediakan di repositori git. Untuk menerapkan jenis pekerjaan, Anda harus melakukan langkah-langkah berikut menggunakan [Integrator Aplikasi](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm):
1. Kloning GitHub repositori [aws-mainframe-modernization-controlm-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) dan unduh `AIJOB.ctmai` file ke lokasi sistem file yang dapat diakses oleh Application Integrator.
1. Masuk ke Integrator Aplikasi.
1. Pada tab **Beranda**, pilih **Impor jenis pekerjaan dari file**, dan pilih lokasi`AIJOB.ctmai`.
1. Jika Anda ingin membuat modifikasi apa pun pada contoh yang disediakan, biasakan diri Anda dengan Integrator Aplikasi.
1. Menyebarkan jenis pekerjaan dengan mengikuti petunjuk dalam dokumentasi [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm).
# Buat profil koneksi Control-M untuk AWS Mainframe Modernization
Profil koneksi menentukan atribut koneksi dan kredensi keamanan untuk contoh aplikasi tertentu. Setiap profil koneksi dapat direferensikan oleh beberapa pekerjaan. Anda dapat memiliki profil terpisah untuk setiap kombinasi unik dari aplikasi dan kredensional.
[Untuk [menentukan profil koneksi](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm), Anda dapat menggunakan antarmuka pengguna grafis (GUI) yang tersedia di domain **Konfigurasi** antarmuka Web Control-M, atau Anda dapat menggunakan JSON.](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) Untuk informasi tentang profil koneksi AWS Mainframe Modernization plug-in, lihat dokumentasi [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters).
Kode berikut adalah contoh menggunakan 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
}
}
```
Buat file JSON yang mirip dengan contoh, dan terapkan dengan menggunakan layanan penerapan [Control-M Automation API](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html). Misalnya, jika kode JSON disimpan ke file bernama`cp-MANAGED-M2-REPLATFORM.json`, sintaks `ctm` CLI untuk menyebarkan profil koneksi ini adalah sebagai berikut:
```
ctm deploy cp-MANAGED-M2-REPLATFORM.json
```
Respons dari Control-M Automation API akan mirip dengan berikut ini:
```
[
{
"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"
]
}
]
```
# Buat pekerjaan dan jadwal di Control-M Planning
Sekarang setelah Anda memiliki jenis pekerjaan yang digunakan dan profil koneksi untuk konektivitas AWS, Anda dapat mulai membuat dan menjalankan pekerjaan.
Setiap pekerjaan AWS Mainframe Modernization layanan terdiri dari satu set atribut, dalam empat bagian. Setiap bagian dapat memiliki banyak atribut. Daftar berikut menunjukkan beberapa atribut yang lebih umum digunakan.
+ Umum:
+ Nama pekerjaan
+ Aplikasi dan sub-aplikasi yang dimiliki pekerjaan itu
+ JCL untuk diserahkan
+ Tautan ke dokumentasi
+ Penjadwalan:
+ Bulan dan Hari pekerjaan ini memenuhi syarat untuk dijalankan
+ Kalender seperti periode akuntansi bisnis, hari libur, atau tanggal khusus lainnya yang tidak dapat didefinisikan secara algoritmik
+ Jendela waktu
+ Perilaku siklik
+ Prasyarat:
+ Dependensi hulu (biasanya pekerjaan, yang harus diselesaikan dengan sukses sebelum pekerjaan ini memenuhi syarat untuk dijalankan)
+ Sumber daya yang mungkin diperlukan
+ Tindakan pengguna yang mungkin diperlukan
+ Tindakan yang dilakukan oleh Control-M setelah menyelesaikan pekerjaan:
+ Menentukan keberhasilan atau kegagalan pekerjaan (biasanya berdasarkan kode penyelesaian pekerjaan, tetapi Anda dapat mengganti pengaturan itu untuk menggunakan teks keluaran atau memeriksa status tertentu)
+ Pemberitahuan, seperti email, untuk kegagalan atau keberhasilan
+ Status penerbitan untuk dependensi hilir
Seperti profil koneksi, pekerjaan dapat dibuat dan digunakan [di GUI atau di](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) dan digunakan dengan menggunakan Control-M Automation API.
Bagian berikut memeriksa beberapa skenario alur kerja umum:
+ [Memulai pekerjaan berdasarkan kode status pekerjaan sebelumnya](status-code.md)
+ [Mengotomatiskan pekerjaan berjalan pada frekuensi terjadwal](scheduled.md)
+ [Pekerjaan dasar berjalan pada acara](event-based.md)
# Memulai pekerjaan berdasarkan status pekerjaan sebelumnya
Buat alur pekerjaan yang disebut alur kerja. Pekerjaan dalam alur kerja saling berhubungan dengan ketergantungan pada keberhasilan penyelesaian pekerjaan sebelumnya.
## Menggunakan GUI Web Control-M
Untuk memulai pekerjaan dari antarmuka pengguna Control-M, lakukan hal berikut:
1. Di domain **Perencanaan**, tambahkan **Workspace** baru. Ini membuka kanvas dengan objek folder kosong.
1. Pilih jenis AWS Mainframe Modernization pekerjaan (jika Anda menggunakan template jenis pekerjaan yang disediakan, ini disebut [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json)), dan seret ke folder.
1. Setelah warna jenis pekerjaan berubah menjadi hijau, jatuhkan. **Panel di sebelah kanan berisi bagian **Umum**, **Penjadwalan**, **Prasyarat**, dan Tindakan.** Untuk membuat pekerjaan, lihat instruksi standar dalam dokumentasi [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm).
1. Selanjutnya, Anda memerlukan nilai **Job Name** untuk mengonfigurasi jenis pekerjaan. Anda dapat menemukan nilai **Nama Job** di layar definisi **Aplikasi** AWS Mainframe Modernization konsol atau dengan menjalankan [ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html). Untuk pilot ini, ulangi langkah 2-4 untuk beberapa pekerjaan, beri nama masing-masing dengan nama apa pun yang Anda pilih. Contoh nama adalah`CBANK`,`CURRENCY`, I`NVFUNDS`,`BROKERAGE`,`RISKMGMT`, dan`BANK-SERVICE-Managed-M2`.
1. Untuk menghubungkan pekerjaan ini ke alur yang Anda inginkan, pilih segitiga kondisi di bawah objek pekerjaan, dan seret ke pekerjaan berikutnya. Misalnya, pilih segitiga kondisi di bawah`CBANK`, dan seret ke`CURRENCY`. Tindakan ini membuat `CBANK` pendahulu. `CURRENCY` Secara default, sekarang `CBANK` harus diselesaikan dengan sukses sebelum MATA UANG memenuhi syarat untuk dijalankan.
Screenshot berikut menunjukkan tampilan Control-M Planning dari alur kerja dasar.
![\[Job flow di sebelah kiri dan properti di sebelah kanan.\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png)
*Gambar disediakan milik BMC Software, Inc. ©2022*
## Menggunakan JSON
Aliran yang sama dapat dikodekan di 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"
]
}
}
}
```
Untuk menerapkan alur ini, gunakan layanan penerapan:
```
ctm deploy folder-MANAGED-M2-REPLATFORM.json
```
# Mengotomatiskan pekerjaan berjalan pada frekuensi terjadwal
Menggunakan alur yang Anda buat di langkah sebelumnya, Anda dapat menambahkan penjadwalan dasar dan runtime.
+ Penjadwalan dasar menentukan hari mana pekerjaan dapat dijalankan (misalnya, setiap hari kerja, hanya pada hari kerja, akhir bulan, atau akhir kuartal).
+ Penjadwalan runtime menentukan kapan pekerjaan akan berjalan pada hari yang memenuhi syarat untuk dijalankan (misalnya, setiap jam, setelah sumber daya tertentu tersedia, atau hanya setelah konfirmasi manual).
Anda dapat mengatur penjadwalan dasar dan runtime pada tab **Penjadwalan**.
# Pekerjaan dasar berjalan pada acara
Control-M Managed File Transfer (MFT) adalah FTP/SFTP klien dan server yang dapat Anda gunakan untuk menonton dan mentransfer file antara host lokal dan host jarak jauh. Untuk informasi selengkapnya tentang mendefinisikan tugas Transfer File, lihat dokumentasi [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm).
Pilot ini menggunakan tugas Transfer File untuk mengawasi peristiwa pembuatan file file dengan ekstensi.poc di `/bmcfile` folder dalam bucket S3 bernama. `bmc-poc-bucket` Ketika peristiwa itu terjadi, pekerjaan Control-M dimulai untuk menjalankan pekerjaan berikutnya. Anda dapat secara opsional melewati jalur lengkap, termasuk nama bucket.
# Pantau pekerjaan
Anda dapat memantau dan memvalidasi pemrosesan pekerjaan dalam domain Pemantauan Control-M dan melalui Konsol Manajemen AWS, memastikan pengamatan dan verifikasi komprehensif di kedua platform ini.
## Pemantauan Kontrol-M
Pengajuan dan proses Job dapat dipantau di domain *Control-M* Monitoring. Secara default, pekerjaan AWS Mainframe Modernization layanan akan muncul bersama dengan semua pekerjaan Control-M lainnya. *Jika Anda hanya ingin melihat pekerjaan AWS Mainframe Modernization layanan tanpa beban kerja lain (atau persyaratan pemfilteran lainnya), Anda dapat membuat Sudut Pandang.*
Sudut pandang tidak hanya menunjukkan informasi pekerjaan tetapi juga hubungan dengan dependensi hulu dan hilir. Selain itu, jika alur kerja Anda menyertakan AWS Mainframe Modernization dan jenis pekerjaan Control-M lainnya, Anda dapat melihat dan mengelola seluruh alur di domain Monitoring.
Untuk mengikuti langkah-langkah rinci, lihat [bagian Viewpoints dari Monitoring dalam dokumentasi](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm) Control-M.
Screenshot berikut menunjukkan output dari dua alur kerja. Di sisi kiri, alur kerja diselesaikan dengan sukses dengan semua pekerjaan berwarna hijau. Di sisi kanan, alur kerja hanya sebagian berhasil karena pekerjaan `CURRRENCY` mengembalikan status **Gagal**, yang ditunjukkan oleh warna merah. Alur kerja berhenti di sana, meninggalkan pekerjaan yang tersisa dalam status **Jadwal Tunggu**.
![\[Diagram alur kerja di sebelah kiri, properti pekerjaan di sebelah kanan.\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png)
*Gambar disediakan milik BMC Software, Inc. ©2022*
## Pemantauan di konsol
Untuk melihat informasi pekerjaan dan log AWS, masuk ke Konsol Manajemen AWS, lalu navigasikan ke [AWS Mainframe Modernization konsol](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications).
![\[Pekerjaan dan status terdaftar di konsol Modernisasi AWS Mainframe.\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png)
Tampilan ini tidak menyertakan dependensi atau beban kerja apa pun yang tidak dikelola oleh layanan. AWS Mainframe Modernization