AWS El servicio de modernización de mainframes (experiencia en entornos de ejecución gestionados) ya no está abierto a nuevos clientes. Para obtener prestaciones similares a las del Servicio de Modernización de AWS Mainframe (experiencia en entornos de ejecución gestionados), explore el Servicio de Modernización de AWS Mainframe (experiencia autogestionada). Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de la modernización del [AWS mainframe.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html) 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. # Replataforma aplicaciones con Rocket Software (anteriormente Micro Focus) Esta guía describe el end-to-end proceso de cambio de plataforma de las aplicaciones de mainframe utilizando soluciones de modernización de AWS mainframe en. AWS Describe todas las tareas e incluye información sobre la configuración y el funcionamiento del entorno de ejecución de modernización de AWS mainframe en Amazon, EC2 desde la configuración y el análisis iniciales hasta la creación, las pruebas y el despliegue de las aplicaciones modernizadas. AWS También se tratan temas avanzados, como el trabajo con estructuras de datos heredadas, el uso de plantillas y proyectos predefinidos, y la configuración de la automatización para las sesiones de streaming. **Topics** + [Configurar Rocket Software (anteriormente Micro Focus) (en Amazon EC2)](mf-runtime-setup.md) + [Configure la automatización para las sesiones de streaming de Rocket Enterprise Analyzer (anteriormente Micro Focus) y Rocket Enterprise Developer](set-up-automation-m2.md) + [Vea los conjuntos de datos como tablas y columnas en Rocket Enterprise Developer (anteriormente Micro Focus Enterprise Developer)](view-datasets-tables-m2.md) + [Edite conjuntos de datos con las herramientas de archivos de datos de Rocket Software (anteriormente Micro Focus) en Enterprise Developer](edit-datasets-m2.md) + [Tutoriales para Rocket Software (anteriormente Micro Focus)](tutorials-mf.md) + [Utilidades por lotes disponibles en AWS Mainframe Modernization](utilities-m2.md) # Configurar Rocket Software (anteriormente Micro Focus) (en Amazon EC2) AWS Mainframe Modernization proporciona varios Amazon Machine Images (AMIs) que incluyen productos con licencia de Rocket Software (anteriormente Micro Focus). Esto AMIs le permite aprovisionar rápidamente instancias de Amazon Elastic Compute Cloud (Amazon EC2) para que sean compatibles con los entornos de Rocket Software que usted controla y administra. En este tema se proporcionan los pasos necesarios para acceder a ellos y lanzarlos AMIs. Su uso AMIs es totalmente opcional y no es obligatorio para completar los tutoriales de esta guía del usuario. **Topics** + [Requisitos previos para configurar Rocket Software (anteriormente Micro Focus) (en Amazon EC2)](mf-runtime-setup-prereq.md) + [Creación de puntos de conexión de VPC de Amazon para Amazon S3](mf-runtime-setup-vpc.md) + [Solicitud de actualización de la lista de permitidos de la cuenta](mf-runtime-setup-allowlist.md) + [Crea el AWS Identity and Access Management rol](mf-runtime-setup-iam-role.md) + [Concesión de permisos necesarios con License Manager](mf-runtime-setup-lic.md) + [Suscríbase a Amazon Machine Images](mf-runtime-setup-ami.md) + [Lance una instancia de AWS Mainframe Modernization Rocket Software (anteriormente Micro Focus)](mf-runtime-setup-mf-instance.md) + [Subred o VPC sin acceso a Internet](mf-runtime-setup-no-access.md) # Requisitos previos para configurar Rocket Software (anteriormente Micro Focus) (en Amazon EC2) Al configurar Rocket Software (en Amazon EC2), asegúrate de cumplir los siguientes requisitos previos. + Acceso de administrador a la cuenta en la que se crearán EC2 las instancias de Amazon. + Identifica el Región de AWS lugar donde se crearán EC2 las instancias de Amazon y verifica que el AWS Mainframe Modernization servicio esté disponible. Consulte [Servicios de AWS por región](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). Asegúrese de elegir una región en la que el servicio esté disponible. + Identifique la Amazon Virtual Private Cloud (Amazon VPC) en la que se crearán EC2 las instancias de Amazon. # Creación de puntos de conexión de VPC de Amazon para Amazon S3 En esta sección, se crea un punto de conexión de Amazon VPC para Amazon S3. La configuración de este punto de conexión le ayudará más adelante a la hora de configurar el acceso a Internet para VPC. 1. Vaya a Amazon VPC en la Consola de administración de AWS. 1. En el panel de navegación, elija **Puntos de conexión**. 1. Elija **Crear punto de conexión**. ![\[Puntos de conexión de VPC con la opción Crear punto de conexión activo.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-s3-endpoint_1.jpg) 1. Introduzca una etiqueta con un nombre significativo, por ejemplo: “Micro-Focus-License-S3”. 1. Elija **Servicios de AWS** en Categoría de servicio. ![\[Configuración del punto de conexión con etiqueta de nombre de ejemplo.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-s3-endpoint_2.png) 1. En **Servicios**, busque el servicio de puerta de enlace de Amazon S3: **com.amazonaws. [región] .s3**. Para `us-west-1` sería: `com.amazonaws.us-west-1.s3`. 1. Elija el servicio **Puerta de enlace**. ![\[Servicios con el servicio de puerta de enlace de Amazon S3 seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-s3-endpoint_3.png) 1. Como VPC, elija la VPC que vaya a utilizar. ![\[VPC con una VPC especificada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-s3-endpoint_4.png) 1. Elija todas las tablas de enrutamiento de la VPC. ![\[Tablas de enrutamiento con todas las tablas de enrutamiento seleccionadas.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-s3-endpoint_5.png) 1. En **Política**, seleccione **Full Acces**. ![\[Política con acceso total seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-s3-endpoint_6.png) **nota** Si decide crear una política personalizada, asegúrese de que tiene acceso al bucket de Amazon S3 `s3://aws-supernova-marketplace--prod`. 1. Elija **Crear punto de conexión**. # Solicitud de actualización de la lista de permitidos de la cuenta Trabaje con su AWS representante para incluir su cuenta en la lista de permitidos para. AWS Mainframe Modernization AMIs Proporcione la siguiente información: + La Cuenta de AWS identificación. + El Región de AWS lugar donde se creó el punto final de Amazon VPC. + El ID del punto de conexión de Amazon VPC para Amazon S3 que se creó en [Creación de puntos de conexión de VPC de Amazon para Amazon S3](mf-runtime-setup-vpc.md). Este es el identificador `vpce-xxxxxxxxxxxxxxxxx` del punto de conexión **com.amazonaws.[region].s3 Gateway** + El número de licencias necesarias en todas las EC2 instancias de Amazon (AMI) de Rocket Software Enterprise Suite. Se requiere una licencia por núcleo de CPU (por cada 2 v CPUs para la mayoría de las EC2 instancias de Amazon). Para obtener más información, consulte [Optimización de las opciones de CPU](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-compute-optimized). El número solicitado se puede ajustar en el futuro mediante AWS. **nota** Ponte en contacto con tu AWS representante o con la AWS Support persona que abra el formulario de asistencia para solicitar la lista de permitidos en tu nombre. No puedes solicitarlo directamente y la solicitud puede tardar varios días en completarse. # Crea el AWS Identity and Access Management rol Crea una AWS Identity and Access Management política y un rol para que los usen las EC2 instancias de AWS Mainframe Modernization Amazon. Al crear el rol a través de la consola de IAM, se creará un perfil de instancia asociado con el mismo nombre. Al asignar este perfil de instancia a las EC2 instancias de Amazon, se pueden asignar licencias de software de Rocket. Para obtener más información sobre los perfiles de instancia, consulta Cómo [usar un rol de IAM para conceder permisos a las aplicaciones que se ejecutan en EC2 instancias de Amazon](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html). ## Creación de una política de IAM Primero se crea una política de IAM y después se asocia al rol. 1. Navegue hasta AWS Identity and Access Management . Consola de administración de AWS 1. Elija **Políticas** y, a continuación, **Crear política**. ![\[Página de políticas sin filtros aplicados.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-policy_1.png) 1. Seleccione la pestaña **JSON**. ![\[Pestaña JSON sin contenido\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-policy_2.png) 1. Sustituya `us-west-1` el siguiente JSON por el Región de AWS lugar donde se definió el punto de conexión de Amazon S3 y, a continuación, copie y pegue el JSON en el editor de políticas. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "S3WriteObject", "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3:::aws-supernova-marketplace-us-west-1-prod/*" ] }, { "Sid": "OtherRequiredActions", "Effect": "Allow", "Action": [ "sts:GetCallerIdentity", "ec2:DescribeInstances", "license-manager:ListReceivedLicenses" ], "Resource": [ "*" ] } ] } ``` ------ **nota** Las acciones bajo el Sid `OtherRequiredActions` no admiten permisos de recursos y deben especificar `*` en el elemento de recurso. ![\[Pestaña JSON con la política especificada y us-west-1 resaltada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-policy_3.png) 1. Elija **Siguiente: etiquetas**. ![\[Etiquetas en las que no se ha introducido ningún dato.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-policy_4.png) 1. Si lo desea, introduzca cualquier etiqueta y, a continuación, seleccione **Siguiente: Revisar**. 1. Introduzca un nombre para la política, por ejemplo, “Microfocus Licensing-Policy”. Si lo desea, introduzca una descripción, por ejemplo: «Debe adjuntarse un rol que incluya esta política a cada EC2 instancia de AWS Mainframe Modernization Amazon». ![\[Política de revisión con nombre y descripción.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-policy_5.png) 1. Elija **Crear política**. ## Creación del rol de IAM Después de crear una política de IAM, cree un rol de IAM y asócielo a la política. 1. En la Consola de administración de AWS, vaya a IAM. 1. Elija **Roles** y, a continuación, **Crear rol**. ![\[Roles sin filtro aplicado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-role_1.png) 1. Deje el **tipo de entidad de confianza** como **AWS servicio** y elija el caso de uso **EC2**habitual. ![\[Seleccione una entidad de confianza con AWS servicio y EC2 seleccione\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-role_2.png) 1. Elija **Siguiente**. 1. Introduzca “Micro” en el filtro y pulse Intro para aplicar el filtro. 1. Elija la política que se acaba de crear, por ejemplo, la “Micro-Focus-Licensing-policy”. 1. Elija **Siguiente**. ![\[Añada permisos con la política de Micro Focus seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-role_3.png) 1. Introduzca el nombre del rol, por ejemplo, “Micro-focus-Licensing-Role”. 1. Sustituya la descripción por una propia, por ejemplo, «Permite que EC2 las instancias de Amazon con este rol obtengan licencias de Micro Focus». ![\[Detalles del rol con nombre y descripción.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-role_4.png) 1. En el **Paso 1: Seleccionar entidades de confianza**, revise el JSON y confirme que tiene los siguientes valores: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sts:AssumeRole" ], "Principal": { "Service": [ "ec2.amazonaws.com" ] } } ] } ``` ------ **nota** El orden del efecto, la acción y el principio no son significativos. 1. Confirme que el **Paso 2: Agregar permisos** muestre su política de licencias. ![\[Paso 2: Agregar permisos con la política de licencias seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-create-iam-role_6.png) 1. Elija **Create role**. Una vez que se haya completado la solicitud de lista de permitidos, continúe con los siguientes pasos. # Concesión de permisos necesarios con License Manager Debes concederte permisos AWS License Manager para configurar el motor de ejecución de Rocket Software (en Amazon EC2). 1. Navegue hasta AWS License Manager Consola de administración de AWS. ![\[AWS License Manager página de inicio.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-license-manager_1.png) 1. Elija **Comenzar a usar AWS License Manager**. 1. Si ve la siguiente ventana emergente, consulte los detalles, seleccione la casilla de verificación y pulse **Conceder permisos**. ![\[Configuración única de los permisos de IAM\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-license-manager_2.png) # Suscríbase a Amazon Machine Images Tras suscribirse a un AWS Marketplace producto, puede lanzar una instancia desde la AMI del producto. También puedes gestionar tus suscripciones AMIs al configurar el motor de ejecución de Rocket Software (anteriormente Micro Focus) (en Amazon EC2). 1. Ve a AWS Marketplace Suscripciones en. Consola de administración de AWS 1. Elija **Administrar suscripciones**. ![\[AWS Marketplace página de inicio.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-ami-subscription_1.png) 1. Copie y pegue uno de los siguientes enlaces en la barra de direcciones del navegador. **nota** Elija únicamente un enlace para uno de los productos para los que esté autorizado a utilizar. Asegúrese de que su cuenta esté incluida en la lista de permitidos siguiendo la [Solicitud de actualización de la lista de permitidos de la cuenta](mf-runtime-setup-allowlist.md) página para utilizar estos enlaces. + [Servidor empresarial: https://aws.amazon.com/marketplace/ pp/prodview-g5emev63l7blc](https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc) + [Servidor empresarial para Windows: pp/prodview-lwybsiyikbhc2 https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2) + [Desarrollador empresarial: pp/prodview-77qmpr42yzxwk https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk) + [Desarrollador empresarial con Visual Studio 2022: pp/prodview-m4l3lqiszo6cm https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm) + [Analizador empresarial: pp/prodview-tttheylcmcihm https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm) + [Herramientas de creación empresarial para Windows: pp/prodview-2rw35bbt6uozi https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi) + [Procedimientos almacenados empresariales: pp/prodview-zoeyqnsdsj6ha https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha) + [Procedimientos almacenados empresariales con SQL Server 2019: pp/prodview-ynfklquwubnz4 https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4) 1. Elija **Continuar con la suscripción**. ![\[Oferta AWS Marketplace de servidores empresariales en.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-ami-subscription_2.png) 1. Si los términos y condiciones son aceptables, seleccione **Aceptar términos**. ![\[Términos y condiciones de suscripción\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-ami-subscription_3.png) 1. El proceso de suscripción puede tardar unos minutos. ![\[Mensaje de suscripción pendiente.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-ami-subscription_4.png) 1. Cuando aparezca el mensaje de agradecimiento, copie y pegue el siguiente enlace del paso 3 para seguir añadiendo suscripciones. ![\[Mensaje de agradecimiento por la suscripción.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-ami-subscription_5.png) 1. Detener cuando la **opción Administrar suscripciones** muestre todos los suscriptores. AMIs **nota** Las preferencias del panel (icono con forma de engranaje) están configuradas para mostrar la vista en forma de tabla. ![\[Administra las suscripciones con la lista de suscriptores AMIs.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-ami-subscription_6.png) # Lance una instancia de AWS Mainframe Modernization Rocket Software (anteriormente Micro Focus) Tras crear los puntos de enlace, la política de IAM, la función de IAM y suscribirse a ellos AMIs, estará listo para lanzar una instancia de AWS Mainframe Modernization Rocket Software (Micro Focus) en la. Consola de administración de AWS 1. Navegue hasta Suscripciones en. AWS Marketplace Consola de administración de AWS 1. Localice la AMI que se va a lanzar y elija **Lanzamiento de una instancia nueva**. ![\[Administre las suscripciones con Enterprise Server y Enterprise Analyzer listos para el lanzamiento.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_1.png) 1. En el cuadro de diálogo de lanzamiento de una nueva instancia, asegúrese de seleccionar la región de la lista de permitidos. 1. Presiona **Continuar para iniciar EC2**. **nota** El siguiente ejemplo muestra el lanzamiento de una AMI para desarrolladores empresariales, pero el proceso es el mismo para todas las AWS Mainframe Modernization AMIs. ![\[Lanzar una nueva instancia.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_2.png) 1. Escriba un nombre del servidor. 1. Elija un tipo de instancia. El tipo de instancia seleccionado debe determinarse en función de los requisitos de rendimiento y coste del proyecto. Se sugieren los siguientes puntos de partida: + Para Enterprise Analyzer, un r6i.xlarge + Para Enterprise Developer, un r6i.large + Para una instancia independiente de Enterprise Server, un r6i.xlarge + En el caso de Rocket Software Performance Availability Cluster (PAC) con escalabilidad horizontal, un r6i.large **nota** La sección Application and OS Images se ha reducido para la captura de pantalla. ![\[Lanzamiento de una instancia con nombre y tipo de instancia.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_3.png) 1. Elija o cree (y guarde) un par de claves (no se muestran). Para obtener más información sobre los pares de claves para instancias de Linux, consulta [Pares de EC2 claves e instancias de Linux de Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html). Para obtener más información sobre los pares de claves para instancias de Windows, consulta [Pares de EC2 claves e instancias de Windows de Amazon](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html). 1. Edite la configuración de red y **elija la VPC de la lista de permitidos** y la subred adecuada. 1. **Elija o cree un nuevo grupo de seguridad**. Si se trata de una EC2 instancia de Enterprise Server, lo habitual es permitir que el tráfico TCP llegue a los puertos 86 y 10086 para administrar la configuración de Rocket Software. 1. Si lo desea, configure el almacenamiento de la EC2 instancia de Amazon. 1. Importante: amplíe los detalles avanzados y, en el perfil de instancia de IAM, elija la función de licencia creada anteriormente, por ejemplo, “Micro-focus-Licensing-role”. **nota** Si omite este paso, una vez creada la instancia, puede modificar la función de IAM desde la opción Seguridad del menú de acciones de la EC2 instancia. ![\[Detalles avanzados con perfil de instancia de IAM\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_4.png) 1. Revise el resumen y pulse **Lanzar instancia**. ![\[Resumen con las opciones seleccionadas.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_5.png) 1. El lanzamiento de la instancia fallará si se elige un tipo de servidor virtual no válido. Si esto ocurre, seleccione **Editar configuración de instancias** y cambie el tipo de instancia. ![\[Mensaje de progreso de la instancia de lanzamiento.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_6.png) 1. Cuando aparezca el mensaje “Correcto”, seleccione **Conectarse a la instancia** para obtener los detalles de la conexión. ![\[Mensaje de lanzamiento correcto de la instancia.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_7.png) 1. Como alternativa, navegue hasta **EC2**. Consola de administración de AWS 1. Elija **Instancias** para ver el estado de la nueva instancia. ![\[Lista de instancias con estado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-launch-instance_8.png) # Subred o VPC sin acceso a Internet Realice estos cambios adicionales si la subred o la VPC no tienen acceso a Internet de salida. El administrador de licencias requiere acceso a los siguientes servicios de AWS: + com.amazonaws. *region*.s3 + com.amazonaws. *region*.ec2 + com.amazonaws. *region*.administrador de licencias + com.amazonaws. *region*.sts Los pasos anteriores definieron el com.amazonaws. *region*El servicio.s3 como punto final de puerta de enlace. Este punto de conexión necesita una entrada en la tabla de enrutamiento para cualquier subred sin acceso a Internet. Los tres servicios adicionales se definirán como puntos de conexión de interfaz. **Topics** + [Añadir la entrada de la tabla de enrutamiento para el punto de conexión Amazon S3](#mf-runtime-setup-no-access-route-table) + [Definición del grupo de seguridad necesario](#mf-runtime-setup-no-access-security-group) + [Creación de puntos de conexión del servicio](#mf-runtime-setup-no-access-endpoints) ## Añadir la entrada de la tabla de enrutamiento para el punto de conexión Amazon S3 1. **Navegue hasta **VPC** en Consola de administración de AWS y elija Subredes.** 1. Elija la subred en la que se crearán EC2 las instancias de Amazon y elija la pestaña Tabla de rutas. 1. Anote algunos dígitos finales del identificador de la tabla de enrutamiento. Por ejemplo, 6b39 de la imagen de abajo. ![\[Detalles de la tabla de enrutamiento.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_1.png) 1. En el panel de navegación, elija **Puntos de conexión**. 1. Elija el punto de conexión creado anteriormente y, a continuación, **Administrar tablas de enrutamiento** en la pestaña Tablas de enrutamiento del punto de conexión o en el menú desplegable Acciones. 1. Elija la tabla de enrutamiento con los dígitos identificados anteriormente y pulse Modificar tablas de enrutamiento. ![\[Tabla de enrutamiento seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_2.png) ## Definición del grupo de seguridad necesario Los servicios Amazon EC2 y License Manager se comunican a través de HTTPS a través del puerto 443. AWS STS Esta comunicación es bidireccional y requiere reglas de entrada y salida para permitir que la instancia se comunique con los servicios. 1. Vaya a Amazon VPC en la Consola de administración de AWS. 1. En el panel de navegación, en **Grupos de seguridad**, elija **Crear grupo de seguridad**. 1. Introduzca el nombre y la descripción de un grupo de seguridad, por ejemplo, “Inbound-Outbound HTTPS”. 1. Pulse la X en el área de selección de VPC para **eliminar la VPC predeterminada** y elija la VPC que contenga el punto de conexión de S3. 1. Agregue una regla de entrada que **permita el tráfico TCP en el puerto 443** desde cualquier lugar. **nota** Las reglas de entrada (y de salida) se pueden restringir aún más limitando el origen. Para obtener más información, consulte [Controle el tráfico a sus AWS recursos mediante grupos de seguridad](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) en la Guía del *usuario de Amazon VPC*. ![\[Detalles básicos con regla de entrada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_3.png) 1. Pulse **Crear grupo de seguridad**. ## Creación de puntos de conexión del servicio Repita este proceso tres veces, una para cada servicio. 1. **Diríjase a Amazon VPC en Consola de administración de AWS y seleccione Endpoints.** 1. Pulse **Crear punto de conexión**. 1. Introduzca un nombre, por ejemplo, «Micro-Focus-License-EC2», «Micro-Focus-License-STS» o «Micro-Focus-License-Manager». 1. Elija **Servicios de AWS** en Categoría de servicio. ![\[Configuración del AWS punto final con los servicios seleccionados.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_4.png) 1. En Servicios, busque el servicio de interfaz correspondiente, que sea uno de los siguientes: + «com.amazonaws. *region*.ec2» + «com.amazonaws. *region*.sts» + «com.amazonaws. *region*.administrador de licencias» Por ejemplo: + “com.amazonaws.us-west-1.ec2” + “com.amazonaws.us-west-1.sts” + “com.amazonaws.us-west-1.license-manager” 1. Elija el servicio de interfaz correspondiente. **com.amazonaws. *region*.ec2:** ![\[Servicios con el servicio EC2 de interfaz de Amazon seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_5.png) **com.amazonaws. *region*.sts:** ![\[Servicios con el servicio AWS STS de interfaz seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_6.png) **com.amazonaws. *region*.administrador de licencias:** ![\[Servicios con el servicio de interfaz License Manager seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_7.png) 1. En VPC, elija la VPC para su instancia. ![\[VPC con la VPC de la instancia seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_8.png) 1. Elija la **Zona de disponibilidad** y las **Subredes** de la VPC. ![\[Subredes con zona de disponibilidad y subred para la VPC seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_9.png) 1. Elija el Grupo de seguridad creado anteriormente. ![\[Grupos de seguridad con el grupo de seguridad seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_10.png) 1. En Política, seleccione **Full Access**. ![\[Política con acceso total seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/mf-no-internet_11.png) 1. Elija **Crear punto de conexión**. 1. Repita este proceso para el resto de las interfaces. # Configure la automatización para las sesiones de streaming de Rocket Enterprise Analyzer (anteriormente Micro Focus) y Rocket Enterprise Developer Puede ejecutar automáticamente un script al inicio y al final de la sesión para permitir una automatización específica del contexto de su cliente. Para obtener más información sobre esta función de WorkSpaces aplicaciones, consulte [Uso de scripts de sesión para gestionar la experiencia de streaming de los usuarios de la AppStream versión 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html) en la *Guía de administración de WorkSpaces aplicaciones de Amazon*. Esta característica requiere que tenga al menos las siguientes versiones de las imágenes de Enterprise Analyzer y Enterprise Developer: + `m2-enterprise-analyzer-v8.0.4.R1` + `m2-enterprise-developer-v8.0.4.R1` **Topics** + [Configuración de la automatización al inicio de la sesión](#set-up-automation-m2.start) + [Configuración de la automatización al final de la sesión](#set-up-automation-m2.end) ## Configuración de la automatización al inicio de la sesión Si desea ejecutar un script de automatización cuando los usuarios se conecten a WorkSpaces las aplicaciones, cree el suyo y asígnele un nombre`m2-user-setup.cmd`. Guarde el script en la carpeta principal de WorkSpaces aplicaciones para el usuario. WorkSpaces Las imágenes de aplicaciones que proporciona AWS Mainframe Modernization buscan un script con ese nombre en esa ubicación y lo ejecutan si existe. **nota** La duración del script no puede superar el límite establecido por WorkSpaces Applications, que actualmente es de 60 segundos. Para obtener más información, consulte [Ejecutar scripts antes de que comiencen las sesiones de streaming](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-before-streaming-sessions-begin) en la *Guía de administración de WorkSpaces aplicaciones de Amazon*. ## Configuración de la automatización al final de la sesión Si desea ejecutar un script de automatización cuando los usuarios se desconecten de WorkSpaces las aplicaciones, cree el suyo y asígnele un nombre`m2-user-teardown.cmd`. Guarde el script en la carpeta principal de WorkSpaces aplicaciones para el usuario. WorkSpaces Las imágenes de aplicaciones que proporciona AWS Mainframe Modernization buscan un script con ese nombre en esa ubicación y lo ejecutan si existe. **nota** La duración del script no puede superar el límite establecido por WorkSpaces Applications, que actualmente es de 60 segundos. Para obtener más información, consulte [Ejecutar scripts una vez finalizadas las sesiones de streaming](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-after-streaming-sessions-end) en la *Guía de administración de WorkSpaces aplicaciones de Amazon*. # Vea los conjuntos de datos como tablas y columnas en Rocket Enterprise Developer (anteriormente Micro Focus Enterprise Developer) Puede acceder a los conjuntos de datos de mainframe que se implementan en AWS Mainframe Modernization mediante el entorno de ejecución de Rocket Software (anteriormente Micro Focus). Puede ver los conjuntos de datos migrados como tablas y columnas desde una instancia de Rocket Enterprise Developer. Ver los conjuntos de datos de esta manera le permite: + Realizar operaciones `SQL SELECT` en los archivos de datos migrados. + Exponer los datos fuera de la aplicación de unidad central migrada sin cambiar la aplicación. + Filtrar fácilmente los datos y guardarlos como CSV u otros formatos de archivo. **nota** Los pasos 1 y 2 son actividades que se realizan una sola vez. Repita los pasos 3 y 4 para en conjunto de datos para crear las vistas de base de datos. **Topics** + [Requisitos previos](#view-datasets-tables-m2.prereq) + [Paso 1: Configurar la conexión ODBC al almacén de datos de Rocket Software (base de datos Amazon RDS)](#view-datasets-tables-m2.odbc) + [Paso 2: Crear el archivo MFDBFH.cfg](#view-datasets-tables-m2.config) + [Paso 3: Crear un archivo de estructura (STR) para el diseño del cuaderno](#view-datasets-tables-m2.str) + [Paso 4: Crear una vista de base de datos con el archivo de estructura (STR)](#view-datasets-tables-m2.dbview) + [Paso 5: Vea los conjuntos de datos de Rocket Software (anteriormente Micro Focus) en forma de tablas y columnas](#view-datasets-tables-m2.cols) ## Requisitos previos + Debe tener acceso a Rocket Enterprise Developer Desktop a través de WorkSpaces aplicaciones. + Debe tener una aplicación implementada y ejecutada en el marco de la modernización del AWS mainframe mediante el motor de ejecución de Rocket Software. + Va a almacenar los datos de la aplicación en la edición de PostgreSQL compatible con Aurora. ## Paso 1: Configurar la conexión ODBC al almacén de datos de Rocket Software (base de datos Amazon RDS) En este paso, configurará una conexión ODBC a la base de datos que contiene los datos que desee ver en forma de tablas y columnas. Solo tendrá que hacerlo una vez. 1. Inicie sesión en Rocket Enterprise Developer Desktop mediante WorkSpaces la URL de streaming de las aplicaciones. 1. Abra el **Administrador de orígenes de datos ODBC**, elija **DSN de usuario** y, a continuación, seleccione **Agregar.** 1. En **Crear nuevo origen de datos**, elija **PostgreSQL ANSI** y, a continuación, **Finalizar.** 1. Cree un origen de datos para `PG.POSTGRES` proporcionando la información de base de datos necesaria, de la siguiente manera: ``` Data Source : PG.POSTGRES Database : postgres Server : rds_endpoint.rds.amazonaws.com Port : 5432 User Name : user_name Password : user_password ``` ![\[Configuración de la conexión ODBC de Postgres en Enterprise Developer.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/view-data-tables-odbc.png) 1. Elija **Probar** para asegurarse de que la conexión funciona. Si la prueba se realiza correctamente, aparecerá el mensaje `Connection successful`. Si la prueba no tiene éxito, lea la siguiente información. + [Solución de problemas de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html) + [¿Cómo resuelvo los problemas al conectarme a mi instancia de base de datos de Amazon RDS?](https://repost.aws/knowledge-center/rds-cannot-connect) 1. Guarde el origen de datos. 1. Cree un origen de datos para `PG.VSAM`, pruebe la conexión y guarde el origen de datos. Proporcione la siguiente información de la base de datos: ``` Data Source : PG.VSAM Database : MicroFocus$SEE$Files$VSAM Server : rds_endpoint.rds.amazonaws.com Port : 5432 User Name : user_name Password : user_password ``` ![\[Configuración del origen de datos de ODBC de PG.VSAM en Enterprise Developer.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/view-data-tables-pg-vsam.png) ## Paso 2: Crear el archivo MFDBFH.cfg En este paso, creará un archivo de configuración que describa el almacén de datos de Micro Focus. Este paso de configuración solo se tiene que realizar una vez. 1. En su carpeta de inicio, por ejemplo, en `D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg`, cree el archivo MFDBFH.cfg con el siguiente contenido. ``` ``` 1. Compruebe la configuración del MFDBFH ejecutando los siguientes comandos para consultar el almacén de datos de Micro Focus: ``` *##* *## Test the connection by running the following commands* *##* set MFDBFH_CONFIG="D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg" dbfhdeploy list sql://ESPACDatabase/VSAM?folder=/DATA ``` ## Paso 3: Crear un archivo de estructura (STR) para el diseño del cuaderno En este paso, creará un archivo de estructura para el diseño del cuaderno de texto que utilizará más adelante para crear vistas de bases de datos a partir de los conjuntos de datos. 1. Compile el programa asociado al cuaderno. Si ningún programa utiliza el cuaderno, cree y compile un programa simple como el siguiente con una instrucción COPY para el cuaderno. ``` IDENTIFICATION DIVISION. PROGRAM-ID. TESTPGM1. ENVIRONMENT DIVISION. CONFIGURATION SECTION. DATA DIVISION. WORKING-STORAGE SECTION. COPY CVTRA05Y. PROCEDURE DIVISION. GOBACK. ``` 1. Después de una compilación correcta, haga clic con el botón derecho en el programa y elija **Crear archivo de diseño de registro**. Se abrirán las herramientas de archivos de datos de Micro Focus que utilizan el archivo .idy generado durante la compilación. ![\[Ubicación del comando Crear archivo de diseño de registro en Enterprise Developer.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/view-data-tables-idy-file.png) 1. Haga clic con el botón derecho en la estructura del registro y elija **Crear diseño predeterminado** (estructura única) o **Crear diseño condicional** (estructura múltiple) según el diseño. Para obtener más información, consulte [Creating Structure Files and Layouts](https://www.microfocus.com/documentation/enterprise-developer/ed60/ES-WIN/GUID-6EDDA4C3-F09E-4CEC-9CF8-281D9D7453C3.html) en la documentación de Micro Focus. ![\[Ubicación de los comandos de diseño en las herramientas de archivos de datos de Micro Focus.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/view-data-tables-mf-data-file-tools.png) 1. Tras crear el diseño, seleccione **Archivo** en el menú y, a continuación, elija **Guardar como**. Busque y guarde el archivo en su carpeta principal con el mismo nombre de archivo que su cuaderno. Puede optar por crear una carpeta llamada `str` y guardar allí todos sus archivos de estructura. ![\[Guardar el archivo str en Enterprise Developer.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/view-data-tables-save-str.png) ## Paso 4: Crear una vista de base de datos con el archivo de estructura (STR) En este paso, utilizará el archivo de estructura creado anteriormente para crear una vista de base de datos para un conjunto de datos. + Utilice el comando `dbfhview` para crear una vista de base de datos para un conjunto de datos que ya se encuentra en el almacén de datos de Micro Focus, como se muestra en el siguiente ejemplo. ``` ## ## The below command creates database view for VSAM file AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS ## using the STR file CVTRA05Y.str ## dbfhview -create -struct:"D:\PhotonUser\My Files\Home Folder\MFED\str\CVTRA05Y.str" -name:V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT -file:sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT?folder=/DATA ## ## Output: ## Micro Focus Database File Handler - View Generation Tool Version 8.0.00 Copyright (C) 1984-2022 Micro Focus. All rights reserved. VGN0017I Using structure definition 'TRAN-RECORD-DEFAULT' VGN0022I View 'V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT' installed in datastore 'sql://espacdatabase/VSAM' VGN0002I The operation completed successfully ``` ## Paso 5: Vea los conjuntos de datos de Rocket Software (anteriormente Micro Focus) en forma de tablas y columnas En este paso, se conectará a la base de datos utilizando `pgAdmin` para poder ejecutar consultas y ver los conjuntos de datos, como tablas y columnas. + Conéctese a la base de datos `MicroFocus$SEE$Files$VSAM` mediante pgAdmin y consulte la vista de base de datos que ha creado en el paso 4. ``` SELECT * FROM public."V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT"; ``` ![\[Conjunto de datos migrado que muestra tablas y columnas en pgAdmin.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/view-data-tables-new-view-pgadmin.png) # Edite conjuntos de datos con las herramientas de archivos de datos de Rocket Software (anteriormente Micro Focus) en Enterprise Developer Puede ver y editar conjuntos de datos en AWS Mainframe Modernization utilizando el motor de ejecución de Rocket Software para cualquier conjunto de datos migrado.  Los pasos de este documento lo guiarán a través del proceso de acceso a los conjuntos de datos mediante las herramientas de archivos de datos.  Esto le permite ver y editar los conjuntos de datos migrados según sea necesario.  **Topics** + [Requisitos previos](#edit-datasets-m2.prereq) + [Inicie las herramientas de archivos de datos de Rocket Software (anteriormente Micro Focus)](#edit-datasets-m2-launch) + [Edite los conjuntos de datos de VSAM almacenados en la base de datos MFDBFH](#edit-datasets-m2-vsam) + [Edite conjuntos de datos que no sean de VSAM almacenados en la base de datos MFDBFH](#edit-datasets-m2-nonvsam) + [Edite conjuntos de datos VSAM y no VSAM almacenados en el sistema de archivos (EFS/FSx)](#edit-datasets-m2-open) ## Requisitos previos Antes de empezar, debe tener implementada una aplicación con los conjuntos de datos importado mediante el servicio de modernización de AWS mainframe mediante el motor de software Rocket. Para continuar con la edición de los conjuntos de datos, debe completar el paso 1, paso 2, y (opcionalmente) el paso 3 de la [Vea los conjuntos de datos como tablas y columnas en Rocket Enterprise Developer (anteriormente Micro Focus Enterprise Developer)](view-datasets-tables-m2.md) página para configurar la conexión ODBC y el almacén de datos de Micro Focus (es decir,). `MFDBFH` **importante** En esta guía se asume que utiliza Amazon Aurora Postgres como almacén de datos de Micro Focus () `MFDBFH` para almacenar los datos de su aplicación. ## Inicie las herramientas de archivos de datos de Rocket Software (anteriormente Micro Focus) Tras cumplir los requisitos previos, inicie las herramientas de archivos de datos de Micro Focus configurando la variable de `MFDBFH_CONFIG` entorno para acceder a los conjuntos de datos almacenados en la base de datos (`MFDBFH`). Para ello, 1. Inicie sesión en el escritorio de Micro Focus Enterprise Developer e inicie la línea de **comandos de Enterprise Developer (64 bits)** desde el **menú Inicio**. 1. Defina la variable de `MFDBFH_CONFIG` entorno con la ruta completa `MFDBCH.cfg` del archivo. ``` set MFDBFH_CONFIG="C:\MicroFocus\config\MFDBFH.cfg" ``` 1. Inicie Micro Focus Data File Tools desde la línea de comandos de Enterprise Developer mediante el siguiente comando. ``` mfdatatools2 ``` ![\[Línea de comandos para desarrolladores empresariales.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/edit-mfdbfh-launch.png) Se abren las herramientas de archivos de datos de Micro Focus en una ventana independiente. ## Edite los conjuntos de datos de VSAM almacenados en la base de datos MFDBFH Una vez que inicie las herramientas de archivos de datos de Micro Focus, abra un conjunto de datos de VSAM que está almacenado en el almacén de datos de Micro Focus. Para ello, 1. **En el **menú Archivo** de la ventana Herramientas de archivos de datos de Micro Focus, seleccione el Explorador de datos.** 1. En la sección Explorador de datos, seleccione **Configuración** (icono de engranaje) para configurar una nueva conexión. Se abrirá una ventana de **configuración de la fuente de datos**. ![\[Ventana de herramientas de archivos de datos de Micro Focus con la sección del explorador de datos.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/edit-mfdbfh-data-source.png) 1. En la ventana de configuración de la fuente de datos, seleccione la pestaña **MFDBFH** e introduzca los siguientes valores: + Servidor: `ESPACDatabase` + Almacén de datos: `VSAM` Seleccione **Aplicar** para guardar la configuración. ![\[Configuración de la fuente de datos de la ventana Micro Focus Data File Tools con la pestaña MFDBFH.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/edit-mfdbfh-data-source-settings.png) El explorador de datos muestra ahora todos los conjuntos de datos que están almacenados. `MFDBFH` ![\[Ventana de herramientas para archivos de datos de Micro Focus con una sección del explorador de datos en la que se muestran todos los conjuntos de datos.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/edit-mfdbfh-datasets.png) 1. Amplíe la ruta relativa `DATA` y haga doble clic en el conjunto de datos de VSAM que desee abrir. 1. En la ventana **Abrir archivo de datos**, elija **Abrir compartido o Abrir** **en modo exclusivo** para abrir el conjunto de datos. ![\[Ventana de herramientas de archivos de datos de Micro Focus con la sección Explorador de datos y la sección Abrir archivos de datos para abrir conjuntos de datos.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/edit-mfdbfh-data-set.png) Ahora puede ver o editar el conjunto de datos abierto. ## Edite conjuntos de datos que no sean de VSAM almacenados en la base de datos MFDBFH Si desea editar conjuntos de datos que no son de VSAM, abra un conjunto de datos que no sea de VSAM y que esté almacenado en el almacén de datos de Micro Focus. Para ello, 1. Desde la línea de comandos de Enterprise Developer (64 bits), ejecute el `dbfhdeploy data extract` comando para descargar el conjunto de datos que no es de VSAM al sistema de archivos local. **nota** Antes de ejecutar este comando, asegúrese de haber establecido la variable de `MFDBFH_CONFIG` entorno con la ruta completa al archivo`MFDBFH.cfg`. ``` dbfhdeploy data extract sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT?folder=/DATA C:\MicroFocus\data\AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT ``` 1. Inicie las herramientas de archivos de datos de Micro Focus desde el **menú Inicio**. 1. En el menú Archivo de Micro Focus Data File Tools, seleccione **Abrir** y, a continuación, elija **Archivo de datos**. 1. En la ventana Abrir archivo de datos, busque el conjunto de datos descargado en su sistema de archivos local. Edite los **detalles del archivo** según sea necesario. A continuación, seleccione **Abrir en modo compartido** o **Abrir en modo exclusivo** para abrir el conjunto de datos. ![\[Abra la ventana de archivos de datos con la pestaña local seleccionada para navegar por los conjuntos de datos.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/edit-mfdbfh-browse.png) Ahora puede ver o editar el conjunto de datos abierto. Los conjuntos de datos editados o actualizados se pueden volver a importar al almacén de datos de Micro Focus siguiendo los pasos de [Importe conjuntos de datos para AWS Mainframe Modernization aplicaciones](applications-m2-dataset.md) o utilizando [la utilidad de línea de comandos dbfhdeploy](https://www.microfocus.com/documentation/enterprise-developer/ed90/ED-Eclipse/GUID-2A16851F-E475-42C9-B024-37567006B86D.html). ## Edite conjuntos de datos VSAM y no VSAM almacenados en el sistema de archivos (EFS/FSx) También puede abrir un conjunto de datos almacenado en un sistema de archivos. Para ello, 1. Monte el EFS/FSx el sistema de archivos en la EC2 instancia de Enterprise Developer. 1. Utilice las herramientas de archivos de datos de Micro Focus para buscar y abrir los conjuntos de datos del sistema de archivos. # Tutoriales para Rocket Software (anteriormente Micro Focus) Los tutoriales de esta sección le ayudan a empezar a configurar diversas tareas en el motor de tiempo de ejecución de Rocket Software para el servicio de modernización del AWS mainframe. Estos tutoriales sirven para configurar una aplicación de ejemplo, usar plantillas con Rocket Enterprise Developer y configurar Enterprise Analyzer. **Topics** + [Tutorial: configuración de la versión de Rocket Software (anteriormente Micro Focus) para la aplicación de BankDemo muestra](tutorial-build-mf.md) + [Tutorial: Configurar WorkSpaces aplicaciones para su uso con Rocket Enterprise Analyzer y Rocket Enterprise Developer](set-up-appstream-mf.md) + [Tutorial: Utilice plantillas con Rocket Enterprise Developer (anteriormente Micro Focus Enterprise Developer)](tutorial-templates-ed.md) + [Tutorial: Configuración de Enterprise Analyzer en aplicaciones WorkSpaces](set-up-ea.md) + [Tutorial: Configurar Rocket Enterprise Developer en WorkSpaces aplicaciones](set-up-ed.md) # Tutorial: configuración de la versión de Rocket Software (anteriormente Micro Focus) para la aplicación de BankDemo muestra AWS La modernización del mainframe le permite configurar compilaciones y canalizaciones de integration/continuous entrega continua (CI/CD) para sus aplicaciones migradas. Estas compilaciones y canalizaciones utilizan y AWS CodeBuild AWS CodePipeline proporcionan estas AWS CodeCommit capacidades. CodeBuild es un servicio de compilación totalmente gestionado que compila el código fuente, ejecuta pruebas unitarias y produce artefactos listos para su despliegue. CodeCommit es un servicio de control de versiones que te permite almacenar y gestionar de forma privada los repositorios de Git en la nube. AWS CodePipeline es un servicio de entrega continua que te permite modelar, visualizar y automatizar los pasos necesarios para lanzar tu software. En este tutorial se muestra cómo AWS CodeBuild compilar el código fuente de la aplicación de BankDemo muestra desde Amazon S3 y, a continuación, exportar el código compilado a Amazon S3. AWS CodeBuild es un servicio de integración continua totalmente gestionado que compila el código fuente, ejecuta pruebas y produce paquetes de software listos para su implementación. Con CodeBuild, puede usar entornos de compilación preempaquetados o puede crear entornos de compilación personalizados que usen sus propias herramientas de compilación. En esta situación de demostración se utiliza la segunda opción. Consiste en un entorno de CodeBuild compilación que utiliza una imagen de Docker preempaquetada. **importante** Antes de iniciar su proyecto de modernización de unidad central, le recomendamos que conozca el [Programa de aceleración de la migración de AWS](https://aws.amazon.com/migration-acceleration-program/mainframe/) o que se ponga en contacto con [especialistas en unidades centrales de AWS](mailto: mainframe@amazon.com) para obtener información sobre los pasos necesarios para modernizar una aplicación de unidad central. **Topics** + [Requisitos previos](#tutorial-build-mf-prerequisites) + [Paso 1: compartición de los activos de compilación con la cuenta de AWS](#tutorial-build-mf-assets) + [Paso 2: creación de buckets de Amazon S3](#tutorial-build-mf-s3) + [Paso 3: creación del archivo de especificaciones de compilación](#tutorial-build-mf-spec) + [Paso 4: carga de los archivos de origen](#tutorial-build-mf-upload) + [Paso 5: creación de políticas de IAM](#tutorial-build-mf-IAM-policy) + [Paso 6: creación de un rol de IAM](#tutorial-build-mf-IAM-role) + [Paso 7: asociación de las políticas de IAM al rol de IAM](#tutorial-build-mf-attach) + [Paso 8: Crea el CodeBuild proyecto](#tutorial-build-mf-create-project) + [Paso 9: inicio de la compilación](#tutorial-build-mf-start) + [Paso 10: descarga de los artefactos de salida](#tutorial-build-mf-download-output) + [Eliminar recursos](#tutorial-build-mf-clean) ## Requisitos previos Antes de comenzar este tutorial, complete los siguientes requisitos previos: + Descarga la [aplicación de BankDemo muestra](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) y descomprímela en una carpeta. La carpeta de origen contiene programas COBOL y cuadernos, así como definiciones. También contiene una carpeta JCL como referencia, aunque no es necesario compilar JCL. La carpeta también contiene los metaarchivos necesarios para la compilación. + **En la consola de modernización AWS del mainframe, elija Herramientas.** En **Análisis, desarrollo y compilación de activos**, seleccione **Compartir activos con mi cuenta de AWS**. ## Paso 1: compartición de los activos de compilación con la cuenta de AWS En este paso, asegúrese de compartir los activos de compilación con su AWS cuenta, especialmente en la región en la que se utilizan los activos. 1. Abra la consola de modernización AWS del mainframe en [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/). 1. En el panel de navegación izquierdo, seleccione **Herramientas**. 1. En **Análisis, desarrollo y creación de activos**, seleccione **Compartir activos con mi AWS cuenta**. **importante** Debes realizar este paso una vez en cada AWS región en la que vayas a realizar las compilaciones. ## Paso 2: creación de buckets de Amazon S3 En este paso, creará dos buckets de Amazon S3. El primero es un bucket de entrada para almacenar el código fuente y el otro es un depósito de salida para almacenar la salida de la compilación. Para obtener más información, consulte [Creación, configuración y trabajo con buckets de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) en la *Guía del usuario de Amazon S3*. 1. Para crear el bucket de entrada, inicie sesión en la consola de Amazon S3 y elija **Crear bucket**. 1. En la **configuración general**, proporciona un nombre para el depósito y especifica el Región de AWS lugar en el que quieres crearlo. Un ejemplo Región de AWS de nombre `regionId` es `codebuild-regionId-accountId-input-bucket` dónde está el depósito y `accountId` es su Cuenta de AWS ID. **nota** Si va a crear el depósito en un lugar diferente al Región de AWS de EE. UU. Este (Virginia del Norte), especifique el `LocationConstraint` parámetro. Para obtener más información, consulte [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) en *Amazon Simple Storage Service API Referenc*. 1. Conserve todos los demás valores y elija **Crear bucket**. 1. Repita los pasos 1 a 3 para crear el bucket de salida. Un ejemplo de nombre es `codebuild-regionId-accountId-output-bucket` dónde `regionId` está Región de AWS el depósito y `accountId` es su Cuenta de AWS ID. Utilice los mismos nombres que elija para los buckets en todo este tutorial. ## Paso 3: creación del archivo de especificaciones de compilación En este paso, creará un archivo de especificaciones de compilación. Este archivo proporciona los comandos de compilación y la configuración relacionada, en formato YAML, CodeBuild para ejecutar la compilación. Para obtener más información, consulta la [referencia sobre las especificaciones de compilación CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) en la *Guía del AWS CodeBuild usuario*. 1. Cree un archivo con el nombre `buildspec.yml` en el directorio que haya utilizado para descomprimir como se indicaba en los requisitos previos. 1. Añada el siguiente contenido al archivo y guarde. No se requieren cambios en este archivo. ``` version: 0.2 env: exported-variables: - CODEBUILD_BUILD_ID - CODEBUILD_BUILD_ARN phases: install: runtime-versions: python: 3.7 pre_build: commands: - echo Installing source dependencies... - ls -lR $CODEBUILD_SRC_DIR/source build: commands: - echo Build started on `date` - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target post_build: commands: - ls -lR $CODEBUILD_SRC_DIR/target - echo Build completed on `date` artifacts: files: - $CODEBUILD_SRC_DIR/target/** ``` Aquí`CODEBUILD_BUILD_ID`, `CODEBUILD_BUILD_ARN``$CODEBUILD_SRC_DIR/source`, y `$CODEBUILD_SRC_DIR/target` están las variables de entorno disponibles en él CodeBuild. Para obtener más información, consulte [Variables de entorno en los entornos de compilación](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html). En este punto, la estructura de directorios debería ser similar a la siguiente. ``` (root directory name) |-- build.xml |-- buildspec.yml |-- LICENSE.txt |-- source |... etc. ``` 1. Comprima el contenido de la carpeta en un archivo con el nombre `BankDemo.zip`. En este tutorial, no puede comprimir la carpeta. Así es que, comprima el contenido de la carpeta en un archivo con el nombre `BankDemo.zip`. ## Paso 4: carga de los archivos de origen En este paso, debe cargar el código fuente de la aplicación de BankDemo muestra en su bucket de entrada de Amazon S3. 1. En la consola de Amazon SNS, en el panel de navegación izquierdo, seleccione **Buckets**. A continuación, elija el bucket de entrada que ha creado anteriormente. 1. En **Objetos**, selecciona **Cargar**. 1. En la sección **Archivos y carpetas**, elija **Añadir archivos**. 1. Vaya al archivo `BankDemo.zip` y elíjalo. 1. Seleccione **Cargar**. ## Paso 5: creación de políticas de IAM En este paso, creará dos [políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Una política otorga permisos para que AWS Mainframe Modernization pueda acceder a la imagen de Docker que contiene las herramientas de compilación de Rocket Software y utilizarla. Esta política no está personalizada para los clientes. La otra política otorga permisos para que AWS Mainframe Modernization interactúe con los buckets de entrada y salida y con los [ CloudWatch registros de Amazon que se CodeBuild generan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html). Para obtener más información sobre la creación de una política de IAM, consulte [Crear políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) en la *Guía del usuario de IAM*. **Para crear una política de acceso a las imágenes de Docker** 1. En la consola de IAM, copie el siguiente documento de política y péguelo en el editor de políticas. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ecr:GetAuthorizationToken" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ecr:BatchCheckLayerAvailability", "ecr:GetDownloadUrlForLayer", "ecr:BatchGetImage" ], "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools" }, { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-m2-repo-*--prod" } ] } ``` ------ 1. Escriba un nombre para la política, por ejemplo, `m2CodeBuildPolicy`. **Crear una política que permita a la modernización del AWS mainframe interactuar con los depósitos y los registros** 1. En la consola de IAM, copie el siguiente documento de política y péguelo en el editor de políticas. Asegúrese de actualizar `regionId` a Región de AWS, y `accountId` a su. Cuenta de AWS 1. Escriba un nombre para la política, por ejemplo, `BankdemoCodeBuildRolePolicy`. ## Paso 6: creación de un rol de IAM En este paso, creará una nueva [función de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que le CodeBuild permita interactuar con AWS los recursos, tras asociar las políticas de IAM que creó anteriormente a esta nueva función de IAM. Para obtener información sobre la creación de un rol de servicio, consulte [Creación de un rol para delegar permisos a un AWS servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) en la Guía del usuario de *IAM*,. 1. Inicie sesión en la consola de IAM; y elija **Roles** en el panel de navegación de la izquierda. 1. Elija **Crear rol**. 1. En **Tipo de entidad de confianza**, seleccione **Servicio de AWS**. 1. **En Casos de uso de otros servicios de AWS**, elija y **CodeBuild**, a continuación, **CodeBuild**vuelva a elegir. 1. Elija **Siguiente**. 1. Elija **Siguiente** en la página **Agregar permisos**. Posteriormente, asignará una política al rol. 1. En **Detalles del rol**, proporcione un nombre para el rol, por ejemplo, `BankdemoCodeBuildServiceRole`. 1. En **Seleccionar entidades de confianza**, compruebe que el documento de política tenga el siguiente aspecto: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Seleccione **Crear rol**. ## Paso 7: asociación de las políticas de IAM al rol de IAM En este paso, asociará las políticas de IAM que ha creado antes al rol de IAM `BankdemoCodeBuildServiceRole`. 1. Inicie sesión en la consola de IAM; y elija **Roles** en el panel de navegación de la izquierda. 1. En **Roles**, elija el rol que ha creado anteriormente, por ejemplo, `BankdemoCodeBuildServiceRole`. 1. En la sección **Políticas de permisos**, elija **Agregar permisos** y, después, **Asociar políticas**. 1. En **Otras políticas de permisos**, elija las políticas que ha creado anteriormente, por ejemplo, `m2CodeBuildPolicy` y`BankdemoCodeBuildRolePolicy`. 1. Seleccione **Asociar políticas**. ## Paso 8: Crea el CodeBuild proyecto En este paso, crearás el CodeBuild proyecto. 1. Inicie sesión en la CodeBuild consola y elija **Crear proyecto de compilación**. 1. En la sección **Configuración del proyecto**, proporciona un nombre para el proyecto, por ejemplo, `codebuild-bankdemo-project`. 1. En la sección **Origen**, en **Proveedor del origen**, elija **Amazon S3** y, a continuación, elija el bucket de entrada que ha creado anteriormente, por ejemplo, `codebuild-regionId-accountId-input-bucket`. 1. En el campo **Clave de objeto de S3 o carpeta de S3**, introduzca el nombre del archivo zip que ha cargado en el bucket de S3. En este caso, el nombre de archivo es `bankdemo.zip`. 1. En la sección **Entorno**, seleccione **Imagen personalizada**. 1. En el campo **Tipo de entorno**, seleccione **Linux**. 1. En **Registro de imágenes**, seleccione **Otro registro**. 1. En el campo **URL del registro externo**, + Para Rocket Software v9: Introduce`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`. Si está utilizando una AWS región diferente con Rocket Software v9, también puede especificar ` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1` dónde hay una AWS región en la que esté disponible el servicio de modernización de AWS mainframe (por ejemplo,). `eu-west-3` + Para Rocket Software v8: Introduce `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1` + Para Rocket Software v7: Introduce `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10` 1. En **Rol de servicio**, elija **Rol de servicio existente** y, en el campo **ARN de rol**, elija el rol de servicio que ha creado anteriormente; por ejemplo, `BankdemoCodeBuildServiceRole`. 1. En **Especificaciones de la compilación**, elija **Utilizar un archivo de especificación de compilación**. 1. En la sección **Artefactos**, en **Tipo**, elija **Amazon S3** y, a continuación, elija su bucket de salida, por ejemplo, `codebuild-regionId-accountId-output-bucket`. 1. En el campo **Nombre**, introduzca el nombre de una carpeta del bucket en la que desee que se incluyan los artefactos de salida de la compilación, por ejemplo, `bankdemo-output.zip`. 1. En **Empaquetado de artefactos**, elija **Zip**. 1. Elija **Crear el proyecto de compilación**. ## Paso 9: inicio de la compilación En este paso, iniciará la compilación. 1. Inicie sesión en la CodeBuild consola. 1. En el panel de navegación, elija **Proyectos de compilación**. 1. Elija el proyecto de compilación que ha creado antes, por ejemplo,`codebuild-bankdemo-project`. 1. Seleccione **Iniciar la compilación**. Este comando inicia la compilación. La compilación se ejecuta de forma asincrónica. La salida del comando es un JSON que incluye el ID del atributo. Este identificador de atributo es una referencia al identificador de CodeBuild compilación de la compilación que acabas de iniciar. Puedes ver el estado de la compilación en la CodeBuild consola. También puede ver los registros detallados sobre la ejecución de la compilación en la consola. Para obtener más información, consulte [View detailed build information](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html) en *AWS CodeBuild User Guide*. Cuando se complete la fase actual, significa que la compilación ha finalizado correctamente y que los artefactos compilados están listos en Amazon S3. ## Paso 10: descarga de los artefactos de salida En este paso, descargará los artefactos de salida de Amazon S3. La herramienta de compilación de Rocket Software puede crear varios tipos de ejecutables diferentes. En este tutorial, generará objetos compartidos. 1. Inicie sesión en la consola de Amazon S3. 1. En la sección **Buckets** role="bold">, elija el nombre del bucket de salida, por ejemplo, `codebuild-regionId-accountId-output-bucket`. 1. Seleccione **Descargar** role="bold">. 1. Descomprima el archivo descargado. Navegue hasta la carpeta de destino para ver los artefactos de la compilación. Estos incluyen los objetos compartidos de Linux `.so`. ## Eliminar recursos Si ya no necesita los recursos que ha creado para este tutorial, elimínelos para evitar cargos adicionales. Para ello, complete los siguientes pasos. + Elimine los depósitos de S3 que ha creado para este tutorial. Para obtener más información, consulte [Eliminar un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) en la *Guía del usuario de Amazon Simple Storage Service*. + Elija las políticas que ha creado para este tutorial. Para obtener más información, consulte [Eliminación de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) en la *Guía del usuario de IAM*. + Elija el rol de IAM que ha creado para este tutorial. Para obtener más información, consulte [Eliminación de roles o perfiles de instancia](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) en la *Guía del usuario de IAM*. + Elimine el CodeBuild proyecto que creó para este tutorial. Para obtener más información, consulte [Eliminar un proyecto de compilación CodeBuild en](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html) la *Guía del AWS CodeBuild usuario*. # Tutorial: Configurar WorkSpaces aplicaciones para su uso con Rocket Enterprise Analyzer y Rocket Enterprise Developer AWS La modernización del mainframe proporciona varias herramientas a través de Amazon WorkSpaces Applications. WorkSpaces Applications es un servicio de streaming de aplicaciones seguro y totalmente gestionado que permite transmitir aplicaciones de escritorio a los usuarios sin tener que volver a escribirlas. WorkSpaces Las aplicaciones proporcionan a los usuarios acceso instantáneo a las aplicaciones que necesitan, con una experiencia de usuario fluida y con capacidad de respuesta en el dispositivo que elijan. El uso de WorkSpaces aplicaciones para alojar herramientas específicas del motor de ejecución ofrece a los equipos de aplicaciones de los clientes la posibilidad de utilizar las herramientas directamente desde sus navegadores web e interactuar con los archivos de las aplicaciones almacenados en depósitos o repositorios de Amazon S3. CodeCommit Para obtener información sobre la compatibilidad de los navegadores en WorkSpaces las aplicaciones, consulte [System Requirements and Feature Support (navegador web)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html) en la *Guía de administración de Amazon WorkSpaces Applications*. Si tiene problemas al utilizar las WorkSpaces aplicaciones, consulte [Solución de problemas de usuario de la AppStream versión 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html) en la *Guía de administración de WorkSpaces aplicaciones de Amazon*. Este documento está dirigido a los miembros del equipo de operaciones del cliente. Describe cómo configurar WorkSpaces las flotas y pilas de Amazon Applications para alojar las herramientas Rocket Enterprise Analyzer y Rocket Enterprise Developer que se utilizan con AWS Mainframe Modernization. Rocket Enterprise Analyzer se suele utilizar durante la fase de evaluación y Rocket Enterprise Developer se suele utilizar durante la fase de migración y modernización del enfoque de modernización del mainframe. AWS Si piensa utilizar Enterprise Analyzer y Enterprise Developer, debe crear flotas y pilas independientes para cada herramienta. Cada herramienta requiere su propia flota y su propia pila, ya que las condiciones de licencia son diferentes. **importante** Los pasos de este tutorial se basan en la CloudFormation plantilla descargable [cfn-m2-.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml). appstream-fleet-ea-ed **Topics** + [Requisitos previos](#tutorial-aas-prerequisites) + [Paso 1: Obtenga las imágenes de las WorkSpaces aplicaciones](#tutorial-aas-step1) + [Paso 2: Crea la pila con la CloudFormation plantilla](#tutorial-aas-step2) + [Paso 3: Crear un usuario en WorkSpaces Aplicaciones](#tutorial-aas-step3) + [Paso 4: Inicie sesión en las WorkSpaces aplicaciones](#tutorial-aas-step4) + [Paso 5: Verificar los buckets de Amazon S3 (opcional)](#tutorial-aas-step5) + [Pasos a seguir a continuación](#tutorial-aas-next-steps) + [Eliminar recursos](#tutorial-aas-cleanup) ## Requisitos previos + [Descargue la plantilla: cfn-m2-.yml. appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) + Obtenga el ID de la VPC y el grupo de seguridad predeterminados. Para obtener más información sobre la VPC predeterminada, consulte [Predeterminado VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) en la Guía del usuario de Amazon *VPC*. Para obtener más información sobre el grupo de seguridad predeterminado, consulte [Grupos de seguridad predeterminados y personalizados](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html) en la *Guía del EC2 usuario de Amazon*. + Asegúrese de que tiene permisos para: + cree pilas, flotas y usuarios en WorkSpaces Aplicaciones. + cree pilas mediante el CloudFormation uso de una plantilla. + Crear buckets y cargar archivos a buckets de Amazon S3. + Descargar credenciales (`access_key_id` y `secret_access_key`) de IAM. ## Paso 1: Obtenga las imágenes de las WorkSpaces aplicaciones En este paso, comparte WorkSpaces las imágenes de las aplicaciones de Enterprise Analyzer y Enterprise Developer con su AWS cuenta. 1. Abra la consola de modernización de AWS mainframe en. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) 1. En el panel de navegación izquierdo, seleccione **Herramientas**. 1. En **Análisis, desarrollo y creación de activos**, seleccione **Compartir activos con mi AWS cuenta**. ## Paso 2: Crea la pila con la CloudFormation plantilla En este paso, utilizará la CloudFormation plantilla descargada para crear una pila de WorkSpaces aplicaciones y una flota para ejecutar Rocket Enterprise Analyzer. Puede repetir este paso más adelante para crear otra pila y flota de WorkSpaces aplicaciones para ejecutar Rocket Enterprise Developer, ya que cada herramienta requiere su propia flota y pila de WorkSpaces aplicaciones. Para obtener más información sobre las CloudFormation pilas, consulta Cómo [trabajar con pilas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) en la Guía del *AWS CloudFormation usuario*. **nota** AWS La modernización de mainframe añade una tarifa adicional al precio estándar de WorkSpaces las aplicaciones para el uso de Enterprise Analyzer y Enterprise Developer. Para obtener más información, consulte [AWS Mainframe Modernization Pricing](https://aws.amazon.com/mainframe-modernization/pricing/). 1. Descargue la plantilla [appstream-fleet-ea-edcfn-m2-.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml), si es necesario. 1. Abre la CloudFormation consola y selecciona **Crear pila** y **con recursos nuevos** (estándar). 1. En **Requisito previo: preparar la plantilla**, elija **La plantilla está lista**. 1. En **Especificar plantilla**, elija **Cargar un archivo de plantilla**. 1. En **Cargar un archivo de plantilla**, selecciona **Elegir archivo** y carga la plantilla [appstream-fleet-ea-edcfn-m2-.yml.](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 1. Elija **Siguiente**. ![\[La página CloudFormation Crear pila con la plantilla cfn-m2- .yml seleccionada. appstream-fleet-ea-ed\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/cfn-create-stack.png) 1. En **Especificar los detalles de la pila**, introduzca la siguiente información: + En **Nombre de pila**, introduzca un nombre de su elección. Por ejemplo, **m2-ea**. + **En **AppStreamApplication**, elige ea.** + En **AppStreamFleetSecurityGroup**, elige el grupo de seguridad predeterminado de tu VPC predeterminada. + En **AppStreamFleetVpcSubnet**, elige una subred dentro de tu VPC predeterminada. + En **AppStreamImageName**, elige la imagen que empiece por. `m2-enterprise-analyzer` Esta imagen contiene la versión actualmente compatible de la herramienta Rocket Enterprise Analyzer. + Acepte los valores predeterminados para el resto de los campos y después elija **Siguiente**. ![\[La página de CloudFormation especificación de detalles de la pila con las opciones de Enterprise Analyzer rellenadas.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/cfn-specify-stack-details.png) 1. Acepte los valores predeterminados y, a continuación, elija **Siguiente**. 1. En **Revisar**, asegúrese de que todos los parámetros son los que desea. 1. Desplázate hasta el final, selecciona **Acepto que AWS CloudFormation podría crear recursos de IAM con nombres personalizados** y selecciona **Create Stack**. La pila y la flota tardan entre 20 y 30 minutos en crearse. Puede elegir **Actualizar** para ver los CloudFormation eventos a medida que se producen. ## Paso 3: Crear un usuario en WorkSpaces Aplicaciones Mientras espera CloudFormation a que termine de crear la pila, puede crear uno o más usuarios en WorkSpaces Aplicaciones. Estos usuarios son los que utilizarán Enterprise Analyzer en WorkSpaces las aplicaciones. Deberá especificar una dirección de correo electrónico para cada usuario y asegurarse de que cada uno tenga los permisos suficientes para crear buckets en Amazon S3, cargar archivos en un bucket y vincular a un bucket para asignar su contenido. 1. Abra la consola de WorkSpaces aplicaciones. 1. En el panel de navegación izquierdo, elija **Grupo de usuarios**. 1. Seleccione la opción **Crear usuario**. 1. Proporcione una dirección de correo electrónico en la que el usuario pueda recibir una invitación por correo electrónico para usar WorkSpaces las Aplicaciones, un nombre y apellidos, y seleccione **Crear usuario**. 1. Repita este procedimiento si es necesario para crear más usuarios. La dirección de correo electrónico de cada usuario debe ser única. Para obtener más información sobre la creación de usuarios de WorkSpaces Aplicaciones, consulte [Grupos de usuarios de WorkSpaces Aplicaciones](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html) en la *Guía de administración de Amazon WorkSpaces Applications*. Cuando CloudFormation termine de crear la pila, puede asignar el usuario que creó a la pila de la siguiente manera: 1. Abra la consola de WorkSpaces aplicaciones. 1. Elija el nombre de usuario. 1. Elija **Acciones** y luego **Asignar pila**. 1. En **Asignar pila**, elija la pila que empieza por `m2-appstream-stack-ea`. 1. Elija **Asignar pila**. ![\[La página de asignación de WorkSpaces aplicaciones muestra el usuario y la pila de Enterprise Analyzer que se va a asignar.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/aas-assign-stack.png) Al asignar un usuario a una pila, WorkSpaces Applications envía un correo electrónico al usuario a la dirección que usted proporcionó. Este correo electrónico contiene un enlace a la página de inicio de sesión de la WorkSpaces aplicación. ## Paso 4: Inicie sesión en las WorkSpaces aplicaciones En este paso, inicia sesión en WorkSpaces Applications mediante el enlace que aparece en el correo electrónico enviado por WorkSpaces Applications al usuario que creó[Paso 3: Crear un usuario en WorkSpaces Aplicaciones](#tutorial-aas-step3). 1. Inicie sesión en WorkSpaces Applications mediante el enlace que aparece en el correo electrónico enviado por WorkSpaces Applications. 1. Cambie la contraseña si se le solicita. La pantalla de WorkSpaces aplicaciones que aparece es similar a la siguiente: ![\[Un ejemplo de pantalla de inicio de sesión de WorkSpaces aplicaciones que muestra el icono del escritorio.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/aas-login-screen.png) 1. Seleccione **Escritorio**. 1. En la barra de tareas, seleccione **Bucar** e introduzca **D:** para navegar hasta la carpeta de inicio. **nota** Si omite este paso, es posible que aparezca el error `Device not ready` al intentar acceder a la carpeta de inicio. En cualquier momento, si tiene problemas para iniciar sesión en WorkSpaces Aplicaciones, puede reiniciar su flota de WorkSpaces aplicaciones e intentar iniciar sesión de nuevo siguiendo estos pasos. 1. Abre la consola de WorkSpaces aplicaciones. 1. En el panel de navegación izquierdo, elija **Flotas**. 1. Elija la flota que está intentando utilizar. 1. Seleccione **Acción** y, a continuación, **Detener**. 1. Espere a que la flota se detenga. 1. Seleccione **Acción** y, a continuación, seleccione **Inciar**. Este proceso puede tardar unos 10 minutos. ## Paso 5: Verificar los buckets de Amazon S3 (opcional) Una de las tareas que llevó a cabo la CloudFormation plantilla que utilizó para crear la pila consistía en crear dos depósitos en Amazon S3, que son necesarios para guardar y restaurar los datos de los usuarios y la configuración de la aplicación en las sesiones de trabajo. Estos buckets son los siguientes: + Su nombre comienza por `appstream2-`. Este bucket asigna los datos a su carpeta de inicio en WorkSpaces Aplicaciones (`D:\PhotonUser\My Files\Home Folder`). **nota** La carpeta de inicio es única para una dirección de correo electrónico determinada y se comparte en todas las flotas y pilas de una cuenta determinada AWS . El nombre de la carpeta principal es un SHA256 hash de la dirección de correo electrónico del usuario y se almacena en una ruta basada en ese hash. + Su nombre comienza por `appstream-app-settings-`. Este depósito contiene información sobre las sesiones de usuario de WorkSpaces las aplicaciones e incluye ajustes como los favoritos del navegador, los perfiles de conexión del IDE y de las aplicaciones y las personalizaciones de la interfaz de usuario. Para obtener más información, consulte [Cómo funciona la persistencia de la configuración](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html) de aplicaciones en la *Guía de administración de WorkSpaces aplicaciones de Amazon*. Para comprobar que se han creado los buckets, siga estos pasos: 1. Abra la consola de Amazon S3. 1. En el panel de navegación izquierdo, elija **Buckets**. 1. En **Buscar buckets por nombre**, introduzca **appstream** para filtrar la lista. Si ve los buckets, no es necesario realizar ninguna otra acción. Solo es para saber que los buckets existen. Si no ve los cubos, significa que la CloudFormation plantilla no ha terminado de ejecutarse o que se ha producido un error. Ve a la CloudFormation consola y revisa los mensajes de creación de la pila. ## Pasos a seguir a continuación Ahora que la infraestructura de WorkSpaces aplicaciones está configurada, puede configurar y empezar a utilizar Enterprise Analyzer. Para obtener más información, consulte [Tutorial: Configuración de Enterprise Analyzer en aplicaciones WorkSpaces](set-up-ea.md). También puede configurar Enterprise Developer. Para obtener más información, consulte [Tutorial: Configurar Rocket Enterprise Developer en WorkSpaces aplicaciones](set-up-ed.md). ## Eliminar recursos El procedimiento para limpiar la pila y las flotas creadas se describe en [Crear una flota y pila de WorkSpaces aplicaciones](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html). Cuando se hayan eliminado los objetos de WorkSpaces las aplicaciones, el administrador de la cuenta también puede, si procede, limpiar los depósitos de Amazon S3 para la configuración de la aplicación y las carpetas de inicio. **nota** La carpeta de inicio de un usuario determinado es única en todas las flotas, por lo que es posible que tengas que conservarla si hay otras pilas de WorkSpaces aplicaciones activas en la misma cuenta. Por último, actualmente WorkSpaces Applications no permite eliminar usuarios mediante la consola. Para ello, debe usar la API de servicio con la CLI. Para obtener más información, consulte [Administración de grupos de usuarios](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html) en la *Guía de administración de Amazon WorkSpaces Applications*. # Tutorial: Utilice plantillas con Rocket Enterprise Developer (anteriormente Micro Focus Enterprise Developer) En este tutorial se describe cómo utilizar plantillas y proyectos predefinidos con Rocket Enterprise Developer. Incluye tres casos de uso. Todos los casos de uso utilizan el código de ejemplo que se proporciona en el BankDemo ejemplo. Para descargar el ejemplo, elija [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip). **importante** Si utiliza la versión de Enterprise Developer para Windows, los binarios generados por el compilador solo se pueden ejecutar en el Enterprise Server suministrado con Enterprise Developer. No puede ejecutarlos en el entorno de ejecución de modernización del AWS mainframe, que está basado en Linux. **Topics** + [Caso de uso 1: Uso de la plantilla de proyecto de COBOL que contiene los componentes de origen](#tutorial-templates-ed-step1) + [Caso de uso 2: Uso de la plantilla de proyecto de COBOL sin los componentes de origen](#tutorial-templates-ed-step2) + [Caso de uso 3: Uso del proyecto de COBOL predefinido que enlaza con las carpetas de origen](#tutorial-templates-ed-step3) + [Uso de la plantilla JSON de definición de región](#tutorial-templates-ed-step4) ## Caso de uso 1: Uso de la plantilla de proyecto de COBOL que contiene los componentes de origen Este caso de uso requiere que copie los componentes de origen en la estructura de directorios de la plantilla como parte de los pasos de preconfiguración de la demostración. En el [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip), se ha cambiado con respecto al del `AWSTemplates.zip` original para evitar tener dos copias del origen. 1. Inicie Enterprise Developer y especifique el espacio de trabajo elegido. ![\[Lanzador de Eclipse con un espacio de trabajo seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc1-step1.png) 1. En la vista del **explorador de aplicaciones**, en el elemento de vista en árbol **Enterprise Development Project**, seleccione **New Project from Template** en el menú contextual. ![\[Menú contextual en la vista en árbol del proyecto de desarrollo empresarial.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc1-step2.png) 1. Introduzca los parámetros de la plantilla como se muestra. **nota** La ruta de la plantilla hará referencia al lugar donde se haya extraído el ZIP. ![\[Cuadro de introducción de parámetros de la plantilla con la ruta y el nombre del proyecto especificados.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc1-step3.png) 1. Si selecciona OK, se creará un proyecto de Eclipse de desarrollo local basado en la plantilla proporcionada, con una estructura completa de origen y entorno de ejecución. ![\[Estructura del proyecto de Eclipse de desarrollo local.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc1-step4.png) La estructura de `System` contiene un archivo completo de definición de recursos con las entradas requeridas para BANKDEMO, el catálogo requerido con las entradas añadidas y los archivos de datos ASCII correspondientes. Como la estructura de la plantilla de origen contiene todos los elementos de origen, estos archivos se copian en el proyecto local y, por lo tanto, se incorporan automáticamente a Enterprise Developer. ## Caso de uso 2: Uso de la plantilla de proyecto de COBOL sin los componentes de origen Los pasos 1 a 3 son idénticos al [Caso de uso 1: Uso de la plantilla de proyecto de COBOL que contiene los componentes de origen](#tutorial-templates-ed-step1). En este caso de uso, la `System` estructura también contiene un archivo completo de definición de recursos con las entradas necesarias BankDemo, el catálogo necesario con las entradas añadidas y los archivos de datos ASCII correspondientes. Sin embargo, la estructura de origen de la plantilla no contiene ningún componente. Debe importarlos al proyecto desde el repositorio de origen que utilice. 1. Elija el nombre del proyecto. En el menú contextual relacionado, seleccione **Import**. ![\[El menú contextual del proyecto con la importación seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc2-step4.png) 1. En el cuadro de diálogo resultante, en la sección **General**, elija **File System** y, a continuación, elija Next. ![\[Cuadro de importación con el sistema de archivos seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc2-step5.png) 1. Rellene el campo **From directory** navegando por el sistema de archivos hasta que señale a la carpeta del repositorio. Seleccione todas las carpetas que desee importar, por ejemplo `sources`. El campo `Into folder` se rellenará automáticamente. Elija **Finish**. ![\[El cuadro del sistema de archivos con el BankDemo directorio expandido.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc2-step6.png) Una vez que la estructura de la plantilla de origen contiene todos los elementos de origen, estos se crean automáticamente en Enterprise Developer. ## Caso de uso 3: Uso del proyecto de COBOL predefinido que enlaza con las carpetas de origen 1. Inicie Enterprise Developer y especifique el espacio de trabajo elegido. ![\[Lanzador de Eclipse con un espacio de trabajo seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc3-step1.png) 1. En el menú **File**, elija **Import**. ![\[Menú File con la opción Import seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc3-step2.png) 1. En el cuadro de diálogo resultante, en **General**, seleccione **Projects from Folder or Archive** y pulse **Next**. ![\[Cuadro Import con los proyectos de la carpeta o el archivo seleccionados.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc3-step3.png) 1. Introduzca el **Import source**, elija el **Directory** y navegue por el sistema de archivos para seleccionar la carpeta de proyecto predefinida. El proyecto que contiene tiene enlaces a las carpetas de origen del mismo repositorio. ![\[Los proyectos de importación se realizan desde el sistema de archivos o el cuadro de archivos con la ruta al origen de importación especificado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-uc3-step4.png) Seleccione **Finalizar**. Como el proyecto se rellena con los enlaces a la carpeta de origen, el código se genera automáticamente. ## Uso de la plantilla JSON de definición de región 1. Cambie a la vista del explorador de servidores. En el menú contextual correspondiente, seleccione **Open Administration Page**, que iniciará el navegador predeterminado. ![\[Menú contextual del explorador de servidores con la página de administración abierta seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-admin-page.png) 1. En la pantalla resultante de Enterprise Server Common Web Administration (ESCWA), seleccione **Import**. ![\[Pantalla de Enterprise Server Common Web Administration con la opción de importación seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-import.png) 1. Seleccione el tipo de importación **JSON** y, después, **Next**. ![\[Cuadro Choose Import Type con JSON seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-import-type.png) 1. Cargue el archivo `BANKDEMO.JSON` suministrado. ![\[Cuadro Choose File to Upload con el archivo BANKDEMO seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-upload.png) Una vez seleccionado, elija **Next**. ![\[Cuadro Select Regions con la opción Clear Ports from Endpoints no seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-next.png) En el panel **Selecr Regions**, asegúrese de que la opción **Clear Ports from Endpoints** no esté seleccionada y, a continuación, siga seleccionando **Next** en los paneles hasta que aparezca el panel **Perform Import**. A continuación, elija **Importar** en el panel de navegación izquierdo. Por último, haga clic en **Finish**. La región BANKDEMO se añadirá a la lista de servidores. ![\[BankDemo Se ha agregado la lista de regiones y servidores.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-server-list.png) 1. Navegue hasta las **General Properties** de la región BANKDEMO. 1. Desplácese a la sección **Configuration**. 1. La variable de entorno ESP debe configurarse en la carpeta `System` correspondiente al proyecto de Eclipse creado en los pasos anteriores. El valor debería ser `workspacefolder/projectname/System`. ![\[Sección de configuración con la variable ESP.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-ESP.png) 1. Haga clic en **Apply**. La región ahora está completamente configurada para ejecutarse junto con el proyecto COBOL de Eclipse. 1. Por último, vuelva a Enterprise Developer y asocie la región importada al proyecto. ![\[Menú contextual del proyecto con la opción Associated with project seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ed-json-associate.png) El entorno Enterprise Developer ya está listo para su uso, con una versión funcional completa de BankDemo. Puede editar, compilar y depurar el código de la región. **importante** Si utiliza la versión de Enterprise Developer para Windows, los binarios generados por el compilador solo se pueden ejecutar en el Enterprise Server suministrado con Enterprise Developer. No se pueden ejecutar en el entorno de ejecución AWS Mainframe Modernization, que está basado en Linux. # Tutorial: Configuración de Enterprise Analyzer en aplicaciones WorkSpaces Este tutorial describe cómo configurar Rocket Enterprise Analyzer (anteriormente Micro Focus Enterprise Analyzer) para analizar una o más aplicaciones de mainframe. La herramienta Enterprise Analyzer proporciona varios informes basados en su análisis del código fuente de la aplicación y las definiciones del sistema. Esta configuración está diseñada para fomentar la colaboración en equipo. La instalación utiliza un bucket de Amazon S3 para compartir el código fuente con los discos virtuales. Para ello, se utiliza [Rclone](https://rclone.org/)) en el equipo de Windows. Con una instancia de Amazon RDS común que ejecute [PostgreSQL](https://www.postgresql.org/), cualquier miembro del equipo puede acceder a todos los informes solicitados. Los miembros del equipo también pueden montar el disco virtual respaldado por Amazon S3 en sus equipos personales y actualizar el bucket de origen desde sus estaciones de trabajo. También pueden usar scripts o cualquier otra forma de automatización en sus equipos si están conectados a otros sistemas internos en las instalaciones. La configuración se basa en las imágenes de Windows de WorkSpaces Applications que AWS Mainframe Modernization comparte con el cliente. La configuración también se basa en la creación de flotas y pilas de WorkSpaces aplicaciones, tal como se describe en. [Tutorial: Configurar WorkSpaces aplicaciones para su uso con Rocket Enterprise Analyzer y Rocket Enterprise Developer](set-up-appstream-mf.md) **importante** En los pasos de este tutorial se parte del supuesto de que se configuran WorkSpaces las aplicaciones con la CloudFormation plantilla descargable [cfn-m2-.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml). appstream-fleet-ea-ed Para obtener más información, consulte [Tutorial: Configurar WorkSpaces aplicaciones para su uso con Rocket Enterprise Analyzer y Rocket Enterprise Developer](set-up-appstream-mf.md). Para realizar los pasos en este tutorial, debe haber configurado la flota y la pila de Enterprise Analyzer y deben estar en funcionamiento. Para obtener una descripción completa de las funciones y prestaciones de Enterprise Analyzer, consulte la [documentación de Enterprise Analyzer en el sitio web](https://www.microfocus.com/documentation/enterprise-analyzer/) de Rocket Software (anteriormente Micro Focus). ## Contenido de la imagen Además de la propia aplicación Enterprise Analyzer, la imagen contiene las siguientes herramientas y bibliotecas. Herramientas de terceros + [Python](https://www.python.org/) + [Rclone](https://rclone.org/) + [pgAdmin](https://www.pgadmin.org/) + [git-scm](https://git-scm.com/) + [Controlador ODBC para PostgreSQL](https://odbc.postgresql.org/) Bibliotecas en `C:\Users\Public` + BankDemo código fuente y definición del proyecto para Enterprise Developer:. `m2-bankdemo-template.zip` + Paquete de instalación de MFA para el sistema central: `mfa.zip`. Para obtener más información, consulte [Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) en la documentación de *Micro Focus Enterprise Developer*. + Archivos de comandos y configuración para Rclone (instrucciones para su uso en los tutoriales): `m2-rclone.cmd` y `m2-rclone.conf`. **Topics** + [Contenido de la imagen](#set-up-ea-image-contents) + [Requisitos previos](#tutorial-ea-prerequisites) + [Paso 1: Configuración](#tutorial-ea-step1) + [Paso 2: Crear la carpeta virtual basada en Amazon S3 en Windows](#tutorial-ea-step2) + [Paso 3: Crear un origen de ODBC para la instancia de Amazon RDS](#tutorial-ea-step3) + [Sesiones posteriores](#tutorial-ea-step4) + [Solución de problemas de conexión de espacio de trabajo](#tutorial-ea-step5) + [Eliminar recursos](#tutorial-ea-clean) ## Requisitos previos + Cargue el código fuente y las definiciones del sistema de la aplicación del cliente que desee analizar en un bucket de S3. Las definiciones del sistema incluyen CICS CSD, definiciones de DB2 objetos, etc. Puede crear una estructura de carpetas dentro del bucket que se adapte a la forma en que desea organizar los artefactos de la aplicación. Por ejemplo, al descomprimir la BankDemo muestra, tiene la siguiente estructura: ``` demo |--> jcl |--> RDEF |--> transaction |--> xa ``` + Cree una instancia de Amazon RDS que ejecute PostgreSQL e iníciela. Esta instancia almacenará los datos y los resultados que produzca Enterprise Analyzer. Puede compartir esta instancia con todos los miembros del equipo de la aplicación. Además, cree un esquema vacío llamado `m2_ea` (o cualquier otro nombre adecuado) en la base de datos. Defina las credenciales para los usuarios autorizados que les permitan crear, insertar, actualizar y eliminar elementos de este esquema. Puede obtener el nombre de la base de datos, la URL del punto de conexión del servidor y el puerto TCP desde la consola de Amazon RDS o a través del administrador de la cuenta. + Asegúrese de haber configurado el acceso programático a su. Cuenta de AWS Para obtener más información, consulte [Acceso programático](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) en *Referencia general de Amazon Web Services*. ## Paso 1: Configuración 1. Inicie una sesión con WorkSpaces Applications con la URL que recibió en el mensaje de correo electrónico de bienvenida de WorkSpaces Applications. 1. Utilice su correo electrónico como ID de usuario y defina su contraseña permanente. 1. Seleccione la pila de Enterprise Analyzer. 1. En la página del menú WorkSpaces Aplicaciones, seleccione **Escritorio** para acceder al escritorio de Windows que está transmitiendo la flota. ## Paso 2: Crear la carpeta virtual basada en Amazon S3 en Windows **nota** Si ya utilizó Rclone durante la versión preliminar de AWS Mainframe Modernization, debe actualizar `m2-rclone.cmd` a la versión más reciente que se encuentra en. `C:\Users\Public` 1. Copie los archivos `m2-rclone.conf` y `m2-rclone.cmd` proporcionados en `C:\Users\Public` a su carpeta de inicio `C:\Users\PhotonUser\My Files\Home Folder` mediante el Explorador de archivos. 1. Actualice los parámetros de `m2-rclone.conf` configuración con su clave de AWS acceso y el secreto correspondiente, así como con su. Región de AWS ``` [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256 ``` 1. En `m2-rclone.cmd`, realice los siguientes cambios: + Cambie `amzn-s3-demo-bucket` por el nombre de su bucket de Amazon S3. Por ejemplo, `m2-s3-mybucket`. + Cambie `your-s3-folder-key` por el nombre de su clave de bucket de Amazon S3. Por ejemplo, `myProject`. + Cambie `your-local-folder-path` por la ruta del directorio en el que desee sincronizar los archivos de la aplicación desde el bucket de Amazon S3 que los contiene. Por ejemplo, `D:\PhotonUser\My Files\Home Folder\m2-new`. Este directorio sincronizado debe ser un subdirectorio de la carpeta principal para que WorkSpaces las aplicaciones puedan realizar copias de seguridad y restaurarlo correctamente al iniciar y finalizar la sesión. ``` :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop ``` 1. Abra una línea de comandos de Windows, ejecute un cd a `C:\Users\PhotonUser\My Files\Home Folder` si es necesario y ejecute `m2-rclone.cmd`. Este script de comandos ejecuta un bucle continuo y sincroniza el bucket y la clave de Amazon S3 con la carpeta local cada 10 segundos. Puede ajustar el tiempo de espera según sea necesario. Debería ver el código fuente de la aplicación ubicado en el bucket de Amazon S3 en el Explorador de archivos de Windows. Para añadir nuevos archivos al conjunto en el que está trabajando o actualizar los existentes, cargue los archivos en el bucket de Amazon S3 y se sincronizarán con su directorio en la siguiente iteración definida en `m2-rclone.cmd`. Del mismo modo, si desea eliminar algunos archivos, elimínelos del bucket de Amazon S3. La siguiente operación de sincronización los eliminará de su directorio local. ## Paso 3: Crear un origen de ODBC para la instancia de Amazon RDS 1. Para iniciar la herramienta EA\$1Admin, navegue hasta el menú de selección de aplicaciones situado en la esquina superior izquierda de la ventana del navegador y seleccione **MF EA\$1Admin**. 1. En el menú **Administrar**, seleccione **Orígenes de datos de ODBC** y, en la pestaña **DSN de usuario**, seleccione **Agregar**. 1. En el cuadro de diálogo Crear nuevo origen de datos, elija el controlador **PostgreSQL Unicode** y, a continuación, elija **Finalizar**. 1. En el cuadro de diálogo **Configuración de controlador ODBC Unicode PostgreSQL (psqlODBC)**, defina y anote el nombre del origen de datos que desee. Complete los siguientes parámetros con los valores de la instancia de RDS que ha creado anteriormente: **Description (Descripción)** Descripción opcional para ayudarle a identificar rápidamente esta conexión a la base de datos. **Database** La base de datos de Amazon RDS que ha creado anteriormente. **Server** El punto de conexión de Amazon RDS. **Puerto** El puerto de Amazon RDS. **User Name** El que se ha definido en la instancia de Amazon RDS. **Password** La que se ha definido en la instancia de Amazon RDS. 1. Elija **Prueba** para validar que la conexión a Amazon RDS se ha realizado correctamente y, a continuación, seleccione **Guardar** para guardar su nuevo DSN de usuario. 1. Espere a que aparezca el mensaje que confirme la creación del espacio de trabajo adecuado y, a continuación, pulse **Aceptar** para terminar con los orígenes de datos de ODBC y cerrar la herramienta EA\$1Admin. 1. Vuelva al menú de selección de aplicaciones y elija Enterprise Analyzer para iniciar la herramienta. Elija **Crear nuevo**. 1. En la ventana de configuración del espacio de trabajo, introduzca el nombre del espacio de trabajo y defina su ubicación. El espacio de trabajo puede ser el disco basado en Amazon S3 si trabaja con esta configuración, o su carpeta de inicio si lo prefiere. 1. Seleccione **Elegir otra base de datos** para conectarse a su instancia de Amazon RDS. 1. Elija el icono de **Postgre** de entre las opciones y, a continuación, pulse **Aceptar**. 1. Para la configuración de Windows, en **Opciones: Definir parámetros de conexión**, introduzca el nombre del origen de datos que ha creado. Introduzca también el nombre de la base de datos, el nombre de esquema, el nombre de usuario y la contraseña. Seleccione **Aceptar**. 1. Espere a que Enterprise Analyzer cree todas las tablas, índices, etc. que necesite para almacenar los resultados. Es posible que tarde un par de minutos. Enterprise Analyzer confirma cuándo la base de datos y el espacio de trabajo están listos para su uso. 1. Vuelva al menú de selección de aplicaciones y elija Enterprise Analyzer para iniciar la herramienta. 1. La ventana de inicio de Enterprise Analyzer aparece en la nueva ubicación del espacio de trabajo seleccionada. Seleccione **Aceptar**. 1. Navegue hasta el repositorio en el panel izquierdo, seleccione el nombre del repositorio y elija **Añadir archivos/carpetas al espacio de trabajo**. Seleccione la carpeta en la que está almacenado el código de la aplicación para añadirlo al espacio de trabajo. Si lo desea, puede utilizar el código del BankDemo ejemplo anterior. Cuando Enterprise Analyzer le pida que verifique esos archivos, elija **Verificar** para iniciar el informe de verificación inicial de Enterprise Analyzer. Este proceso puede tardar unos minutos, dependiendo del tamaño de la aplicación. 1. Amplíe su espacio de trabajo para ver los archivos y carpetas que ha agregado al espacio de trabajo. Los tipos de objetos y los informes de complejidad ciclomática también están visibles en el cuadrante superior del panel **Visor de gráficos**. Ahora puede usar Enterprise Analyzer para todas las tareas necesarias. ## Sesiones posteriores 1. Inicie una sesión con WorkSpaces Applications con la URL que recibió en el mensaje de correo electrónico de bienvenida de WorkSpaces Applications. 1. Inicie sesión con su correo electrónico y contraseña permanente. 1. Seleccione la pila de Enterprise Analyzer. 1. Inicie `Rclone` para conectarse al disco respaldado por Amazon S3 si utiliza esta opción para compartir los archivos del espacio de trabajo. 1. Inicie Enterprise Analyzer para hacer sus tareas. ## Solución de problemas de conexión de espacio de trabajo Cuando intente volver a conectarse a su espacio de trabajo de Enterprise Analyzer, es posible que aparezca un error como el siguiente: ``` Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location? ``` Para resolver este problema, pulse **Aceptar** para borrar el mensaje y, a continuación, complete los pasos siguientes. 1. En WorkSpaces Aplicaciones, seleccione el icono **Iniciar aplicación** en la barra de herramientas y, a continuación, elija **EA\$1Admin** para iniciar la herramienta de administración de Enterprise Analyzer. ![\[Las WorkSpaces aplicaciones abren el menú selector con la herramienta de administración Rocket Enterprise Developer seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/aas-launch-selector.png) 1. En el menú **Administrar**, seleccione **Actualizar ruta de espacio de trabajo...**. ![\[Menú de administración de la herramienta de administración de Rocket Enterprise Analyzer con la opción Refresh Workspace Path seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ea_admin-administer-refresh.png) 1. En **Seleccionar espacio de trabajo**, elija el espacio de trabajo que desee y, a continuación, pulse **Aceptar**. ![\[El cuadro de diálogo Seleccione el espacio de trabajo de la herramienta de administración de Rocket Enterprise Analyzer con un proyecto seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ea_admin-select-workspace.png) 1. Pulse **Aceptar** para confirmar el mensaje de error. ![\[Mensaje de error de Enterprise Analyzer "Cannot access the workspace directory" con la opción Aceptar seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ea_admin-select-workspace-error.png) 1. En **Ruta de red del directorio de espacio de trabajo**, introduzca la ruta correcta a su espacio de trabajo, por ejemplo `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`. ![\[Cuadro de diálogo Ruta de red del directorio de espacio de trabajo de Enterprise Analyzer con una ruta de ejemplo.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png) 1. Cierre la herramienta Micro Focus Enterprise Analyzer Administration. ![\[Herramienta Micro Focus Enterprise Analyzer Administration con el botón Cerrar seleccionado.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/ea_admin-close.png) 1. En WorkSpaces Aplicaciones, seleccione el icono **Iniciar aplicación** en la barra de herramientas y, a continuación, elija **EA** para iniciar Micro Focus Enterprise Analyzer. ![\[Las WorkSpaces aplicaciones abren el icono de la aplicación con EA seleccionada.\]](http://docs.aws.amazon.com/es_es/m2/latest/userguide/images/aas-launch-ea.png) 1. Repita los pasos 3 a 5. Ahora Micro Focus Enterprise Analyzer debería abrirse con el espacio de trabajo existente. ## Eliminar recursos Si ya no necesita los recursos que ha creado para este tutorial, elimínelos para que no se le cobre por ellos. Realice los siguientes pasos: + Use la herramienta **EA\$1Admin** para eliminar el espacio de trabajo. + Elimine los buckets de S3 que ha creado para este tutorial. Para obtener más información, consulte [Eliminar un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) en la *Guía del usuario de Amazon S3*. + Elija la base de datos que ha creado para este tutorial. Para obtener más información, consulte [Eliminación de una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL). # Tutorial: Configurar Rocket Enterprise Developer en WorkSpaces aplicaciones Este tutorial describe cómo configurar Rocket Enterprise Developer (anteriormente Micro Focus Enterprise Developer) para una o más aplicaciones de mainframe con el fin de mantenerlas, compilarlas y probarlas mediante las funciones de Enterprise Developer. La configuración se basa en las imágenes de Windows de las WorkSpaces aplicaciones que AWS Mainframe Modernization comparte con el cliente y en la creación de flotas y pilas de WorkSpaces aplicaciones, tal como se describe en. [Tutorial: Configurar WorkSpaces aplicaciones para su uso con Rocket Enterprise Analyzer y Rocket Enterprise Developer](set-up-appstream-mf.md) **importante** En los pasos de este tutorial se parte del supuesto de que se configuran WorkSpaces las aplicaciones mediante la CloudFormation plantilla descargable [cfn-m2](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) - .yaml. appstream-fleet-ea-ed Para obtener más información, consulte [Tutorial: Configurar WorkSpaces aplicaciones para su uso con Rocket Enterprise Analyzer y Rocket Enterprise Developer](set-up-appstream-mf.md). Debe realizar los pasos de esta configuración cuando la flota y la pila de Enterprise Developer estén en ejecución. Para obtener una descripción completa de las funciones y prestaciones de Enterprise Developer v7, consulte su [documentación up-to-date en línea (versión 7.0) en el sitio de Rocket Software (anteriormente Micro Focus)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html). ## Contenido de la imagen Además de Enterprise Developer en sí, la imagen contiene la imagen que contiene Rumba (un TN327 emulador 0). También contiene las siguientes herramientas y bibliotecas. Herramientas de terceros + [Python](https://www.python.org/) + [Rclone](https://rclone.org/) + [pgAdmin](https://www.pgadmin.org/) + [git-scm](https://git-scm.com/) + [Controlador ODBC para PostgreSQL](https://odbc.postgresql.org/) Bibliotecas en `C:\Users\Public` + BankDemo código fuente y definición de proyecto para Enterprise Developer:`m2-bankdemo-template.zip`. + Paquete de instalación de MFA para el sistema central: `mfa.zip`. Para obtener más información, consulte [Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) en la documentación de *Micro Focus Enterprise Developer*. + Archivos de comandos y configuración para Rclone (instrucciones para su uso en los tutoriales): `m2-rclone.cmd` y `m2-rclone.conf`. Si necesita acceder a un código fuente que aún no está cargado en CodeCommit los repositorios, pero que está disponible en un bucket de Amazon S3, por ejemplo, para realizar la carga inicial del código fuente en git, siga el procedimiento para crear un disco virtual de Windows tal y como se describe en[Tutorial: Configuración de Enterprise Analyzer en aplicaciones WorkSpaces](set-up-ea.md). **Topics** + [Contenido de la imagen](#set-up-ed-image-contents) + [Requisitos previos](#tutorial-ed-prerequisites) + [Paso 1: Configuración por parte de usuarios individuales de Enterprise Developer](#tutorial-ed-step1) + [Paso 2: Crear la carpeta virtual basada en Amazon S3 en Windows (opcional)](#tutorial-ed-step2) + [Paso 3: Clonar el repositorio](#tutorial-ed-step3) + [Sesiones posteriores](#tutorial-ed-step4) + [Eliminar recursos](#tutorial-ed-clean) ## Requisitos previos + Uno o más CodeCommit repositorios cargados con el código fuente de la aplicación que se va a mantener. La configuración del repositorio debe cumplir con los requisitos de la CI/CD canalización anterior para crear sinergias mediante la combinación de ambas herramientas. + Cada usuario debe tener credenciales para el CodeCommit repositorio o los repositorios definidos por el administrador de la cuenta de acuerdo con la información de [Autenticación y control de acceso para AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html). La estructura de esas credenciales se analiza en [Autenticación y control de acceso para AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) y la referencia completa para las autorizaciones de IAM CodeCommit se encuentra en la [referencia de CodeCommit permisos](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html): el administrador puede definir políticas de IAM distintas para funciones distintas con credenciales específicas para la función de cada repositorio y limitar las autorizaciones del usuario al conjunto específico de tareas que debe realizar en un repositorio determinado. Por lo tanto, para cada responsable del CodeCommit repositorio, el administrador de la cuenta generará un usuario principal y le concederá permisos para acceder al repositorio o repositorios necesarios seleccionando la política o políticas de CodeCommit acceso de IAM adecuadas. ## Paso 1: Configuración por parte de usuarios individuales de Enterprise Developer 1. Obtenga sus credenciales de IAM: 1. Conéctese a la AWS consola en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Siga el procedimiento descrito en el paso 3 de [Setup for HTTPS users using Git credentials](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html) en la *guía del usuario de AWS CodeCommit *. 1. Copie las credenciales CodeCommit de inicio de sesión específicas que IAM generó para usted, ya sea mostrando, copiando y pegando esta información en un archivo seguro de su ordenador local o seleccionando **Descargar credenciales para descargar** esta información como un archivo.CSV. Necesitará esta información para conectarse a CodeCommit. 1. Inicie una sesión con WorkSpaces las aplicaciones en función de la URL recibida en el correo electrónico de bienvenida. Utilice su correo electrónico como nombre de usuario y cree su contraseña. 1. Seleccione su pila de Enterprise Developer. 1. En la página de menú, elija **Escritorio** para acceder al escritorio de Windows que está transmitiendo la flota. ## Paso 2: Crear la carpeta virtual basada en Amazon S3 en Windows (opcional) Si es necesario utilizar Rclone (véase más arriba), cree la carpeta virtual basada en Amazon S3 en Windows: (opcional si todos los artefactos de la aplicación provienen exclusivamente de Access). CodeCommit **nota** Si ya utilizó Rclone durante la versión preliminar de AWS Mainframe Modernization, debe actualizar `m2-rclone.cmd` a la versión más reciente que se encuentra en. `C:\Users\Public` 1. Copie los archivos `m2-rclone.conf` y `m2-rclone.cmd` proporcionados en `C:\Users\Public` a su carpeta de inicio `C:\Users\PhotonUser\My Files\Home Folder` mediante el Explorador de archivos. 1. Actualice los parámetros de `m2-rclone.conf` configuración con su clave de AWS acceso y el secreto correspondiente, así como con su. Región de AWS ``` [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256 ``` 1. En `m2-rclone.cmd`, realice los siguientes cambios: + Cambie `amzn-s3-demo-bucket` por el nombre de su bucket de Amazon S3. Por ejemplo, `m2-s3-mybucket`. + Cambie `your-s3-folder-key` por el nombre de su clave de bucket de Amazon S3. Por ejemplo, `myProject`. + Cambie `your-local-folder-path` por la ruta del directorio en el que desee sincronizar los archivos de la aplicación desde el bucket de Amazon S3 que los contiene. Por ejemplo, `D:\PhotonUser\My Files\Home Folder\m2-new`. Este directorio sincronizado debe ser un subdirectorio de la carpeta principal para que WorkSpaces las aplicaciones puedan realizar copias de seguridad y restaurarlo correctamente al iniciar y finalizar la sesión. ``` :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop ``` 1. Abra una línea de comandos de Windows, ejecute un cd a `C:\Users\PhotonUser\My Files\Home Folder` si es necesario y ejecute `m2-rclone.cmd`. Este script de comandos ejecuta un bucle continuo y sincroniza el bucket y la clave de Amazon S3 con la carpeta local cada 10 segundos. Puede ajustar el tiempo de espera según sea necesario. Debería ver el código fuente de la aplicación ubicado en el bucket de Amazon S3 en el Explorador de archivos de Windows. Para añadir nuevos archivos al conjunto en el que está trabajando o actualizar los existentes, cargue los archivos en el bucket de Amazon S3 y se sincronizarán con su directorio en la siguiente iteración definida en `m2-rclone.cmd`. Del mismo modo, si desea eliminar algunos archivos, elimínelos del bucket de Amazon S3. La siguiente operación de sincronización los eliminará de su directorio local. ## Paso 3: Clonar el repositorio 1. Navegue hasta el menú selector de aplicaciones en la esquina superior izquierda de la ventana del navegador y seleccione Enterprise Developer. 1. Complete la creación del espacio de trabajo requerida por Enterprise Developer en su carpeta de inicio eligiendo `C:\Users\PhotonUser\My Files\Home Folder` (también conocida como `D: \PhotonUser\My Files\Home Folder`) como ubicación del espacio de trabajo. 1. En Enterprise Developer, clona tu CodeCommit repositorio yendo al Explorador de proyectos, haz clic con el botón derecho y selecciona **Importar, Importar****...**, **Git**, **Projects** from **Git** **Clone URI**. A continuación, introduce tus credenciales CodeCommit de inicio de sesión específicas y completa el cuadro de diálogo de Eclipse para importar el código. El repositorio de CodeCommit git ahora está clonado en tu espacio de trabajo local. Su espacio de trabajo de Enterprise Developer ya está listo para iniciar los trabajos de mantenimiento de su aplicación. En concreto, puedes usar la instancia local de Enterprise Server (ES) integrada con Enterprise Developer para depurar y ejecutar tu aplicación de forma interactiva y validar los cambios a nivel local. **nota** El entorno de Enterprise Developer local, incluida la instancia local de Enterprise Server, se ejecuta en Windows, mientras que AWS Mainframe Modernization se ejecuta en Linux. Le recomendamos que ejecute pruebas complementarias en el entorno Linux proporcionado por AWS Mainframe Modernization después de instalar la nueva aplicación CodeCommit y reconstruirla para este objetivo y antes de lanzar la nueva aplicación a producción. ## Sesiones posteriores Cuando seleccione una carpeta que esté bajo la administración de WorkSpaces aplicaciones, como la carpeta principal, para clonar su CodeCommit repositorio, se guardará y restaurará de forma transparente en todas las sesiones. Complete los siguientes pasos la próxima vez que necesite trabajar con la aplicación: 1. Inicie una sesión con WorkSpaces las aplicaciones en función de la URL recibida en el correo electrónico de bienvenida. 1. Inicie sesión con su correo electrónico y contraseña permanente. 1. Seleccione la pila de Enterprise Developer. 1. Inicie `Rclone` para conectarse (véase anteriormente) al disco respaldado por Amazon S3 si utiliza esta opción para compartir los archivos del espacio de trabajo. 1. Inicie Enterprise Developer para hacer su trabajo. ## Eliminar recursos Si ya no necesita los recursos que ha creado para este tutorial, elimínelos para que no se le siga cobrando por ellos. Realice los siguientes pasos: + Elimine el CodeCommit repositorio que creó para este tutorial. Para obtener más información, consulte [Eliminar un CodeCommit repositorio](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html) en la *Guía del AWS CodeCommit usuario*. + Elimine la base de datos que ha creado para este tutorial. Para obtener más información, consulte [Eliminación de una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL). # Utilidades por lotes disponibles en AWS Mainframe Modernization Las aplicaciones de mainframe suelen utilizar programas de utilidad por lotes para realizar funciones específicas, como ordenar datos, transferir archivos mediante FTP, cargar datos en bases de datos DB2, descargar datos de bases de datos, etc. Al migrar sus aplicaciones a AWS Mainframe Modernization, necesitará utilidades de reemplazo funcionalmente equivalentes que puedan realizar las mismas tareas que las que utilizaba en el mainframe. Es posible que algunas de estas utilidades ya estén disponibles como parte de los motores de ejecución de AWS Mainframe Modernization, pero ofrecemos las siguientes utilidades de reemplazo: + M2SFTP: permite la transferencia segura de archivos mediante el protocolo SFTP. + M2WAIT: espera un período de tiempo específico antes de continuar con el siguiente paso de un trabajo por lotes. + TXT2PDF: convierte archivos de texto a formato PDF. + M2DFUTIL: proporciona funciones de copia de seguridad, restauración, eliminación y copia en conjuntos de datos, de forma similar al soporte que proporciona la utilidad ADRDSSU del mainframe. + M2RUNCMD: permite ejecutar comandos, scripts y llamadas al sistema de Rocket Software (anteriormente Micro Focus) directamente desde JCL. Desarrollamos estas utilidades por lotes basándonos en los comentarios de los clientes y las diseñamos para que proporcionaran la misma funcionalidad que las utilidades de unidad central. El objetivo es hacer que la transición del mainframe a la modernización del mainframe sea lo más AWS fluida posible. **Topics** + [Ubicación binaria](#location-utilities) + [Utilidad por lotes M2SFTP](m2sftp.md) + [Utilidad por lotes M2WAIT](m2wait.md) + [TXT2Utilidad por lotes de PDF](txt2pdf.md) + [Utilidad por lotes M2DFUTIL](m2dfutil.md) + [Utilidad por lotes M2RUNCMD](m2runcmd.md) ## Ubicación binaria Estas utilidades vienen preinstaladas en los productos Rocket Enterprise Developer (ED) y Rocket Software (ES). Puede encontrarlas en la siguiente ubicación de todas las variantes de ED y ES: + Linux: `/opt/aws/m2/microfocus/utilities/64bit` + Windows de 32 bits: `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows de 64 bits: `C:\AWS\M2\MicroFocus\Utilities\64bit` # Utilidad por lotes M2SFTP M2SFTP es un programa de utilidades de JCL diseñado para realizar transferencias de archivos seguras entre sistemas que utilizan el protocolo de transferencia segura de archivos (SFTP). El programa utiliza el cliente SFTP de Putty, `psftp`, para realizar las transferencias reales de archivos. El programa funciona de manera similar a un programa de utilidades de FTP para unidades centrales y utiliza la autenticación de usuario y contraseña. **nota** No se admite la autenticación de clave pública. Para convertir el FTP de su ordenador central JCLs a SFTP, cambie a. `PGM=FTP` `PGM=M2SFTP` **Topics** + [Plataformas admitidas](#m2sftp-platforms) + [Instalación de dependencias](#m2sftp-dependencies) + [Configure M2SFTP para gestionar la modernización del AWS mainframe](#m2sftp-configure-managed) + [Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluidas las aplicaciones) WorkSpaces](#m2sftp-configure-customer-infra) + [Ejemplo JCLs](#m2sftp-jcl) + [Referencia de comandos del cliente SFTP de Putty (PSFTP)](#m2sftp-cmd-ref) + [Siguientes pasos](#m2sftp-next) ## Plataformas admitidas Puede utilizar M2SFTP en cualquiera de las siguientes plataformas: + AWS Modernización del mainframe gestionada por Rocket Software (anteriormente Micro Focus) + Rocket Software Runtime (en Amazon EC2) + Todas las variantes de los productos Rocket Software Enterprise Developer (ED) y Rocket Software Enterprise Server (ES). ## Instalación de dependencias **Para instalar el cliente SFTP de Putty en Windows** + Descargue el cliente [SFTP de PuTTY](https://www.putty.org/) e instálelo. **Para instalar el cliente SFTP de Putty en Linux:** + Ejecute el siguiente comando para instalar el cliente SFTP de Putty. ``` sudo yum -y install putty ``` ## Configure M2SFTP para gestionar la modernización del AWS mainframe Si sus aplicaciones migradas se ejecutan en AWS Mainframe Modernization Managed, tendrá que configurar M2SFTP de la siguiente manera. + Establezca las variables de entorno de Rocket Enterprise Server adecuadas para el MFFTP. A continuación se muestran algunos ejemplos: + `MFFTP_TEMP_DIR` + `MFFTP_SENDEOL` + `MFFTP_TIME` + `MFFTP_ABEND` Puede configurar tantas variables como desee. Puede configurarlas en su JCL mediante la instrucción `ENVAR DD`. Para obtener más información sobre estas variables, consulte [MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) en la documentación de Micro Focus. Para probar la configuración, consulte [Ejemplo JCLs](#m2sftp-jcl). ## Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluidas las aplicaciones) WorkSpaces Si las aplicaciones migradas se ejecutan en el entorno de ejecución de modernización de AWS mainframe en Amazon EC2, configure M2SFTP de la siguiente manera. 1. Cambie la [ruta del programa JES de Micro Focus](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir la ubicación binaria de las utilidades por lotes. Si necesita especificar varias rutas, utilice dos puntos (`:`) para separarlas en Linux y punto y coma (`;`) en Windows. + Linux: `/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. Establezca las variables de entorno de Rocket Enterprise Server adecuadas para el MFFTP. A continuación se muestran algunos ejemplos: + `MFFTP_TEMP_DIR` + `MFFTP_SENDEOL` + `MFFTP_TIME` + ``MFFTP\$1ABEND Puede configurar tantas variables como desee. Puede configurarlas en su JCL mediante la instrucción `ENVAR DD`. Para obtener más información sobre estas variables, consulte [MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) en la documentación de Micro Focus. Para probar la configuración, consulte [Ejemplo JCLs](#m2sftp-jcl). ## Ejemplo JCLs Para probar la instalación, puede utilizar uno de los siguientes archivos JCL de ejemplo. **M2 SFTP1 .jcl** Este JCL muestra cómo llamar a M2SFTP para enviar un archivo a un servidor SFTP remoto. Observe las variables de entorno que se establecen en la instrucción `ENVVAR DD`. ``` //M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Sample SFTP JCL step to send a file to SFTP server* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2SFTP, // PARM='127.0.0.1 (EXIT=99 TIMEOUT 300' //* //SYSFTPD DD * RECFM FB LRECL 80 SBSENDEOL CRLF MBSENDEOL CRLF TRAILINGBLANKS FALSE /* //NETRC DD * machine 127.0.0.1 login sftpuser password sftppass /* //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //STDOUT DD SYSOUT=* //INPUT DD * type a locsite notrailingblanks cd files put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt quit /* //ENVVAR DD * MFFTP_VERBOSE_OUTPUT=ON MFFTP_KEEP=N /* //* // ``` **M2 .jcl SFTP2** Este JCL muestra cómo llamar a M2SFTP para recibir un archivo de un servidor SFTP remoto. Observe las variables de entorno establecidas en la instrucción `ENVVAR DD`. ``` //M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Sample SFTP JCL step to receive a file from SFTP server* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2SFTP //* //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //STDOUT DD SYSOUT=* //INPUT DD * open 127.0.0.1 sftpuser sftppass cd files locsite recfm=fb lrecl=150 get AWS.M2.CARDDEMO.CARDDATA.PS.txt + 'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace quit /* //ENVVAR DD * MFFTP_VERBOSE_OUTPUT=ON MFFTP_KEEP=N /* //* // ``` **nota** Recomendamos encarecidamente almacenar las credenciales de FTP en un archivo NETRC y restringir el acceso únicamente a los usuarios autorizados. ## Referencia de comandos del cliente SFTP de Putty (PSFTP) El cliente PSFTP no admite todos los comandos de FTP. La siguiente lista muestra todos los comandos compatibles con PSFTP. | Comando | Description (Descripción) | | --- | --- | | \$1 | Ejecuta un comando local | | bye | Finaliza su sesión de SFTP | | cd | Cambia su directorio de trabajo remoto | | chmod | Cambia los permisos y modos de los archivos | | close | Finaliza la sesión de SFTP pero no cierra PSFTP | | del | Elimina archivos en el servidor remoto | | dir | Lista los archivos remotos | | exit | Finaliza su sesión de SFTP | | introducción | Descarga el archivo del servidor en el equipo local. | | help | Brinda ayuda | | lcd | Cambia el directorio de trabajo local | | lpwd | Imprime el directorio de trabajo local | | ls | Lista los archivos remotos | | mget | Descarga varios archivos a la vez | | mkdir | Crea directorios en el servidor remoto | | mput | Carga varios archivos a la vez | | mv | Mueve o cambia el nombre de los archivos en el servidor remoto | | open | Conectarse a un host | | put | Carga un archivo del equipo local al servidor. | | pwd | Imprime su directorio de trabajo remoto | | quit | Finaliza su sesión de SFTP | | reget | Continúa descargando archivos | | ren | Mueve los archivos en el servidor remoto o les cambia el nombre | | reput | Continúa descargando archivos | | rm | Elimina archivos en el servidor remoto | | rmdir | Elimina directorios en el servidor remoto | ## Siguientes pasos Para cargar y descargar archivos en Amazon Simple Storage Service mediante SFTP, puede utilizar M2SFTP junto con el AWS Transfer Family, tal y como se describe en las siguientes entradas del blog. + [Uso de directorios lógicos de AWS SFTP para crear un servicio de distribución de datos sencillo](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/) + [Habilite la autenticación por contraseña para su uso AWS Transfer for SFTPAWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/) # Utilidad por lotes M2WAIT M2WAIT es un programa de utilidad para unidades centrales que le permite introducir un periodo de espera en los scripts de JCL especificando una duración en segundos, minutos u horas. Puede llamar a M2WAIT directamente desde JCL pasando el tiempo de espera como parámetro de entrada. Internamente, el programa M2WAIT llama al módulo suministrado por Rocket Software (anteriormente Micro Focus) `C$SLEEP` para que espere un tiempo específico. **nota** Puede utilizar los alias de Micro Focus para reemplazar los que tiene en sus scripts de JCL. Para obtener más información, consulte [JES Alias](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html) en la documentación de Micro Focus. **Topics** + [Plataformas admitidas](#m2wait-platforms) + [Configure M2WAIT para gestionar la modernización AWS del mainframe](#m2wait-configure-managed) + [Configurar M2WAIT para el tiempo de ejecución de modernización AWS del mainframe en Amazon EC2 (incluidas las WorkSpaces aplicaciones)](#m2wait-configure-customer-infra) + [JCL de ejemplo](#m2wait-jcl) ## Plataformas admitidas Puede utilizar M2WAIT en cualquiera de las siguientes plataformas: + AWS Rocket Software (anteriormente Micro Focus) gestionó la modernización de la unidad central + Rocket Software Runtime (en Amazon EC2) + Todas las variantes de los productos Rocket Software Enterprise Developer (ED) y Rocket Software Enterprise Server (ES). ## Configure M2WAIT para gestionar la modernización AWS del mainframe Si sus aplicaciones migradas se ejecutan en AWS Mainframe Modernization Managed, tendrá que configurar M2WAIT de la siguiente manera. + Utilice el programa M2WAIT en su JCL pasando el parámetro de entrada como se muestra en [JCL de ejemplo](#m2wait-jcl). ## Configurar M2WAIT para el tiempo de ejecución de modernización AWS del mainframe en Amazon EC2 (incluidas las WorkSpaces aplicaciones) Si las aplicaciones migradas se ejecutan en el entorno de ejecución de modernización de AWS mainframe en Amazon EC2, configure M2WAIT de la siguiente manera. 1. Cambie la [ruta del programa JES de Micro Focus](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir la ubicación binaria de las utilidades por lotes. Si necesita especificar varias rutas, utilice dos puntos (`:`) para separarlas en Linux y punto y coma (`;`) en Windows. + Linux: `/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. Utilice el programa M2WAIT en su JCL pasando el parámetro de entrada como se muestra en [JCL de ejemplo](#m2wait-jcl). ## JCL de ejemplo Para probar la instalación, puede utilizar el programa `M2WAIT1.jcl`. Este ejemplo de JCL muestra cómo llamar a M2WAIT y pasarle varias duraciones diferentes. ``` //M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Wait for 12 Seconds* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2WAIT,PARM='S012' //SYSOUT DD SYSOUT=* //* //*-------------------------------------------------------------------** //* Wait for 0 Seconds (defaulted to 10 Seconds)* //*-------------------------------------------------------------------** //* //STEP02 EXEC PGM=M2WAIT,PARM='S000' //SYSOUT DD SYSOUT=* //* //*-------------------------------------------------------------------** //* Wait for 1 Minute* //*-------------------------------------------------------------------** //* //STEP03 EXEC PGM=M2WAIT,PARM='M001' //SYSOUT DD SYSOUT=* //* // ``` # TXT2Utilidad por lotes de PDF TXT2PDF es un programa de utilidad para ordenadores centrales que se utiliza habitualmente para convertir un archivo de texto en un archivo PDF. Esta utilidad utiliza el mismo código fuente para el TXT2 PDF (z/OSsoftware gratuito). La modificamos para que se ejecute en el entorno de ejecución del software AWS Mainframe Modernization Rocket (anteriormente Micro Focus). **Topics** + [Plataformas admitidas](#txt2pdf-platforms) + [Configure el TXT2 PDF para gestionar la modernización AWS del mainframe](#txt2pdf-configure-managed) + [Configurar el TXT2 PDF para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluidas WorkSpaces las aplicaciones)](#txt2pdf-configure-customer-infra) + [ACL de ejemplo](#txt2pdf-jcl) + [Modificaciones](#txt2pdf-mods) + [Referencias](#txt2pdf-ref) ## Plataformas admitidas Puede utilizar TXT2 PDF en cualquiera de las siguientes plataformas: + AWS Modernización del mainframe gestionada por Rocket Software + Rocket Software Runtime (en Amazon EC2) + Todas las variantes de los productos Rocket Enterprise Developer (ED) y Rocket Enterprise Server (ES). ## Configure el TXT2 PDF para gestionar la modernización AWS del mainframe Si las aplicaciones migradas se ejecutan en AWS Mainframe Modernization Managed, configure el TXT2 PDF de la siguiente manera. + Cree una biblioteca REXX EXEC llamada `AWS.M2.REXX.EXEC`. Descargue estos [módulos REXX](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) y cópielos en la biblioteca. + `TXT2PDF.rex`- z/OS Software gratuito TXT2 en PDF (modificado) + `TXT2PDFD.rex`- z/OS Software gratuito para TXT2 PDF (sin modificar) + `TXT2PDFX.rex`- z/OS Software gratuito para TXT2 PDF (modificado) + `M2GETOS.rex`- Para comprobar el tipo de sistema operativo (Windows o Linux) Para probar la configuración, consulte [ACL de ejemplo](#txt2pdf-jcl). ## Configurar el TXT2 PDF para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluidas WorkSpaces las aplicaciones) Si las aplicaciones migradas se ejecutan en el entorno de ejecución de modernización de AWS mainframe de Amazon EC2, configure el TXT2 PDF de la siguiente manera. 1. Establezca la variable `MFREXX_CHARSET` de entorno de Rocket Software en el valor adecuado, como «`A`" para los datos ASCII. **importante** Si introduce un valor incorrecto, podrían producirse problemas de conversión de datos (de EBCDIC a ASCII), lo que haría que el PDF resultante fuera ilegible o inoperable. Recomendamos configurar `MFREXX_CHARSET` para que coincida con `MF_CHARSET`. 1. Cambie la [ruta del programa JES de Micro Focus](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para que incluya la ubicación binaria de las utilidades por lotes. Si necesita especificar varias rutas, utilice dos puntos (`:`) para separarlas en Linux y punto y coma (`;`) en Windows. + Linux: `/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. Cree una biblioteca REXX EXEC llamada `AWS.M2.REXX.EXEC``. Descargue estos [módulos REXX](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) y cópielos en la biblioteca. + `TXT2PDF.rex`- z/OS Software gratuito TXT2 en PDF (modificado) + `TXT2PDFD.rex`- z/OS Software gratuito para TXT2 PDF (sin modificar) + `TXT2PDFX.rex`- z/OS Software gratuito para TXT2 PDF (modificado) + `M2GETOS.rex`- Para comprobar el tipo de sistema operativo (Windows o Linux) Para probar la configuración, consulte [ACL de ejemplo](#txt2pdf-jcl). ## ACL de ejemplo Para probar la instalación, puede utilizar uno de los siguientes archivos JCL de ejemplo. **TXT2PDF1.jcl** Este archivo JCL de ejemplo utiliza un nombre DD para la TXT2 conversión a PDF. ``` //TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* PRE DELETE* //*-------------------------------------------------------------------** //* //PREDEL EXEC PGM=IEFBR14 //* //DD01 DD DSN=AWS.M2.TXT2PDF1.PDF.VB, // DISP=(MOD,DELETE,DELETE) //* //DD02 DD DSN=AWS.M2.TXT2PDF1.PDF, // DISP=(MOD,DELETE,DELETE) //* //*-------------------------------------------------------------------** //* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=IKJEFT1B //* //SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC //* //INDD DD * 1THIS IS THE FIRST LINE ON THE PAGE 1 0THIS IS THE THIRD LINE ON THE PAGE 1 -THIS IS THE 6TH LINE ON THE PAGE 1 THIS IS THE 7TH LINE ON THE PAGE 1 +____________________________________ - OVERSTRIKE 7TH LINE 1THIS IS THE FIRST LINE ON THE PAGE 2 0THIS IS THE THIRD LINE ON THE PAGE 2 -THIS IS THE 6TH LINE ON THE PAGE 2 THIS IS THE 7TH LINE ON THE PAGE 2 +____________________________________ - OVERSTRIKE 7TH LINE /* //* //OUTDD DD DSN=AWS.M2.TXT2PDF1.PDF.VB, // DISP=(NEW,CATLG,DELETE), // DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0) //* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DDNAME=SYSIN //* //SYSIN DD * %TXT2PDF BROWSE Y IN DD:INDD + OUT DD:OUTDD + CC YES /* //* //*-------------------------------------------------------------------** //* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)* //*-------------------------------------------------------------------** //* //STEP02 EXEC PGM=VB2LSEQ //* //INFILE DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR //* //OUTFILE DD DSN=AWS.M2.TXT2PDF1.PDF, // DISP=(NEW,CATLG,DELETE), // DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0) //* //SYSOUT DD SYSOUT=* //* // ``` **TXT2PDF2.jcl** En este ejemplo de JCL se utiliza un nombre DSN para la conversión a PDF. TXT2 ``` //TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* PRE DELETE* //*-------------------------------------------------------------------** //* //PREDEL EXEC PGM=IEFBR14 //* //DD01 DD DSN=AWS.M2.TXT2PDF2.PDF.VB, // DISP=(MOD,DELETE,DELETE) //* //DD02 DD DSN=AWS.M2.TXT2PDF2.PDF, // DISP=(MOD,DELETE,DELETE) //* //*-------------------------------------------------------------------** //* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=IKJEFT1B //* //SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC //* //INDD DD * 1THIS IS THE FIRST LINE ON THE PAGE 1 0THIS IS THE THIRD LINE ON THE PAGE 1 -THIS IS THE 6TH LINE ON THE PAGE 1 THIS IS THE 7TH LINE ON THE PAGE 1 +____________________________________ - OVERSTRIKE 7TH LINE 1THIS IS THE FIRST LINE ON THE PAGE 2 0THIS IS THE THIRD LINE ON THE PAGE 2 -THIS IS THE 6TH LINE ON THE PAGE 2 THIS IS THE 7TH LINE ON THE PAGE 2 +____________________________________ - OVERSTRIKE 7TH LINE /* //* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DDNAME=SYSIN //* //SYSIN DD * %TXT2PDF BROWSE Y IN DD:INDD + OUT 'AWS.M2.TXT2PDF2.PDF.VB' + CC YES /* //* //*-------------------------------------------------------------------** //* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)* //*-------------------------------------------------------------------** //* //STEP02 EXEC PGM=VB2LSEQ //* //INFILE DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR //* //OUTFILE DD DSN=AWS.M2.TXT2PDF2.PDF, // DISP=(NEW,CATLG,DELETE), // DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0) //* //SYSOUT DD SYSOUT=* //* // ``` ## Modificaciones Para que el programa TXT2 PDF se ejecute en el entorno de ejecución de AWS Mainframe Modernization Rocket Software, realizamos los siguientes cambios: + Cambios en el código fuente para garantizar la compatibilidad con el entorno de ejecución REXX de Rocket Software + Cambios para garantizar que el programa pueda ejecutarse en los sistemas operativos Windows y Linux + Modificaciones para admitir el tiempo de ejecución en EBCDIC y ASCII ## Referencias TXT2Referencias en PDF y código fuente: + [Convertidor de texto a PDF](https://homerow.net/rexx/txt2pdf/) + [z/OSHerramientas gratuitas TCP/IP y de correo](http://www.lbdsoftware.com/tcpip.html) + [TXT2Guía de referencia para el usuario en PDF](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf) # Utilidad por lotes M2DFUTIL M2DFUTIL es un programa de utilidad de JCL que proporciona funciones de copia de seguridad, restauración, eliminación y copia en conjuntos de datos, de forma similar al soporte que proporciona la utilidad ADRDSSU del mainframe. Este programa conserva muchos de los parámetros SYSIN de ADRDSSU, lo que agiliza el proceso de migración a esta nueva utilidad. **Topics** + [Plataformas admitidas](#m2dfutil-platforms) + [Requisitos de la plataforma](#m2dfutil-platform) + [Compatibilidad futura planificada](#m2udfutil-future-support) + [Ubicaciones de los activos](#mdfutil-assets) + [Configurar M2DFUTIL o el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream](#mdfutil-dependencies) + [Sintaxis general](#mdfutil-syntax) + [Ejemplo JCLs](#mdfutil-sample-jcls) ## Plataformas admitidas Puede utilizar M2DFUTIL en cualquiera de las siguientes plataformas: + Rocket Software (anteriormente Micro Focus) ES en Windows (64 y 32 bits) + Rocket Software ES en Linux (64 bits) ## Requisitos de la plataforma M2DFUTIL depende de llamar a un script para realizar una prueba de expresión regular. En Windows, debe instalar los Windows Services for Linux (WSL) para que se ejecute este script. ## Compatibilidad futura planificada Entre las funciones que actualmente no están disponibles en la utilidad ADRDSSU del mainframe, pero que estarán disponibles en el futuro, se incluyen: + M2 administrado + VSAM + Compatibilidad con COPY para cambiar el nombre de los archivos + Compatibilidad con RENAME para RESTORE + Múltiples INCLUDE y EXCLUDE + Cláusula BY para la subselección mediante DSORG, CREDT, EXPDT + Cláusula MWAIT para reintentar errores en la cola + Compatibilidad con el almacenamiento de S3 para DUMP/RESTORE ## Ubicaciones de los activos El módulo de carga de esta utilidad se llama `M2DFUTIL.so` en Linux y `M2DFUTIL.dll` en Windows. Este módulo de carga se puede encontrar en las siguientes ubicaciones: + Linux: `/opt/aws/m2/microfocus/utilities/64bit` + Windows de 32 bits: `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows de 64 bits: `C:\AWS\M2\MicroFocus\Utilities\64bit` El script utilizado para las pruebas de expresiones regulares se llama `compare.sh`. Este script se puede encontrar en las siguientes ubicaciones: + Linux: `/opt/aws/m2/microfocus/utilities/scripts` + Windows de 32 bits: `C:\AWS\M2\MicroFocus\Utilities\scripts` ## Configurar M2DFUTIL o el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream Configure su región de Enterprise Server con lo siguiente: + Agregue las siguientes variables en **[ES-Environment]** + `M2DFUTILS_BASE_LOC`: la ubicación predeterminada para la salida de DUMP + `M2DFUTILS_SCRIPTPATH`: la ubicación del script `compare.sh` documentada en **Ubicaciones de activos** + `M2DFUTILS_VERBOSE`: [DETALLADO o NORMAL]. Esto controla el nivel de detalle de la salida `SYSPRINT ` + Compruebe que la ruta del módulo de carga se haya agregado a la configuración de `JES\Configuration\JES Program Path` + Compruebe que los scripts del directorio de utilidades tengan permisos de ejecución. Puede agregar un permiso de ejecución mediante el comando `chmod + x