Integrieren von COBOL- und RPG-Programmen auf IBM-Midrange-Systemen mit Standardworkflows in Azure Logic Apps

Artikel
03/15/2024

Gilt für: Azure Logic Apps (Standard)

Um über Standardworkflows in Azure Logic Apps auf COBOL- und RPG-Programme auf IBM-Midrange-Systemen zuzugreifen und sie auszuführen, können Sie den integrierten, dienstanbieterbasierten Connector IBM i-Programmaufruf verwenden. Das IBM i-Betriebssystem stellt einen DPC-Server (Distributed Program Calls; verteilte Programmaufrufe) bereit. Der Connector kommuniziert mit dem IBM i-DPC-Server per TCP/IP, um COBOL- und RPG-Programme auszuführen. Der IBM i-Connector ist in allen Azure Logic Apps-Regionen verfügbar. Einzige Ausnahmen sind „Azure Government“ und „Microsoft Azure, betrieben von 21Vianet“.

In dieser Schrittanleitung werden die folgenden Aspekte des IBM i-Connectors beschrieben:

Gründe für die Verwendung des IBM i-Connectors in Azure Logic Apps
Voraussetzungen und Setup für die Verwendung des IBM i-Connectors
Schritte zum Hinzufügen von IBM i Connectoraktionen zu Ihrem Standard-Logik-App-Workflow

Gründe für die Verwendung dieses Connectors

Vor über 50 Jahren hat IBM die ersten Midrange-Systeme veröffentlicht. IBM hat sie als kompakt, preisgünstig und leistungsstark beworben – ein System für jetzt und für die Zukunft. Im Laufe der Jahre wurden die Midrange-Systeme weiterentwickelt und in vielen mittelgroßen Unternehmen oder großen Konzernen zur Erweiterung von Mainframeumgebungen eingesetzt. Midrange-Systeme mit IBM i (in der Regel Power Systems) unterstützen TCP/IP und SNA.

Das IBM i-System enthält unter anderem das DPC-Serverfeature, das es den meisten IBM i-Anwendungen ermöglicht, mit minimalen Anpassungen über das clientseitig initiierte Anforderung-Antwort-Muster mit Clients wie Azure Logic Apps zu interagieren. DPC ist ein dokumentiertes Protokoll, das die Programm-zu-Programm-Integration in einem IBM i-System unterstützt – mit problemlosem Zugriff über das TCP/IP-Netzwerkprotokoll durch Clientanwendungen.

Microsoft Host Integration Server (HIS) bietet Konnektivität mit IBM i-Systemen über TCP/IP und APPC LU6.2. Seit vielen Jahren nutzen Kunden den HIS Transaction Integrator (TI), um IBM i-Systeme und Windows lokal zu integrieren. Der Connector IBM i-Programmaufruf verwendet das TCP/IP-Programmiermodell für die Interaktion mit IBM i-COBOL- und -RPG-Programmen.

Das folgende Diagramm zeigt, wie der IBM i-Connector mit einem IBM i-System interagiert:

Zur Erweiterung dieser Hybrid Cloud-Szenarien kann der IBM i-Connector in einem Standardworkflow mit dem HIS-Designer für Logic Apps verwendet werden. Dieser ermöglicht die Erstellung einer Programmdefinition oder Programmzuordnung des COBOL- oder RPG-Programms. Für diese Aufgabe verwendet der HIS-Designer ein Programmiermodell, das die Merkmale des Datenaustauschs zwischen dem Midrange-System und dem Workflow bestimmt. Der HIS-Designer konvertiert diese Informationen in Metadaten, die der IBM i-Connector beim Ausführen einer Aktion in Ihrem Workflow verwendet.

Nachdem Sie die Metadatendatei über den HIS-Designer als HIDX-Datei (Host Integration Designer XML) generiert haben, können Sie sie Ihrer Standard-Logik-App-Ressource als Zuordnungsartefakt hinzufügen. Dadurch kann Ihr Workflow auf die Metadaten Ihrer App zugreifen, wenn Sie eine IBM i-Connectoraktion hinzufügen. Der Connector liest die Metadatendatei aus Ihrer Logik-App-Ressource und präsentiert in Ihrem Workflow dynamisch Parameter für die Verwendung mit dem IBM i-Connector. Sie können dann Parameter für die Hostanwendung bereitstellen, und der Connector gibt die Ergebnisse an Ihren Workflow zurück. So können Sie Ihre Legacy-Apps in Azure, Microsoft, andere Apps, Dienste und Systeme integrieren, die von Azure Logic Apps unterstützt werden.

Technische Referenz für den Connector

Im folgenden Abschnitt werden die Vorgänge für den IBM i-Connector beschrieben, der derzeit nur die folgende Aktion enthält:

Aufrufen eines IBM i-Programms

Parameter	Erforderlich	Type	Beschreibung
HIDX-Name	Ja	String	Wählen Sie die zu verwendende IBM i-HIDX-Datei aus.
Methodenname	Ja	String	Wählen Sie die Methode in der HIDX-Datei aus, die Sie verwenden möchten.
Erweiterte Parameter	No	Varies	Diese Liste wird angezeigt, nachdem Sie eine Methode ausgewählt haben, damit Sie weitere Parameter hinzufügen können, die mit der ausgewählten Methode verwendet werden sollen. Die verfügbaren Parameter variieren je nach HIDX-Datei und ausgewählter Methode.

Dieser Vorgang umfasst auch erweiterte Parameter. Diese werden nach der Wahl einer Methode angezeigt, damit Sie sie auswählen und mit der gewählten Methode verwenden können. Diese Parameter variieren je nach HIDX-Datei und ausgewählter Methode.

Begrenzungen

Derzeit erfordert dieser Connector, dass Sie Ihre HIDX-Datei direkt in Ihre Standard-Logik-App-Ressource (und nicht in ein Integrationskonto) hochladen.

Voraussetzungen

Ein Azure-Konto und ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.
Zugreifen auf das Midrange-System, das das IBM i-System hostet
Die HIDX-Datei (Host Integration Designer XML), die die notwendigen Metadaten für den Connector IBM i-Programmaufruf bereitstellt, damit Ihr Midrange-Programm ausgeführt werden kann.

Um diese HIDX-Datei zu erstellen, müssen Sie den HIS-Designer für Azure Logic Apps herunterladen und installieren. Die einzige Voraussetzung ist Microsoft .NET Framework 4.8.

Um ein Midrange-Programm aufrufen zu können, muss Ihr Workflow mit dem Typ, den Parametern und den Rückgabewerten des Midrange-Programms vertraut sein. Der IBM i-Connector verwaltet diesen Prozess sowie Datenkonvertierungen, die erforderlich sind, um Eingabedaten aus dem Workflow für das Midrange-Programm bereitzustellen und ggf. vom Midrange-Programm generierte Ausgabedaten an den Workflow zu senden. Weitere Funktionen des Connectors sind die Definition von Tabellendaten sowie die Übersetzung von Codepages. Für diesen Prozess erfordert Azure Logic Apps, dass Sie diese Informationen als Metadaten bereitstellen.

Verwenden Sie zum Erstellen dieser Metadaten den HIS-Designer für Logik-Apps. Mit diesem Tool können Sie die Methoden, Parameter und Rückgabewerte, die Sie in Ihrem Workflow verwenden, manuell erstellen. Sie können auch COBOL- oder RPG-Programmdefinitionen (Copybooks) importieren, die diese Informationen bereitstellen.

Das Tool generiert eine HIDX-Datei (Host Integration Designer XML), die die notwendigen Metadaten für den Connector bereitstellt. Bei Verwendung von HIS können Sie den TI-Designer verwenden, um die HIDX-Datei zu erstellen.
Der Standard-Logik-App-Workflow, in dem Sie in das IBM i-System integrieren möchten

Der IBM i-Connector verfügt über keine Trigger. Verwenden Sie daher einen beliebigen Trigger, um Ihren Workflow zu starten (z. B. Serie oder Anforderung). Anschließend können Sie die IBM i-Connectoraktion hinzufügen. Erstellen Sie zunächst einen leeren Workflow in Ihrer Standard-Logik-App-Ressource.

Definieren und Generieren von Metadaten

Nachdem Sie den HIS-Designer für Azure Logic Apps heruntergeladen und installiert haben, führen Sie diese Schritte aus, um die HIDX-Datei auf der Grundlage des Metadatenartefakts zu generieren.

Hochladen der HIDX-Datei

Führen Sie die folgenden Schritte aus, damit Ihr Workflow die HIDX-Datei verwendet:

Navigieren Sie zu dem Ordner, in dem Sie Ihre HIDX-Datei gespeichert haben, und kopieren Sie die Datei.
Anschließend können Sie im Azure-Portal die HIDX-Datei als Zuordnung zu Ihrer Standard-Logik-App-Ressource hochladen.
Fügen Sie Ihrem Workflow eine IBM i-Aktion hinzu.

Wenn Sie später in diesem Leitfaden Ihrem Workflow erstmals eine Aktion des Connectors IBM i-Programmaufruf hinzufügen, werden Sie aufgefordert, eine Verbindung zwischen Ihrem Workflow und dem Midrange-System zu erstellen. Nachdem Sie die Verbindung erstellt haben, können Sie Ihre zuvor hinzugefügte HIDX-Datei, die auszuführende Methode und die zu verwendenden Parameter auswählen.

Hinzufügen einer IBM i-Aktion

Öffnen Sie im Azure-Portal Ihre Standard-Logik-App und deren Workflow im Workflow-Designer.
Falls Sie noch keinen Trigger zum Starten des Workflows hinzugefügt haben, führen Sie diese allgemeinen Schritte aus, um den gewünschten Trigger hinzuzufügen.

In diesem Beispiel wird der Trigger Anforderung namens Beim Empfang einer HTTP-Anforderung verwendet.
Führen Sie zum Hinzufügen einer IBM i-Connectoraktion diese allgemeinen Schritte aus, um die Aktion IBM i-Programm aufrufen des integrierten Connectors IBM i-Programmaufruf hinzuzufügen.

Wenn der Bereich mit den Verbindungsdetails angezeigt wird, geben Sie die folgenden Informationen an (z. B. den Hostservernamen und die Konfigurationsinformationen des IBM i-Systems):

Parameter	Erforderlich	Wert	BESCHREIBUNG
Verbindungsname	Ja	<connection-name>	Name der Verbindung
Allgemeiner Name des Serverzertifikats	No	<Allgemeiner Name des Serverzertifikats>	Der Name des zu verwendenden TLS-Zertifikats (Transport Security Layer)
Codepage	No	<Codepage>	Die Codepagenummer, die zum Konvertieren von Text verwendet werden soll
Kennwort	No	<Kennwort>	Das optionale Benutzerkennwort für die Verbindungsauthentifizierung
Portnummer	Ja	<Portnummer>	Die für die Verbindungsauthentifizierung zu verwendende Portnummer
Servername	Ja	<server-name>	Der Servername
Timeout	No	<timeout>	Das Timeout in Sekunden beim Warten auf Antworten vom Server
Benutzername	No	<Benutzername>	Der optionale Benutzername für die Verbindungsauthentifizierung
Verwenden Sie TLS	No	„true“ oder „false“	Steuert, ob die Verbindung mit Transport Security Layer (TLS) geschützt wird.
Serverzertifikat überprüfen	No	„true“ oder „false“	Steuert, ob das Serverzertifikat überprüft wird.

Zum Beispiel:

Wählen Sie abschließend Neues Element erstellen aus.

Wenn der Detailbereich der Aktion angezeigt wird, geben Sie im Abschnitt Parameter die erforderlichen Informationen an:

Parameter	Erforderlich	Wert	Beschreibung
HIDX-Name	Ja	<HIDX-file-name>	Wählen Sie die zu verwendende IBM i-HIDX-Datei aus.
Methodenname	Ja	<method-name>	Wählen Sie die Methode in der HIDX-Datei aus, die Sie verwenden möchten.
Erweiterte Parameter	No	Varies	Diese Liste wird angezeigt, nachdem Sie eine Methode ausgewählt haben, damit Sie weitere Parameter hinzufügen können, die mit der ausgewählten Methode verwendet werden sollen. Die verfügbaren Parameter variieren je nach HIDX-Datei und ausgewählter Methode.

Zum Beispiel:

Auswählen der HIDX-Datei und der Methode

Screenshot der IBM i-Aktion mit ausgewählter HIDX-Datei und -Methode.

Auswählen erweiterter Parameter

Wenn Sie fertig sind, speichern Sie Ihren Workflow. Wählen Sie auf der Symbolleiste des Designers die Option Speichern aus.

Testen Ihres Workflows

Um Ihren Workflow auszuführen, wählen Sie im Workflowmenü die Option Übersicht aus. Wählen Sie auf der Symbolleiste Übersicht die Option Ausführen>Ausführen aus.

Nach Abschluss der Ausführung des Workflows wird der Ausführungsverlauf des Workflows angezeigt. Erfolgreiche Schritte sind mit einem Häkchen versehen, während nicht erfolgreiche Schritte mit einem Ausrufezeichen (!) gekennzeichnet sind.
Um die Eingaben und Ausgaben für jeden einzelnen Schritt anzuzeigen, erweitern Sie den jeweiligen Schritt.
Um die Ausgaben zu überprüfen, wählen Sie Unformatierte Ausgaben anzeigen aus.

Freigeben über