AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS 大型主機現代化可用性變更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 安裝檔案傳輸代理程式
<a name="m2-agent-installation"></a>

您可以使用本文件做為step-by-step指南，在來源大型主機上安裝 代理程式。

**注意**  
本指南僅適用於大型主機系統程式設計人員。

**Topics**
+ [步驟 1：建立 M2-agent程式的 zFS 資料集](#allocate-dataset)
+ [步驟 2：將資料集格式化為 zFS](#format-dataset)
+ [步驟 3：掛載檔案系統](#mount-filesystem)
+ [步驟 4：驗證掛載](#verify-mount)
+ [步驟 5：輸入 OMVS](#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 資料集
<a name="allocate-dataset"></a>

使用下列 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
<a name="format-dataset"></a>

建立資料集後，將其格式化為 zFS 檔案系統。

其中一種方法是使用下列 JCL：

```
FORMAT  EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD  SYSOUT=*
```

提交此任務並檢查是否成功完成。

## 步驟 3：掛載檔案系統
<a name="mount-filesystem"></a>

若要掛載檔案系統，請使用 `MOUNT`命令。您可以在 ISPF 或 批次的命令列中掛載檔案系統。

例如：

```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```

您將在步驟 6 中使用此掛載點。

**注意**  
定義掛載路徑是選用的，您應該為此使用現有的目錄。

## 步驟 4：驗證掛載
<a name="verify-mount"></a>

使用 `D OMVS,F`命令或在 Unix System Service (USS) 中檢查，確認檔案系統已正確掛載。

## 步驟 5：輸入 OMVS
<a name="enter-omvs"></a>

使用下列命令來輸入 OMVS：

```
TSO OMVS
```

## 步驟 6：設定代理程式安裝目錄環境變數
<a name="agent-directory"></a>

使用下列命令來設定代理程式安裝目錄環境：

```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```

**注意**  
掛載點在步驟 3 中定義。

## 步驟 7：設定工作目錄環境變數
<a name="work-directory"></a>

使用下列命令來設定工作目錄環境變數：

```
export WORK_DIR=$AGENT_DIR/tmp
```

## 步驟 8：建立工作目錄
<a name="create-work-directory"></a>

使用下列命令來設定工作目錄環境：

```
mkdir -p $WORK_DIR
```

## 步驟 9：複製代理程式 tar 檔案並複製工作目錄
<a name="agent-tar-package"></a>

使用 [ M2 代理程式連結從 AWS 下載代理程式](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar) tar 檔案。

傳輸機制將取決於您的環境，但請確定 tar 檔案是以二進位模式傳輸。

## 步驟 10：完成代理程式安裝
<a name="finish-agent-installation"></a>

請依照下列步驟完成代理程式安裝。

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`。

   若要建立檔案傳輸代理程式，請更新三個符號變數 HLQ （高階限定詞）`VOLSER`、 和 `AGNTPATH`，以供稍後在 JCL 中使用：

   ```
   oedit $AGENT_DIR/current-version/installation/CPY#PDS 
   ```

**注意**  
此 JCL 專為在大型主機上設定代理程式安裝的特定層面而量身打造。它會配置必要的資料集，然後將特定檔案從 Unix 檔案系統複製到這些資料集。