

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# AWS Mainframe Modernization pada integrasi Amazon EC2 dengan Control-M
<a name="aws-mainframe-modernization-ec2"></a>

Bagian ini menjelaskan bagaimana Control-M terintegrasi dengan dan mendukung pekerjaan batch yang berjalan di lingkungan runtime Modernisasi AWS Mainframe khusus yang diterapkan pada instans EC2. Jika Anda menerapkan AWS Replatform yang dikelola sepenuhnya dengan lingkungan runtime Micro Focus, lihat bagian [AWS Mainframe Modernization Integrasi terkelola dengan Control-M](aws-mainframe-modernization-managed.md).

Bagian ini mengasumsikan prasyarat berikut:
+ Akun AWS aktif.
+ Virtual Private Cloud (VPC) dimana instans EC2 akan dibuat.
+ Aplikasi mainframe dimigrasikan dan berjalan di AWS Replatform dengan lingkungan Micro Focus pada instans EC2 dan mendukung mesin runtime Micro Focus dengan beberapa pekerjaan batch yang ditentukan. Untuk pilot ini, ikuti instruksi di [aplikasi Replatforming dengan Micro](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html) Focus. Dokumentasi mencakup semua tugas dan informasi tambahan tentang mengonfigurasi dan mengoperasikan AWS Replatform dengan lingkungan runtime Micro Focus di Amazon EC2.

Topik berikut ini mencakup penyiapan yang diperlukan untuk integrasi antara Control-M dan AWS Replatform dengan lingkungan Micro Focus:
+ [Menyebarkan sumber daya Control-M dan Micro Focus](deploy-resources-environment.md)
+ [Membuat profil koneksi Control-M](create-control-m-connection-profile.md)
+ [Buat pekerjaan dan jadwal di Control-M Planning](create-jobs-schedules-control-m-planning.md)
+ [Mengelola pekerjaan berjalan di Control-M dengan menggunakan Monitoring](monitor.md)

# Menyebarkan sumber daya Control-M dan Micro Focus
<a name="deploy-resources-environment"></a>

Dua langkah pertama dalam mengintegrasikan AWS Mainframe Modernization dengan Control-M adalah menerapkan Control-M Agent dan kemudian menerapkan plug-in pada Agen. Langkah ketiga adalah menyebarkan jenis pekerjaan di Control-M Application Integrator.

## Menerapkan Agen Control-M pada instans EC2
<a name="deploy-agent"></a>

Saat menggunakan AWS Replatform khusus dengan Micro Focus pada lingkungan runtime Amazon EC2, utilitas `MFBSIFJCL` akan dipanggil. Utilitas beroperasi pada host yang diluncurkan menggunakan penawaran Micro Focus Enterprise Server dari AWS Marketplace. Untuk menjalankan `MFBSIFJCL` utilitas, Anda juga harus menyebarkan Agen Control-M pada host itu. Untuk petunjuk, lihat dokumentasi [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm).

**catatan**  
Anda dapat mengunduh media instalasi yang diperlukan dari [situs Unduhan Produk Elektronik BMC](https://www.bmc.com/support/resources/product-downloads.html).

## Menerapkan plug-in Micro Focus pada Agen Control-M
<a name="deploy-plug-in"></a>

Plug-in menyediakan integrasi dan dukungan untuk aplikasi dan layanan yang diatur oleh Control-M.

Penyebaran plug-in adalah aktivitas yang jarang terjadi. Jika Anda sudah memiliki plug-in yang ingin Anda gunakan, lewati langkah ini, dan buat profil koneksi.

Di Amazon EC2, layanan AWS Mainframe Modernization Replatform dengan Micro Focus memperlihatkan mesin Micro Focus. Untuk mengintegrasikan AWS Mainframe Modernization, Control-M menggunakan plug-in Micro Focus. Untuk informasi selengkapnya, lihat dokumentasi [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html).

Anda harus menyebarkan plug-in ini ke Agen yang diinstal pada host tempat Micro Focus Enterprise Server berjalan.

## Menyebarkan jenis AWS Mainframe Modernization pekerjaan di Control-M Application Integrator
<a name="application-integrator"></a>

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](create-control-m-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):
+ 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.
+ Masuk ke Integrator Aplikasi.
+ Pada tab **Beranda**, pilih **Impor jenis pekerjaan dari file**, dan pilih lokasi`AIM2JOB.ctmai`.
+ Jika Anda ingin membuat modifikasi apa pun pada contoh yang disediakan, biasakan diri Anda dengan Integrator Aplikasi.
+ 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).

# Membuat profil koneksi Control-M
<a name="create-control-m-connection-profile"></a>

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, Anda dapat menggunakan [domain Konfigurasi](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm) antarmuka Web Control-M, atau Anda dapat menggunakan JSON. Kode berikut adalah contoh menggunakan 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": "*****"
  }
}
```

Kode contoh ada di file `ConnectionProfile-Custom-M2-Replatform.json` di GitHub repo. Untuk menerapkan kode, gunakan layanan penerapan Control-M Automation API:

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

Respons dari Control-M Automation API akan mirip dengan berikut ini:

```
[ 
 {
    "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 " ]
  }
]
```

# Buat pekerjaan dan jadwal di Control-M Planning
<a name="create-jobs-schedules-control-m-planning"></a>

Sekarang setelah plug-in digunakan dan profil koneksi untuk konektivitas Micro Focus, Anda dapat mulai membuat dan menjalankan pekerjaan.

Setiap Control-M untuk pekerjaan Micro Focus 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 operasional yang disediakan situs
+ 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 seperti berlari setiap jam
+ 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 dengan [menggunakan Control-M Web](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) atau [ditulis dalam 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 dengan menggunakan alur kerja](initiate-jobs.md)
+ [Mengotomatiskan pekerjaan berjalan pada frekuensi terjadwal](automate-jobs.md)

# Memulai pekerjaan dengan menggunakan alur kerja
<a name="initiate-jobs"></a>

Buat alur pekerjaan yang disebut alur kerja. Pekerjaan dalam alur kerja saling berhubungan dengan ketergantungan pada keberhasilan penyelesaian pekerjaan sebelumnya.

## Menggunakan Control-M Web
<a name="control-m-web"></a>

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. Pada bilah Menu, pilih **Add Job, pilih pekerjaan** Micro Focus Windows atau Micro Focus Linux, dan seret ke bagian depan folder.

1. Setelah warna 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. Untuk petunjuk tentang membangun Control-M untuk pekerjaan Micro Focus, lihat dokumentasi [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob). Untuk pilot ini, ulangi langkah 2-4 untuk lima pekerjaan, beri nama masing-masing dari ke`aws-mf-job1`. `aws-mf-job5`

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`aws-mf-job1`, dan seret ke`aws-mf-job2`. Tindakan ini membuat `aws-mf-job1` pendahulu. `aws-mf-job2` Secara default, sekarang `aws-mf-job1` harus diselesaikan dengan sukses sebelum `aws-mf-job2` memenuhi syarat untuk dijalankan.

Diagram berikut menunjukkan tampilan Control-M Planning dari alur kerja dasar.



![\[Diagram alur kerja, dengan properti di panel sisi kanan.\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png)


*Gambar disediakan milik BMC Software, Inc. ©2022*

## Menggunakan JSON
<a name="json"></a>

Aliran yang sama dapat dikodekan dalam JSON. Dalam GitHub repo, kode contoh ada di file`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"
      ]
    }
  }
}
```

Untuk menerapkan alur ini, gunakan Control-M Automation API:

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

# Mengotomatiskan pekerjaan berjalan pada frekuensi terjadwal
<a name="automate-jobs"></a>

Menggunakan alur yang Anda buat di langkah sebelumnya, Anda dapat menambahkan penjadwalan dasar dan runtime.
+ Penjadwalan dasar menentukan hari mana pekerjaan memenuhi syarat untuk dijalankan (misalnya, setiap hari kerja, hanya pada hari kerja, akhir bulan, atau akhir kuartal). Anda dapat mengatur penjadwalan dasar pada tab [Penjadwalan](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm).
+ Penjadwalan runtime menentukan kapan pekerjaan berjalan pada hari yang memenuhi syarat untuk dijalankan (misalnya, setelah pekerjaan pendahulunya selesai, setiap jam, setelah sumber daya tertentu tersedia, atau hanya setelah konfirmasi manual).

**Anda dapat menentukan beberapa penjadwalan runtime di bagian **Penjadwalan** dan lainnya di bagian Prasyarat.**

# Pantau pekerjaan
<a name="monitor"></a>

Anda dapat memantau dan memverifikasi pekerjaan di domain Control-M Monitoring dan di antarmuka [pengguna Micro Focus Enterprise Server Common Web Administration](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html).

## Pemantauan Kontrol-M
<a name="monitoring"></a>

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.

Anda dapat mengikuti langkah-langkah rinci dengan mengunjungi [bagian Viewpoints dari Monitoring dalam dokumentasi](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm) Control-M.

Tangkapan layar berikut menunjukkan output dari dua alur kerja. Di sisi kiri, alur kerja diselesaikan dengan sukses dengan kelima pekerjaan berwarna hijau. Di sisi kanan, alur kerja hanya sebagian berhasil karena `aws-mf-job3` mengembalikan status **Gagal**, dan alur kerja berhenti di sana, meninggalkan `aws-mf-job5` status **Jadwal Tunggu**.



![\[Diagram alur kerja di sisi kiri, memantau output pada Output tab di panel sisi kanan.\]](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png)


*Gambar disediakan milik BMC Software, Inc. ©2022*