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 메인프레임 현대화 데이터 세트 정의 참조
애플리케이션에 처리에 몇 개 이상의 데이터 세트가 필요한 경우 AWS Mainframe Modernization 콘솔에 하나씩 입력하는 것은 비효율적입니다. 대신 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 Base의 샘플 데이터 세트 요청 형식](#datasets-m2-definition-gdg)
+ [PS 또는 GDG 세대를 위한 샘플 데이터 세트 요청 형식](#datasets-m2-definition-ps)
+ [PO용 샘플 데이터 세트 요청 형식](#datasets-m2-definition-po)
## 공통 속성
몇 가지 파라미터는 모든 데이터 세트에 공통됩니다. 이러한 매개변수는 다음 영역을 다룹니다.
+ 데이터 세트에 대한 정보(`datasetName`, `datasetOrg`, `recordLength`, `encoding`)
+ **가져오려는** 위치, 즉 데이터 세트의 소스 위치에 대한 정보. 이 위치는 메인프레임 상의 위치가 아닙니다. 이 경로에서 데이터 세트를 업로드한 Amazon S3 위치(`externalLocation`)입니다.
+ **가져오려는** 위치, 즉 데이터 세트의 대상 위치에 대한 정보. 이 위치는 런타임 엔진에 따라 데이터베이스 또는 파일 시스템입니다. (`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 관계형 데이터베이스 서비스 또는 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 또는 알 수 없는 유형의 데이터 세트가 지원됩니다.
**참고**
애플리케이션에 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 데이터 세트에는 다음과 같은 속성이 지원됩니다.
**인코딩**
(필수) 데이터 세트의 문자 세트 인코딩을 지정합니다. 가능한 값은 ASCII(`A`), EBCDIC(`E`) 및 알 수 없음(`?`)입니다.
**형식**
(필수) VSAM 데이터 세트 유형과 레코드 형식을 지정합니다.
+ AWS 메인프레임 런타임 엔진의 변환: 가능한 값은 ESDS(`ES`) 및 KSDS()입니다`KS`. 레코드 형식은 고정되거나 가변적일 수 있습니다.
+ Rocket Software 런타임 엔진: 가능한 값은 ESDS(`ES`), KSDS(`KS`) 및 RRDS()입니다`RR`. VSAM 정의에는 레코드 형식을 포함하므로 별도로 지정할 필요가 없습니다.
**primaryKeys**
(필수) VSAM KSDS 데이터 세트에만 적용됩니다. 프라이머리 키를 지정합니다. 프라이머리 키 이름, 키 오프셋 및 키 길이로 구성됩니다. `name`는 선택 사항이며 `offset` 및 `length`는 필수입니다.
**recordLength**
(필수) 레코드 길이를 지정합니다. 고정 길이 레코드 형식의 경우 이들 값이 일치해야 합니다.
+ AWS 메인프레임 런타임 엔진의 변환: VSAM ESDS 및 KSDS의 경우 `min`는 선택 사항`max`이며 필수입니다.
+ Rocket Software 런타임 엔진: `min` 및 `max`가 필요합니다.
**externalLocation**
(필수) **원본** 위치, 즉 데이터 세트를 업로드한 Amazon S3 버킷을 지정합니다.
### 메인프레임 엔진별 속성에 대한 AWS 변환
메인프레임 런타임 엔진용 AWS 변환은 VSAM 데이터 세트에 대한 압축을 지원합니다. 다음 예제는 JSON에서 이 속성을 지정하는 방법을 보여줍니다.
```
{
common properties
...
"datasetOrg": {
"vsam": {
common properties
...
"compressed": boolean,
common properties
...
}
}
}
```
압축 속성을 다음과 같이 지정합니다.
**압축**
(선택 사항) 이 데이터 세트의 인덱스를 압축된 값으로 저장할지 여부를 지정합니다. 데이터 세트가 큰 경우(일반적으로 100Mb 초과)이 있는 경우 이 플래그를 `true`로 설정하는 것이 좋습니다.
## GDG Base의 샘플 데이터 세트 요청 형식
+ 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 기본 데이터 세트에는 다음 속성이 지원됩니다.
**limit**
(필수) 활성 세대 또는 편향 수를 지정합니다. 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 세대 데이터 세트에 지원되는 속성은 다음과 같습니다.
**형식**
(필수) 데이터 세트 레코드의 형식을 지정합니다. 가능한 값은 `F`, `FA`, `FB`, `FBA`, `FBM`, `FBS`, `FM`, `FS`, `LSEQ`, `U`, `V`, `VA`, `VB`, `VBA`, `VBM`, `VBS`, `VM` 및 `VS`입니다.
**인코딩**
(필수) 데이터 세트의 문자 세트 인코딩을 지정합니다. 가능한 값은 ASCII(`A`), EBCDIC(`E`) 및 알 수 없음(`?`) 입니다
**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 데이터 세트에는 다음과 같은 속성이 지원됩니다.
**형식**
(필수) 데이터 세트 레코드의 형식을 지정합니다. 가능한 값은 `F`, `FA`, `FB`, `FBA`, `FBM`, `FBS`, `FM`, `FS`, `LSEQ`, `U`, `V`, `VA`, `VB`, `VBA`, `VBM`, `VBS`, `VM` 및 `VS`입니다.
**인코딩**
(필수) 데이터 세트의 문자 세트 인코딩을 지정합니다. 가능한 값은 ASCII(`A`), EBCDIC(`E`) 및 알 수 없음(`?`)입니다.
**memberFileExtensions**
(필수) 하나 이상의 파일 이름 확장자가 포함된 배열을 지정하여 PDS 멤버로 포함할 파일을 지정할 수 있습니다.
**recordLength**
(선택 사항) 레코드 길이를 지정합니다. 레코드의 최소(`min`) 길이와 최대(`max`) 길이는 모두 선택 사항입니다. 고정 길이 레코드 형식의 경우 이들 값이 일치해야 합니다.
**externalLocation**
(필수) **원본** 위치, 즉 데이터 세트를 업로드한 Amazon S3 버킷을 지정합니다.
**참고**
Rocket Software 런타임 엔진의 현재 구현에서는 PDS 항목을 동적 데이터 세트로 추가합니다.