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)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# M2DFUTIL バッチユーティリティ
<a name="m2dfutil"></a>

M2DFUTIL は、メインフレーム ADRDSSU ユーティリティが提供するサポートと同様に、データセットのバックアップ、復元、削除、コピー機能を提供する JCL ユーティリティプログラムです。このプログラムは ADRDSSU の SYSIN パラメータの多くを保持するため、この新しいユーティリティへの移行プロセスが効率化されます。

**Topics**
+ [

## サポートされているプラットフォーム
](#m2dfutil-platforms)
+ [

## プラットフォームの要件
](#m2dfutil-platform)
+ [

## 今後のサポートの予定
](#m2udfutil-future-support)
+ [

## アセットの場所
](#mdfutil-assets)
+ [

## Amazon EC22 で M2DFUTIL または AWS Mainframe Modernization ランタイムを設定する (AppStream 2.0 を含む)
](#mdfutil-dependencies)
+ [

## 一般的な構文
](#mdfutil-syntax)
+ [

## サンプル JCL
](#mdfutil-sample-jcls)

## サポートされているプラットフォーム
<a name="m2dfutil-platforms"></a>

M2DFUTIL は、以下のどのプラットフォームでも使用できます。
+ Windows 上の Rocket Software (旧 Micro Focus) ES (64 ビットと 32 ビット)
+ Linux での Rocket Software ES (64 ビット)

## プラットフォームの要件
<a name="m2dfutil-platform"></a>

M2DFUTIL は、正規表現テストを実行するスクリプトの呼び出しに依存します。Windows では、このスクリプトを実行するには Windows Services for Linux (WSL) をインストールする必要があります。

## 今後のサポートの予定
<a name="m2udfutil-future-support"></a>

以下を含む機能は、現在メインフレームの ADRDSSU ユーティリティでは使用できませんが、今後サポートを予定しています。
+ M2 Managed
+ VSAM
+ ファイルの名前変更での COPY のサポート
+ RESTORE での RENAME のサポート 
+ 複数の INCLUDE と EXCLUDE
+ DSORG、CREDT、EXPDT による副選択のための BY 句
+ エンキュー失敗を再試行するための MWAIT 句
+ DUMP/RESTORE での S3 ストレージのサポート

## アセットの場所
<a name="mdfutil-assets"></a>

このユーティリティのロードモジュールは、Linux では `M2DFUTIL.dll`、Windows では `M2DFUTIL.so` と呼ばれます。このロードモジュールは、次のいずれかの場所にあります。
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 ビット): `C:\AWS\M2\MicroFocus\Utilities\64bit`

正規表現のテストに使用されるスクリプトは `compare.sh` と呼ばれます。このスクリプトは、次のいずれかの場所にあります。
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Amazon EC22 で M2DFUTIL または AWS Mainframe Modernization ランタイムを設定する (AppStream 2.0 を含む)
<a name="mdfutil-dependencies"></a>

Enterprise Server のリージョンを次のように設定します。
+ **[ES 環境]** に以下の変数を追加します。
  + `M2DFUTILS_BASE_LOC` - DUMP 出力のデフォルト場所
  + `M2DFUTILS_SCRIPTPATH` - 「**アセットの場所**」に記載されている `compare.sh` スクリプトの場所
  + `M2DFUTILS_VERBOSE` - [冗長または標準]。これは `SYSPRINT ` 出力の詳細レベルを制御します。
+ ロードモジュールパスが `JES\Configuration\JES Program Path` 設定に追加されていることを確認します。
+ ユーティリティディレクトリ内のスクリプトに実行権限があることを確認します。Linux 環境では、`chmod + x <script name>` コマンドを使用して実行権限を追加できます。

## 一般的な構文
<a name="mdfutil-syntax"></a>

### DUMP
<a name="mdfutil-dump"></a>

現在のカタログの場所からバックアップの場所にファイルをコピーできます。この場所は、現時点でファイルシステムである必要があります。

#### プロセス
<a name="mdfutil-dump-process"></a>

DUMP は以下を実行します。

1. ターゲットロケーションディレクトリを作成する。

1. ターゲットロケーションディレクトリを PDS メンバーとしてカタログ化する。

1. INCLUDE パラメータを処理して、インクルードするファイルを特定する。

1. EXCLUDE パラメータを処理して、インクルードされたファイルの選択を解除する。

1. ダンプ中のファイルを削除するかどうかを判断する。

1. 処理するファイルをエンキューする。

1. ファイルをコピーする。

1. 今後の RESTORE オペレーションのため、コピーしたファイルのカタログ化された DCB 情報をターゲットロケーションのサイドファイルにエクスポートする。

#### 構文
<a name="mdfutil-dump-syntax"></a>

```
DUMP
TARGET ( TARGET LOCATION  )    -
INCLUDE ( DSN. )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### 必須パラメータ
<a name="mdfutil-dump-requiredparam"></a>

以下は DUMP の必須パラメータです。
+ `SYSPRINT DD NAME` - 追加のロギング情報を格納するため
+ `TARGET` - ターゲットロケーション 以下のいずれかになります。
  + ダンプロケーションのフルパス
  + **M2DFUTILS\$1BASE\$1LOC** 変数で定義された場所に作成されたサブディレクトリ名
+ `INCLUDE` - 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか
+ `EXCLUDE` - 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか

#### 任意指定のパラメータ
<a name="mdfutil-dump-optionalparam"></a>
+ CANCEL - エラーが発生した場合はキャンセルします。処理済みのファイルは保持されます。
+ (デフォルト) IGNORE - すべてのエラーを無視し、最後まで処理します
+ DELETE - ENQ エラーが発生しない場合、ファイルは削除され、カタログ化が解除されます。

### DELETE
<a name="mdfutil-delete"></a>

ファイルの一括削除およびカタログ化の解除ができます。ファイルはバックアップされません。

#### プロセス
<a name="mdfutil-delete-process"></a>

DELETE は以下を実行します。

1. INCLUDE パラメータを処理して、インクルードするファイルを特定する。

1. EXCLUDE パラメータを処理して、インクルードされたファイルの選択を解除する。

1. 処理するファイルをエンキューする。処理を OLD、DELETE、KEEP に設定する。

#### 構文
<a name="mdfutil-delete-syntax"></a>

```
DELETE
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### 必須パラメータ
<a name="mdfutil-delete-requiredparam"></a>

以下は DELETE の必須パラメータです。
+ `SYSPRINT DD NAME` - 追加のロギング情報を格納するため
+ `INCLUDE` - 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか 
+ `EXCLUDE` - 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか 

#### 任意指定のパラメータ
<a name="mdfutil-delete-optionalparam"></a>
+ CANCEL - エラーが発生した場合はキャンセルします。処理済みのファイルは保持されます。
+ (デフォルト) IGNORE - すべてのエラーを無視し、最後まで処理します

### RESTORE
<a name="mdfutil-restore"></a>

DUMP を使用して以前にバックアップしたファイルを復元できます。RENAME を使用して復元済みの DSNAME を変更した場合を除き、ファイルはカタログ化された元の場所に復元されます。

#### プロセス
<a name="mdfutil-restore-process"></a>

RESTORE は以下を実行します。

1. ソースロケーションディレクトリを検証する。

1. カタログエクスポートファイルを処理して、インクルードするファイルを特定する。

1. EXCLUDE パラメータを処理して、インクルードされたファイルの選択を解除する。

1. 処理するファイルをエンキューする。

1. エクスポート情報に基づいてカタログ化されていないファイルをカタログ化する。

1. ファイルが既にカタログ化されていて、エクスポートカタログ情報が同じ場合、REPLACE オプションが設定されている場合は、RESTORE はカタログ化されたデータセットを置き換えます。

#### 構文
<a name="mdfutil-restore-syntax"></a>

```
RESTORE
SOURCE ( TARGET LOCATION ) 
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ REPLACE]
```

#### 必須パラメータ
<a name="mdfutil-restore-requiredparam"></a>

以下は RESTORE の必須パラメータです。
+ `SYSPRINT DD NAME` - 追加のロギング情報を格納するため 
+ `SOURCE` - ソースロケーション。以下のいずれかになります。
  + ダンプロケーションのフルパス
  + **M2DFUTILS\$1BASE\$1LOC** 変数で定義された場所に作成されたサブディレクトリ名
+ `INCLUDE` - 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか
+ `EXCLUDE` - 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか

#### 任意指定のパラメータ
<a name="mdfutil-restore-optionalparam"></a>
+ CANCEL - エラーが発生した場合はキャンセルします。処理済みのファイルは保持されます。
+ (デフォルト) IGNORE - すべてのエラーを無視し、最後まで処理します
+ REPLACE - ファイルが既にカタログ化されていて、カタログレコードが同じ場合は、カタログ化されたファイルを置き換えます。

## サンプル JCL
<a name="mdfutil-sample-jcls"></a>

 **DUMP ジョブ**

このジョブは `TESTDUMP` というサブディレクトリを作成します。これは **M2DFUTILS\$1BASE\$1LOC** 変数によって指定されるデフォルトのバックアップ場所です。このバックアップ用に、`M2DFUTILS.TESTDUMP` という PDS ライブラリが作成されます。エクスポートされたカタログデータは、`CATDUMP.DAT` というバックアップディレクトリの行順ファイルに保存されます。選択したすべてのファイルが、このバックアップディレクトリにコピーされます。

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

 **DELETE ジョブ**

このジョブは、INCLUDE パラメータに一致するすべてのファイルをカタログから削除します。

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

 **RESTORE ジョブ**

このジョブは、INCLUDE パラメータに一致するファイルを `TESTDUMP` バックアップ場所から復元します。カタログ化されたファイルが CATDUMP エクスポートのファイルと同じで、REPLACE オプションが指定されている場合、カタログ化されたファイルは置き換えられます。

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