AWS Der Mainframe Modernization Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem AWS Mainframe Modernization Service (Managed Runtime Environment-Erfahrung) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-Managed Experience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# M2DFUTIL-Batch-Hilfsprogramm
<a name="m2dfutil"></a>

M2DFUTIL ist ein JCL-Hilfsprogramm, das Sicherungs-, Wiederherstellungs-, Lösch- und Kopierfunktionen für Datensätze bereitstellt, ähnlich der Unterstützung durch das Mainframe-Hilfsprogramm ADRDSSU. Dieses Programm behält viele der SYSIN-Parameter von ADRDSSU bei, wodurch der Prozess zur Migration zu diesem neuen Hilfsprogramm optimiert wird.

**Topics**
+ [Unterstützte Plattformen](#m2dfutil-platforms)
+ [Anforderungen an die Plattform](#m2dfutil-platform)
+ [Geplante future Unterstützung](#m2udfutil-future-support)
+ [Standorte von Vermögenswerten](#mdfutil-assets)
+ [Konfiguration von M2DFUTIL oder AWS Mainframe Modernization Runtime auf Amazon EC2 (einschließlich 2.0) AppStream](#mdfutil-dependencies)
+ [Allgemeine Syntax](#mdfutil-syntax)
+ [Beispiel JCLs](#mdfutil-sample-jcls)

## Unterstützte Plattformen
<a name="m2dfutil-platforms"></a>

Sie können M2DFUTIL auf jeder der folgenden Plattformen verwenden:
+ Rocket Software (ehemals Micro Focus) ES unter Windows (64 Bit und 32 Bit)
+ Rocket Software ES auf Linux (64 Bit)

## Anforderungen an die Plattform
<a name="m2dfutil-platform"></a>

M2DFUTIL hängt davon ab, dass ein Skript aufgerufen wird, um einen Test mit regulären Ausdrücken durchzuführen. Unter Windows müssen Sie Windows Services for Linux (WSL) installieren, damit dieses Skript ausgeführt werden kann.

## Geplante future Unterstützung
<a name="m2udfutil-future-support"></a>

Zu den Funktionen, die derzeit nicht über das Mainframe-Hilfsprogramm ADRDSSU verfügbar sind, aber in future verfügbar sein werden, gehören: 
+ M2 verwaltet
+ VSAM
+ COPY-Unterstützung für das Umbenennen von Dateinamen
+ RENAME-Unterstützung für RESTORE 
+ Mehrfach INCLUDE und EXCLUDE
+ BY-Klausel für die Unterauswahl nach DSORG, CREDT, EXPDT
+ MWAIT-Klausel zum erneuten Versuch, Fehler in der Warteschlange zu wiederholen
+ S3-Speicherunterstützung für DUMP/RESTORE

## Standorte von Vermögenswerten
<a name="mdfutil-assets"></a>

Das Lademodul für dieses Hilfsprogramm wird `M2DFUTIL.so` unter Linux und `M2DFUTIL.dll` Windows aufgerufen. Dieses Lademodul befindet sich an den folgenden Orten:
+ 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`

Das für das Testen regulärer Ausdrücke verwendete Skript wird aufgerufen`compare.sh`. Dieses Skript befindet sich an den folgenden Orten:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 Bit): `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Konfiguration von M2DFUTIL oder AWS Mainframe Modernization Runtime auf Amazon EC2 (einschließlich 2.0) AppStream
<a name="mdfutil-dependencies"></a>

Konfigurieren Sie Ihre Enterprise Server-Region wie folgt:
+ Fügen Sie die folgenden Variablen in **[ES-Environment**] hinzu
  + `M2DFUTILS_BASE_LOC`- Der Standardspeicherort für die DUMP-Ausgabe
  + `M2DFUTILS_SCRIPTPATH`— Der unter **Asset** Locations dokumentierte Speicherort des `compare.sh` Skripts
  + `M2DFUTILS_VERBOSE`- [AUSFÜHRLICH oder NORMAL]. Dies steuert den Detaillierungsgrad der Ausgabe `SYSPRINT `
+ Stellen Sie sicher, dass der Pfad zum Lademodul der `JES\Configuration\JES Program Path` Einstellung hinzugefügt wurde
+ Stellen Sie sicher, dass die Skripts im Verzeichnis der Dienstprogramme über Ausführungsberechtigungen verfügen. In der Linux-Umgebung können Sie mit dem `chmod + x <script name>` Befehl eine Ausführungsberechtigung hinzufügen

## Allgemeine Syntax
<a name="mdfutil-syntax"></a>

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

Bietet die Möglichkeit, Dateien vom aktuellen katalogisierten Speicherort an einen Backup-Speicherort zu kopieren. Bei diesem Speicherort muss es sich derzeit um ein Dateisystem handeln.

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

DUMP führt Folgendes aus:

1. Erstellen Sie das Zielverzeichnis.

1. Katalogisieren Sie das Zielverzeichnis als PDS-Mitglied.

1. Ermitteln Sie, welche Dateien eingeschlossen werden sollen, indem Sie den INCLUDE-Parameter verarbeiten.

1. Deaktivieren Sie die eingeschlossenen Dateien, indem Sie den EXCLUDE-Parameter verarbeiten.

1. Ermitteln Sie, ob die ausgegebenen Dateien GELÖSCHT werden sollen.

1. Stellen Sie die zu verarbeitenden Dateien in eine Warteschlange.

1. Kopieren Sie die Dateien.

1. Exportieren Sie die katalogisierten DCB-Informationen der kopierten Dateien in eine Nebendatei am Zielort, um future RESTORE-Operationen zu unterstützen.

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

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

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

Im Folgenden sind die erforderlichen Parameter für DUMP aufgeführt:
+ `SYSPRINT DD NAME`- Um zusätzliche Protokollierungsinformationen zu enthalten
+ `TARGET`- Zielort. Dies kann folgendes sein:
  + Vollständiger Pfad des Speicherorts
  + **Name des Unterverzeichnisses, das an dem in der Variablen M2DFUTILS\$1BASE\$1LOC definierten Speicherort erstellt wurde**
+ `INCLUDE`— Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge
+ `EXCLUDE`- Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge

#### Optionale Parameter
<a name="mdfutil-dump-optionalparam"></a>
+ CANCEL — Stornieren Sie den Vorgang, falls ein Fehler auftritt. Dateien, die verarbeitet wurden, werden beibehalten
+ (Standard) IGNORE — Ignoriert jeden Fehler und verarbeitet den Vorgang bis zum Ende
+ DELETE — Wenn kein ENQ-Fehler auftritt, wird die Datei gelöscht und nicht katalogisiert

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

Bietet die Möglichkeit, Dateien massenweise zu löschen und deren Katalogisierung aufzuheben. Dateien werden nicht gesichert.

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

DELETE führt Folgendes aus:

1. Ermitteln Sie, welche Dateien eingeschlossen werden sollen, indem Sie den INCLUDE-Parameter verarbeiten.

1. Deaktivieren Sie die eingeschlossenen Dateien, indem Sie den EXCLUDE-Parameter verarbeiten.

1. Stellen Sie die zu verarbeitenden Dateien in die Warteschlange. Setzen Sie die Disposition auf OLD, DELETE, KEEP.

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

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

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

Im Folgenden sind die erforderlichen Parameter für DELETE aufgeführt:
+ `SYSPRINT DD NAME`- Um zusätzliche Protokollierungsinformationen zu enthalten
+ `INCLUDE`— Entweder ein einzelner benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge 
+ `EXCLUDE`- Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge 

#### Optionale Parameter
<a name="mdfutil-delete-optionalparam"></a>
+ CANCEL — Stornieren Sie den Vorgang, falls ein Fehler auftritt. Verarbeitete Dateien werden beibehalten 
+ (Standard) IGNORE — Ignoriert jeden Fehler und verarbeitet den Vorgang bis zum Ende

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

Bietet die Möglichkeit, Dateien wiederherzustellen, die zuvor mit DUMP gesichert wurden. Dateien werden am ursprünglichen katalogisierten Speicherort wiederhergestellt, sofern RENAME nicht verwendet wird, um den wiederhergestellten DSNAME zu ändern.

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

RESTORE führt Folgendes aus:

1. Überprüfen Sie das Quellverzeichnis.

1. Ermitteln Sie, welche Dateien aufgenommen werden sollen, indem Sie die Katalogexportdatei verarbeiten.

1. Deaktivieren Sie die eingeschlossenen Dateien, indem Sie den EXCLUDE-Parameter verarbeiten.

1. Stellen Sie die zu verarbeitenden Dateien in die Warteschlange.

1. Katalogdateien, die nicht anhand ihrer Exportinformationen katalogisiert wurden.

1. Wenn eine Datei bereits katalogisiert ist und die Exportkataloginformationen identisch sind, ersetzt RESTORE den katalogisierten Datensatz, sofern die Option REPLACE gesetzt ist.

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

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

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

Im Folgenden sind die erforderlichen Parameter für RESTORE aufgeführt:
+ `SYSPRINT DD NAME`— Um zusätzliche Protokollierungsinformationen zu enthalten 
+ `SOURCE`- Standort der Quelle. Dies kann folgendes sein:
  + Vollständiger Pfad des Speicherorts
  + **Name des Unterverzeichnisses, das an dem in der Variablen M2DFUTILS\$1BASE\$1LOC definierten Speicherort erstellt wurde**
+ `INCLUDE`— Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge
+ `EXCLUDE`- Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge

#### Optionale Parameter
<a name="mdfutil-restore-optionalparam"></a>
+ ABBRECHEN — Stornieren, falls ein Fehler auftritt. Verarbeitete Dateien wurden beibehalten
+ (Standard) IGNORE — Ignoriert jeden Fehler und verarbeitet den Vorgang bis zum Ende
+ REPLACE — Wenn die wiederherzustellende Datei bereits katalogisiert ist und die Katalogdatensätze identisch sind, ersetzen Sie die katalogisierte Datei

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

 **DUMP-Job**

Dieser Job erstellt ein Unterverzeichnis namens. `TESTDUMP` Dies ist der Standardspeicherort für Backups, der durch die Variable **M2DFUTILS\$1BASE\$1LOC** angegeben wird. Es erstellt eine PDS-Bibliothek für dieses Backup namens. `M2DFUTILS.TESTDUMP` Die exportierten Katalogdaten werden in einer zeilensequentiellen Datei im Backup-Verzeichnis namens gespeichert. `CATDUMP.DAT` Alle ausgewählten Dateien werden in dieses Backup-Verzeichnis kopiert.

```
//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
/*
//
```

 **Job LÖSCHEN**

Dieser Job löscht alle Dateien aus dem Katalog, die dem INCLUDE-Parameter entsprechen.

```
/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
/*
 //
```

 **Job WIEDERHERSTELLEN**

Dieser Job stellt die Dateien, die dem INCLUDE-Parameter entsprechen, aus dem `TESTDUMP` Backup-Speicherort wieder her. Katalogisierte Dateien werden ersetzt, wenn die katalogisierte Datei mit der Datei im CATDUMP-Export übereinstimmt und die Option REPLACE angegeben ist.

```
//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
/*
//
```