AWS Layanan Modernisasi Mainframe (Managed Runtime Environment experience) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Layanan Modernisasi AWS Mainframe (pengalaman Lingkungan Runtime Terkelola), jelajahi Layanan Modernisasi AWS Mainframe (Pengalaman yang Dikelola Sendiri). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan [AWS ketersediaan Modernisasi Mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

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

# Instal agen Transfer File
<a name="m2-agent-installation"></a>

Anda dapat menggunakan dokumen ini sebagai step-by-step panduan untuk menginstal agen pada mainframe sumber.

**catatan**  
Panduan ini hanya untuk programmer sistem mainframe.

**Topics**
+ [Langkah 1: Buat kumpulan data ZFs untuk M2-Agent](#allocate-dataset)
+ [Langkah 2: Format kumpulan data sebagai ZFs](#format-dataset)
+ [Langkah 3: Pasang sistem file](#mount-filesystem)
+ [Langkah 4: Verifikasi mount](#verify-mount)
+ [Langkah 5: Masukkan OMVS](#enter-omvs)
+ [Langkah 6: Mengatur variabel lingkungan direktori instalasi agen](#agent-directory)
+ [Langkah 7: Mengatur variabel lingkungan direktori kerja](#work-directory)
+ [Langkah 8: Buat direktori kerja](#create-work-directory)
+ [Langkah 9: Salin file tar agen dan salin direktori kerja](#agent-tar-package)
+ [Langkah 10: Selesaikan instalasi agen](#finish-agent-installation)

## Langkah 1: Buat kumpulan data ZFs untuk M2-Agent
<a name="allocate-dataset"></a>

Buat ZF untuk instalasi M2-Agent menggunakan JCL (Job Control Language) di bawah ini:

```
DEFINE   EXEC   PGM=IDCAMS
SYSPRINT DD     SYSOUT=A
SYSIN    DD     *
 DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
 VOLUMES(*) -
 LINEAR CYL(1000 200))
```

## Langkah 2: Format kumpulan data sebagai ZFs
<a name="format-dataset"></a>

Setelah membuat kumpulan data, formatlah sebagai sistem file ZFs.

Salah satu cara untuk melakukannya adalah dengan menggunakan JCL berikut:

```
FORMAT  EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD  SYSOUT=*
```

Kirimkan pekerjaan ini dan periksa apakah berhasil diselesaikan.

## Langkah 3: Pasang sistem file
<a name="mount-filesystem"></a>

Untuk me-mount sistem file, gunakan perintah. `MOUNT` Anda dapat memasang sistem file di baris perintah di ISPF atau dalam batch.

Contoh:

```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```

Anda akan menggunakan titik pemasangan ini pada langkah 6.

**catatan**  
Mendefinisikan jalur pemasangan adalah opsional dan Anda harus menggunakan direktori yang ada untuk ini.

## Langkah 4: Verifikasi mount
<a name="verify-mount"></a>

Verifikasi bahwa sistem file dipasang dengan benar menggunakan `D OMVS,F` perintah atau dengan memeriksa dalam Unix System Service (USS).

## Langkah 5: Masukkan OMVS
<a name="enter-omvs"></a>

Gunakan perintah berikut untuk memasukkan OMVS:

```
TSO OMVS
```

## Langkah 6: Mengatur variabel lingkungan direktori instalasi agen
<a name="agent-directory"></a>

Gunakan perintah berikut untuk mengatur lingkungan direktori instalasi agen:

```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```

**catatan**  
Titik pemasangan didefinisikan pada langkah 3.

## Langkah 7: Mengatur variabel lingkungan direktori kerja
<a name="work-directory"></a>

Gunakan perintah berikut untuk mengatur variabel lingkungan direktori kerja:

```
export WORK_DIR=$AGENT_DIR/tmp
```

## Langkah 8: Buat direktori kerja
<a name="create-work-directory"></a>

Gunakan perintah berikut untuk mengatur lingkungan direktori kerja:

```
mkdir -p $WORK_DIR
```

## Langkah 9: Salin file tar agen dan salin direktori kerja
<a name="agent-tar-package"></a>

Unduh file tar agen dari AWS menggunakan [tautan agen M2](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar).

Mekanisme transfer akan tergantung pada lingkungan Anda, tetapi pastikan bahwa file tar ditransfer dalam mode biner.

## Langkah 10: Selesaikan instalasi agen
<a name="finish-agent-installation"></a>

Ikuti langkah-langkah ini untuk menyelesaikan instalasi agen.

1. Setel variabel lingkungan versi m2-agent ke versi yang sedang diinstal menggunakan perintah berikut:

   ```
   export M2_AGENT_VERSION=1.0.0
   ```

1. Ekstrak paket agen tar menggunakan perintah berikut:

   ```
   tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
   ```

1. Buat tautan `current-version` simbolis ke direktori instalasi agen saat ini dengan perintah berikut:

   ```
   ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
   ```

1. Perbarui dan kirimkan `CPY#PDS` untuk membuat kumpulan data agen Transfer File.
**catatan**  
JCL menggunakan. `SYS2.AWS.M2 HLQ`

   Untuk membuat agen Transfer File, perbarui tiga variabel simbolik HLQ (kualifikasi tingkat tinggi)`VOLSER`, dan `AGNTPATH` untuk digunakan nanti di JCL:

   ```
   oedit $AGENT_DIR/current-version/installation/CPY#PDS 
   ```

**catatan**  
JCL ini dirancang untuk menyiapkan aspek-aspek tertentu dari instalasi agen pada mainframe. Ini mengalokasikan set data yang diperlukan dan kemudian menyalin file tertentu dari sistem file Unix ke set data ini.