Integration von COBOL- und RPG-Programmen in IBM-Midrange-Systemen mit Standard-Workflows in Azure Logic Apps

Gilt für: Azure Logic Apps (Standard)

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

In diesem Artikel werden die folgenden Aspekte zum IBM i Connector beschrieben:

• Szenarien für die Verwendung des IBM i-Connectors in Azure Logic Apps
• Voraussetzungen und Einrichtung für die Verwendung des IBM i-Connectors
• Schritte zum Hinzufügen von IBM i Connector-Aktionen zum Standardlogik-App-Workflow

Überprüfen der Nutzungsszenarien für Konnektoren

Vor mehr als 50 Jahren veröffentlichte IBM die ersten Midrange-Systeme. IBM werbete sie als "Klein in Größe, klein im Preis und Big in Performance. Es ist ein System für jetzt und für die Zukunft." Im Laufe der Jahre entwickelten sich die Midrange-Systeme und wurden in mittelständischen Unternehmen oder in großen Unternehmen zum Erweitern von Mainframeumgebungen durchdringend. Midrange-Systeme, die IBM i ausführen, in der Regel Power Systems, unterstützen TCP/IP und SNA.

Das IBM i-System enthält das DPC-Serverfeature, mit dem die meisten IBM i-Anwendungen mit Clients wie Azure Logic Apps interagieren können, indem das nur vom Client initiierte Anforderungsantwortmuster mit minimalen Änderungen verwendet wird. DPC ist ein dokumentiertes Protokoll, das die Programm-zu-Programm-Integration in einem IBM i-System unterstützt, auf das Clientanwendungen problemlos über das TCP/IP-Netzwerkprotokoll zugreifen können.

Microsoft Host Integration Server (HIS) bietet Konnektivität zu IBM i-Systemen mithilfe von TCP/IP und APPC LU6.2. Seit vielen Jahren nutzen Kunden den HIS Transaction Integrator, um lokale IBM i-Systeme und Windows zu integrieren. Der IBM i Program Call Connector 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:

Um diese Hybrid-Cloudszenarien zu erweitern, arbeitet der IBM i Connector in einem Standard-Workflow mit dem HIS Designer für Logik-Apps zusammen, mit dem Sie eine Programmdefinition oder Programmzuordnung des COBOL- oder RPG-Programms erstellen können. Für diese Aufgabe verwendet der HIS Designer ein Programmiermodell , das die Merkmale des Datenaustauschs zwischen der Midrange 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 als HOST Integration Designer-XML-Datei (HIDX) aus dem HIS-Designer generiert haben, können Sie diese Datei als Zuordnungsartefakt zu Ihrer Standardlogik-App-Ressource hinzufügen. Auf diese Weise kann Ihr Workflow auf die Metadaten Ihrer App zugreifen, wenn Sie eine IBM i Connector-Aktion hinzufügen. Der Connector liest die Metadatendatei aus Ihrer Logik-App-Ressource und stellt Parameter für die Verwendung mit dem IBM i-Connector in Ihrem Workflow dynamisch dar. Sie können dann Parameter für die Hostanwendung bereitstellen, und der Connector gibt die Ergebnisse an Ihren Workflow zurück. Daher können Sie Ihre älteren Apps in Azure, Microsoft, andere Apps, Dienste und Systeme integrieren, die Von Azure Logic Apps unterstützt werden.

Technische Referenz für den Connector

Derzeit steht für den IBM i Connector eine Operation zur Verfügung: Rufen Sie ein IBM i-Programm auf. In der folgenden Tabelle wird die Verwendung für diese Aktion zusammengefasst:

Dieser Vorgang enthält auch erweiterte Parameter, die nach der Auswahl einer Methode angezeigt werden, damit Sie die ausgewählte Methode auswählen und verwenden können. Diese Parameter variieren je nach HIDX-Datei und der ausgewählten Methode.

Voraussetzungen

• Ein Azure Konto und ein Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Zugriff auf den Midrange-Server, auf dem das IBM i-System gehostet wird.

• Die HOST Integration Designer XML (HIDX)-Datei, die die erforderlichen Metadaten für den IBM i Program Call Connector zum Ausführen Ihres Midrange-Programms bereitstellt.

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

  Um ein Midrange-Programm aufzurufen, muss Ihr Workflow den Typ, parameter und Rückgabewerte des Midrange-Programms verstehen. Der IBM i Connector verwaltet diesen Prozess und Datenkonvertierungen. Diese erforderlichen Konvertierungen stellen Eingabedaten vom Workflow in das Midrange-Programm bereit und senden alle Ausgabedaten, die aus dem Midrange-Programm generiert werden, an den Workflow. Der Connector stellt auch tabellarische Datendefinition und Codepage-Übersetzung bereit. 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 HOST Integration Designer XML -Datei (HIDX), die die erforderlichen Metadaten für den Connector bereitstellt. Wenn Sie HIS verwenden, können Sie den HIS Transaction Integrator (TI)-Designer verwenden, um die HIDX-Datei zu erstellen.

• Der Standardlogik-App-Workflow, bei dem Sie sich mit dem IBM i-System integrieren möchten.

  Der IBM i Connector verfügt nicht über Trigger. Verwenden Sie daher einen Trigger, um Ihren Workflow zu starten, z. B. den Serientrigger oder den Anforderungstrigger . Anschließend können Sie die IBM i Connector-Aktion hinzufügen. Erstellen Sie zunächst einen leeren Workflow in Ihrer Standardlogik-App-Ressource.

Einschränkungen

Derzeit erfordert der IBM i Connector, dass Sie Ihre HIDX-Datei direkt in Ihre Standardlogik-App-Ressource hochladen, nicht auf ein Integrationskonto.

Definieren und Generieren von Metadaten

Nachdem Sie den HIS Designer für Azure Logic Apps heruntergeladen und installiert haben, führen Sie die folgenden Schritte aus, um die HIDX-Datei aus dem Metadatenartefakt zu generieren.

Hochladen der HIDX-Datei

Führen Sie die folgenden Schritte aus, um den Workflow für die Verwendung der HIDX-Datei zu verwenden:

1. Wechseln Sie zu dem Ordner, in dem Sie Ihre HIDX-Datei gespeichert haben, und kopieren Sie die Datei.

2. Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.

3. Laden Sie im Menü der Logik-App unter Artefaktedie HIDX-Datei als Zuordnung zur Logik-App-Ressource hoch.

4. Fahren Sie mit dem nächsten Abschnitt fort, um Ihrem Workflow eine IBM i-Aktion hinzuzufügen.

Später in diesem Leitfaden, wenn Sie Ihrem Workflow zum ersten Mal eine IBM i Program Call Connector-Aktion hinzufügen, werden Sie aufgefordert, eine Verbindung zwischen Ihrem Workflow und dem Midrange-System herzustellen. Nachdem Sie die Verbindung erstellt haben, können Sie die zuvor hinzugefügte HIDX-Datei, die auszuführende Methode und die zu verwendenden Parameter auswählen.

Hinzufügen einer IBM i-Aktion

Führen Sie die folgenden Schritte aus, um eine IBM i-Aktion hinzuzufügen und die erforderlichen Parameter zu konfigurieren:

1. Öffnen Sie im Azure-Portal Ihre Standard-Logik-App und deren Workflow im Workflow-Designer.

2. Wenn Sie keinen Trigger zum Starten des Workflows haben, führen Sie die folgenden allgemeinen Schritte aus, um den gewünschten Trigger hinzuzufügen.

   Dieses Beispiel setzt sich mit dem Request-Trigger fort, der den Namen Wenn eine HTTP-Anforderung empfangen wird trägt.

   

3. Um eine IBM i Connector-Aktion hinzuzufügen, führen Sie die folgenden allgemeinen Schritte aus, um die integrierte Ibm i Program Call-Connectoraktion namens "Call an IBM i Program" hinzuzufügen.

4. Geben Sie nach dem Anzeigen des Bereichs "Verbindungsdetails" die folgenden Informationen an, z. B. den Hostnamen und die IBM i-Systemkonfigurationsinformationen:

   Parameter	Erforderlich	Wert	Description
   Verbindungsname	Yes	< Verbindungsname>	Der Name für Ihre Verbindung.
   Allgemeiner Name des Serverzertifikats	Nein	< Server-Zertifikats-Common-Name>	Der Name des zu verwendenden TLS-Zertifikats (Transport Security Layer).
   Codepage	Nein	< Codeseite>	Die Codeseitenzahl, die zum Konvertieren von Text verwendet werden soll.
   Passwort	Nein	< Passwort>	Das optionale Benutzerkennwort für die Verbindungsauthentifizierung.
   Portnummer	Yes	< Portnummer>	Die für die Verbindungsauthentifizierung zu verwendende Portnummer.
   Servername	Yes	< Servername>	Der Servername.
   Timeout	Nein	< Zeitüberschreitung>	Der Timeoutzeitraum in Sekunden, während auf Antworten vom Server gewartet wird.
   Benutzername	Nein	< Benutzername>	Der optionale Benutzername für die Verbindungsauthentifizierung.
   Verwenden von TLS	Nein	„true“ oder „false“	Sichern Sie die Verbindung mit Transport Security Layer (TLS).
   Überprüfen des Serverzertifikats	Nein	„true“ oder „false“	Überprüfen Sie das Zertifikat des Servers.

   Beispiel:

   

5. Wenn Sie fertig sind, wählen Sie "Neu erstellen" aus.

6. Geben Sie nach dem Anzeigen des Aktionsdetailsbereichs im Abschnitt "Parameter " die erforderlichen Informationen an:

   Parameter	Erforderlich	Wert	Description
   HIDX-Name	Yes	< HIDX-Dateiname>	Wählen Sie die IBM i HIDX-Datei aus, die Sie verwenden möchten.
   Methodenname	Yes	< Methodenname>	Wählen Sie die Methode in der HIDX-Datei aus, die Sie verwenden möchten.
   Erweiterte Parameter	Nein	Variiert	Diese Liste wird angezeigt, nachdem Sie eine Methode ausgewählt haben, damit Sie andere Parameter hinzufügen können, die mit der ausgewählten Methode verwendet werden sollen. Die verfügbaren Parameter variieren je nach HIDX-Datei und der ausgewählten Methode.

   Beispiel:

   HiDX-Datei und -Methode auswählen

   

   Auswählen erweiterter Parameter

   

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

Testen Ihres Workflows

Führen Sie die folgenden Schritte aus, um Den Workflow zu überprüfen und die Ausgaben zu bestätigen:

1. Um Ihren Workflow auszuführen, wählen Sie auf der Designersymbolleiste "Ausführen"> aus.

   Nachdem der Workflow abgeschlossen ist, wird der Ausführungsverlauf des Workflows angezeigt. Erfolgreiche Schritte zeigen Häkchen an, während bei erfolglosen Schritten ein Ausrufezeichen (!) angezeigt werden.

2. Um die Eingaben und Ausgaben für jeden Schritt zu überprüfen, erweitern Sie diesen Schritt.

3. Um die Ausgaben zu überprüfen, wählen Sie " Unformatierte Ausgaben anzeigen" aus.

Verwandte Inhalte

• Überprüfen des Workflowstatus, Anzeigen des Ausführungsverlaufs und Einrichten von Warnungen in Azure Logic Apps
• Anzeigen von Metriken für Workflowintegrität und -leistung in Azure Logic Apps
• Überwachen und Sammeln von Diagnosedaten für Workflows in Azure Logic Apps
• Aktivieren und Anzeigen erweiterter Telemetrie in Application Insights für Standard Workflows in Azure Logic Apps