AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ファイル転送エージェントのインストール
このドキュメントをステップバイステップガイドとして使用して、ソースメインフレームにエージェントをインストールできます。
**注記**
このガイドは、メインフレームシステムプログラマー専用です。
**Topics**
+ [ステップ 1: M2-agent 用の zFS データセットを作成する](#allocate-dataset)
+ [ステップ 2: データセットを zFS としてフォーマットする](#format-dataset)
+ [ステップ 3: ファイルシステムをマウントする](#mount-filesystem)
+ [ステップ 4: マウントを確認する](#verify-mount)
+ [ステップ 5: OMV を入力する](#enter-omvs)
+ [ステップ 6: エージェントのインストールディレクトリの環境変数を設定する](#agent-directory)
+ [ステップ 7: 作業ディレクトリの環境変数を設定する](#work-directory)
+ [ステップ 8: 作業ディレクトリを作成する](#create-work-directory)
+ [ステップ 9: エージェント tar ファイルをコピーし、作業ディレクトリをコピーする](#agent-tar-package)
+ [ステップ 10: エージェントのインストールを完了する](#finish-agent-installation)
## ステップ 1: M2-agent 用の zFS データセットを作成する
以下の JCL (ジョブコントロール言語) を使用して M2-agent のインストール用の zFS を作成します。
```
DEFINE EXEC PGM=IDCAMS
SYSPRINT DD SYSOUT=A
SYSIN DD *
DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
VOLUMES(*) -
LINEAR CYL(1000 200))
```
## ステップ 2: データセットを zFS としてフォーマットする
データセットを作成したら、zFS ファイルシステムとしてフォーマットします。
これを行う方法の 1 つは、以下のジョブ制御言語 (JCL) を使用することです。
```
FORMAT EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD SYSOUT=*
```
このジョブを送信し、正常に完了したかどうかを確認してください。
## ステップ 3: ファイルシステムをマウントする
ファイルシステムをマウントするには、`MOUNT` コマンドを使用します。ファイルシステムは ISPF のコマンドラインまたはバッチでマウントできます。
例えば、次のようになります。
```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```
ステップ 6 では、このマウントポイントを使用します。
**注記**
マウントパスの定義はオプションであるため、既存のディレクトリを使用する必要があります。
## ステップ 4: マウントを確認する
`D OMVS,F` コマンドを使用するか UNIX System Service (USS) 内でチェックして、ファイルシステムが正しくマウントされていることを確認します。
## ステップ 5: OMV を入力する
以下のコマンドを使用して、OMV を入力します。
```
TSO OMVS
```
## ステップ 6: エージェントのインストールディレクトリの環境変数を設定する
エージェントのインストールディレクトリ環境を設定するには、以下のコマンドを使用します。
```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```
**注記**
マウントポイントはステップ 3 で定義されます。
## ステップ 7: 作業ディレクトリの環境変数を設定する
以下のコマンドを使用して、作業ディレクトリの環境変数を設定します。
```
export WORK_DIR=$AGENT_DIR/tmp
```
## ステップ 8: 作業ディレクトリを作成する
以下のコマンドを使用して、作業ディレクトリ環境を設定します。
```
mkdir -p $WORK_DIR
```
## ステップ 9: エージェント tar ファイルをコピーし、作業ディレクトリをコピーする
[M2 エージェントリンク](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar)を使用して、AWS からエージェント tar ファイルをダウンロードします。
転送メカニズムは環境によって異なりますが、tar ファイルがバイナリモードで転送されていることを確認してください。
## ステップ 10: エージェントのインストールを完了する
以下のステップに従って、エージェントのインストールを完了します。
1. 以下のコマンドを使用して、m2-agent バージョンの環境変数を現在インストールされているバージョンに設定します。
```
export M2_AGENT_VERSION=1.0.0
```
1. 以下のコマンドを使用して、エージェント tar パッケージを抽出します。
```
tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
```
1. 以下のコマンドを使用して、現在のエージェントインストールディレクトリへの `current-version` シンボリックリンクを作成します。
```
ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
```
1. ファイル転送エージェントデータセットを作成するために、`CPY#PDS` を更新して送信します。
**注記**
JCL は `SYS2.AWS.M2 HLQ` を使用します。
ファイル転送エージェントを作成するには、JCL の後半で使用する 3 つのシンボリック変数 HLQ (ハイレベル修飾子)、`VOLSER` および `AGNTPATH` を更新します。
```
oedit $AGENT_DIR/current-version/installation/CPY#PDS
```
**注記**
この JCL は、メインフレームでのエージェントインストールの特定の要素の設定向けに調整されています。必要なデータセットを割り当ててから、UNIX ファイルシステムから特定のファイルをそれらのデータセットにコピーします。