Integración de programas COBOL y RPG en sistemas de rango medio de IBM con flujos de trabajo estándar en Azure Logic Apps

Se aplica a: Azure Logic Apps (estándar)

Para acceder y ejecutar programas COBOL y RPG en sistemas de rango medio de IBM desde flujos de trabajo estándar en Azure Logic Apps, puede usar el conector integrado basado en el proveedor de servicios IBM i Program Call . El sistema operativo IBM i proporciona un servidor de llamadas de programa distribuido (DPC). El conector se comunica con el servidor IBM i DPC para ejecutar programas COBOL y RPG mediante TCP/IP. El conector IBM i está disponible en todas las regiones de Azure Logic Apps, excepto Azure Government y Microsoft Azure operado por 21Vianet.

En este artículo se describen los siguientes aspectos sobre el conector IBM i:

• Escenarios para usar el conector ibm i en Azure Logic Apps
• Requisitos previos y configuración para usar el conector IBM i
• Pasos para agregar acciones del conector ibm i al flujo de trabajo de la aplicación lógica estándar

Revisión de los escenarios de uso del conector

Hace más de 50 años, IBM lanzó los primeros sistemas de gama media. IBM los anunció como "Pequeño en tamaño, pequeño en precio y grande en rendimiento. Es un sistema por ahora y para el futuro". A lo largo de los años, los sistemas de gama media evolucionaron y se convirtieron en generalizados en empresas medianas o en grandes empresas para ampliar los entornos del sistema central. Los sistemas de rango medio que ejecutan IBM i, normalmente Power Systems, admiten TCP/IP y SNA.

El sistema IBM i incluye la característica de servidor DPC que permite a la mayoría de las aplicaciones de IBM i interactuar con clientes como Azure Logic Apps mediante el patrón de solicitud-respuesta solo iniciado por el cliente con modificaciones mínimas. DPC es un protocolo documentado que admite la integración de programa a programa en un sistema IBM i, al que las aplicaciones cliente pueden acceder fácilmente mediante el protocolo de red TCP/IP.

Microsoft Host Integration Server (HIS) proporciona conectividad a sistemas IBM i mediante TCP/IP y APPC LU6.2. Durante muchos años, los clientes han usado el integrador de transacciones his para integrar sistemas IBM i locales y Windows. El conector ibm i Program Call utiliza el modelo de programación TCP/IP para interactuar con los programas IBM i COBOL y RPG.

En el diagrama siguiente se muestra cómo interactúa el conector ibm i con un sistema IBM i:

Para ampliar estos escenarios de nube híbrida, el conector IBM i de un flujo de trabajo estándar funciona con HIS Designer para Logic Apps, que puede usar para crear una definición de programa o un mapa de programa del programa COBOL o RPG. Para esta tarea, el Diseñador de HIS usa un modelo de programación que determina las características del intercambio de datos entre el rango medio y el flujo de trabajo. His Designer convierte esa información en metadatos que usa el conector ibm i al ejecutar una acción en el flujo de trabajo.

Después de generar el archivo de metadatos como un archivo XML de Host Integration Designer (HIDX) desde HIS Designer, puede agregar ese archivo como un artefacto de mapa al recurso de aplicación lógica estándar. De este modo, el flujo de trabajo puede acceder a los metadatos de tu aplicación al agregar una acción del conector IBM i. El conector lee el archivo de metadatos del recurso de la aplicación lógica y presenta dinámicamente parámetros para usarlos con el conector IBM i en el flujo de trabajo. A continuación, puede proporcionar parámetros a la aplicación host y el conector devuelve los resultados al flujo de trabajo. Como resultado, puede integrar las aplicaciones heredadas con Azure, Microsoft, otras aplicaciones, servicios y sistemas compatibles con Azure Logic Apps.

Referencia técnica del conector

Actualmente, hay disponible una operación para el conector IBM i: Llamar a un programa IBM i. En la tabla siguiente se resume el uso de esta acción:

Esta operación también incluye parámetros avanzados, que aparecen después de seleccionar un método, para que pueda seleccionar y usar con el método seleccionado. Estos parámetros varían en función del archivo HIDX y del método que seleccione.

Prerrequisitos

• Una cuenta y una suscripción de Azure. Si no tiene una suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure.

• Acceso al servidor de rango medio que hospeda el sistema IBM i.

• El archivo Host Integration Designer XML (HIDX) que proporciona los metadatos necesarios para que el conector IBM i Program Call ejecute el programa de sistema intermedio.

  Para crear este archivo HIDX, descargue e instale HIS Designer para Azure Logic Apps. El único requisito previo es Microsoft .NET Framework 4.8.

  Para invocar un programa de rango medio, el flujo de trabajo debe comprender el tipo, los parámetros y los valores devueltos del programa de rango medio. El conector ibm i administra este proceso y conversiones de datos. Estas conversiones necesarias proporcionan datos de entrada del flujo de trabajo al programa de rango medio y envían los datos de salida generados desde el programa de rango medio al flujo de trabajo. El conector también proporciona la definición de datos tabulares y la traducción de páginas de códigos. Para este proceso, Azure Logic Apps requiere que proporcione esta información como metadatos.

  Para crear estos metadatos, utilice el HIS Designer para Logic Apps. Con esta herramienta, puede crear manualmente los métodos, parámetros y valores devueltos que se usan en el flujo de trabajo. También puede importar definiciones de programas COBOL o RPG (copybooks) que proporcionen esta información.

  La herramienta genera un archivo XML (HIDX) de Host Integration Designer que proporciona los metadatos necesarios para el conector. Si usa HIS, puede usar el Diseñador del Integrador de transacciones (TI) de HIS para crear el archivo HIDX.

• Flujo de trabajo de la aplicación lógica estándar donde desea integrar con el sistema IBM i.

  El conector IBM i no tiene desencadenadores, por lo que use cualquier desencadenador para iniciar el flujo de trabajo, como el desencadenador de periodicidad o el desencadenador de solicitud. A continuación, puede agregar la acción del conector IBM i. Para empezar, cree un flujo de trabajo en blanco en el recurso de aplicación lógica estándar.

Limitaciones

Actualmente, el conector ibm i requiere que cargue el archivo HIDX directamente en el recurso de aplicación lógica estándar, no en una cuenta de integración.

Definición y generación de metadatos

Después de descargar e instalar HIS Designer para Azure Logic Apps, siga estos pasos para generar el archivo HIDX desde el artefacto de metadatos.

Carga del archivo HIDX

Para que el flujo de trabajo use el archivo HIDX, siga estos pasos:

1. Vaya a la carpeta donde guardó el archivo HIDX y copie el archivo.

2. En el portal de Azure, abra el recurso de aplicación lógica estándar.

3. En el menú de la aplicación lógica, en Artefactos, cargue el archivo HIDX como un mapa al recurso de aplicación lógica.

4. Continúe con la sección siguiente para agregar una acción de IBM i al flujo de trabajo.

En esta guía, la primera vez que se agrega una acción del conector IBM i Program Call al flujo de trabajo, se pide que se cree una conexión entre el flujo de trabajo y el sistema intermedio. Después de crear la conexión, puede seleccionar el archivo HIDX agregado anteriormente, el método que se va a ejecutar y los parámetros que se van a usar.

Agregar una acción de IBM i

Siga estos pasos para agregar una acción de IBM i y configurar los parámetros necesarios:

1. En Azure Portal, abre tu recurso de aplicación lógica estándar y el flujo de trabajo en el diseñador.

2. Si no tiene un desencadenador para iniciar el flujo de trabajo, siga estos pasos generales para agregar el desencadenador que desee.

   Este ejemplo continúa con el desencadenador Solicitud denominado Cuando se recibe una solicitud HTTP:

   

3. Para agregar una acción del conector IBM i, siga estos pasos generales para agregar la acción del conector integrado ibm i Program Call denominado Call an IBM i Program.

4. Una vez que aparezca el panel de detalles de conexión, proporcione la siguiente información, como el nombre del servidor host y la información de configuración del sistema IBM i:

   Parámetro	Obligatorio	Importancia	Description
   Nombre de conexión	Sí	< nombre-de-conexión>	El nombre de tu conexión.
   Nombre común del certificado de servidor	No	< nombre-común-del-certificado-del-servidor>	Nombre del certificado de capa de seguridad de transporte (TLS) que se va a usar.
   Página de códigos	No	< página de códigos>	El número de página de códigos a usar para convertir texto.
   Contraseña	No	< contraseña>	Contraseña de usuario opcional para la autenticación de conexión.
   Número de puerto	Sí	< port-number>	Número de puerto que se va a usar para la autenticación de conexión.
   Nombre del servidor	Sí	< nombre del servidor>	Nombre del servidor.
   Tiempo de espera	No	< interrupción>	El tiempo de espera en segundos mientras se espera la respuesta del servidor.
   Nombre de usuario	No	< nombre de usuario>	Nombre de usuario opcional para la autenticación de conexión.
   Uso de TLS	No	Verdadero o falso	Proteja la conexión con la capa de seguridad de transporte (TLS).
   Validar certificado de servidor	No	Verdadero o falso	Valide el certificado del servidor.

   Por ejemplo:

   

5. Cuando haya terminado, seleccione Crear nuevo.

6. Una vez que aparezca el panel de detalles de la acción, en la sección Parámetros , proporcione la información necesaria:

   Parámetro	Obligatorio	Importancia	Description
   Nombre HIDX	Sí	< HIDX-file-name>	Seleccione el archivo IBM i HIDX que desea usar.
   Nombre de método	Sí	< method-name>	Seleccione el método en el archivo HIDX que desea usar.
   Parámetros avanzados	No	Varía	Esta lista aparece después de seleccionar un método para que pueda agregar otros parámetros para usarlos con el método seleccionado. Los parámetros disponibles varían en función del archivo HIDX y del método que seleccione.

   Por ejemplo:

   Selección del archivo y el método HIDX

   

   Selección de parámetros avanzados

   

7. Cuando haya terminado, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).

Prueba del flujo de trabajo

Siga estos pasos para comprobar el flujo de trabajo y confirmar las salidas:

1. Para ejecutar el flujo de trabajo, en la barra de herramientas del diseñador, seleccione Ejecutar>Ejecutar.

   Una vez que el flujo de trabajo termine de ejecutarse, aparecerá el historial de ejecución del flujo de trabajo. Los pasos correctos muestran marcas de verificación, mientras que los pasos incorrectos muestran un signo de exclamación (!).

2. Para revisar las entradas y salidas de cada paso, expanda ese paso.

3. Para revisar las salidas, seleccione Ver salidas sin procesar.

Contenido relacionado

• Comprobación del estado del flujo de trabajo, visualización del historial de ejecución y configuración de alertas en Azure Logic Apps
• Visualización de métricas para el estado y el rendimiento del flujo de trabajo en Azure Logic Apps
• Supervisión y recopilación de datos de diagnóstico para flujos de trabajo en Azure Logic Apps
• Habilitación y visualización de la telemetría mejorada en Application Insights para flujos de trabajo estándar en Azure Logic Apps