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.

# Verfügbare Batch-Dienstprogramme in AWS Mainframe Modernization
<a name="utilities-m2"></a>

Mainframe-Anwendungen verwenden häufig Batch-Hilfsprogramme, um bestimmte Funktionen auszuführen, z. B. das Sortieren von Daten, das Übertragen von Dateien über FTP, das Laden von Daten in Datenbanken DB2, das Entladen von Daten aus Datenbanken usw.

Wenn Sie Ihre Anwendungen auf AWS Mainframe Modernization migrieren, benötigen Sie funktionsgleiche Ersatzprogramme, die dieselben Aufgaben ausführen können wie die, die Sie auf dem Mainframe verwendet haben. Einige dieser Dienstprogramme sind möglicherweise bereits als Teil der Runtime-Engines für die AWS Mainframe-Modernisierung verfügbar, aber wir bieten die folgenden Ersatz-Utilities an:
+ M2SFTP — ermöglicht die sichere Dateiübertragung mithilfe des SFTP-Protokolls.
+ M2WAIT — wartet eine bestimmte Zeit, bevor mit dem nächsten Schritt in einem Batch-Job fortgefahren wird.
+ TXT2PDF — konvertiert Textdateien in das PDF-Format.
+ M2DFUTIL — bietet Sicherungs-, Wiederherstellungs-, Lösch- und Kopierfunktionen für Datensätze, die der Unterstützung durch das Mainframe-Hilfsprogramm ADRDSSU ähneln.
+ M2RUNCMD — ermöglicht die Ausführung von Befehlen, Skripten und Systemaufrufen von Rocket Software (ehemals Micro Focus) direkt von JCL aus.

Wir haben diese Batch-Dienstprogramme auf der Grundlage von Kundenfeedback entwickelt und so konzipiert, dass sie dieselben Funktionen wie die Mainframe-Utilities bieten. Ziel ist es, Ihren Übergang von der Mainframe-Modernisierung zur AWS Mainframe-Modernisierung so reibungslos wie möglich zu gestalten.

**Topics**
+ [Binärer Standort](#location-utilities)
+ [M2SFTP-Batch-Hilfsprogramm](m2sftp.md)
+ [M2WAIT-Batch-Hilfsprogramm](m2wait.md)
+ [TXT2PDF-Batch-Hilfsprogramm](txt2pdf.md)
+ [M2DFUTIL-Batch-Hilfsprogramm](m2dfutil.md)
+ [M2RUNCMD Batch-Hilfsprogramm](m2runcmd.md)

## Binärer Standort
<a name="location-utilities"></a>

Diese Dienstprogramme sind auf den Produkten Rocket Enterprise Developer (ED) und Rocket Software (ES) vorinstalliert. Sie finden sie für alle Varianten von ED und ES an der folgenden Stelle:
+ 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`

# M2SFTP-Batch-Hilfsprogramm
<a name="m2sftp"></a>

M2SFTP ist ein JCL-Hilfsprogramm, das entwickelt wurde, um sichere Dateiübertragungen zwischen Systemen mithilfe des Secure File Transfer Protocol (SFTP) durchzuführen. Das Programm verwendet den Putty SFTP-Client, um die eigentlichen Dateiübertragungen `psftp` durchzuführen. Das Programm funktioniert ähnlich wie ein Mainframe-FTP-Hilfsprogramm und verwendet Benutzer- und Kennwortauthentifizierung.

**Anmerkung**  
Die Authentifizierung mit öffentlichen Schlüsseln wird nicht unterstützt.

Um Ihr Mainframe-FTP JCLs zur Verwendung von SFTP zu konvertieren, wechseln `PGM=FTP` Sie zu. `PGM=M2SFTP`

**Topics**
+ [Unterstützte Plattformen](#m2sftp-platforms)
+ [Installieren von Abhängigkeiten](#m2sftp-dependencies)
+ [Konfigurieren Sie M2SFTP für Mainframe Modernization Managed AWS](#m2sftp-configure-managed)
+ [M2SFTP für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Beispiel JCLs](#m2sftp-jcl)
+ [Befehlsreferenz für den Putty SFTP (PSFTP) -Client](#m2sftp-cmd-ref)
+ [Nächste Schritte](#m2sftp-next)

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

Sie können M2SFTP auf jeder der folgenden Plattformen verwenden:
+ AWS Von Rocket Software (ehemals Micro Focus) verwaltete Mainframe-Modernisierung
+ Rocket Software Runtime (auf Amazon EC2)
+ Alle Varianten der Produkte Rocket Software Enterprise Developer (ED) und Rocket Software Enterprise Server (ES).

## Installieren von Abhängigkeiten
<a name="m2sftp-dependencies"></a>

**Um den Putty SFTP-Client unter Windows zu installieren**
+ Laden Sie den [PuTTY SFTP-Client](https://www.putty.org/) herunter und installieren Sie ihn.

**Um den Putty SFTP-Client unter Linux zu installieren:**
+ Führen Sie den folgenden Befehl aus, um den Putty SFTP-Client zu installieren:

  ```
    sudo yum -y install putty
  ```

## Konfigurieren Sie M2SFTP für Mainframe Modernization Managed AWS
<a name="m2sftp-configure-managed"></a>

Wenn Ihre migrierten Anwendungen auf AWS Mainframe Modernization Managed laufen, müssen Sie M2SFTP wie folgt konfigurieren.
+ Stellen Sie die entsprechenden Rocket Enterprise Server-Umgebungsvariablen für MFFTP ein. Hier sind ein paar Beispiele:
  + `MFFTP_TEMP_DIR`
  + `MFFTP_SENDEOL`
  + `MFFTP_TIME`
  + `MFFTP_ABEND`

  Sie können so wenige oder so viele dieser Variablen festlegen, wie Sie möchten. Sie können sie mit der `ENVAR DD` Anweisung in Ihrer JCL setzen. Weitere Informationen zu diesen Variablen finden Sie unter [MFFTP-Steuervariablen](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) in der Micro Focus-Dokumentation.

Informationen zum Testen Ihrer Konfiguration finden Sie unter. [Beispiel JCLs](#m2sftp-jcl)

## M2SFTP für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces
<a name="m2sftp-configure-customer-infra"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie M2SFTP wie folgt.

1. Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (`:`), um Pfade unter Linux und Semikolons (`;`) unter Windows zu trennen.
   + 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`

1. Stellen Sie die entsprechenden Rocket Enterprise Server-Umgebungsvariablen für MFFTP ein. Hier sind ein paar Beispiele:
   + `MFFTP_TEMP_DIR`
   + `MFFTP_SENDEOL`
   + `MFFTP_TIME`
   + ``MFFTP\$1ABEND

   Sie können so wenige oder so viele dieser Variablen setzen, wie Sie möchten. Sie können sie mit der `ENVAR DD` Anweisung in Ihrer JCL setzen. Weitere Informationen zu diesen Variablen finden Sie unter [MFFTP-Steuervariablen](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) in der Micro Focus-Dokumentation.

Informationen zum Testen Ihrer Konfiguration finden Sie unter. [Beispiel JCLs](#m2sftp-jcl)

## Beispiel JCLs
<a name="m2sftp-jcl"></a>

Um die Installation zu testen, können Sie eine der folgenden JCL-Beispieldateien verwenden.

**M2 .jcl SFTP1**

Diese JCL zeigt, wie M2SFTP aufgerufen wird, um eine Datei an einen Remote-SFTP-Server zu senden. Beachten Sie die Umgebungsvariablen, die in der Anweisung festgelegt sind. `ENVVAR DD`

```
//M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to send a file to SFTP server* 
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP,
//            PARM='127.0.0.1 (EXIT=99 TIMEOUT 300'
//*
//SYSFTPD  DD  *
RECFM FB
LRECL 80
SBSENDEOL CRLF
MBSENDEOL CRLF
TRAILINGBLANKS FALSE
/*
//NETRC    DD  *
machine 127.0.0.1 login sftpuser password sftppass
/*
//SYSPRINT DD  SYSOUT=*
//OUTPUT   DD  SYSOUT=*
//STDOUT   DD  SYSOUT=*
//INPUT    DD  *
type a
locsite notrailingblanks
cd files
put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf   
put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt
quit
/*
//ENVVAR   DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```

**M2 SFTP2 .jcl**

Diese JCL zeigt, wie M2SFTP aufgerufen wird, um eine Datei von einem Remote-SFTP-Server zu empfangen. Beachten Sie die in der Anweisung festgelegten Umgebungsvariablen. `ENVVAR DD`

```
//M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to receive a file from SFTP server* 
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP
//*
//SYSPRINT DD  SYSOUT=*
//OUTPUT   DD  SYSOUT=*
//STDOUT   DD  SYSOUT=*
//INPUT    DD  *
open 127.0.0.1
sftpuser
sftppass
cd files
locsite recfm=fb lrecl=150
get AWS.M2.CARDDEMO.CARDDATA.PS.txt +
'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace
quit
/*
//ENVVAR   DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```

**Anmerkung**  
Wir empfehlen dringend, FTP-Anmeldeinformationen in einer NETRC-Datei zu speichern und den Zugriff nur auf autorisierte Benutzer zu beschränken.

## Befehlsreferenz für den Putty SFTP (PSFTP) -Client
<a name="m2sftp-cmd-ref"></a>

Der PSFTP-Client unterstützt nicht alle FTP-Befehle. Die folgende Liste zeigt alle Befehle, die PSFTP unterstützt.


| Befehl | Description | 
| --- | --- | 
|  \$1  |  Führen Sie einen lokalen Befehl aus  | 
|  Tschüss  |  Beenden Sie Ihre SFTP-Sitzung  | 
|  cd  |  Ändern Sie Ihr Remote-Arbeitsverzeichnis  | 
|  chmod  |  Dateiberechtigungen und Modi ändern  | 
|  close  |  Beenden Sie Ihre SFTP-Sitzung, aber beenden Sie PSFTP nicht  | 
|  Entf  |  Dateien auf dem Remoteserver löschen  | 
|  dir  |  Entfernte Dateien auflisten  | 
|  exit  |  Beenden Sie Ihre SFTP-Sitzung  | 
|  get  |  Laden Sie eine Datei vom Server auf Ihren lokalen Computer herunter  | 
|  help  |  Gib Hilfe  | 
|  lcd  |  Lokales Arbeitsverzeichnis ändern  | 
|  lpwd  |  Lokales Arbeitsverzeichnis drucken  | 
|  LS  |  Entfernte Dateien auflisten  | 
|  mget  |  Laden Sie mehrere Dateien gleichzeitig herunter  | 
|  mkdir  |  Erstellen Sie Verzeichnisse auf dem Remoteserver  | 
|  mput  |  Laden Sie mehrere Dateien gleichzeitig hoch  | 
|  mv  |  Datei (en) auf dem Remoteserver verschieben oder umbenennen  | 
|  geöffnet  |  Stellen Sie eine Connect zu einem Host her  | 
|  put  |  Laden Sie eine Datei von Ihrem lokalen Computer auf den Server hoch  | 
|  pwd  |  Drucken Sie Ihr Remote-Arbeitsverzeichnis  | 
|  quit  |  Beenden Sie Ihre SFTP-Sitzung  | 
|  bereuen  |  Dateien weiter herunterladen  | 
|  ren  |  Datei (en) auf dem Remoteserver verschieben oder umbenennen  | 
|  wiedergeben  |  Fahren Sie mit dem Hochladen von Dateien fort  | 
|  rm  |  Löschen Sie Dateien auf dem Remoteserver  | 
|  rmdir  |  Entfernen Sie Verzeichnisse auf dem Remoteserver  | 

## Nächste Schritte
<a name="m2sftp-next"></a>

Um Dateien mithilfe von SFTP in Amazon Simple Storage Service hoch- und herunterzuladen, können Sie M2SFTP in Verbindung mit dem verwenden AWS Transfer Family, wie in den folgenden Blogbeiträgen beschrieben.
+ [Verwenden Sie logische AWS SFTP-Verzeichnisse, um einen einfachen Datenverteilungsservice zu erstellen](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Aktivieren Sie die Kennwortauthentifizierung für die Verwendung AWS Transfer for SFTPAWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)

# M2WAIT-Batch-Hilfsprogramm
<a name="m2wait"></a>

M2WAIT ist ein Mainframe-Hilfsprogramm, mit dem Sie eine Wartezeit in Ihren JCL-Skripten einführen können, indem Sie eine Zeitdauer in Sekunden, Minuten oder Stunden angeben. Sie können M2WAIT direkt von JCL aus aufrufen, indem Sie die Zeit, die Sie warten möchten, als Eingabeparameter übergeben. Intern ruft das M2WAIT-Programm das von Rocket Software (ehemals Micro Focus) bereitgestellte Modul auf, `C$SLEEP` um auf eine bestimmte Zeit zu warten.

**Anmerkung**  
Sie können Micro Focus-Aliase verwenden, um das zu ersetzen, was Sie in Ihren JCL-Skripten haben. Weitere Informationen finden Sie unter [JES-Alias](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html) in der Micro Focus-Dokumentation.

**Topics**
+ [Unterstützte Plattformen](#m2wait-platforms)
+ [Konfigurieren Sie M2WAIT für AWS Mainframe-Modernisierung (Managed)](#m2wait-configure-managed)
+ [M2WAIT für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces](#m2wait-configure-customer-infra)
+ [Beispiel JCL](#m2wait-jcl)

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

Sie können M2WAIT auf jeder der folgenden Plattformen verwenden:
+ AWS Von Rocket Software (ehemals Micro Focus) verwaltete Mainframe-Modernisierung
+ Rocket Software Runtime (auf Amazon EC2)
+ Alle Varianten der Produkte Rocket Software Enterprise Developer (ED) und Rocket Software Enterprise Server (ES).

## Konfigurieren Sie M2WAIT für AWS Mainframe-Modernisierung (Managed)
<a name="m2wait-configure-managed"></a>

Wenn Ihre migrierten Anwendungen auf AWS Mainframe Modernization Managed laufen, müssen Sie M2WAIT wie folgt konfigurieren.
+ Verwenden Sie das Programm M2WAIT in Ihrer JCL, indem Sie die Eingabeparameter übergeben, wie unter gezeigt. [Beispiel JCL](#m2wait-jcl)

## M2WAIT für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces
<a name="m2wait-configure-customer-infra"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie M2WAIT wie folgt.

1. Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (`:`), um Pfade unter Linux und Semikolons (`;`) unter Windows zu trennen.
   + 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`

1. Verwenden Sie das Programm M2WAIT in Ihrer JCL, indem Sie den Eingabeparameter übergeben, wie unter gezeigt. [Beispiel JCL](#m2wait-jcl)

## Beispiel JCL
<a name="m2wait-jcl"></a>

Um die Installation zu testen, können Sie das `M2WAIT1.jcl` Programm verwenden.

Diese Beispiel-JCL zeigt, wie man M2WAIT aufruft und ihm mehrere verschiedene Dauern übergibt.

```
//M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Wait for 12 Seconds*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2WAIT,PARM='S012'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 0 Seconds (defaulted to 10 Seconds)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=M2WAIT,PARM='S000'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 1 Minute*
//*-------------------------------------------------------------------**
//*
//STEP03 EXEC PGM=M2WAIT,PARM='M001'
//SYSOUT DD SYSOUT=*
//*
//
```

# TXT2PDF-Batch-Hilfsprogramm
<a name="txt2pdf"></a>

TXT2PDF ist ein Mainframe-Hilfsprogramm, das häufig zum Konvertieren einer Textdatei in eine PDF-Datei verwendet wird. Dieses Programm verwendet denselben Quellcode für TXT2 PDF (z/OSFreeware). Wir haben es so modifiziert, dass es unter der Laufzeitumgebung AWS Mainframe Modernization Rocket Software (ehemals Micro Focus) läuft.

**Topics**
+ [Unterstützte Plattformen](#txt2pdf-platforms)
+ [TXT2PDF für AWS Mainframe Modernization Managed konfigurieren](#txt2pdf-configure-managed)
+ [TXT2PDF für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich WorkSpaces Anwendungen)](#txt2pdf-configure-customer-infra)
+ [Beispiel JCL](#txt2pdf-jcl)
+ [Modifikationen](#txt2pdf-mods)
+ [Referenzen](#txt2pdf-ref)

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

Sie können TXT2 PDF auf jeder der folgenden Plattformen verwenden:
+ AWS Mainframe-Modernisierung, Rocket Software Managed
+ Rocket Software Runtime (auf Amazon EC2)
+ Alle Varianten der Produkte Rocket Enterprise Developer (ED) und Rocket Enterprise Server (ES).

## TXT2PDF für AWS Mainframe Modernization Managed konfigurieren
<a name="txt2pdf-configure-managed"></a>

Wenn Ihre migrierten Anwendungen auf AWS Mainframe Modernization Managed ausgeführt werden, konfigurieren Sie TXT2 PDF wie folgt.
+ Erstellen Sie eine REXX EXEC-Bibliothek mit dem Namen. `AWS.M2.REXX.EXEC` Laden Sie diese [REXX-Module](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) herunter und kopieren Sie sie in die Bibliothek. 
  + `TXT2PDF.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
  + `TXT2PDFD.rex`- TXT2 z/OS PDF-Freeware (unverändert)
  + `TXT2PDFX.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
  + `M2GETOS.rex`- Um den Betriebssystemtyp zu überprüfen (Windows oder Linux)

Informationen zum Testen Ihrer Konfiguration finden Sie unter[Beispiel JCL](#txt2pdf-jcl).

## TXT2PDF für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich WorkSpaces Anwendungen)
<a name="txt2pdf-configure-customer-infra"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie TXT2 PDF wie folgt.

1. Stellen Sie die Rocket Software-Umgebungsvariable `MFREXX_CHARSET` auf den entsprechenden Wert ein, z. B. „`A`“ für ASCII-Daten.
**Wichtig**  
Die Eingabe eines falschen Werts könnte zu Problemen bei der Datenkonvertierung (von EBCDIC nach ASCII) führen, wodurch das resultierende PDF unlesbar oder funktionsunfähig wird. `MFREXX_CHARSET``MF_CHARSET`Wir empfehlen eine entsprechende Einstellung.

1. Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (`:`), um Pfade unter Linux und Semikolons (`;`) unter Windows zu trennen.
   + 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`

1. Erstellen Sie eine REXX EXEC-Bibliothek namens. `AWS.M2.REXX.EXEC`` Laden Sie diese [REXX-Module](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) herunter und kopieren Sie sie in die Bibliothek. 
   + `TXT2PDF.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
   + `TXT2PDFD.rex`- TXT2 z/OS PDF-Freeware (unverändert)
   + `TXT2PDFX.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
   + `M2GETOS.rex`- Um den Betriebssystemtyp zu überprüfen (Windows oder Linux)

Informationen zum Testen Ihrer Konfiguration finden Sie unter[Beispiel JCL](#txt2pdf-jcl).

## Beispiel JCL
<a name="txt2pdf-jcl"></a>

Um die Installation zu testen, können Sie eine der folgenden JCL-Beispieldateien verwenden.

**TXT2PDF1.jcl**

Diese JCL-Beispieldatei verwendet einen DD-Namen für die TXT2 PDF-Konvertierung.

```
//TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL  EXEC PGM=IEFBR14
//* 
//DD01     DD DSN=AWS.M2.TXT2PDF1.PDF.VB,                      
//            DISP=(MOD,DELETE,DELETE)
//*
//DD02     DD DSN=AWS.M2.TXT2PDF1.PDF,                       
//            DISP=(MOD,DELETE,DELETE)
//* 
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC  DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD     DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE   6TH LINE ON THE PAGE 1
THIS IS THE   7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE          
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE   6TH LINE ON THE PAGE 2 
THIS IS THE   7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE                 
/*
//*
//OUTDD    DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0)
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//*
//SYSIN    DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT DD:OUTDD +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//* 
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE   DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR             
//*
//OUTFILE  DD DSN=AWS.M2.TXT2PDF1.PDF,                      
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT   DD SYSOUT=*
//*
//
```

**TXT2PDF2.jcl**

Dieses JCL-Beispiel verwendet einen DSN-Namen für die PDF-Konvertierung. TXT2

```
//TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL  EXEC PGM=IEFBR14
//* 
//DD01     DD DSN=AWS.M2.TXT2PDF2.PDF.VB,                      
//            DISP=(MOD,DELETE,DELETE)
//*
//DD02     DD DSN=AWS.M2.TXT2PDF2.PDF,                       
//            DISP=(MOD,DELETE,DELETE)
//* 
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//* 
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC  DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD     DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE   6TH LINE ON THE PAGE 1
THIS IS THE   7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE          
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE   6TH LINE ON THE PAGE 2 
THIS IS THE   7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE                 
/*
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//*
//SYSIN    DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT 'AWS.M2.TXT2PDF2.PDF.VB' +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE   DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR             
//*
//OUTFILE  DD DSN=AWS.M2.TXT2PDF2.PDF,                      
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT   DD SYSOUT=*
//*
//
```

## Modifikationen
<a name="txt2pdf-mods"></a>

Damit das TXT2 PDF-Programm in der AWS Mainframe Modernization Rocket Software-Laufzeitumgebung ausgeführt werden kann, haben wir die folgenden Änderungen vorgenommen:
+ Änderungen am Quellcode, um die Kompatibilität mit der REXX-Laufzeit von Rocket Software sicherzustellen
+ Änderungen, um sicherzustellen, dass das Programm sowohl auf Windows- als auch auf Linux-Betriebssystemen ausgeführt werden kann
+ Änderungen zur Unterstützung sowohl der EBCDIC- als auch der ASCII-Laufzeit

## Referenzen
<a name="txt2pdf-ref"></a>

TXT2PDF-Referenzen und Quellcode:
+ [Text-zu-PDF-Konverter](https://homerow.net/rexx/txt2pdf/)
+ [z/OSFreeware TCP/IP und Mail-Tools](http://www.lbdsoftware.com/tcpip.html)
+ [TXT2PDF-Benutzerreferenzhandbuch](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf)

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

# M2RUNCMD Batch-Hilfsprogramm
<a name="m2runcmd"></a>

Sie können M2RUNCMD, ein Batch-Hilfsprogramm, verwenden, um Befehle, Skripte und Systemaufrufe von Rocket Software (ehemals Micro Focus) direkt von JCL aus auszuführen, anstatt sie über ein Terminal oder eine Befehlszeile auszuführen. Die Ausgabe der Befehle wird im Spool-Protokoll des Batch-Jobs protokolliert.

**Topics**
+ [Unterstützte Plattformen](#m2runcmd-platforms)
+ [M2RUNCMD für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich 2.0) AppStream](#m2runcmd-configure)
+ [Beispiel JCLs](#m2runcmd-sample-jcls)

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

Sie können M2RUNCMD auf den folgenden Plattformen verwenden:
+ Rocket Software Runtime (auf Amazon EC2)
+  Alle Varianten der Produkte Rocket Software Enterprise Developer (ED) und Rocket Software Enterprise Server (ES).

## M2RUNCMD für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich 2.0) AppStream
<a name="m2runcmd-configure"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie M2RUNCMD wie folgt.
+ Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/index.html?t=GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (:), um Pfade unter Linux und Semikolons (;) unter Windows zu trennen.
  + 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`

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

Um die Installation zu testen, können Sie eines der folgenden Beispiele verwenden JCLs.

 **RUNSCRL1.jcl**

Diese Beispiel-JCL erstellt ein Skript und führt es aus. Im ersten Schritt wird ein Skript mit dem Namen `/tmp/TEST_SCRIPT.sh` und Inhalt aus `SYSUT1` In-Stream-Daten erstellt. Im zweiten Schritt wird die Ausführungsberechtigung festgelegt und das im ersten Schritt erstellte Skript ausgeführt. Sie können sich auch dafür entscheiden, nur den zweiten Schritt auszuführen, um bereits vorhandene Rocket Software- und Systembefehle auszuführen.

```
//RUNSCRL1 JOB 'RUN SCRIPT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//*
//*-------------------------------------------------------------------*
//*  CREATE SCRIPT (LINUX)                                           
//*-------------------------------------------------------------------*
//*
//STEP0010 EXEC PGM=IEBGENER
//*
//SYSPRINT DD SYSOUT=*
//SYSIN    DD DUMMY
//*
//SYSUT1   DD *
#!/bin/bash

set -x

## ECHO PATH ENVIRONMNET VARIABLE
echo $PATH

## CLOSE/DISABLE VSAM FILE
casfile -r$ES_SERVER -oc  -ed -dACCTFIL

## OPEN/ENABLE VSAM FILE
casfile -r$ES_SERVER -ooi -ee -dACCTFIL

exit $?
/*
//SYSUT2   DD DSN=&&TEMP,
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(RECFM=LSEQ,LRECL=300,DSORG=PS,BLKSIZE=0)
//*MFE: %PCDSN='/tmp/TEST_SCRIPT.sh'
//*
//*-------------------------------------------------------------------*
//*   RUN SCRIPT (LINUX)                                              *
//*-------------------------------------------------------------------*
//*
//STEP0020 EXEC PGM=RUNCMD
//*
//SYSOUT  DD  SYSOUT=*
//* 
//SYSIN   DD *
*RUN SCRIPT
 sh /tmp/TEST_SCRIPT.sh
/*
//
```

 **SYSOUT**

Die Ausgabe des Befehls oder Skripts, das ausgeführt wird, wird in das `SYSOUT` Protokoll geschrieben. Für jeden ausgeführten Befehl werden der Befehl, die Ausgabe und der Rückgabecode angezeigt.

```
************ CMD Start ************   
                                                                                    
CMD_STR: sh /tmp/TEST_SCRIPT.sh                                                                                              
CMD_OUT:                                                                                                                                                                                                                             
+ echo /opt/microfocus/EnterpriseServer/bin:/sbin:/bin:/usr/sbin:/usr/bin    
/opt/microfocus/EnterpriseServer/bin:/sbin:/bin:/usr/sbin:/usr/bin           
+ casfile -rMYDEV -oc -ed -dACCTFIL                                                                       
-Return Code:   0                                                                                                         
Highest return code:    0                                                                                                 
+ casfile -rMYDEV -ooi -ee -dACCTFIL                                                                     
-Return Code:   8                                                                                                         
Highest return code:    8                                                                                                 
+ exit 8                                                                                                                  

CMD_RC=8                                                                                                                  

************  CMD End  ************
```

 **RUNCMDL1.jcl**

Diese Beispiel-JCL verwendet RUNCMD, um mehrere Befehle auszuführen.

```
//RUNCMDL1 JOB 'RUN CMD',CLASS=A,MSGCLASS=X,TIME=1440
//*
//*
//*-------------------------------------------------------------------*
//*   RUN SYSTEM COMMANDS                                             *
//*-------------------------------------------------------------------*
//*
//STEP0001 EXEC PGM=RUNCMD
//*
//SYSOUT  DD  SYSOUT=*
//* 
//SYSIN   DD *
*LIST DIRECTORY
 ls
*ECHO PATH ENVIRONMNET VARIABLE
 echo $PATH
/*
//
```