AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section [Modification de la disponibilité de la modernisation du AWS mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Installation d'un agent de transfert de fichiers
Vous pouvez utiliser ce document comme step-by-step guide pour installer un agent sur le mainframe source.
**Note**
Ce guide s'adresse uniquement aux programmeurs de systèmes mainframe.
**Topics**
+ [Étape 1 : créer un ensemble de données ZFS pour l'agent M2](#allocate-dataset)
+ [Étape 2 : Formater l'ensemble de données au format ZFS](#format-dataset)
+ [Étape 3 : monter le système de fichiers](#mount-filesystem)
+ [Étape 4 : vérifier le support](#verify-mount)
+ [Étape 5 : Entrez OMVS](#enter-omvs)
+ [Étape 6 : définir la variable d'environnement du répertoire d'installation de l'agent](#agent-directory)
+ [Étape 7 : définir la variable d'environnement du répertoire de travail](#work-directory)
+ [Étape 8 : Création du répertoire de travail](#create-work-directory)
+ [Étape 9 : Copiez le fichier tar de l'agent et copiez le répertoire de travail](#agent-tar-package)
+ [Étape 10 : terminer l'installation de l'agent](#finish-agent-installation)
## Étape 1 : créer un ensemble de données ZFS pour l'agent M2
Créez un fichier ZFS pour l'installation de l'agent M2 à l'aide du langage JCL (Job Control Language) ci-dessous :
```
DEFINE EXEC PGM=IDCAMS
SYSPRINT DD SYSOUT=A
SYSIN DD *
DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
VOLUMES(*) -
LINEAR CYL(1000 200))
```
## Étape 2 : Formater l'ensemble de données au format ZFS
Après avoir créé le jeu de données, formatez-le en tant que système de fichiers ZFS.
Pour ce faire, vous pouvez utiliser le JCL suivant :
```
FORMAT EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD SYSOUT=*
```
Soumettez cette tâche et vérifiez si elle s'est terminée correctement.
## Étape 3 : monter le système de fichiers
Pour monter le système de fichiers, utilisez la `MOUNT` commande. Vous pouvez monter le système de fichiers en ligne de commande, dans ISPF ou par lots.
Par exemple :
```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```
Vous utiliserez ce point de montage à l'étape 6.
**Note**
La définition du chemin de montage est facultative et vous devez utiliser un répertoire existant pour cela.
## Étape 4 : vérifier le support
Vérifiez que le système de fichiers est correctement monté à l'aide de `D OMVS,F` la commande ou en vérifiant dans Unix System Service (USS).
## Étape 5 : Entrez OMVS
Utilisez la commande suivante pour entrer dans OMVS :
```
TSO OMVS
```
## Étape 6 : définir la variable d'environnement du répertoire d'installation de l'agent
Utilisez la commande suivante pour définir l'environnement du répertoire d'installation de l'agent :
```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```
**Note**
Le point de montage est défini à l'étape 3.
## Étape 7 : définir la variable d'environnement du répertoire de travail
Utilisez la commande suivante pour définir la variable d'environnement du répertoire de travail :
```
export WORK_DIR=$AGENT_DIR/tmp
```
## Étape 8 : Création du répertoire de travail
Utilisez la commande suivante pour définir l'environnement du répertoire de travail :
```
mkdir -p $WORK_DIR
```
## Étape 9 : Copiez le fichier tar de l'agent et copiez le répertoire de travail
Téléchargez le fichier tar de l'agent depuis AWS en utilisant le [lien de l'agent M2](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar).
Le mécanisme de transfert dépend de votre environnement, mais assurez-vous que le fichier tar est transféré en mode binaire.
## Étape 10 : terminer l'installation de l'agent
Suivez ces étapes pour terminer l'installation de l'agent.
1. Définissez la variable d'environnement m2-agent version sur la version actuellement installée à l'aide de la commande suivante :
```
export M2_AGENT_VERSION=1.0.0
```
1. Extrayez le package tar de l'agent à l'aide de la commande suivante :
```
tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
```
1. Créez un lien `current-version` symbolique vers le répertoire d'installation actuel de l'agent à l'aide de la commande suivante :
```
ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
```
1. Mettez à jour et soumettez `CPY#PDS` pour créer les ensembles de données de l'agent de transfert de fichiers.
**Note**
JCL utilise le. `SYS2.AWS.M2 HLQ`
Pour créer l'agent de transfert de fichiers, mettez à jour les trois variables symboliques HLQ (High Level Qualifier)`VOLSER`, `AGNTPATH` à utiliser ultérieurement dans la JCL :
```
oedit $AGENT_DIR/current-version/installation/CPY#PDS
```
**Note**
Cette JCL est conçue pour configurer certains aspects de l'installation de l'agent sur le mainframe. Il alloue les ensembles de données nécessaires, puis copie des fichiers spécifiques du système de fichiers Unix vers ces ensembles de données.