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.
# Installieren Sie einen File Transfer Agent
Sie können dieses Dokument als step-by-step Leitfaden für die Installation eines Agenten auf dem Quell-Mainframe verwenden.
**Anmerkung**
Dieses Handbuch richtet sich nur an Mainframe-Systemprogrammierer.
**Topics**
+ [Schritt 1: Erstellen Sie einen ZfS-Datensatz für den M2-Agenten](#allocate-dataset)
+ [Schritt 2: Formatieren Sie den Datensatz als ZFS](#format-dataset)
+ [Schritt 3: Mounten Sie das Dateisystem](#mount-filesystem)
+ [Schritt 4: Überprüfen Sie den Mount](#verify-mount)
+ [Schritt 5: Geben Sie OMVS ein](#enter-omvs)
+ [Schritt 6: Legen Sie die Umgebungsvariable für das Installationsverzeichnis des Agenten fest](#agent-directory)
+ [Schritt 7: Legen Sie die Umgebungsvariable für das Arbeitsverzeichnis fest](#work-directory)
+ [Schritt 8: Erstellen Sie das Arbeitsverzeichnis](#create-work-directory)
+ [Schritt 9: Kopieren Sie die Tar-Datei des Agenten und das Arbeitsverzeichnis](#agent-tar-package)
+ [Schritt 10: Beenden Sie die Agenteninstallation](#finish-agent-installation)
## Schritt 1: Erstellen Sie einen ZfS-Datensatz für den M2-Agenten
Erstellen Sie ein ZFS für die M2-Agent-Installation mit der folgenden JCL (Job Control Language):
```
DEFINE EXEC PGM=IDCAMS
SYSPRINT DD SYSOUT=A
SYSIN DD *
DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
VOLUMES(*) -
LINEAR CYL(1000 200))
```
## Schritt 2: Formatieren Sie den Datensatz als ZFS
Nachdem Sie den Datensatz erstellt haben, formatieren Sie ihn als ZFS-Dateisystem.
Eine Möglichkeit, dies zu tun, ist die Verwendung der folgenden JCL:
```
FORMAT EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD SYSOUT=*
```
Reichen Sie diesen Job ein und überprüfen Sie, ob er erfolgreich abgeschlossen wurde.
## Schritt 3: Mounten Sie das Dateisystem
Um das Dateisystem zu mounten, verwenden Sie den `MOUNT` Befehl. Sie können das Dateisystem in der Befehlszeile in ISPF oder im Batch mounten.
Beispiel:
```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```
Sie werden diesen Einhängepunkt in Schritt 6 verwenden.
**Anmerkung**
Die Definition des Einhängepfads ist optional und Sie sollten dafür ein vorhandenes Verzeichnis verwenden.
## Schritt 4: Überprüfen Sie den Mount
Stellen Sie sicher, dass das Dateisystem korrekt gemountet ist. Verwenden Sie dazu einen `D OMVS,F` Befehl oder überprüfen Sie es im Unix System Service (USS).
## Schritt 5: Geben Sie OMVS ein
Verwenden Sie den folgenden Befehl, um OMVS einzugeben:
```
TSO OMVS
```
## Schritt 6: Legen Sie die Umgebungsvariable für das Installationsverzeichnis des Agenten fest
Verwenden Sie den folgenden Befehl, um die Umgebung für das Installationsverzeichnis des Agenten festzulegen:
```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```
**Anmerkung**
Der Einhängepunkt wird in Schritt 3 definiert.
## Schritt 7: Legen Sie die Umgebungsvariable für das Arbeitsverzeichnis fest
Verwenden Sie den folgenden Befehl, um die Umgebungsvariable für das Arbeitsverzeichnis festzulegen:
```
export WORK_DIR=$AGENT_DIR/tmp
```
## Schritt 8: Erstellen Sie das Arbeitsverzeichnis
Verwenden Sie den folgenden Befehl, um die Arbeitsverzeichnisumgebung festzulegen:
```
mkdir -p $WORK_DIR
```
## Schritt 9: Kopieren Sie die Tar-Datei des Agenten und das Arbeitsverzeichnis
Laden Sie die Agent-Tar-Datei über den [M2-Agent-Link](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar) von AWS herunter.
Der Übertragungsmechanismus hängt von Ihrer Umgebung ab. Stellen Sie jedoch sicher, dass die Tar-Datei im Binärmodus übertragen wird.
## Schritt 10: Beenden Sie die Agenteninstallation
Gehen Sie wie folgt vor, um die Agenteninstallation abzuschließen.
1. Stellen Sie die Umgebungsvariable m2-agent-Version mit dem folgenden Befehl auf die Version ein, die gerade installiert wird:
```
export M2_AGENT_VERSION=1.0.0
```
1. Extrahieren Sie das Agenten-Tar-Paket mit dem folgenden Befehl:
```
tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
```
1. Erstellen Sie mit dem folgenden Befehl einen `current-version` symbolischen Link zum aktuellen Agenten-Installationsverzeichnis:
```
ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
```
1. Aktualisieren und abschicken`CPY#PDS`, um die Datensätze des File Transfer Agents zu erstellen.
**Anmerkung**
JCL verwendet die`SYS2.AWS.M2 HLQ`.
Um den File Transfer Agent zu erstellen, aktualisieren Sie die drei symbolischen Variablen HLQ (High Level Qualifier) und`VOLSER`, die später in der `AGNTPATH` JCL verwendet werden sollen:
```
oedit $AGENT_DIR/current-version/installation/CPY#PDS
```
**Anmerkung**
Diese JCL ist auf die Einrichtung bestimmter Aspekte der Agenteninstallation auf dem Mainframe zugeschnitten. Sie weist die erforderlichen Datensätze zu und kopiert dann bestimmte Dateien aus dem Unix-Dateisystem in diese Datensätze.