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.

# Utilitas batch M2DFUTIL
<a name="m2dfutil"></a>

M2DFUTIL adalah program utilitas JCL yang menyediakan fungsi backup, restore, delete, dan copy pada dataset, mirip dengan dukungan yang disediakan oleh utilitas mainframe ADRDSSU. Program ini mempertahankan banyak parameter SYSIN dari ADRDSSU, yang merampingkan proses untuk bermigrasi ke utilitas baru ini.

**Topics**
+ [

## Platform yang didukung
](#m2dfutil-platforms)
+ [

## Persyaratan platform
](#m2dfutil-platform)
+ [

## Dukungan future yang direncanakan
](#m2udfutil-future-support)
+ [

## Lokasi aset
](#mdfutil-assets)
+ [

## Konfigurasikan runtime Modernisasi M2DFUTIL atau AWS Mainframe di Amazon EC2 (termasuk 2.0) AppStream
](#mdfutil-dependencies)
+ [

## Sintaks umum
](#mdfutil-syntax)
+ [

## Sampel JCLs
](#mdfutil-sample-jcls)

## Platform yang didukung
<a name="m2dfutil-platforms"></a>

Anda dapat menggunakan M2DFUTIL di salah satu platform berikut:
+ Perangkat Lunak Rocket (sebelumnya Micro Focus) ES pada Windows (64 bit dan 32 bit)
+ Perangkat Lunak Roket ES di Linux (64 bit)

## Persyaratan platform
<a name="m2dfutil-platform"></a>

M2DFUTIL bergantung pada memanggil skrip untuk melakukan tes ekspresi reguler. Di Windows, Anda harus menginstal Windows Services for Linux (WSL) agar skrip ini dapat dijalankan.

## Dukungan future yang direncanakan
<a name="m2udfutil-future-support"></a>

Fitur yang saat ini tidak tersedia dari utilitas ADRDSSU mainframe, tetapi berada dalam lingkup future meliputi: 
+ M2 Dikelola
+ VSAM
+ Dukungan COPY untuk penggantian nama file
+ Ganti nama dukungan untuk RESTORE 
+ Beberapa INCLUDE dan EXCLUDE
+ BY klausa untuk subpemilihan oleh DSORG, CREDT, EXPDT
+ Klausa MWAIT untuk mencoba lagi kegagalan enqueue
+ Dukungan penyimpanan S3 untuk DUMP/RESTORE

## Lokasi aset
<a name="mdfutil-assets"></a>

Modul beban untuk utilitas ini disebut `M2DFUTIL.so` di Linux dan `M2DFUTIL.dll` Windows. Modul beban ini dapat ditemukan di lokasi berikut:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

Script yang digunakan untuk pengujian ekspresi reguler disebut`compare.sh`. Skrip ini dapat ditemukan di lokasi berikut:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 bit): `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Konfigurasikan runtime Modernisasi M2DFUTIL atau AWS Mainframe di Amazon EC2 (termasuk 2.0) AppStream
<a name="mdfutil-dependencies"></a>

Konfigurasikan wilayah Server Perusahaan Anda dengan yang berikut:
+ Tambahkan variabel berikut di **[ES-Environment**]
  + `M2DFUTILS_BASE_LOC`- Lokasi default untuk output DUMP
  + `M2DFUTILS_SCRIPTPATH`- Lokasi `compare.sh` skrip yang didokumentasikan di **Lokasi Aset**
  + `M2DFUTILS_VERBOSE`- [VERBOSE atau NORMAL]. Ini mengontrol tingkat detail dalam `SYSPRINT ` output
+ Verifikasi bahwa jalur modul beban ditambahkan ke `JES\Configuration\JES Program Path` pengaturan
+ Verifikasi bahwa skrip di direktori utilitas telah menjalankan izin. Anda dapat menambahkan izin jalankan menggunakan `chmod + x <script name>` perintah, di lingkungan Linux

## Sintaks umum
<a name="mdfutil-syntax"></a>

### MEMBUANG
<a name="mdfutil-dump"></a>

Menyediakan kemampuan untuk menyalin file dari lokasi katalog saat ini ke lokasi cadangan. Lokasi ini saat ini harus berupa sistem file.

#### Proses
<a name="mdfutil-dump-process"></a>

DUMP akan melakukan hal berikut:

1. Buat direktori lokasi target.

1. Katalog direktori lokasi target sebagai anggota PDS.

1. Tentukan file yang akan disertakan dengan memproses parameter INCLUDE.

1. Hapus pilihan file yang disertakan dengan memproses parameter EXCLUDE.

1. Tentukan apakah file yang dibuang akan DIHAPUS.

1. Enqueue file yang akan diproses.

1. Salin file.

1. Ekspor file yang disalin yang dikatalogkan informasi DCB ke file samping di lokasi target untuk membantu operasi RESTORE future.

#### Sintaksis
<a name="mdfutil-dump-syntax"></a>

```
DUMP
TARGET ( TARGET LOCATION  )    -
INCLUDE ( DSN. )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Parameter yang diperlukan
<a name="mdfutil-dump-requiredparam"></a>

Berikut ini adalah parameter yang diperlukan untuk DUMP:
+ `SYSPRINT DD NAME`- Untuk memuat informasi pencatatan tambahan
+ `TARGET`- Lokasi target. Itu bisa berupa:
  + Jalur lengkap lokasi pembuangan
  + Nama subdirektori dibuat di lokasi yang ditentukan dalam variabel **M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid
+ `EXCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid

#### Parameter opsional
<a name="mdfutil-dump-optionalparam"></a>
+ BATAL - Batalkan jika terjadi kesalahan. File yang diproses akan disimpan
+ (Default) IGNORE - Abaikan kesalahan dan proses sampai akhir
+ DELETE - Jika tidak ada kesalahan ENQ terjadi, maka file tersebut dihapus dan tidak dikatalogkan

### DELETE
<a name="mdfutil-delete"></a>

Memberikan kemampuan untuk menghapus massal dan file uncatalog. File tidak dicadangkan.

#### Proses
<a name="mdfutil-delete-process"></a>

DELETE akan melakukan hal berikut:

1. Tentukan file yang akan disertakan dengan memproses parameter INCLUDE.

1. Hapus pilihan file yang disertakan dengan memproses parameter EXCLUDE.

1. Enqueue file yang akan diproses. Mengatur disposisi ke OLD, DELETE, KEEP.

#### Sintaksis
<a name="mdfutil-delete-syntax"></a>

```
DELETE
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Parameter yang diperlukan
<a name="mdfutil-delete-requiredparam"></a>

Berikut ini adalah parameter yang diperlukan untuk DELETE:
+ `SYSPRINT DD NAME`- Untuk memuat informasi pencatatan tambahan
+ `INCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid 
+ `EXCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid 

#### Parameter opsional
<a name="mdfutil-delete-optionalparam"></a>
+ BATAL - Batalkan jika terjadi kesalahan. File yang diproses akan disimpan 
+ (Default) IGNORE - Abaikan kesalahan dan proses sampai akhir

### MEMULIHKAN
<a name="mdfutil-restore"></a>

Memberikan kemampuan untuk memulihkan file yang sebelumnya dicadangkan menggunakan DUMP. File dikembalikan ke lokasi katalog asli kecuali RENAME digunakan untuk mengubah DSNAME yang dipulihkan.

#### Proses
<a name="mdfutil-restore-process"></a>

RESTORE akan melakukan hal berikut:

1. Validasi direktori lokasi sumber.

1. Tentukan file yang akan disertakan dengan memproses file ekspor katalog.

1. Hapus pilihan file yang disertakan dengan memproses parameter EXCLUDE.

1. Enqueue file yang akan diproses.

1. File katalog yang tidak dikatalogkan berdasarkan informasi ekspornya.

1. Jika file sudah dikatalogkan dan informasi katalog ekspor sama, RESTORE akan menggantikan kumpulan data yang dikatalogkan jika opsi REPLACE disetel.

#### Sintaksis
<a name="mdfutil-restore-syntax"></a>

```
RESTORE
SOURCE ( TARGET LOCATION ) 
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ REPLACE]
```

#### Parameter yang diperlukan
<a name="mdfutil-restore-requiredparam"></a>

Berikut ini adalah parameter yang diperlukan untuk RESTORE:
+ `SYSPRINT DD NAME`- Untuk memuat informasi pencatatan tambahan 
+ `SOURCE`- Lokasi sumber. Itu bisa berupa:
  + Jalur lengkap lokasi pembuangan
  + Nama subdirektori dibuat di lokasi yang ditentukan dalam variabel **M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid
+ `EXCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid

#### Parameter opsional
<a name="mdfutil-restore-optionalparam"></a>
+ BATAL - Batalkan jika ada kesalahan. File yang diproses dipertahankan
+ (Default) IGNORE - Abaikan kesalahan dan proses sampai akhir
+ REPLACE - Jika file yang dipulihkan sudah dikatalogkan dan catatan katalognya sama, maka ganti file yang dikatalogkan

## Sampel JCLs
<a name="mdfutil-sample-jcls"></a>

 **Pekerjaan DUMP**

Pekerjaan ini akan membuat subdirektori yang disebut`TESTDUMP`. Ini adalah lokasi cadangan default yang ditentukan oleh variabel **M2DFUTILS\$1BASE\$1LOC**. Ini akan membuat pustaka PDS untuk cadangan ini disebut`M2DFUTILS.TESTDUMP`. Data katalog yang diekspor disimpan dalam file berurutan baris di direktori cadangan yang disebut. `CATDUMP.DAT` Semua file yang dipilih akan disalin ke direktori cadangan ini.

```
//M2DFDMP JOB 'M2DFDMP',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDUMP.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSIN    DD *
DUMP TARGET(TESTDUMP)               -
     INCLUDE(TEST.FB.FILE*.ABC)     -
 CANCEL
/*
//
```

 **HAPUS pekerjaan**

Pekerjaan ini akan menghapus semua file dari katalog yang cocok dengan parameter INCLUDE.

```
/M2DFDEL JOB 'M2DFDEL',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDEL.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN    DD *
  DELETE                               -
     INCLUDE(TEST.FB.FILE*.ABC)        -
 CANCEL
/*
 //
```

 **MENGEMBALIKAN pekerjaan**

Pekerjaan ini akan mengembalikan file yang cocok dengan parameter INCLUDE dari lokasi `TESTDUMP` cadangan. File yang dikatalogkan akan diganti jika file yang dikatalogkan sama dengan yang ada di ekspor CATDUMP dan opsi REPLACE ditentukan.

```
//M2DFREST JOB 'M2DFREST',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
////SYSPRINT DD DSN=TESTREST.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN    DD *
RESTORE SOURCE(TESTDUMP)               -
     INCLUDE(TEST.FB.FILE*.ABC)        -
 IGNORE
 REPLACE
/*
//
```