Propiedades comunes Ejemplo de formato de solicitud de conjunto de datos para VSAM Ejemplo de formato de solicitud de conjunto de datos para la base GDG Ejemplo de formato de solicitud de conjunto de datos para PS o GDG generaciones Ejemplo de formato de solicitud de conjunto de datos para PO

AWS Referencia de definición de conjuntos de datos de modernización de mainframe

Si su aplicación requiere más de unos pocos conjuntos de datos para su procesamiento, es ineficiente ingresarlos uno por uno en la consola de modernización del AWS mainframe. En su lugar, le recomendamos que cree un JSON archivo para especificar cada conjunto de datos. Los distintos tipos de conjuntos de datos se especifican de forma diferente en elJSON, aunque muchos parámetros son comunes. En este documento se describen los detalles JSON necesarios para importar diferentes tipos de conjuntos de datos.

nota

Antes de importar un conjunto de datos, debe transferirlo de la unidad central a AWS. Los conjuntos de datos deben estar en un formato que se pueda cargar en el motor de ejecución seleccionado. En muchos casos, puede ser un archivo secuencial, pero en el caso de Micro Focus tendrá VSAM que estar en su formato propietario. La DFCONV utilidad es el método sugerido para convertir el archivo. Especifique el nombre del depósito y la carpeta en el JSON archivo de definición del conjunto de datos.

Para obtener más información sobre el motor de ejecución de Micro Focus, consulte Conversión de archivos DFCONV por lotes en la documentación para desarrolladores de Micro Focus Enterprise.

Para obtener más información sobre AWS Blu Age, consulteConfigurar la configuración de AWS Blu Age Runtime.

Temas

Propiedades comunes
Ejemplo de formato de solicitud de conjunto de datos para VSAM
Ejemplo de formato de solicitud de conjunto de datos para la base GDG
Ejemplo de formato de solicitud de conjunto de datos para PS o GDG generaciones
Ejemplo de formato de solicitud de conjunto de datos para PO

Propiedades comunes

Varios parámetros son comunes en todos los conjuntos de datos. Estos parámetros cubren las siguientes áreas:

Información sobre el conjunto de datos (datasetName, datasetOrg, recordLength, encoding).
Información sobre la ubicación desde la que está importando, es decir, la ubicación de origen del conjunto de datos. Esta no es la ubicación de la unidad central. Es la ruta a la ubicación de Amazon S3 en la que cargó el conjunto de datos (externalLocation).
Información sobre la ubicación a la que está importando, es decir, la ubicación de destino del conjunto de datos. Esta ubicación puede ser una base de datos o un sistema de archivos, según el motor de tiempo de ejecución. (storageType y relativePath).
Información sobre el tipo de conjunto de datos (tipo de conjunto de datos específico, formato, codificación, etc.).

Cada definición de conjunto de datos tiene la misma JSON estructura. El siguiente ejemplo JSON muestra todos estos parámetros comunes.


{
    "dataSet": {
        "storageType": "Database",
        "datasetName": "MFI01V.MFIDEMO.BNKACC",
        "relativePath": "DATA",
        "datasetOrg": {
            "type": {
                type-specific properties
                    ... 
            },
        },
    },
}

Las siguientes propiedades son comunes a todos los conjuntos de datos.

storageType

Obligatorio. Se aplica a la ubicación de destino. Especifica si el conjunto de datos se almacena en una base de datos o en un sistema de archivos. Los valores posibles son Database o FileSystem.

AWS Motor de ejecución Blu Age: los sistemas de archivos no son compatibles. Debe utilizar una base de datos.
Motor de ejecución de Micro Focus: se admiten bases de datos y sistemas de archivos. Puede utilizar Amazon Relational Database Service o Amazon Aurora para las bases de datos, y Amazon Elastic File System o FSx Amazon for Lustre para los sistemas de archivos.

datasetName

(Obligatorio) Especifica el nombre completo del conjunto de datos tal como aparece en el mainframe.

relativePath

(Obligatorio) Se aplica a la ubicación de destino. Especifica la ubicación relativa del conjunto de datos en la base de datos o el sistema de archivos.

datasetOrg

(Obligatorio) Especifica el tipo de conjunto de datos. Los valores posibles son vsam, gdg, ps, po o unknown.

AWS Motor de ejecución Blu Age: solo se admiten conjuntos de datos VSAM tipográficos.
Motor de tiempo de ejecución Micro Focus: VSAM se admiten conjuntos de datos de tipo PS, PO o desconocido. GDG
nota
Si la aplicación requiere archivos que no sean archivos de COBOL datos, sino que lo sean PDF u otros archivos binarios, puede especificarlos de la siguiente manera:
```
"datasetOrg": {
            "type": PS {
                "format": U
            },
```

Ejemplo de formato de solicitud de conjunto de datos para VSAM

AWS Motor de tiempo de ejecución Blu Age: compatible.
Motor de tiempo de ejecución de Micro Focus: compatible.

Si va a importar conjuntos VSAM de datos, vsam especifíquelos comodatasetOrg. JSONDebe parecerse al ejemplo siguiente:


{
    "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"
}

Los conjuntos de VSAM datos admiten las siguientes propiedades.

encoding

(Obligatorio) Especifica la codificación del conjunto de caracteres del conjunto de datos. Los valores posibles son ASCII (A), EBCDIC (E) y Unknown (?).

format

(Obligatorio) Especifica el tipo de conjunto de VSAM datos y el formato de registro.

AWS Motor de ejecución Blu Age: los valores posibles son ESDS KSDS (ESKS), () y RRDS (RR). El formato de registro puede ser fijo o variable.
Motor de tiempo de ejecución Micro Focus: los valores posibles son ESDS KSDS (ESKS), () y RRDS (RR). La VSAM definición incluye el formato de registro, por lo que no es necesario especificarlo por separado.

primaryKey

(Obligatorio) Se aplica únicamente a VSAM KSDS los conjuntos de datos. Especifica la clave principal. Consta del nombre de la clave principal, el desplazamiento y la longitud de la clave. name es opcional; offset y length son obligatorias.

recordLength

(Obligatorio) Especifica la longitud de un registro. Para los formatos de registro de longitud fija, estos valores deben coincidir.

AWS Motor de ejecución Blu Age: for VSAM ESDS KSDSRRDS, y, min es opcional y max obligatorio.
Motor de tiempo de ejecución de Micro Focus: min y max son obligatorios.

externalLocation

(Obligatorio) Especifica la ubicación de origen: es decir, el depósito de Amazon S3 en el que cargó el conjunto de datos.

Propiedades específicas del motor de Blue Age

El motor de ejecución AWS Blu Age admite la compresión de conjuntos VSAM de datos. El siguiente ejemplo muestra cómo se puede especificar esta propiedad enJSON.


{
    common properties
        ...
        "datasetOrg": {
            "vsam": {
                common properties
                ...
                "compressed": boolean,
                common properties
                ...
            }
        }
}

Especifique la propiedad de compresión de la siguiente manera:

compression: (Opcional) Especifica si los índices de este conjunto de datos se almacenan como valores comprimidos. Si tiene un conjunto de datos grande (normalmente > 100 Mb), considere configurar este indicador en true.

Ejemplo de formato de solicitud de conjunto de datos para la base GDG

AWS Motor de ejecución Blu Age: no compatible.
Motor de tiempo de ejecución de Micro Focus: compatible.

Si va a importar conjuntos de datos GDG base, gdg especifíquelos comodatasetOrg. JSONDebe parecerse al ejemplo siguiente:


{
    "storageType": "Database",
    "datasetName": "AWS.M2.GDG",
    "relativePath": "DATA",
    "datasetOrg": {
        "gdg": {
            "limit": "3",
            "rollDisposition": "Scratch and No Empty"
        }
    }
}

Los conjuntos de datos GDG base admiten las siguientes propiedades.

límite: (Obligatorio) Especifica el número de generaciones activas o sesgos. Para un clúster GDG base, el máximo es 255.
rollDisposition: (Opcional) Especifica cómo gestionar los conjuntos de datos de generación cuando se alcanza o se supera el máximo. Los valores posibles son No Scratch and No Empty, Scratch and No Empty, Scratch and Empty o No Scratch and Empty. El valor predeterminado es Scratch and No Empty.

Ejemplo de formato de solicitud de conjunto de datos para PS o GDG generaciones

AWS Motor de ejecución Blu Age: no compatible.
Motor de tiempo de ejecución de Micro Focus: compatible.

Si va a importar conjuntos de datos de PS o GDG generaciones, ps especifíquelos comodatasetOrg. JSONDebe parecerse al siguiente ejemplo:


{
    "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"
}
}

Las siguientes propiedades son compatibles con los conjuntos de datos PS o GDG Generations.

format: (Obligatorio) Especifica el formato de los registros del conjunto de datos. Los posibles valores son F, FA, FB, FBA, FBM, FBS, FM, FS, LSEQ, U, V, VA, VB, VBA, VBM, VBS, VM y VS.
encoding: (Obligatorio) Especifica la codificación del conjunto de caracteres del conjunto de datos. Los valores posibles son ASCII (A), EBCDIC (E) y Unknown (?)
recordLength: (Obligatorio) Especifica la longitud de un registro. Debe especificar la longitud mínima (min) y máxima (max) del registro. Para los formatos de registro de longitud fija, estos valores deben coincidir.
externalLocation: (Obligatorio) Especifica la ubicación de origen: es decir, el depósito de Amazon S3 en el que cargó el conjunto de datos.

Ejemplo de formato de solicitud de conjunto de datos para PO

Si va a importar conjuntos de datos de PO, especifique po como datasetOrg. JSONDebe parecerse al ejemplo siguiente:


{
    "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/"
}
}

Los conjuntos de datos de PO admiten las siguientes propiedades.

format: (Obligatorio) Especifica el formato de los registros del conjunto de datos. Los posibles valores son F, FA, FB, FBA, FBM, FBS, FM, FS, LSEQ, U, V, VA, VB, VBA, VBM, VBS, VM y VS.
encoding: (Obligatorio) Especifica la codificación del conjunto de caracteres del conjunto de datos. Los valores posibles son ASCII (A), EBCDIC (E) y Unknown (?).
memberFileExtensions: (Obligatorio) Especifica una matriz que contiene una o más extensiones de nombre de archivo, lo que le permite especificar los archivos que se van a incluir como PDS miembros.
recordLength: (Opcional) Especifica la longitud de un registro. Tanto la longitud mínima (min) como la máxima (max) del registro son opcionales. Para los formatos de registro de longitud fija, estos valores deben coincidir.
externalLocation: (Obligatorio) Especifica la ubicación de origen: es decir, el depósito de Amazon S3 en el que cargó el conjunto de datos.

nota

La implementación actual del motor de ejecución de Micro Focus añade PDS entradas como conjuntos de datos dinámicos.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Referencia de definición de aplicaciones

Entornos de ejecución gestionados