AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、2025 年 11 月 7 日以降、新しいお客様に公開されなくなります。サービスを使用する場合は、2025 年 11 月 7 日までにサインアップしてください。AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、AWS 「 Mainframe Modernization の可用性の変更」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
M2DFUTIL バッチユーティリティ
M2DFUTIL は、メインフレーム ADRDSSU ユーティリティが提供するサポートと同様に、データセットのバックアップ、復元、削除、コピー機能を提供する JCL ユーティリティプログラムです。このプログラムは ADRDSSU の SYSIN パラメータの多くを保持するため、この新しいユーティリティへの移行プロセスが効率化されます。
トピック
サポートされているプラットフォーム
M2DFUTIL は、以下のどのプラットフォームでも使用できます。
-
Windows (64 ビットと 32 ビット) の Rocket Software (旧 Micro Focus) ES
-
Linux での Rocket Software ES (64 ビット）
プラットフォームの要件
M2DFUTIL は、正規表現テストを実行するスクリプトの呼び出しに依存します。Windows では、このスクリプトを実行するには Windows Services for Linux (WSL) をインストールする必要があります。
今後のサポートの予定
以下を含む機能は、現在メインフレームの ADRDSSU ユーティリティでは使用できませんが、今後サポートを予定しています。
-
M2 Managed
-
VSAM
-
ファイルの名前変更での COPY のサポート
-
RESTORE での RENAME のサポート
-
複数の INCLUDE と EXCLUDE
-
DSORG、CREDT、EXPDT による副選択のための BY 句
-
エンキュー失敗を再試行するための MWAIT 句
-
DUMP/RESTORE での S3 ストレージのサポート
アセットの場所
このユーティリティのロードモジュールは、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 (AppStream 2.0 を含む) で M2DFUTIL または AWS Mainframe Modernization ランタイムを設定する AppStream
Enterprise Server のリージョンを次のように設定します。
-
[ES 環境] に以下の変数を追加します。
-
M2DFUTILS_BASE_LOC- DUMP 出力のデフォルト場所 -
M2DFUTILS_SCRIPTPATH- 「アセットの場所」に記載されているcompare.shスクリプトの場所 -
M2DFUTILS_VERBOSE- [冗長または標準]。これはSYSPRINT出力の詳細レベルを制御します。
-
-
ロードモジュールパスが
JES\Configuration\JES Program Path設定に追加されていることを確認します。 -
ユーティリティディレクトリ内のスクリプトに実行権限があることを確認します。Linux 環境では、
chmod + x <script name>コマンドを使用して実行権限を追加できます。
一般的な構文
DUMP
現在のカタログの場所からバックアップの場所にファイルをコピーできます。この場所は、現時点でファイルシステムである必要があります。
プロセス
DUMP は以下を実行します。
-
ターゲットロケーションディレクトリを作成する。
-
ターゲットロケーションディレクトリを PDS メンバーとしてカタログ化する。
-
INCLUDE パラメータを処理して、インクルードするファイルを特定する。
-
EXCLUDE パラメータを処理して、インクルードされたファイルの選択を解除する。
-
ダンプ中のファイルを削除するかどうかを判断する。
-
処理するファイルをエンキューする。
-
ファイルをコピーする。
-
今後の RESTORE オペレーションのため、コピーしたファイルのカタログ化された DCB 情報をターゲットロケーションのサイドファイルにエクスポートする。
構文
DUMP TARGET ( TARGET LOCATION ) - INCLUDE ( DSN. ) [ EXCLUDE ( DSN ) ] [ CANCEL | IGNORE ] [ DELETE ]
必須パラメータ
以下は DUMP の必須パラメータです。
-
SYSPRINT DD NAME- 追加のロギング情報を格納するため -
TARGET- ターゲットロケーション 以下のいずれかになります。-
ダンプロケーションのフルパス
-
M2DFUTILS_BASE_LOC 変数で定義された場所に作成されたサブディレクトリ名
-
-
INCLUDE- 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか -
EXCLUDE- 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか
任意指定のパラメータ
-
CANCEL - エラーが発生した場合はキャンセルします。処理済みのファイルは保持されます。
-
(デフォルト) IGNORE - すべてのエラーを無視し、最後まで処理します
-
DELETE - ENQ エラーが発生しない場合、ファイルは削除され、カタログ化が解除されます。
DELETE
ファイルの一括削除およびカタログ化の解除ができます。ファイルはバックアップされません。
プロセス
DELETE は以下を実行します。
-
INCLUDE パラメータを処理して、インクルードするファイルを特定する。
-
EXCLUDE パラメータを処理して、インクルードされたファイルの選択を解除する。
-
処理するファイルをエンキューする。処理を OLD、DELETE、KEEP に設定する。
構文
DELETE INCLUDE ( DSN ) [ EXCLUDE ( DSN ) ] [ CANCEL | IGNORE ] [ DELETE ]
必須パラメータ
以下は DELETE の必須パラメータです。
-
SYSPRINT DD NAME- 追加のロギング情報を格納するため -
INCLUDE- 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか -
EXCLUDE- 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか
任意指定のパラメータ
-
CANCEL - エラーが発生した場合はキャンセルします。処理済みのファイルは保持されます。
-
(デフォルト) IGNORE - すべてのエラーを無視し、最後まで処理します
RESTORE
DUMP を使用して以前にバックアップしたファイルを復元できます。RENAME を使用して復元済みの DSNAME を変更した場合を除き、ファイルはカタログ化された元の場所に復元されます。
プロセス
RESTORE は以下を実行します。
-
ソースロケーションディレクトリを検証する。
-
カタログエクスポートファイルを処理して、インクルードするファイルを特定する。
-
EXCLUDE パラメータを処理して、インクルードされたファイルの選択を解除する。
-
処理するファイルをエンキューする。
-
エクスポート情報に基づいてカタログ化されていないファイルをカタログ化する。
-
ファイルが既にカタログ化されていて、エクスポートカタログ情報が同じ場合、REPLACE オプションが設定されている場合は、RESTORE はカタログ化されたデータセットを置き換えます。
構文
RESTORE SOURCE ( TARGET LOCATION ) INCLUDE ( DSN ) [ EXCLUDE ( DSN ) ] [ CANCEL | IGNORE ] [ REPLACE]
必須パラメータ
以下は RESTORE の必須パラメータです。
-
SYSPRINT DD NAME- 追加のロギング情報を格納するため -
SOURCE- ソースロケーション。以下のいずれかになります。-
ダンプロケーションのフルパス
-
M2DFUTILS_BASE_LOC 変数で定義された場所に作成されたサブディレクトリ名
-
-
INCLUDE- 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか -
EXCLUDE- 単名の DSNAME または有効なメインフレーム DSN 検索文字列のいずれか
任意指定のパラメータ
-
CANCEL - エラーが発生した場合はキャンセルします。処理済みのファイルは保持されます。
-
(デフォルト) IGNORE - すべてのエラーを無視し、最後まで処理します
-
REPLACE - ファイルが既にカタログ化されていて、カタログレコードが同じ場合は、カタログ化されたファイルを置き換えます。
サンプル JCL
DUMP ジョブ
このジョブは TESTDUMP というサブディレクトリを作成します。これは M2DFUTILS_BASE_LOC 変数によって指定されるデフォルトのバックアップ場所です。このバックアップ用に、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 /* //
