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.
Tutorial: Configuración de una canalización de CI/CD para su uso con Micro Focus Enterprise Developer
En este tutorial se muestra cómo importar, editar, compilar y ejecutar la aplicación de BankDemo ejemplo en Micro Focus Enterprise Developer y, a continuación, cómo confirmar los cambios para activar una canalización de CI/CD.
Contenido
- Requisitos previos
- Creación de una infraestructura básica de canalización de CI/CD
- Cree un AWS CodeCommit repositorio y una canalización de CI/CD
- Creación AppStream de Enterprise Developer 2.0
- Configuración y prueba de Enterprise Developer
- Clona el BankDemo CodeCommit repositorio en Enterprise Developer
- Cree un COBOL proyecto de BankDemo mainframe y cree una aplicación
- Cree un entorno local BankDemo CICS y por lotes para las pruebas
- Inicie el BANKDEMO servidor desde Enterprise Developer
- Inicie el terminal Rumba 3270
- Ejecuta BankDemo una transacción
- Detenga el BANKDEMO servidor de Enterprise Developer
- Ejercicio 1: Mejorar el cálculo del préstamo durante la BANKDEMO solicitud
- Agregue la regla de análisis de préstamos a Enterprise Developer Code Analysis
- Paso 1: Realizar un análisis de código para calcular el préstamo
- Paso 2: Modifique el CICS BMS mapa y el programa y pruébelo COBOL
- Paso 3: Añadir el cálculo del importe total en el COBOL programa
- Paso 4: Confirmar los cambios y ejecutar la canalización de CI/CD
- Ejercicio 2: Extraiga el cálculo del préstamo en BankDemo la solicitud
- Limpieza de recursos
Requisitos previos
Descargue los siguientes archivos.
-
basic-infra.yaml
-
pipeline.yaml
-
m2-code-sync-function.zip
-
config_git.yml
-
BANKDEMO-source.zip
-
BANKDEMO-exercise.zip
El propósito de cada archivo es el siguiente:
basic-infra.yaml
-
Esta AWS CloudFormation plantilla crea la infraestructura básica necesaria para la canalización de CI/CD: VPC buckets de Amazon S3, etc.
pipeline.yaml
-
Una función Lambda utiliza esta AWS CloudFormation plantilla para lanzar la pila de canalización. Asegúrese de que la plantilla se encuentre en un bucket de Amazon S3 de acceso público. Añada el enlace a este bucket como valor predeterminado para el parámetro
PipelineTemplateURL
de la plantillabasic-infra.yaml
. m2-code-sync-function.zip
-
Esta función Lambda crea el CodeCommit repositorio, la estructura de directorios basada en
config_git.yaml
, y lanza la pila de canalizaciones mediante.pipeline.yaml
Asegúrese de que este archivo zip esté disponible en un bucket de Amazon S3 de acceso público en todos los Regiones de AWS lugares en los que se admita la modernización de AWS mainframe. Le recomendamos que almacene el archivo en un depósito en uno Región de AWS y lo replique en todos los depósitos. Regiones de AWS Utilice una convención de nomenclatura para el depósito con un sufijo que identifique lo específico Región de AWS (por ejemplom2-cicd-deployment-source-eu-west-1
) y añada el prefijom2-cicd-deployment-source
como valor predeterminado para el parámetroDeploymentSourceBucket
y forme el depósito completo mediante la función de AWS CloudFormation sustitución!Sub {DeploymentSourceBucket}-${AWS::Region}
mientras hace referencia a ese depósito en labasic-infra.yaml
plantilla como recurso.SourceSyncLambdaFunction
config_git.yml
-
CodeCommit definición de la estructura de directorios. Para obtener más información, consulte Ejemplo de archivo de activación: config_git.yml YAML.
BANKDEMO-source.zip
.-
BankDemo código fuente y archivo de configuración creados a partir del CodeCommit repositorio.
BANKDEMO-exercise.zip
.-
BankDemo fuente de los ejercicios tutoriales creados a partir del CodeCommit repositorio.
Creación de una infraestructura básica de canalización de CI/CD
Utilice la AWS CloudFormation plantilla basic-infra.yaml
para crear la pila de infraestructura básica de la canalización de CI/CD a través de la AWS CloudFormation consola. Esta pila crea buckets de Amazon S3 en los que puede cargar el código y los datos de su aplicación, y una AWS Lambda función de apoyo para crear otros recursos necesarios, como un AWS CodeCommit repositorio y una AWS CodePipeline canalización.
nota
Para lanzar esta pila, necesita permisos de administraciónIAM, Amazon S3, Lambda AWS CloudFormation y permisos de uso. AWS KMS
-
Inicie sesión en AWS Management Console https://console.aws.amazon.com/cloudformation
y abra la AWS CloudFormation consola. -
Cree una nueva pila utilizando una de las siguientes opciones:
-
Elija Crear pila. Esta es la única opción si tiene una pila actualmente en activo.
-
En la página Pilas, elija Crea pila. Esta opción sólo es visible si no hay pilas en ejecución.
-
-
En la página Especificar la plantilla:
-
En Preparar la plantilla, elija La plantilla está lista.
-
En Especificar plantilla, elija Amazon S3 URL como fuente de la plantilla e introduzca una de las siguientes opciones en URLs función de su perfil Región de AWS.
-
https://m2-us-east-1.s3.us-east-1.amazonaws.com/cicd/mf/basic-infra.yaml
-
https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/basic-infra.yaml
-
-
Para aceptar la configuración elija Siguiente.
Se abre la página Crear pila.
Realice los siguientes cambios:
-
Proporcione los valores adecuados para el nombre y los parámetros de la pila para la configuración de red.
-
La mayoría de los parámetros de Configuraciones de la implementación se rellenan previamente de forma adecuada, por lo que no es necesario modificarlos. En función de su Región de AWS ubicación, cambie la AWS CloudFormation plantilla de canalización por una de las siguientes opciones de Amazon S3URLs.
-
https://m2-us-east-1.s3.amazonaws.com/cicd/mf/pipeline.yaml
-
https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/pipeline.yaml
-
-
Elija Next (Siguiente).
nota
No cambie los valores de los parámetros predeterminados a menos que haya modificado la AWS CloudFormation plantilla usted mismo.
-
-
En Configurar opciones de pila, elija Siguiente.
-
En Capacidades, elija Acepto que AWS CloudFormation podría crear IAM recursos AWS CloudFormation para permitir la creación de un IAM rol en su nombre. Seleccione Crear pila.
nota
El aprovisionamiento de la pila puede tardar entre 3 y 5 minutos.
-
Una vez que la pila se haya creado correctamente, diríjase a la sección Salidas de la pila recién aprovisionada. Allí encontrará el bucket de Amazon S3 en el que debe cargar el código de la unidad central y los archivos dependientes.
Cree un AWS CodeCommit repositorio y una canalización de CI/CD
En este paso, se crea un CodeCommit repositorio y se aprovisiona una pila de canalizaciones de CI/CD llamando a una función de Lambda que llama AWS CloudFormation para crear la pila de canalizaciones.
-
Descargue la aplicación de BankDemo muestra
en su máquina local. -
Cargue
bankdemo.zip
desde el equipo local al bucket de Amazon S3 creado en Creación de una infraestructura básica de canalización de CI/CD. -
Descargue
config_git.yml
. -
Modifique el
config_git.yml
si es necesario, de la siguiente manera:-
Añada su propio nombre de repositorio de destino, rama de destino y mensaje de confirmación.
repository-config: target-repository: bankdemo-repo target-branch: main commit-message: Initial commit for bankdemo-repo main branch
-
Escriba la dirección de correo electrónico que desea utilizar para las notificaciones.
pipeline-config: # Send pipeline failure notifications to these email addresses alert-notifications: - myname@mycompany.com # Send notifications for manual approval before production deployment to these email addresses approval-notifications: - myname@mycompany.com
-
-
Cargue el
config_git.yml
archivo que contiene la definición de la estructura de carpetas del CodeCommit repositorio en el bucket de Amazon S3 creado enCreación de una infraestructura básica de canalización de CI/CD. Esto invocará la función de Lambda que aprovisionará automáticamente el repositorio y la canalización.Esto creará un CodeCommit repositorio con el nombre indicado en
target-repository
elconfig_git.yml
archivo; por ejemplo,bankdemo-repo
.La función Lambda también creará la pila de canalizaciones de CI/CD a través de ella. AWS CloudFormation La pila AWS CloudFormation tendrá el mismo prefijo que el nombre de
target-repository
proporcionado seguido de una cadena aleatoria (por ejemplo,bankdemo-repo-
). Puede encontrar el CodeCommit repositorio URL y el URL para acceder a la canalización creada en la AWS consola de administración.01234567
-
Si se completa la creación del CodeCommit repositorio, la canalización de CI/CD se activará inmediatamente para realizar una CI/CD completa.
-
Una vez insertado el archivo, se activará automáticamente la canalización, que se construirá, se desplegará en el entorno provisional, realizará algunas pruebas y esperará a la aprobación manual antes de implementarlo todo en el entorno de producción.
Ejemplo de archivo de activación: config_git.yml YAML
repository-config: target-repository: bankdemo-repo target-branch: main commit-message: Initial commit for bankdemo-repo main branch directory-structure: - '/': files: - build.xml - '*.yaml' - '*.yml' - '*.xml' - 'LICENSE.txt' readme: | # Root Folder - 'build.xml' : Build configuration for the application - tests: files: - '*.py' readme: | # Test Folder - '*.py' : Test scripts - config: files: - 'BANKDEMO.csd' - 'BANKDEMO.json' - 'BANKDEMO_ED.json' - 'dfhdrdat' - 'ESPGSQLXA.dll' - 'ESPGSQLXA64.so' - 'ESPGSQLXA64_S.so' - 'EXTFH.cfg' - 'm2-2021-04-28.normal.json' - 'MFDBFH.cfg' - 'application-definition-template-config.json' readme: | # Config Folder This folder contains the application configuration files. - 'BANKDEMO.csd' : CICS Resource definitions export file - 'BANKDEMO.json' : Enterprise Server configuration - 'BANKDEMO_ED.json' : Enterprise Server configuration for ED - 'dfhdrdat' : CICS resource definition file - 'ESPGSQLXA.dll' : XA switch module Windows - 'ESPGSQLXA64.so' : XA switch module Linux - 'ESPGSQLXA64_S.so' : XA switch module Linux - 'EXTFH.cfg' : Micro Focus File Handler configuration - 'm2-2021-04-28.normal.json' : M2 request document - 'MFDBFH.cfg' : Micro Focus Database File Handler - 'application-definition-template-config.json' : Application definition for M2 - source: subdirs: - .settings: files: - '.bms.mfdirset' - '.cbl.mfdirset' - copybook: files: - '*.cpy' - '*.inc' readme: | # Copy folder This folder contains the source for COBOL copy books, PLI includes, ... - .cpy COBOL copybooks - .inc PLI includes # - ctlcards: # files: # - '*.ctl' # - 'KBNKSRT1.txt' # readme: | # # Control Card folder # This folder contains the source for Batch Control Cards # - .ctl Control Cards - ims: files: - '*.dbd' - '*.psb' readme: | # ims folder This folder contains the IMS DB source files with the extensions - .dbd for IMS DBD source - .psb for IMS PSB source - jcl: files: - '*.jcl' - '*.ctl' - 'KBNKSRT1.txt' - '*.prc' readme: | # jcl folder This folder contains the JCL source files with the extensions - .jcl # - proclib: # files: # - '*.prc' # readme: | # # proclib folder # This folder contains the JCL procedures referenced via PROCLIB statements in the JCL with extensions # - .prc - rdbms: files: - '*.sql' readme: | # rdbms folder This folder contains any DB2 related source files with extensions - .sql for any kind of SQL source - screens: files: - '*.bms' - '*.mfs' readme: | # screens folder This folder contains the screens source files with the extensions - .bms for CICS BMS screens - .mfs for IMS MFS screens subdirs: - .settings: files: - '*.bms.mfdirset' - cobol: files: - '*.cbl' - '*.pli' readme: | # source folder This folder contains the program source files with the extensions - .cbl for COBOL source - .pli for PLI source subdirs: - .settings: files: - '*.cbl.mfdirset' - tests: files: - 'test_script.py' readme: | # tests Folder This folder contains the application test scripts pipeline-config: alert-notifications: - myname@mycompany.com approval-notifications: - myname@mycompany.com
Creación AppStream de Enterprise Developer 2.0
Para configurar Micro Focus Enterprise Developer en AppStream 2.0, consulteTutorial: Configurar Micro Focus Enterprise Developer en AppStream 2.0.
Para conectar el CodeCommit repositorio a Enterprise Developer, utilice el nombre especificado target-repository
enEjemplo de archivo de activación: config_git.yml YAML.
Configuración y prueba de Enterprise Developer
Temas
- Clona el BankDemo CodeCommit repositorio en Enterprise Developer
- Cree un COBOL proyecto de BankDemo mainframe y cree una aplicación
- Cree un entorno local BankDemo CICS y por lotes para las pruebas
- Inicie el BANKDEMO servidor desde Enterprise Developer
- Inicie el terminal Rumba 3270
- Ejecuta BankDemo una transacción
- Detenga el BANKDEMO servidor de Enterprise Developer
Conéctese a la instancia de Enterprise Developer AppStream 2.0 en la que creóCreación AppStream de Enterprise Developer 2.0.
-
Inicie Enterprise Developer desde el menú de incio de Windows. Elija Micro Focus Enterprise Developer y, a continuación, Enterprise Developer for Eclipse. Si es la primera vez que lo inicia, es posible que tarde algún tiempo.
-
En el lanzador de Eclipse, en el espacio de trabajo: introduzca
C:\Users\<username>\workspace
y seleccione Lanzar.nota
Asegúrese de elegir la misma ubicación después de volver a conectarse a la instancia AppStream 2.0. La selección del espacio de trabajo no es persistente.
-
En Welcome, elige Open COBOL Perspective. Esto solo se mostrará la primera vez en un espacio de trabajo nuevo.
Clona el BankDemo CodeCommit repositorio en Enterprise Developer
-
Elija Window / Perspective / Open Perspective / Other ... / Git.
-
Elija Clone a Git repository.
-
En Clone Git Repository, introduzca la siguiente información:
-
En Ubicación URI, introduzca el HTTPS URL del CodeCommit repositorio.
nota
Copie el clon URL HTTPS del CodeCommit repositorio en la consola AWS de administración y péguelo aquí. Se URI dividirá en las rutas de host y repositorio.
-
El usuario guarda CodeCommit las credenciales en Authentication User and Password y selecciona Guardar en Secure Store.
-
-
En Branch Selection, elija Main branch y, a continuación, Next .
-
En Destino local, en Directorio, ingresa
C:\Users\<username>\workspace
y selecciona Finalizar.El proceso de clonación finaliza cuando
BANKDEMO [main]
se muestra en la vista Repositorios de Git.
Cree un COBOL proyecto de BankDemo mainframe y cree una aplicación
-
Cambie a COBOLPerspective.
-
En Project, desactive Build Automatically.
-
En Archivo, seleccione Nuevo y, a continuación, COBOLProyecto Mainframe.
-
En New Mainframe COBOL Project, introduzca la siguiente información:
-
En Project name, introduzca
BankDemo
. -
Elija la Micro Focus template [64 bit]
-
Elija Finish.
-
-
En COBOLExplorer, expanda el nuevo BankDemo proyecto.
nota
[BANKDEMO main]
entre corchetes indica que el proyecto está conectado al BankDemo CodeCommit repositorio local. -
Si la vista en árbol no muestra las entradas de los COBOL programas, los cuadernos, las BMS fuentes y JCL los archivos, seleccione Actualizar en el menú contextual del BankDemo proyecto.
-
BankDemo En el menú contextual, seleccione Propiedades/Micro Focus/Configuración del proyecto/COBOL:
-
Seleccione Conjunto de caracteres - ASCII.
-
Elija Apply y, después, Close.
-
-
Si la compilación de la COBOL fuente BMS y la fuente no se inicia inmediatamente, compruebe en el menú Proyecto que la opción Construir automáticamente esté habilitada.
La salida de la compilación se mostrará en la vista de la consola y lo normal es que se complete después de unos minutos con los mensajes
BUILD SUCCESSFUL
yBuild finished with no errors
.La BankDemo aplicación ahora debería estar compilada y lista para su ejecución local.
Cree un entorno local BankDemo CICS y por lotes para las pruebas
-
En COBOLExplorer, expanda
BANKDEMO / config
. -
En el editor, abra
BANKDEMO_ED.json
. -
Busque la cadena
ED_Home=
y cambie la ruta para que apunte al proyecto de Enterprise Developer, de la siguiente manera:D:\\<username>\\workspace\\BANKDEMO
. Observe el uso de barras dobles (\\
) en la definición de la ruta. -
Guarde y cierre el archivo.
-
Elija Server Explorer.
-
En el menú contextual predeterminado, elija Open Administration Page. La página de administración del servidor Micro Focus Enterprise se abre en el navegador predeterminado.
-
Solo para las sesiones AppStream 2.0, realice los siguientes cambios para poder conservar su región local de Enterprise Server para las pruebas locales:
-
En Directory Server/Default, elija PROPERTIES/Configuración.
-
Sustituya la Repository Location por
D:\<username>\My Files\Home Folder\MFDS
.
nota
Debe completar los pasos 5 a 8 después de cada nueva conexión a una instancia AppStream 2.0.
-
-
En Directory Server / Default, elija Import y, a continuación, complete los siguientes pasos:
-
En el paso 1: Tipo de importación, seleccione JSONy elija Siguiente.
-
En Step 2: Upload , haga clic para cargar el archivo del cuadrado azul.
-
En Choose File to Upload, introduzca:
-
File name:
D:\<username>\workspace\BANKDEMO\config\BANKDEMO_ED.json
. -
Elija Open.
-
-
Elija Next.
-
En Step 3: Regions elimine Clear Ports from Endpoints.
-
Elija Next (Siguiente).
-
En Step 4: Import, elija Import.
-
Seleccione Finalizar.
La lista mostrará ahora un nuevo nombre de servidor
BANKDEMO
. -
Inicie el BANKDEMO servidor desde Enterprise Developer
-
Elija Enterprise Developer.
-
En el explorador de servidores, elija Default y, a continuación, elija Refresh en el menú contextual.
Ahora también debería mostrarse la lista de servidoresBANKDEMO.
-
Elige BANKDEMO.
-
En el menú contextual, elija Asociar con el proyecto y, a continuación, elija BANKDEMO.
-
En el menú contextual, elija Start.
La vista de la consola debería mostrar el registro del inicio del servidor.
Si aparece el mensaje
BANKDEMO CASSI5030I PLTPI Phase 2 List(PI) Processing Completed
, el servidor está listo para probar la CICS BANKDEMO aplicación.
Inicie el terminal Rumba 3270
-
Desde el menú de inicio de Windows, inicie Micro Focus Rumba+ Desktop o Rumba+ Desktop.
-
En Bienvenido, elija CREATENEWSESSION/Mainframe Display.
-
En Mainframe Display, elija Connection / Configure.
-
En Configuración de sesión, elija Conexión/TN3270.
-
En Host Name / Address, elija Insert and enter IP address
127.0.0.1
. -
En Telnet Port, introduzca el puerto
6000
. -
Seleccione Apply.
-
Elija Connect.
La pantalla de CICS bienvenida muestra una pantalla con el mensaje de la fila 1:
This is the Micro Focus MFE CICS region BANKDEMO
. -
Presiona CTRL +Shift+Z para borrar la pantalla.
Ejecuta BankDemo una transacción
-
En una pantalla vacía, introduzca
BANK
. -
En la pantalla BANK10, en el campo de entrada del seudónimo... :, introduzca
guest
y pulse Entrar. -
En la pantalla BANK20, en el campo de entrada situado antes de Calcular el coste de un préstamo, introduzca
/
(barra inclinada) y pulse Entrar. -
En la pantalla BANK70:
-
En The amount you would like to borrow...:, introduzca
10000
. -
En At an interest rate of................:, introduzca
5.0
. -
En For how many months...................:, introduzca
10
. -
Pulse Intro.
Se debe mostrar el siguiente resultado:
Resulting monthly payment.............: $1023.06
Esto completa la configuración de la BANKDEMO aplicación en Enterprise Developer.
-
Detenga el BANKDEMO servidor de Enterprise Developer
-
En el explorador de servidores, elija Default y, a continuación, elija Refresh en el menú contextual.
-
Elija BANKDEMO.
-
En el menú contextual, elija Stop.
La vista de la consola debería mostrar el registro de la detención del servidor.
Si se muestra el mensaje
Server: BANKDEMO stopped successfully
, el servidor se ha apagado correctamente.
Ejercicio 1: Mejorar el cálculo del préstamo durante la BANKDEMO solicitud
Temas
- Agregue la regla de análisis de préstamos a Enterprise Developer Code Analysis
- Paso 1: Realizar un análisis de código para calcular el préstamo
- Paso 2: Modifique el CICS BMS mapa y el programa y pruébelo COBOL
- Paso 3: Añadir el cálculo del importe total en el COBOL programa
- Paso 4: Confirmar los cambios y ejecutar la canalización de CI/CD
En este escenario, explicará el proceso de realizar un ejemplo de cambio en el código, implementarlo y probarlo.
El departamento de préstamos quiere que aparezca un nuevo campo en la pantalla BANK7 0 de cálculo del préstamo para mostrar el importe total del préstamo. Esto requiere un cambio de BMS pantalla (MBANK70). CBL, añadiendo un nuevo campo y el correspondiente programa de manejo de pantalla SBANK7 0P. CBLcon cuadernos relacionados. Además, la rutina de cálculo de préstamos en BBANK7 0P. CBLdebe ampliarse con la fórmula adicional.
Para completar este ejercicio, asegúrese de completar los siguientes requisitos previos.
-
Descarga BANKDEMO-exercise.zip
para D:\PhotonUser\My Files\Home Folder
. -
Descomprima el archivo .zip en
D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise
. -
Crea la carpeta
D:\PhotonUser\My Files\Home Folder\AnalysisRules
. -
Copie el archivo de reglas
Loan+Calculation+Update.General-1.xml
de la carpetaBANKDEMO-exercise
aD:\PhotonUser\My Files\Home Folder\AnalysisRules
.
nota
El código cambia en *. CBLy *. CPYestán marcados con EXER 01 en las columnas 1 a 6 para este ejercicio.
Agregue la regla de análisis de préstamos a Enterprise Developer Code Analysis
Las reglas de análisis definidas en Micro Focus Enterprise Analyzer se pueden exportar desde Enterprise Analyzer e importar a Enterprise Developer para ejecutar las mismas reglas de análisis en todos los orígenes del proyecto de Enterprise Developer.
-
Abra
Window/Preferences/Micro Focus/COBOL/Code Analysis/Rules
. -
Elija Edit... e introduzca el nombre de la carpeta
D:\PhotonUser\My Files\Home Folder\AnalysisRules
que contiene el archivo de reglasLoan+Calculation+Update.General-1.xml
. -
Seleccione Finalizar.
-
Seleccione Apply y, a continuación, seleccione Close.
-
En el menú contextual del BANKDEMO proyecto, seleccione Análisis de código.
Debería ver una entrada para Loan Calculation Update.
Paso 1: Realizar un análisis de código para calcular el préstamo
Con la nueva regla de análisis queremos identificar los COBOL programas y las líneas de código que contienen y que coinciden con los patrones de búsqueda*PAYMENT*
, así *LOAN*
como *RATE*
en las expresiones, sentencias y variables. Esto nos ayudará a navegar por el código e identificar los cambios de código necesarios.
-
En el menú contextual BANKDEMO del proyecto, seleccione Code Analysis/Loan Calculation Update.
Esto ejecutará la regla de búsqueda y mostrará los resultados en una nueva pestaña llamada Code Analysis. La ejecución del análisis finaliza cuando desaparece la barra de progreso verde situada en la parte inferior derecha.
La pestaña Code Analysis debería mostrar una lista expandida de
BBANK20P.CBL
,BBANK70P.CBL
ySBANK70P.CBL
, cada uno con un listado de las instrucciones, expresiones y variables que coincidan con los patrones de búsqueda.Al observar el resultado de
BBANK20P.CBL
, solo se mueven los literales que coinciden con el patrón de búsqueda. Por lo tanto, este programa se puede ignorar. -
En la barra de menú de pestañas, elija - Icon para colapsar todo.
-
Expanda
SBANK70P.CBL
y seleccione las líneas en cualquier orden haciendo doble clic para ver cómo se abrirá el origen y se resaltará la línea seleccionada en el código fuente. También verá que todas las líneas fuente identificadas están marcadas.
Paso 2: Modifique el CICS BMS mapa y el programa y pruébelo COBOL
Primero cambiaremos el BMS mapa MBANK70.BMS
y el programa de manejo de pantalla SBANK70P.CBL
y el cuaderno CBANKDAT.CPY
para mostrar el nuevo campo. Para evitar codificación innecesaria en este ejercicio, los módulos de origen modificados están disponibles en la carpeta D:\PhotonUser\My
Files\Home Folder\BANKDEMO-exercise\Exercise01
. Normalmente, un desarrollador utilizaría los resultados del análisis de código para navegar y modificar los orígenes. Si tiene tiempo y desea realizar los cambios manuales, hágalo con la información proporcionada en *Cambio manual en 0. MBANK7 BMSy SBANK7 0P. CBL(Opcional) *.
Para realizar cambios rápidos, copie los siguientes archivos:
-
..\BANKDEMO-exercise\Exercis01\screens\MBANK70.BMS
aD:\PhotonUser\workspace\bankdemo\source\screens
. -
.\BANKDEMO-exercise\Exercis01\cobol\SBANK70P.CBL
aD:\PhotonUser\workspace\bankdemo\source\cobol
. -
..\BANKDEMO-exercise\Exercis01\copybook\CBANKDAT.CPY
aD:\PhotonUser\workspace\bankdemo\source\copybook
. -
Para asegurarse de que todos los programas afectados por los cambios estén compilados, elija Project/Clean.../Clean all project.
Para realizar cambios manuales en MBANK70.BMS
ySBANK70P.CBL
, complete los siguientes pasos:
-
Para el cambio manual de la BMS
MBANK70.BMS
fuente, añada después delPAYMENT
campo:-
TXT09 con los mismos atributos que TXT 08 y con INITIAL el valor «Importe total del préstamo»
-
TOTALcon los mismos atributos que PAYMENT
-
Pruebe los cambios
Para probar los cambios, repita los pasos de las siguientes secciones:
-
Ejecuta BankDemo una transacción
Además, ahora también debería ver el texto
Total Loan Amount.....................:
.
Paso 3: Añadir el cálculo del importe total en el COBOL programa
En el segundo paso, cambiaremos BBANK70P.CBL
y sumaremos el cálculo del importe total del préstamo. El origen preparado con los cambios necesarios está disponible en la carpeta D:\PhotonUser\My Files\Home
Folder\BANKDEMO-exercise\Exercise01
. Si tiene tiempo y desea realizar los cambios manuales, hágalo con la información proporcionada en *Cambio manual en BBANK7 0P. CBL(Opcional) *.
Para realizar cambios rápidos, copie el siguiente archivo:
-
..\BANKDEMO-exercise\Exercis01\source\cobol\BBANK70P.CBL
aD:\PhotonUser\workspace\bankdemo\source\cobol
.
Para realizar un cambio manual en BBANK70P.CBL
, complete los siguientes pasos:
-
Utilice el resultado del análisis de código para identificar los cambios necesarios.
Pruebe los cambios
Para probar los cambios, repita los pasos de las siguientes secciones:
-
Ejecuta BankDemo una transacción
Además, ahora también debería ver el texto
Total Loan Amount.....................: $10230.60
.
Paso 4: Confirmar los cambios y ejecutar la canalización de CI/CD
Guarde los cambios en el CodeCommit repositorio central y active la canalización de CI/CD para crear, probar e implementar los cambios.
-
Desde el BANKDEMO proyecto, en el menú contextual, selecciona Team/Commit.
-
En la pestaña Git Staging, introduzca el siguiente mensaje de confirmación:
Added Total Amount Calculation
. -
Elija Commit and Push....
-
Abre la CodePipeline consola y comprueba el estado de la ejecución de la canalización.
nota
En caso de que tenga algún problema con la característica Commit o Push de Enterprise Developer o Teams, utilice la interfaz de línea de comandos de Git Bash.
Ejercicio 2: Extraiga el cálculo del préstamo en BankDemo la solicitud
Temas
En el siguiente ejercicio, analizará otro ejemplo de solicitud de cambio. En este escenario, el departamento de préstamos quiere reutilizar la rutina de cálculo de préstamos de forma independiente. WebService La rutina debería permanecer COBOL y también debería poder invocarse desde el programa existente CICSCOBOL. BBANK70P.CBL
Paso 1: Refactorizar la rutina de cálculo de préstamos en una sección COBOL
En el primer paso, extraemos la rutina de cálculo del préstamo en una COBOL sección. Este paso es necesario para extraer el código en un COBOL programa independiente en el siguiente paso.
-
Abre
BBANK70P.CBL
en el COBOL editor. -
En el menú contextual del proyecto de BANKDEMO, seleccione Code Analysis/Loan Calculation Update. Esto solo escaneará el origen actual en busca de los patrones definidos en la regla de análisis.
-
En el resultado, en la pestaña Code Analysis, busque la primera instrucción aritmética
DIVIDE WS-LOAN-INTEREST BY 12
. -
Haga doble clic en la instrucción para ir a la línea de origen en el editor. Esta es la primera instrucción de la rutina de cálculo de préstamos.
-
Marque el siguiente bloque de código para extraer la rutina de cálculo de préstamos en una sección.
DIVIDE WS-LOAN-INTEREST BY 12 GIVING WS-LOAN-INTEREST ROUNDED. COMPUTE WS-LOAN-MONTHLY-PAYMENT ROUNDED = ((WS-LOAN-INTEREST * ((1 + WS-LOAN-INTEREST) ** WS-LOAN-TERM)) / (((1 + WS-LOAN-INTEREST) * WS-LOAN-TERM) - 1 )) * WS-LOAN-PRINCIPAL. EXER01 COMPUTE WS-LOAN-TOTAL-PAYMENT = EXER01 (WS-LOAN-MONTHLY-PAYMENT * WS-LOAN-TERM).
-
En el menú contextual del editor, seleccione Refactor/Extract to Section....
-
Introduzca el nombre de la nueva sección: LOAN - CALCULATION.
-
Seleccione OK.
El bloque de código marcado se ha extraído ahora a la nueva sección
LOAN-CALCULATION
y el bloque de código se ha sustituido por la instrucciónPERFROM LOAN-CALCULATION
.
Pruebe los cambios
Para probar los cambios, repita los pasos de las siguientes secciones:
-
Ejecuta BankDemo una transacción
Además, ahora también debería ver el texto
Total Loan Amount.....................: $10230.60
. -
Detenga el BANKDEMO servidor de Enterprise Developer
nota
Si quiere evitar los pasos anteriores para extraer el bloque de código a una sección, puede copiar el origen modificado del paso 1 de
..\BANKDEMO-exercise\Exercis02\Step1\cobol\BBANK70P.CBL
aD:\PhotonUser\workspace\bankdemo\source\cobol
.
Paso 2: Extraiga la rutina de cálculo de préstamos a un programa independiente COBOL
En el paso 2, el bloque de código de la sección LOAN-CALCULATION
se extraerá a un programa independiente y el código original se sustituirá por el código para llamar al nuevo subprograma.
-
Abra
BBANK70P.CBL
en el editor y busque la nueva instrucciónPERFORM LOAN-CALCULATION
creada en el paso 1. -
Coloque el cursor dentro del nombre de la sección. Se marcará en gris.
-
En el menú contextual, seleccione Refactor->Extract Section/Paragraph to Program....
-
En Extraer la sección/párrafo del programa, ingrese el nuevo nombre de archivo:. LOANCALC CBL.
-
Seleccione OK.
El nuevo programa
LOANCALC.CBL
se abrirá en el editor. -
Desplácese hacia abajo y revise el código que se está extrayendo y generando para la interfaz de llamada.
-
Seleccione el editor con
BBANK70P.CBL
y vaya aLOAN-CALCULATION SECTION
. Revise el código que se está generando para llamar al nuevo subprogramaLOANCALC.CBL
.nota
La
CALL
sentencia es usarDFHEIBLK
yDFHCOMMAREA
llamarLOANCALC
con bloques CICS de control. Como queremos decir que el nuevoLOANCALC.CBL
subprograma no es CICS programa, debemos eliminarDFHEIBLK
y cancelarDFHCOMMAREA
la llamada comentando o borrando.
Pruebe los cambios
Para probar los cambios, repita los pasos de las siguientes secciones:
-
Ejecuta BankDemo una transacción
Además, ahora también debería ver el texto
Total Loan Amount.....................: $10230.60
. -
Detenga el BANKDEMO servidor de Enterprise Developer
nota
Si quiere evitar los pasos anteriores para extraer el bloque de código a una sección, puede copiar el origen modificado del paso 1 de
..\BANKDEMO-exercise\Exercis02\Step2\cobol\BBANK70P.CBL
yLOANCALC.CBL
aD:\PhotonUser\workspace\bankdemo\source\cobol
.
Paso 3: Confirmar los cambios y ejecutar la canalización de CI/CD
Guarde los cambios en el CodeCommit repositorio central y active la canalización de CI/CD para compilar, probar e implementar los cambios.
-
Desde el BANKDEMO proyecto, en el menú contextual, selecciona Team/Commit.
-
En la pestaña Git Staging
-
Añada etapas sin etapas. LOANCALC CBLy. LOANCALC CBL.mfdirset.
-
Introduzca un mensaje de confirmación:
Added Total Amount Calculation
.
-
-
Elija Commit and Push....
-
Abre la CodePipeline consola y comprueba el estado de la ejecución de la canalización.
nota
En caso de que tenga algún problema con la característica Commit o Push de Enterprise Developer o Teams, utilice la interfaz de línea de comandos de Git Bash.
Limpieza de 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 la CodePipeline canalización. Para obtener más información, consulte Eliminar una canalización CodePipeline en la Guía del AWS CodePipeline usuario.
-
Elimine el CodeCommit repositorio. Para obtener más información, consulte Eliminar un CodeCommit repositorio en la Guía del AWS CodeCommit usuario.
-
Elimine el bucket de S3. Para obtener más información, consulte Eliminar un bucket en la Guía del usuario de Amazon Simple Storage Service.
-
Elimine la AWS CloudFormation pila. Para obtener más información, consulte Eliminar una pila de la AWS CloudFormation consola en la Guía del AWS CloudFormation usuario.