Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
AWS Mainframe Modernization referencia de definición de aplicación
En AWS Mainframe Modernization, las aplicaciones de mainframe migradas se configuran en un JSON archivo de definición de aplicaciones, que es específico del motor de ejecución que elija. La definición de una aplicación contiene tanto información general como información específica del motor. En este tema se describen las definiciones de las aplicaciones AWS Blu Age y Micro Focus e identifica todos los elementos obligatorios y opcionales.
Contenido
- Sección de cabecera general
- Descripción general de la sección de definiciones
- AWS Ejemplo de definición de aplicación de Blu Age
- AWS Detalles de la definición de Blu Age
- Definición de la aplicación Micro Focus
- Detalles de definición de Micro Focus
- Oyente (es): obligatorio
- Ubicaciones de los conjuntos de datos: obligatorias
- Controlador de autenticación y autorización de Amazon Cognito: opcional
- LDAPy el controlador de Active Directory (opcional)
- Configuración de lotes: obligatoria
- CICSconfiguración: requerida
- Impresoras: opcionales
- Recursos de XA: opcionales
- Configuración de tiempo de ejecución: opcional
Sección de cabecera general
Cada definición de aplicación comienza con información general sobre la versión de la plantilla y las ubicaciones de origen. La versión actual de la definición de la aplicación es la 2.0.
Utilice la siguiente estructura para especificar la versión de la plantilla y las ubicaciones de origen.
"template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "mainframe-deployment-bucket", "s3-key-prefix": "v1" } } ]
nota
Puede utilizar la siguiente sintaxis si desea introducir S3 ARN como s3-bucket:
"template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "arn:aws:s3:::mainframe-deployment-bucket", "s3-key-prefix": "v1" } } ]
- template-version
-
(Obligatorio) Especifica la versión del archivo de definición de la aplicación. No cambie este valor. La única permitida actualmente es la 2.0. Especifique
template-versioncon una cadena. - source-locations
-
Especifica las ubicaciones de los archivos y otros recursos que la aplicación necesita durante el tiempo de ejecución.
- id de origen
-
Especifica un nombre para la ubicación. Este nombre se utiliza para hacer referencia a la ubicación de origen según sea necesario en la definición de la aplicaciónJSON.
- tipo de fuente
-
Especifica el tipo de fuente. Actualmente, el único valor permitido es s3.
- properties
-
Proporciona los detalles de la ubicación de origen. Cada propiedad se especifica con una cadena.
-
s3-bucket: obligatorio. Especifica el nombre del bucket de Amazon S3 donde se almacenan los archivos. -
s3-key-prefix: obligatorio. Especifica el nombre de la carpeta del bucket de Amazon S3 donde se almacenan los archivos.
-
Descripción general de la sección de definiciones
Especifica las definiciones de recursos de los servicios, la configuración, los datos y otros recursos típicos que la aplicación necesita para ejecutarse. Al actualizar una definición de aplicación, AWS Mainframe Modernization detecta los cambios comparando definition las listas source-locations y de las versiones anterior y actual del JSON archivo de definición de aplicación.
La sección de definición es específica del motor y está sujeta a cambios. En las siguientes secciones, se muestran ejemplos de definiciones de aplicaciones específicas de los motores para ambos motores.
AWS Ejemplo de definición de aplicación de Blu Age
{ "template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "mainframe-deployment-bucket-aaa", "s3-key-prefix": "v1" } } ], "definition" : { "listeners": [{ "port": 8194, "type": "http" }], "ba-application": { "app-location": "${s3-source}/murachs-v6/" }, "blusam": { "db": { "nb-threads": 8, "batch-size": 10000, "name": "blusam", "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG" }, "redis": { "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com", "port": 6379, "useSsl": true, "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm" } } } }
AWS Detalles de la definición de Blu Age
Oyente(s): obligatorio
Especifique el puerto que utilizará para acceder a la aplicación a través del Elastic Load Balancing AWS Mainframe Modernization creado. Utilice la estructura siguiente:
"listeners": [{ "port": 8194, "type": "http" }],
- port
-
(Obligatorio) Puede usar cualquier puerto disponible, excepto los conocidos puertos del 0 al 1023. Le recomendamos que utilice valores entre 8192 y 8199. Asegúrese de que no haya otros oyentes o aplicaciones funcionando en este puerto.
- type
-
(Obligatorio) Actualmente, solo
httpes compatible.
AWS Solicitud Blu Age: obligatoria
Especifique la ubicación en la que el motor recoge el archivo de imagen de la aplicación mediante la siguiente estructura.
"ba-application": { "app-location": "${s3-source}/murachs-v6/", "files-directory": "/m2/mount/myfolder", "enable-jics": <true|false>, "shared-app-location": "${s3-source}/shared/" },
- app-location
-
La ubicación específica en Amazon S3 donde está almacenado el archivo de imagen de la aplicación.
- files-directory
-
(Opcional) La ubicación de los archivos de entrada/salida de los lotes. Debe ser una subcarpeta de la configuración de Amazon EFS o del punto de FSx montaje de Amazon a nivel de entorno. La subcarpeta debe ser propiedad de un usuario adecuado para que la utilice la aplicación Blu Age que se ejecuta en ella. AWS Mainframe Modernization Para ello, al adjuntar la unidad a una EC2 instancia de Amazon Linux, se
3001debe crear un grupo con ID101y un usuario con ID, y la carpeta deseada debe ser propiedad de este usuario. Por ejemplo, de esta forma, Blu Age AWS Mainframe Modernization Managed puede utilizar latestclientcarpeta.groupadd -g 101 mygroup useradd -M -g mygroup -p mypassword -u 3001 myuser mkdir testclient chown myuser:mygroup testclient - enable-jics
-
(Opcional) Especifica si se debe habilitarJICS. El valor predeterminado es true (verdadero). Si se establece en falso, se evita que se genere la JICS base de datos.
- shared-app-location
-
(Opcional) Ubicación adicional en Amazon S3 donde se almacenan los elementos de la aplicación compartidos. Puede contener el mismo tipo de estructura de aplicación que la ubicación de la aplicación.
BluSAM: opcional
Especifique la SAM base de datos Blu y la caché de Redis mediante la siguiente estructura.
"blusam": { "db": { "nb-threads": 8, "batch-size": 10000, "name": "blusam", "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:blusam-FfmXLG" }, "redis": { "hostname": "blusam.c3geul.ng.0001.usw2.cache.amazonaws.com", "port": 6379, "useSsl": true, "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:111122223333:secret:bluesamredis-nioefm" } }
- db
-
Especifica las propiedades de la base de datos utilizada con la aplicación. La base de datos debe ser una base de datos de Aurora Postgre. SQL Puede especificar las propiedades siguientes:
-
nb-threads- (Opcional) Especifica cuántos subprocesos dedicados se utilizan para el mecanismo de escritura trasera del que se basa el motor BluSAM. El valor predeterminado es 8. -
batch-size- (Opcional) Especifica el umbral que utiliza el mecanismo de escritura trasera para iniciar las operaciones de almacenamiento por lotes. El umbral representa el número de registros modificados que iniciarán una operación de almacenamiento por lotes para garantizar que los registros modificados se conserven. El desencadenante en sí se basa en una combinación del tamaño del lote y un tiempo transcurrido de un segundo, lo que se alcance primero. El valor predeterminado es 10000. -
name- (Opcional) Especifica el nombre de la base de datos. -
secret-manager-arn- Especifica el nombre de recurso de Amazon (ARN) del secreto que contiene las credenciales de la base de datos. Para obtener más información, consulte Paso 4: Crear y configurar un secreto de AWS Secrets Manager base de datos.
-
- Redis
-
Especifica las propiedades de la caché de Redis que la aplicación utiliza para almacenar los datos temporales que necesita en una ubicación central para mejorar el rendimiento. Le recomendamos que cifre y proteja con contraseña la caché de Redis.
-
hostname: especifica la ubicación de la caché de Redis. -
port: especifica el puerto, normalmente el 6379, al que la caché de Redis envía y recibe las comunicaciones. -
useSsl: especifica si la caché de Redis está cifrada. Si lo está, establezcauseSslen false. -
secret-manager-arn- Especifica el nombre de recurso de Amazon (ARN) del secreto que contiene la contraseña de caché de Redis. Si la caché de Redis no está protegida con contraseña, no especifiquesecret-manager-arn. Para obtener más información, consulte Paso 4: Crear y configurar un secreto de AWS Secrets Manager base de datos.
-
AWS Colas de mensajes de Blue Age: opcionales
Especifique los detalles de conexión JMS -MQ para la aplicación AWS Blu Age.
"message-queues": [ { "product-type": "JMS-MQ", "queue-manager": "QMgr1", "channel": "mqChannel1", "hostname": "mqserver-host1", "port": 1414, "user-id": "app-user1", "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:sample/mq/test-279PTa" }, { "product-type": "JMS-MQ", "queue-manager": "QMgr2", "channel": "mqChannel2", "hostname": "mqserver-host2", "port": 1412, "user-id": "app-user2", "secret-manager-arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:sample/mq/test-279PTa" } ]
- product-type
-
(Obligatorio) Especifica el tipo de producto. Actualmente, solo puede ser "JMS-MQ» para las aplicaciones de AWS Blu Age.
- queue-manager
-
(Obligatorio) Especifica el nombre del administrador de colas.
- channel
-
(Obligatorio) Especifica el nombre del canal de conexión al servidor.
- hostname
-
(Obligatorio) Especifica el nombre de host del servidor de cola de mensajes.
- port
-
(Obligatorio) Especifica el número de puerto de escucha en el que está escuchando el servidor.
- user-id
-
(Opcional) Especifica el ID de cuenta de usuario autorizado para realizar operaciones de cola de mensajes en el canal especificado.
- secret-manager-arn
-
(Opcional) Especifica el nombre de recurso de Amazon (ARN) de Secrets Manager que proporciona la contraseña del usuario especificado.
AWS EFSConfiguración de almacenamiento de la aplicación Blu Age: opcional
Especifique los detalles del punto de EFS acceso de almacenamiento de la aplicación mediante la siguiente estructura.
"ba-application": { "file-permission-mask": "UMASK002" }, "efs-configs": [ { "file-system-id": "fs-01376dfsvfvrsvsr", "mount-point": "/m2/mount/efs-ap2", "access-point-id": fsap-0eaesefvrefrewgv8" } ]
- file-system-id
-
(Obligatorio) El ID del sistema de EFS archivos al que se aplica el punto de acceso. Patrón: «fs- ([0-9a-f] {8,40}) {1,128} $»
- punto de montaje
-
(Obligatorio) El punto de montaje del sistema de archivos a nivel de aplicación. Debe ser diferente del punto de montaje del almacenamiento a nivel de entorno.
- access-point-id
-
(Obligatorio) El ID del punto de acceso, asignado por AmazonEFS. Patrón: «^fsap- ([0-9a-f] {8,40}) {1,128} $»
- file-permission-mask
-
(Opcional) Define la máscara de creación de archivos para los archivos creados por el proceso de solicitud. Por ejemplo, si el valor se establece en
UMASK006, todos los archivos tendrán el permiso 660. Esto significa que solo el propietario del archivo y el grupo de archivos tendrán acceso de lectura y escritura, mientras que los demás usuarios no tendrán ningún permiso.nota
El valor establecido para este campo solo se tiene en cuenta cuando se utiliza el EFS almacenamiento a nivel de aplicación.
nota
Cuando se proporciona la configuración efs, se debe especificar el directorio de archivos en la sección de definición de la aplicación. Debe ser una subcarpeta del punto de EFS montaje de Amazon configurada a nivel de aplicación.
Definición de la aplicación Micro Focus
La siguiente sección de ejemplos de definición está dedicada al motor de tiempo de ejecución de Micro Focus y contiene elementos obligatorios y opcionales.
{ "template-version": "2.0", "source-locations": [ { "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "mainframe-deployment-bucket-aaa", "s3-key-prefix": "v1" } } ], "definition" : { "listeners": [{ "port": 5101, "type": "tn3270" }], "dataset-location": { "db-locations": [{ "name": "Database1", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456" }] }, "cognito-auth-handler": { "user-pool-id": "cognito-idp.us-west-2.amazonaws.com/us-west-2_rvYFnQIxL", "client-id": "58k05jb8grukjjsudm5hhn1v87", "identity-pool-id": "us-west-2:64464b12-0bfb-4dea-ab35-5c22c6c245f6" }, "ldap-ad-auth-handler": { "ldap-ad-connection-secrets": [LIST OF AD-SECRETS] }, "batch-settings": { "initiators": [{ "classes": ["A", "B"], "description": "initiator...." }], "jcl-file-location": "${s3-source}/batch/jcl", "program-path": "/m2/mount/libs/loadlib:$EFS_MOUNT/emergency/loadlib", "system-procedure-libraries":"SYS1.PROCLIB;SYS2.PROCLIB", "aliases": [ {"alias": "FDSSORT", "program": "SORT"}, {"alias": "MFADRDSU", "program": "ADRDSSU"} ] }, "cics-settings": { "binary-file-location": "${s3-source}/cics/binaries", "csd-file-location": "${s3-source}/cics/def", "system-initialization-table": "BNKCICV" }, "jes-printers": [ { "name": "printerName", "classes": [ "A", "B" ], "description": "printer desc....", "exit-module": { "name": "lrsprte6" } } ], "xa-resources" : [{ "name": "XASQL", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456", "xa-connection-type": "postgres", "module": "${s3-source}/xa/ESPGSQLXA64.so" }], "runtime-settings": { "environment-variables": { "ES_JES_RESTART": "N", "EFS_MOUNT": "/m2/mount/efs", "LRSQ_ADDRESS": "<lrsq-address>" } } } }
Detalles de definición de Micro Focus
El contenido de la sección de definición del archivo de definición de la aplicación de Micro Focus varía en función de los recursos que la aplicación de la unidad central migrada requiera en tiempo de ejecución.
Oyente (es): obligatorio
Especifique un oyente mediante la siguiente estructura:
"listeners": [{ "port": 5101, "type": "tn3270" }],
- port
-
En el caso de tn3270, el valor predeterminado es 5101. Para otros tipos de oyentes de servicios, el puerto varía. Puede usar cualquier puerto disponible, excepto los puertos bien conocidos del 0 al 1023. Cada oyente debe tener un puerto distintivo. Los oyentes no deben compartir puertos. Para obtener más información, consulte Listener Control
en la documentación de Micro Focus Enterprise Server. - type
-
Especifica el tipo de oyente del servicio. Para obtener más información, consulte Listeners
en la documentación de Micro Focus Enterprise Server.
Ubicaciones de los conjuntos de datos: obligatorias
Especifique la ubicación del conjunto de datos mediante la siguiente estructura.
"dataset-location": { "db-locations": [{ "name": "Database1", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456" }], }
- db-locations
-
Especifica la ubicación de los conjuntos de datos que crea la aplicación migrada. Actualmente, solo AWS Mainframe Modernization admite conjuntos de datos de una única VSAM base de datos.
-
name: especifica el nombre de la instancia de base de datos que contiene los conjuntos de datos que crea la aplicación migrada. -
secret-manager-arn- Especifica el nombre de recurso de Amazon (ARN) del secreto que contiene las credenciales de la base de datos.
-
Controlador de autenticación y autorización de Amazon Cognito: opcional
AWS Mainframe Modernization utiliza Amazon Cognito para la autenticación y autorización de las aplicaciones migradas. Especifique el controlador de autenticación de Amazon Cognito mediante la siguiente estructura.
"cognito-auth-handler": { "user-pool-id": "cognito-idp.Region.amazonaws.com/Region_rvYFnQIxL", "client-id": "58k05jb8grukjjsudm5hhn1v87", "identity-pool-id": "Region:64464b12-0bfb-4dea-ab35-5c22c6c245f6" }
- user-pool-id
-
Especifica el grupo de usuarios de Amazon Cognito que se AWS Mainframe Modernization utiliza para autenticar a los usuarios de la aplicación migrada. El del grupo Región de AWS de usuarios debe coincidir con el de Región de AWS la AWS Mainframe Modernization aplicación.
- client-id
-
Especifica la aplicación migrada a la que puede acceder el usuario autenticado.
- identity-pool-id
-
Especifica el grupo de identidades de Amazon Cognito en el que el usuario autenticado intercambia un token del grupo de usuarios por credenciales que permiten al usuario acceder. AWS Mainframe Modernization El del grupo Región de AWS de identidades debe coincidir con el de Región de AWS la AWS Mainframe Modernization aplicación.
LDAPy el controlador de Active Directory (opcional)
Puede integrar la aplicación con Active Directory (AD) o cualquier tipo de LDAP servidor para que los usuarios de la aplicación puedan utilizar sus credenciales LDAP /AD para la autorización y la autenticación.
Para integrar su aplicación con AD
-
Siga los pasos descritos en Configuring Active Directory for Enterprise Server Security
, en la documentación de Micro Focus Enterprise Server. -
Cree un AWS Secrets Manager secreto con el AD/LDAP details for each AD/LDAP servidor que desee usar con la aplicación. Para obtener información sobre cómo crear un secreto, consulte Crear un secreto de AWS Secrets Manager en la Guía del AWS Secrets Manager usuario. Para el tipo de secreto, elija Otro tipo de secreto e incluya los siguientes pares clave-valor.
{ "connectionPath" : "<HOST-ADDRESS>:<PORT>", "authorizedId" : "<USER-FULL-DN>", "password" : "<PASSWORD>", "baseDn" : "<BASE-FULL-DN>", "userClassDn" : "<USER-TYPE>", "userContainerDn" : "<USER-CONTAINER-DN>", "groupContainerDn" : "<GROUP-CONTAINER-DN>", "resourceContainerDn" : "<RESOURCE-CONTAINER-DN>" }Recomendaciones de seguridad
-
Para
connectionPath, AWS Mainframe Modernization es compatible con los protocolos LDAP and LDAP over SSL (LDAPS). Recomendamos su uso LDAPS porque es más seguro y evita que las credenciales aparezcan en las transmisiones de red. -
Para
authorizedIdypassword, le recomendamos que especifique las credenciales de un usuario sin más permisos que los permisos de verificación y de solo lectura más restrictivos que se requieren para que la aplicación se ejecute. -
Recomendamos rotar las LDAP credenciales AD/ de forma regular.
-
No cree usuarios de AD con el nombre de usuario
awsuseromfuser. Estos dos nombres de usuario están reservados para el uso de AWS .
A continuación, se muestra un ejemplo.
{ "connectionPath" : "ldaps://msad4.m2.example.people.aws.dev:636", "authorizedId" : "CN=LDAPUser,OU=Users,OU=msad4,DC=msad4,DC=m2,DC=example,DC=people,DC=aws,DC=dev", "password" : "ADPassword", "userContainerDn" : "CN=Enterprise Server Users,CN=Micro Focus,CN=Program Data,OU=msad4,DC=msad4,DC=m2,DC=example,DC=people,DC=aws,DC=dev", "groupContainerDn" : "CN=Enterprise Server Groups,CN=Micro Focus,CN=Program Data,OU=msad4,DC=msad4,DC=m2,DC=example,DC=people,DC=aws,DC=dev", "resourceContainerDn" : "CN=Enterprise Server Resources,CN=Micro Focus,CN=Program Data,OU=msad4,DC=msad4,DC=m2,DC=example,DC=people,DC=aws,DC=dev" }Cree el secreto con una clave gestionada por el clienteKMS. Debe conceder AWS Mainframe Modernization los
DescribeSecretpermisosGetSecretValuey sobre el secretoDecrypty losDescribeKeypermisos sobre la KMS clave. Para obtener más información, consulta los permisos de la KMS clave en la Guía del AWS Secrets Manager usuario. -
-
Agregue el código siguiente a la definición de la aplicación.
"ldap-ad-auth-handler": { "ldap-ad-connection-secrets": [LIST OF AD/LDAP SECRETS] }A continuación, se muestra un ejemplo.
"ldap-ad-auth-handler": { "ldap-ad-connection-secrets": ["arn:aws:secrets:1234:us-east-1:secret:123456"] }
Si la aplicación está integrada LDAP y se ha iniciado, debe proporcionar las credenciales para ejecutar al menos una de las operaciones relacionadas con la aplicación mencionadas en la lista de autorizaciones admitidas.
El controlador de autenticación LDAP /AD está disponible para Micro Focus 8.0.11 y versiones posteriores.
nota
Actualmente, el LDAP administrador debe proporcionar permisos de «modificación» sobre la casstart utilidad en los recursos del servidor empresarial «OPERCMDS» de su directorio. LDAP Esto debe hacerse para que todos los usuarios predeterminados necesarios (por ejemploCICSUSER, si la aplicación está CICS relacionada) puedan iniciar la aplicación correctamente.
Para proporcionar las credenciales LDAP de usuario para la autenticación y la autorización
-
Cree una AWS Secrets Manager con las siguientes claves y valores:
{ "username" : "<USERNAME>", "password" : "<PASSWORD>" }importante
Debe tener los derechos de ejecución
DescribeSecretsyGetSecretValuesobre el Secrets Manager que se utilice. Además, asocie una KMS clave y los permisos necesarios para el AWS Secrets Manager, como se menciona en Elegir un AWS KMS key. -
Elija el parámetro Secrets Manager.
Esta es la lista de operaciones de la aplicación que actualmente admiten la autorización:
-
StartBatchJob -
CancelBatchJobExecution -
ListBatchJobRestartPoints
Configuración de lotes: obligatoria
Especifique los detalles necesarios para los trabajos por lotes que se ejecutan como parte de la aplicación mediante la siguiente estructura.
"batch-settings": { "initiators": [{ "classes": ["A", "B"], "description": "initiator...." }], "jcl-file-location": "${s3-source}/batch/jcl", "program-path": "/m2/mount/libs/loadlib:$EFS_MOUNT/emergency/loadlib", "system-procedure-libraries":"SYS1.PROCLIB;SYS2.PROCLIB", "aliases": [ {"alias": "FDSSORT", "program": "SORT"}, {"alias": "MFADRDSU", "program": "ADRDSSU"} ] }
- initiators
-
Especifica un iniciador de lotes que se inicia cuando la aplicación migrada se inicia correctamente y continúa ejecutándose hasta que la aplicación se detiene. Puede definir una o más clases por iniciador. También puede definir varios iniciadores. Por ejemplo:
"batch-settings": { "initiators": [ { "classes": ["A", "B"], "description": "initiator...." }, { "classes": ["C", "D"], "description": "initiator...." } ], }Para obtener más información, consulte Para definir un iniciador de lotes o una impresora SEP
en la documentación de Micro Focus Enterprise Server. -
classes: especifica las clases de trabajo que puede ejecutar el iniciador. Puede usar hasta 36 caracteres. Puede usar los siguientes caracteres: A-Z o 0-9. -
description: describe para qué sirve el iniciador.
-
- jcl-file-location
-
Especifica la ubicación de los archivos JCL (Job Control Language) que requieren los trabajos por lotes que ejecuta la aplicación migrada.
- ruta del programa
-
Especifica la ruta necesaria para ejecutar trabajos por lotes cuando un programa de a no JCL se encuentra en la ubicación predeterminada. Los nombres de las distintas rutas se separan con dos puntos (:).
nota
La ruta del programa solo puede ser una EFS ruta.
- system-procedure-libraries
-
Especifica los conjuntos de datos particionados predeterminados en los que se buscarán los JCL procedimientos. Sin embargo, el procedimiento no se encuentra en las JCLLIB instrucciones JCL ni a través de ellas. Estos conjuntos de datos deben estar catalogados y debe usarse el nombre del catálogo. Y las entradas se separan con punto y coma (;).
- alias
-
Define un mapeo de los nombres de programas y utilidades utilizados en JCL el nombre de implementación de la utilidad. AWS y las utilidades por lotes de terceros (p. ej.SFTP, M2WAIT, Syncsort, etc.) pueden tener alias de forma opcional para eliminar la necesidad de cambiarlos. JCL Por ejemplo:
-
FDSSORTAlias para y alias FDSSORT para SORT FDSICET ICETOOL
-
ADRDSSUAlias MFADRDSU de ADRDSSU
-
Alias de Syncsort para DMXMFSRT SORT
-
CICSconfiguración: requerida
Especifique los detalles necesarios para las CICS transacciones que se ejecutan como parte de la aplicación mediante la siguiente estructura.
"cics-settings": { "binary-file-location": "${s3-source}/cics/binaries", "csd-file-location": "${s3-source}/cics/def", "system-initialization-table": "BNKCICV" }
- binary-file-location
-
Especifica la ubicación de los archivos del programa de CICS transacciones.
- csd-file-location
-
Especifica la ubicación del archivo de definición de CICS recursos (CSD) de esta aplicación. Para obtener más información, consulte las definiciones CICS de recursos
en la documentación de Micro Focus Enterprise Server. - system-initialization-table
-
Especifica la tabla de inicialización del sistema (SIT) que utiliza la aplicación migrada. El nombre de la SIT tabla puede tener un máximo de 8 caracteres. Puede usar A-Z, 0-9, $, @ y #. Para obtener más información, consulte las definiciones CICS de recursos
en la documentación de Micro Focus Enterprise Server.
Impresoras: opcionales
Especifique una impresora jet con la siguiente estructura.
"jes-printers": [ { "name": "printerName", "classes": [ "A", "B" ], "description": "printer desc....", "exit-module": { "name": "lrsprte6", "module" : "program" } } ],
nota
Puede haber un máximo de 25 impresoras configuradas para una aplicación determinada.
- name
-
(Obligatorio) Especifica el nombre que se va a asociar a este recurso de impresora. Los nombres deben ser únicos para cada impresora y se puede utilizar un límite de 128 caracteres alfanuméricos.
- clases
-
(Obligatorio) Especifica las clases de salida aplicables a este recurso de impresora. Se puede utilizar un límite de 36 caracteres alfanuméricos.
- description
-
(Opcional) Texto descriptivo adicional para la impresora.
- módulo de salida
-
(Opcional) Especifica un módulo personalizado para la salida de impresión. No hay valores predeterminados; si no se especifican, no se utilizará ningún módulo de salida. Puede utilizar un módulo de salida de impresión gestionado o suministrar el suyo propio. Los módulos de salida de impresión gestionados se definen utilizando un nombre reservado
lrsprte6para la LRS cola o bien, introduzca el suyo propio mediante el parámetro del módulo para especificar la ubicación y el nombre.La estructura de
exit-moduletiene dos componentes:-
name- (Obligatorio), siexit-modulese utiliza. El nombre de la entrada del módulo de salida. El nombre de entrada del módulo de salida está limitado a un máximo de 8 caracteres. -
module- (Opcional) La ubicación en S3 del binario del módulo de salida de impresión.
-
Puede ver más ejemplos de cómo definir el módulo de salida en la Impresoras sección.
Recursos de XA: opcionales
Especifique los detalles necesarios para los recursos de XA que requiere la aplicación mediante la siguiente estructura.
"xa-resources" : [{ "name": "XASQL", "secret-manager-arn": "arn:aws:secrets:1234:us-east-1:secret:123456", "xa-connection-type": "postgres", "module": "${s3-source}/xa/ESPGSQLXA64.so" }]
nota
La definición del recurso XA se ha actualizado para incluir un xa-connection-type campo opcional. Si no se proporciona, se supone que el tipo de conexión es «postgres».
- name
-
(Obligatorio) Especifica el nombre del recurso XA.
- secret-manager-arn
-
(Obligatorio) Especifica el nombre del recurso de Amazon (ARN) para el secreto que contiene las credenciales para conectarse a la base de datos.
- xa-connection-type
-
(Opcional) Especifica el tipo de conexión de recursos XA.
- module
-
(Obligatorio) Especifica la ubicación del archivo ejecutable del módulo conmutador RM. Para obtener más información, consulte Planificación y diseño XARs
en la documentación de Micro Focus Enterprise Server.
Configuración de tiempo de ejecución: opcional
Especifique los detalles necesarios para que la configuración del tiempo de ejecución gestione las variables de entorno permitidas mediante la siguiente estructura.
"runtime-settings": { "environment-variables": { "ES_JES_RESTART": "N", "EFS_MOUNT": "/m2/mount/efs" } }
- variables de entorno
-
Especifica las variables de entorno compatibles con Micro Focus que se aplican al tiempo de ejecución de esta aplicación.
-
ES_JES_RESTARTes una variable de entorno de Micro Focus que permite JCL reiniciar el procesamiento. Opcionalmente, también se puede utilizarES_ALLOC_OVERRIDEcomo variable de entorno de Micro Focus. -
EFS_MOUNTes una variable de entorno personalizada que la aplicación puede utilizar para identificar la ubicación del EFS montaje del entorno.
-
Puede acceder a todas las variables de entorno de Micro Focus
