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)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Mainframe Modernization データセット定義リファレンス
アプリケーションで処理に複数のデータセットが必要な場合は、 AWS Mainframe Modernization コンソールにデータセットを 1 つずつ入力することは非効率です。代わりに、JSON ファイルを作成して各データセットを指定することをお勧めします。JSON ではデータセットの種類によって指定方法が異なりますが、多くのパラメータは共通です。このドキュメントでは、さまざまなタイプのデータセットをインポートするために必要な JSON の詳細について説明します。
**注記**
データセットをインポートする前に、データセットをメインフレームからに AWSに転送する必要があります。データセットは、選択したランタイムエンジンにロードできる形式である必要があります。多くの場合、これはシーケンシャルファイルである可能性がありますが、Rocket Software (旧 Micro Focus) VSAM の場合は、独自の形式である必要があります。`DFCONV` ユーティリティは、ファイル変換において推奨される方法です。データセット定義 JSON ファイルにバケットとフォルダの名前を指定します。
Rocket Software ランタイムエンジンの詳細については、*Rocket Software* ドキュメントの[「DFCONV Batch File Conversion](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/BKFHFHCONVS001.html)」を参照してください。
メインフレームの AWS 変換の詳細については、「」を参照してください[メインフレームランタイムの AWS 変換の設定](ba-runtime-config.md)。
**Topics**
+ [一般的なプロパティ](#datasets-m2-definition-common)
+ [VSAM のデータセットリクエストフォーマットの例](#datasets-m2-definition-vsam)
+ [GDG ベースのデータセットリクエストフォーマットの例](#datasets-m2-definition-gdg)
+ [PS または GDG 世代別データセットリクエストフォーマットの例](#datasets-m2-definition-ps)
+ [PO のデータセットリクエストフォーマットの例](#datasets-m2-definition-po)
## 一般的なプロパティ
いくつかのパラメータは、すべてのデータセットに共通しています。これらのパラメータは、以下の領域をカバーします。
+ データセットに関する情報 (`datasetName`、`datasetOrg`、`recordLength`、`encoding`)
+ インポート**元**の場所に関する情報。つまりデータセットのソースの場所に関する情報。これはメインフレーム上の場所ではありません。データセット (`externalLocation`) をアップロードした Amazon S3 の場所へのパスです。
+ インポート**先**の場所に関する情報。つまりデータセットのターゲットの場所に関する情報。この場所は、ランタイムエンジンによってデータベースかファイルシステムのどちらかになります (`storageType`と`relativePath`)。
+ データセットタイプ (特定のデータセットタイプ、形式、エンコードなど) に関する情報。
各データセット定義は同じ JSON 構造になっています。次の JSON の例は、これらすべての共通パラメータを示しています。
```
{
"dataSet": {
"storageType": "Database",
"datasetName": "MFI01V.MFIDEMO.BNKACC",
"relativePath": "DATA",
"datasetOrg": {
"{{type}}": {
type-specific properties
...
},
},
},
}
```
以下のプロパティは、すべてのデータセットに共通です。
**storageType**
必須。**ターゲット**の場所に適用されます。データセットをデータベースに保存するのか、ファイルシステムに保存するのかを指定します。想定される値は、`Database` または `FileSystem` です。
+ AWS メインフレームランタイムエンジンの変換: ファイルシステムはサポートされていません。データベースを使用する必要があります。
+ Rocket Software ランタイムエンジン: データベースとファイルシステムの両方がサポートされています。データベースには Amazon Relational Database Service または Amazon Aurora のいずれかを使用することができます。ファイルシステムには Amazon Elastic File System または Amazon FSx for Lustre を使用することができます。
**datasetName**
(必須) メインフレームに表示されるデータセットの完全修飾名を指定します。
**relativePath**
(必須) **ターゲット**の場所に適用されます。データベースまたはファイルシステム内のデータセットの相対位置を指定します。
**datasetOrg**
(必須) データセットのタイプを指定します。可能な値は `vsam`、`gdg`、`ps`、`po`、または `unknown` です。
+ AWS メインフレームランタイムエンジンの変換: VSAM タイプのデータセットのみがサポートされています。
+ Rocket Software ランタイムエンジン: VSAM、GDG、PS、PO、または Unknown タイプのデータセットがサポートされています。
**注記**
アプリケーションが COBOL データファイルではなく PDF またはその他のバイナリファイルを必要とする場合は、次のように指定できます。
```
"datasetOrg": {
"type": PS {
"format": U
},
```
## VSAM のデータセットリクエストフォーマットの例
+ AWS メインフレームランタイムエンジンの変換: サポートされています。
+ Rocket Software ランタイムエンジン: サポートされています。
VSAM データセットをインポートする場合は、`datasetOrg` として `vsam` を指定します。JSON は次の例のようになります。
```
{
"storageType": "Database",
"datasetName": "AWS.M2.VSAM.KSDS",
"relativePath": "DATA",
"datasetOrg": {
"vsam": {
"encoding": "A",
"format": "KS",
"primaryKey": {
"length": 11,
"offset": 0
}
}
},
"recordLength": {
"min": 300,
"max": 300
}
},
"externalLocation": {
"s3Location": "s3://$M2_DATA_STORE/catalog/data/AWS.M2.VSAM.KSDS.DAT"
}
```
VSAM データセットでは次のプロパティがサポートされています。
**encoding**
(必須) データセットの文字セットエンコードを指定します。指定できる値は ASCII (`A`)、EBCDIC (`E`)、Unknown (`?`) です。
**format**
(必須) VSAM データセットタイプとレコード形式を指定します。
+ AWS メインフレームランタイムエンジンの変換: 指定できる値は ESDS (`ES`) と KSDS () です`KS`。レコード形式は固定長でも可変長でも構いません。
+ Rocket Software ランタイムエンジン: 指定できる値は ESDS (`ES`)、KSDS ()、RRDS (`KS`) です`RR`。VSAM の定義には、レコードの形式が含まれているため、別途指定する必要はありません。
**primaryKey**
(必須) VSAM KSDS データセットにのみ適用されます。プライマリキーを指定します。プライマリキー名、キーオフセット、キー長で構成されます。`name` はオプションで、`offset` と `length` は必須です。
**recordLength**
(必須) レコードの長さを指定します。固定長レコード形式では、これらの値が一致する必要があります。
+ AWS メインフレームランタイムエンジンの変換: for VSAM ESDS、および KSDS `min`はオプションであり、必須`max`です。
+ Rocket Software ランタイムエンジン: `min`と `max` が必要です。
**externalLocation**
(必須) **ソース**の場所、つまりデータセットをアップロードした Amazon S3 バケットを指定します。
### メインフレームエンジン固有のプロパティの AWS Transform
AWS Transform for mainframe ランタイムエンジンは、VSAM データセットの圧縮をサポートしています。以下の例は、JSON でこのプロパティを指定する方法を示しています。
```
{
common properties
...
"datasetOrg": {
"vsam": {
common properties
...
"compressed": boolean,
common properties
...
}
}
}
```
圧縮プロパティを次のように指定します。
**compression**
(任意) このデータセットのインデックスを圧縮値として保存するかどうかを指定します。データセットが大きい場合 (通常は 100 Mb 以上)、このフラグを `true` に設定することを検討してください。
## GDG ベースのデータセットリクエストフォーマットの例
+ AWS メインフレームランタイムエンジンの変換: サポートされていません。
+ Rocket Software ランタイムエンジン: サポートされています。
GDG ベースデータセットをインポートする場合は、`datasetOrg` として `gdg` を指定します。JSON は次の例のようになります。
```
{
"storageType": "Database",
"datasetName": "AWS.M2.GDG",
"relativePath": "DATA",
"datasetOrg": {
"gdg": {
"limit": "3",
"rollDisposition": "Scratch and No Empty"
}
}
}
```
GDG ベースデータセットでは以下のプロパティがサポートされています。
**制限**
(必須) アクティブな世代の数またはバイアスを指定します。GDG ベースクラスターの最大値は 255 です。
**rollDisposition**
(任意) 最大値に達した場合や最大値を超えた場合の世代データセットの処理方法を指定します。可能な値は、`No Scratch and No Empty`、`Scratch and No Empty`、`Scratch and Empty` または `No Scratch and Empty` です。デフォルトは `Scratch and No Empty` です。
## PS または GDG 世代別データセットリクエストフォーマットの例
+ AWS メインフレームランタイムエンジンの変換: サポートされていません。
+ Rocket Software ランタイムエンジン: サポートされています。
PS または GDG 世代別データセットをインポートする場合は、`datasetOrg` として `ps` を指定します。JSON は次の例のようになります。
```
{
"storageType": "Database",
"datasetName": "AWS.M2.PS.FB",
"relativePath": "DATA",
"datasetOrg": {
"ps": {
"format": "FB",
"encoding": "A"
}
},
"recordLength": {
"min": 300,
"max": 300
}
},
"externalLocation": {
"s3Location": "s3://$M2_DATA_STORE/catalog/data/AWS.M2.PS.LSEQ"
}
}
```
PS または GDG 世代別データセットでは、次のプロパティがサポートされています。
**format**
(必須) データセットレコードの形式を指定します。指定できる値は、`F`、`FA`、`FB`、`FBA`、`FBM`、`FBS`、`FM`、`FS`、`LSEQ`、`U`、`V`、`VA`、`VB`、`VBA`、`VBM`、`VBS`、`VM`、`VS` です。
**encoding**
(必須) データセットの文字セットエンコードを指定します。指定できる値は ASCII (`A`)、EBCDIC (`E`)、Unknown (`?`) です。
**recordLength**
(必須) レコードの長さを指定します。レコードの最小長 (`min`) と最大長 (`max`) の両方を指定する必要があります。固定長レコード形式では、これらの値が一致する必要があります。
**externalLocation**
(必須) **ソース**の場所、つまりデータセットをアップロードした Amazon S3 バケットを指定します。
## PO のデータセットリクエストフォーマットの例
PO データセットをインポートする場合は、`datasetOrg` として `po` を指定します。JSON は次の例のようになります。
```
{
"storageType": "Database",
"datasetName": "AWS.M2.PO.PROC",
"relativePath": "DATA",
"datasetOrg": {
"po": {
"format": "LSEQ",
"encoding": "A",
"memberFileExtensions": ["PRC"]
}
},
"recordLength": {
"min": 80,
"max": 80
}
},
"externalLocation": {
"s3Location": "s3://$M2_DATA_STORE/source/proc/"
}
}
```
PO データセットでは以下のプロパティがサポートされています。
**format**
(必須) データセットレコードの形式を指定します。指定できる値は、`F`、`FA`、`FB`、`FBA`、`FBM`、`FBS`、`FM`、`FS`、`LSEQ`、`U`、`V`、`VA`、`VB`、`VBA`、`VBM`、`VBS`、`VM`、`VS` です。
**encoding**
(必須) データセットの文字セットエンコードを指定します。指定できる値は ASCII (`A`)、EBCDIC (`E`)、Unknown (`?`) です。
**memberFileExtensions**
(必須) 1 つ以上のファイル名拡張子を含む配列を指定すると、PDS メンバーとして含めるファイルを指定することができます。
**recordLength**
(任意) レコードの長さを指定します。レコードの最小長 (`min`) と最大長 (`max`) はどちらもオプションです。固定長レコード形式では、これらの値が一致する必要があります。
**externalLocation**
(必須) **ソース**の場所、つまりデータセットをアップロードした Amazon S3 バケットを指定します。
**注記**
Rocket Software ランタイムエンジンの現在の実装では、PDS エントリを動的データセットとして追加します。