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.
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: Implemente la aplicación en NTT DATA CardDemo
Esta página le guía a través del step-by-step proceso de implementación de la aplicación de CardDemo ejemplo en la replataforma de modernización del AWS mainframe con el tiempo de ejecución de NTT DATA Unikix.
La aplicación CardDemo de muestra es una aplicación de mainframe simplificada diseñada y desarrollada para probar y mostrar la tecnología asociada a los casos de uso de AWS migración y modernización de mainframes.
Para obtener más información sobre esta aplicación, consulte el repositorio de. GitHub CardDemo
Temas
Diagrama de flujo de implementación
En el siguiente diagrama se muestra cada paso del flujo de trabajo para implementar una aplicación en el tiempo de ejecución de UniKix de NTT DATA.
Requisitos previos
-
Siga las instrucciones que se proporcionan en la sección AWS Modernización del mainframe y cambio de plataforma con NTT DATA Uso de la AMI de NTT DATA UniKix Marketplace
. -
Modifique la opción de metadatos de la instancia IMDSv2a Opcional, tal y como se menciona en Restaurar el uso de IMDSv1 en la guía del usuario de Amazon EC2.
-
Descargue los componentes CardDemo de tiempo de ejecución para NTT DATA desde UniKix
-
Inicie sesión en la instancia EC2 en tiempo de UniKix ejecución como
ec2-user. -
Extraiga los componentes CardDemo de tiempo de ejecución descargados mediante este enlace: UniKix_ CardDemo _runtime_v1.zip
. -
El directorio extraído debería contener los directorios
migrated_appybin. -
Mueva los directorios
migrated_appybinal directorio$HOME. La ruta sería como/home/ec2-user. -
Debería tener los siguientes directorios en
$HOME:-
/home/ec2-user/bin -
/home/ec2-user/migrated_app
-
-
Mueva todos los archivos dentro del directorio $HOME/bin con el siguiente comando:
-
-
chmod +x $HOME/bin/*
-
-
Paso 1: preparación del entorno
Tras completar los requisitos previos, el primer paso es preparar el entorno en el que desea implementar la CardDemo aplicación.
-
Inicie sesión en la instancia EC2 en UniKix tiempo de ejecución como.
ec2-user -
Observe la lista de UniKix software preempaquetado en la AMI, como TPE, BPE y COBOL, junto con otros de la ubicación del UniKix producto de NTT DATA mediante el siguiente comando en su instancia de EC2:
ls -l /opt/software/ -
Examine la aplicación migrada. CardDemo Verá todo el código fuente, incluidos los mapas BMS, los programas COBOL, los cuadernos COBOL y. JCLs También encontrará la exportación de los catálogos de BPE y TPE, las definiciones de recursos del CICS y los datos migrados, como los archivos secuenciales y los archivos VSAM, de la siguiente manera:
ls $HOME/migrated_app/*/* -
Para crear la estructura de carpetas, ejecute el script
create_projectcon el siguiente comando:sh $HOME/bin/create_project -
Active el CardDemo entorno buscando el archivo de configuración mediante:
carddemo.envsource $HOME/bin/carddemo.env
Paso 2: creación de una región de TPE
Una vez que haya activado el entorno en el que desea implementar la aplicación, debe crear una región de TPE.
-
Cree una región de TPE mediante el comando
kixregion createRegionque requiere entradas como$KIXSYS,$JAVA_HOMEy$KIXLICDIR. Estas variables de entorno ya están configuradas en el archivo de configuracióncarddemo.env.kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR -
Configure la región de TPE mediante el comando
kixregion setAttr.kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS -
Para generar el archivo de entorno de usuario específico para esta región de TPE, ejecute el comando
kixregion createScript. Este comando crea o actualiza$KIXSYS/bin/userenven función de la configuración de la región de TPE.kixregion createScript $KIXSYS -
Active la región de TPE mediante el aprovisionamiento del archivo de entorno de usuario (
$KIXSYS/bin/userenv).source $KIXSYS/bin/userenv -
Cree la región de TPE ejecutando el comando
kixinstall2.kixinstall2
Paso 3: creación del subsistema y del nodo de BPE
Después de crear una región de TPE, debe crear el subsistema y el nodo de BPE siguiendo estos pasos.
-
Cambie la propiedad y los permisos de
INSTEBM.sudo chown root $INSTEBM sudo chmod 4755 $INSTEBM -
Cree un nodo de BPE mediante el comando
INSTEBM. El directorio de nodos de BPE se proporciona como el parámetro de entrada.$INSTEBM $EBMHOME -
Active el entorno de lotes mediante el aprovisionamiento del archivo
batchenva partir del nodo de BPE recién creado.source $EBMHOME/batchenv -
Cree el subsistema de BPE dentro de este nodo mediante Batch Administration Manager (bam). El comando
bamabrirá la interfaz de Batch Administration Manager.bam-
Inicie el nodo de BPE mediante la interfaz de BAM. Elija la opción 2, Entornos del sistema en el menú principal.
-
Elija la opción 2, Iniciar/detener el nodo de lote para iniciar el nodo de BPE.
-
Una vez iniciado, pulse la tecla Intro dos veces para volver al menú principal de BAM.
-
Para crear el subsistema de BPE, elija la opción 3, Aplicaciones y subsistemas.
-
A continuación, elija la opción 3, Crear un subsistema.
-
Introduzca el nombre del subsistema como
sys1.
-
Elija la opción 3, Administración de datos.
-
Elija la opción 5, ya que la CardDemo aplicación incluye archivos secuenciales y VSAM.
-
(Opcional). Pulse R para volver a la página Crear menú y revise las diferentes opciones de configuración disponibles.
-
En la página Crear, introduzca C para crear el subsistema
sys1.
-
Revise la configuración e introduzca C para continuar con el resto de la configuración del entorno. Esta configuración del entorno se rellena previamente porque se han establecido las variables de entorno necesarias definidas en el archivo de configuración
carddemo.envy la estructura de carpetas recomendada. -
Introduzca s para confirmar y guardar la configuración del entorno actual.
-
Introduzca s para mostrar el registro al crear el subsistema.
-
Pulse la tecla Intro hasta volver al menú principal y salir de la interfaz de BAM seleccionando la opción Salir.
-
-
Active el subsistema de BPE mediante el aprovisionamiento de
batchenvcon el nombre del subsistemasys1.source $EBMHOME/batchenv sys1
Paso 4: Compilar e implementar la aplicación CardDemo
En este paso, se compilan los programas de COBOL y se implementan los artefactos de aplicación, como el JCL, los procedimientos, los archivos de datos y las definiciones de recursos del CICS.
-
Vuelva a activar el CardDemo entorno buscando el archivo
carddemo.envde configuración.source $HOME/bin/carddemo.env -
Vaya al directorio de origen de COBOL.
cd $MIGAPP_DIR/cbl -
Compile el programa de Cobol
CBACT01C.cblmediante el scriptcompile.compile CBACT01C.cbl -
Compile todos los programas de Cobol mediante el script
compile.all.compile.all -
Navegue hasta el directorio de origen de mapas de BMS.
cd $MIGAPP_DIR/bms -
Compile el mapa de BMS
COACTUP.bmsmediante el scriptcompbms.compbms COACTUP.bms -
Compile todos los mapas de BMS mediante el script
compbms.all.compbms.all -
Verifique los binarios compilados para los mapas COBOL y BMS.
ls $PROJECT_ROOT/loadlib ls $PROJECT_ROOT/maps -
Implemente otros artefactos de aplicación, como el JCL, los procedimientos, los archivos de datos y las definiciones de recursos del CICS mediante el script
deploy_app.deploy_app -
Desplácese hasta el directorio JCL del proyecto.
cd $PROJECT_ROOT/jcl -
Traduzca ACCTFILE de JCL a macro de JCL de BPE. Utilice el comando
mvstrans, con la opción -v para la verificación de JCL y la opción -v para crear la macro.mvstrans ACCTFILE -v mvstrans ACCTFILE -f -
Traduzca el procedimiento JCL REPROC a la macro de procedimiento de JCL de BPE. Utilice el comando
mvstranscon la opción -p junto con la opción -v para la verificación y la opción -f para crear la macro.mvstrans REPROC -v -p mvstrans REPROC -f -p -
Translate all JCLs y los procedimientos de JCL.
for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out
Paso 5: importación del catálogo de BPE y TPE
En este paso, se importa el catálogo de BPE y TPE mediante diferentes comandos.
-
Importe el catálogo de BPE mediante el comando
loadcat.loadcat $MIGAPP_DIR/catlg/bpe/BPECAT* -
Vaya al directorio $KIXSYS.
cd $KIXSYS -
Importe el catálogo de TPE mediante el comando
kiximpcat.kiximpcat -c CATALOG -l CATALOG.lst -
Importe las definiciones de recursos de CICS mediante el comando kiximptbl.
kiximptbl
Paso 6: inicio y conexión de TPE con BPE
En este paso, debe iniciar la región de TPE creada anteriormente junto con el administrador de BPE y conectarlos para poder ejecutar la aplicación de muestra. CardDemo
-
Ejecute el comando
kixverifyen todos los archivos VSAM para asegurarse de que se restablezcan y de que se cierren todos los archivos abiertos anteriormente.kixverify -r ALL -
Inicie la región de TPE.
kixregion start $KIXSYS -
Asegúrese de que tanto BPE como TPE estén conectados. Esto es fundamental, ya que los archivos de VSAM son propiedad de TPE y cualquier operación por lotes que acceda al VSAM requerirá una conexión a TPE.
ebmsys -t
Paso 7: ejecuta la aplicación CardDemo
En este paso, ejecuta la CardDemo aplicación en el emulador de TN3270 terminal.
La AMI en UniKix tiempo de ejecución incluye el emulador de terminal TN3270 que puede iniciar directamente desde la instancia UniKix EC2.
Conéctese a TPE mediante el emulador TN3270 de terminal
-
Inicie la TN3270 terminal con el
kixtermcomando.kixterm
(Opcional). Si desea utilizar su propio emulador de terminal:
-
Obtenga la dirección IP de la instancia de tiempo de UniKix ejecución de la consola Amazon EC2.
-
Obtenga el número de puerto para conectarse a la región de TPE mediante el emulador de TN3270 terminal. Puede encontrarlo en el TNServer ListenPort archivo unikixrc.cfg.
cat $KIXSYS/unikixrc.cfg
-
Configura tu emulador de TN3270 terminal para que utilice la dirección IP de la instancia de UniKix ejecución y el número de puerto 15440.
Transacciones en línea
En esta sección se supone que te has conectado al emulador de TN3270 terminal mediante el kixterm comando.
-
Tras conectarte desde el emulador de TN3270 terminal, pulsa la tecla «Entrar» para borrar la pantalla del TPE e introducir la transacción inicial.
-
En la transacción inicial CC00 (pantalla de inicio de sesión), introduzca el nombre
USER001de usuario yPASSWORDla contraseña.
-
Elija la opción 01 en el Menú principal para ver las cuentas.
-
En la pantalla Ver cuenta, introduce un número de cuenta (por ejemplo, 00000000010). Debería ver la información de la cuenta rellenada a partir de los datos migrados.
-
Pulse la tecla «PF03» dos veces para volver a la pantalla de inicio de sesión y salga del TN3270 terminal pulsando «Ctrl+C» (Windows) o «Cmd+C» (MacBook).
Tareas por lotes
-
Vaya al directorio JCL.
cd $MBMSUB -
Envíe el trabajo
MFCATGL1y observe la salida del registro de trabajos.BPESUB READCARD -
Opcionalmente, podría ver los registros de trabajos desde el directorio
$SUBSYS_OUTDIR.ls -lrt $SUBSYS_OUTDIR/*
Ya ha implementado correctamente la CardDemo aplicación en NTT DATA UniKix Runtime y ha verificado la aplicación en ejecución navegando por algunas pantallas en línea de CICS y realizando trabajos por lotes.
Resolución de problemas
A continuación, se muestran algunos errores comunes que puede encontrar al configurar la aplicación. CardDemo
Error: Licensing error
Si recibe un error de licencia mientras sigue este tutorial, es posible que la licencia IMDSv2esté habilitada en su EC2. Puede resolver este problema modificando la opción de metadatos de la instancia IMDSv2a Opcional, tal y como se menciona en Restore the use of IMDSv1 en la guía del usuario de Amazon EC2.
Error: TPE is not connected to BPE
Si TPE no está conectado a BPE, asegúrese de que la Tabla de configuración de VSAM esté configurada correctamente con el directorio de nodos de BPE. Para acceder a la tabla de configuración de VSAM, inicie el emulador de TN3270 terminal mediante el siguiente comando:
kixterm
-
Introduzca el nombre de la transacción como
CTBL. -
En el menú Administrador de tablas, elija la opción Tablas estándar.
-
En la pantalla Tablas estándar, elija la opción Tabla de configuración de VSAM.
-
Compruebe si la opción ¿Conectarse al nodo por lotes? está establecida en S y el directorio de nodos es correcto.