Integrieren von IMS-Programmen in IBM Standard frames in Standardworkflows in Azure Logic Apps

Artikel
01/10/2024

Gilt für: Azure Logic Apps (Standard)

Um auf IBM Standard frame-Apps auf IMS-Systemen (Information Management System) über Standardworkflows in Azure Logic Apps zuzugreifen und diese auszuführen, können Sie den integrierten IMS-Programmanruf, anbieterbasierten Connector verwenden. IMS bietet einen Tp-Monitor (Transaction Program) mit einem integrierten Transaction Manager (TM) und hierarchischen Datenbank. Der Connector kommuniziert mit IBM IMS-Transaktionsprogrammen mithilfe von IMS Verbinden, einer IMS TM-Netzwerkkomponente. Diese Komponente bietet eine leistungsstarke Kommunikation für IMS-Systeme zwischen einem oder mehreren TCP/IP-Clients und einem oder mehreren IMS-Systemen. Der IMS-Connector ist in allen Azure Logic Apps-Regionen verfügbar, mit Ausnahme von Azure Government und Microsoft Azure, betrieben von 21Vianet.

In diesem Anleitungshandbuch werden die folgenden Aspekte des IMS-Connectors beschrieben:

Gründe für die Verwendung des IMS-Connectors in Azure Logic Apps
Voraussetzungen und Einrichtung für die Verwendung des IMS-Connectors
Schritte zum Hinzufügen von IMS-Connectoraktionen zum Standardlogik-App-Workflow

Gründe für die Verwendung dieses Connectors

IMS-Systeme waren eines der ersten unternehmenskritischen Systeme, die auf Standard Frames ausgeführt werden. Microsoft Host Integration Server (HIS) bietet Konnektivität zu IMS-Systemen durch die folgenden zwei Modelle: IMS Verbinden und APPC LU6.2. Kunden haben den HIS Transaction Integrator (TI) verwendet, um ihre IMS-Systeme seit vielen Jahren mit Windows lokal zu integrieren. Der IMS-Programmanrufconnector verwendet das IMS-Verbinden-Modell für die Interaktion mit IMS-Transaktionsprogrammen über TCP/IP.

Das folgende Diagramm zeigt, wie der IMS-Connector mit einem IBM Standard framesystem interagiert:

Um diese hybriden Cloudszenarien zu erweitern, funktioniert der IMS-Connector in einem Standardworkflow mit dem HIS Designer für Logik-Apps, mit dem Sie eine Programmdefinition oder Programmzuordnung des Standard frametransaktionsprogramms erstellen können. Für diese Aufgabe konvertiert der HIS-Designer diese Informationen in Metadaten, die der IMS-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 IMS-Connector-Aktion hinzufügen. Der Connector liest die Metadatendatei aus Ihrer Logik-App-Ressource und stellt die Parameter dynamisch dar, die mit dem IMS-Connector in Ihrem Workflow verwendet werden sollen. 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

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

Aufrufen eines IMS-Programms

Parameter	Erforderlich	Art	Beschreibung
HIDX-Name	Ja	String	Wählen Sie die HIDX-Datei IMS aus, die Sie verwenden möchten.
Methodenname	Ja	String	Wählen Sie die Methode in der HIDX-Datei aus, die Sie verwenden möchten.
Erweiterte Parameter	Nein	Varies	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.

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.

Begrenzungen

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

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.
Zugriff auf den Standard frame, der das IMS-System hostet
Die HOST Integration Designer XML (HIDX)-Datei, die die erforderlichen Metadaten für den IMS-Programmaufrufconnector bereitstellt, um Ihr Standard frameprogramm auszuführen.

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 Standard frameprogramm aufzurufen, muss Ihr Workflow den Typ, parameter und Rückgabewerte des Standard Frameprogramms verstehen. Der IMS-Connector verwaltet den Prozess und die Datenkonvertierungen, die zum Bereitstellen von Eingabedaten aus dem Workflow an das Standard frameprogramm und zum Senden von Ausgabedaten aus dem Standard frameprogramm an den Workflow erforderlich sind. Der Connector stellt auch tabellenseitige Datendefinition und Codeseitenü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 können, manuell erstellen. Mit dem Tool können Sie außerdem 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 TI-Designer verwenden, um die HIDX-Datei zu erstellen.
Der Standardlogik-App-Workflow, der für die Integration in das IMS-System verwendet werden soll

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

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:

Wechseln Sie zu dem Ordner, in dem Sie Ihre HIDX-Datei gespeichert haben, und kopieren Sie die Datei.
Laden Sie in der Azure-Portal die HIDX-Datei als Zuordnung zu Ihrer Standardlogik-App-Ressource hoch.
Fügen Sie nun ihrem Workflow eine IMS-Aktion hinzu.

Später in diesem Handbuch werden Sie aufgefordert, eine Verbindung zwischen Ihrem Workflow und dem Standard framesystem zu erstellen, wenn Sie Ihrem Workflow zum ersten Mal eine IMS-Programmanrufaktion hinzufügen. 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 IMS-Aktion

Öffnen Sie im Azure-Portal die Standardlogik-App-Ressource und den Workflow im Designer.
Wenn Sie noch keinen Trigger zum Starten des Workflows hinzugefügt haben, führen Sie die folgenden allgemeinen Schritte aus, um den gewünschten Trigger hinzuzufügen.

In diesem Beispiel wird der Anforderungstrigger mit dem Namen "Wenn eine HTTP-Anforderung empfangen wird" fortgesetzt.
Um eine IMS-Connectoraktion hinzuzufügen, führen Sie die folgenden allgemeinen Schritte aus, um die integrierte IMS-Konnektoraktion namens "ImS-Programm aufrufen" hinzuzufügen.

Geben Sie nach dem Anzeigen des Bereichs "Verbindungsdetails" die folgenden Informationen an:

Parameter	Erforderlich	Wert	BESCHREIBUNG
Verbindungsname	Ja	<connection-name>	Name der Verbindung
Die IMS-System-ID	Ja	<IMS-System-ID>	Der Name des IMS-Systems, in dem das IMS-Verbinden-Modell eingehende Anforderungen leitet
ITOC-Beendigungsname	Nein	<ITOC-Exit-Name>	Der Name für die Beendigungsroutine, die IMS zum Verarbeiten eingehender Anforderungen verwendet
MFS Mod-Name	Nein	<MFS-Mod-Name>	Der Name, der dem Ausgabedeskriptor für ausgehende IMS-Nachrichten zugeordnet ist
Verwenden des HWSO1-Sicherheitsausgangs	Nein	„true“ oder „false“	Der Server verwendet den HWSO1-Sicherheitsausgang.
Allgemeiner Name des Serverzertifikats	Nein	<server-cert-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
Kennwort	Nein	<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	Nein	<Timeout>	Der Timeoutzeitraum in Sekunden, während auf Antworten vom Server gewartet wird
Benutzername	Nein	<Benutzername>	Der optionale Benutzername für die Verbindungsauthentifizierung
Verwenden Sie 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:

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

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

Parameter	Erforderlich	Wert	Beschreibung
HIDX-Name	Ja	<HIDX-file-name>	Wählen Sie die HIDX-Datei IMS aus, die Sie verwenden möchten.
Methodenname	Ja	<method-name>	Wählen Sie die Methode in der HIDX-Datei aus, die Sie verwenden möchten.
Erweiterte Parameter	Nein	Varies	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

Wenn Sie fertig sind, speichern Sie Ihren Workflow. Wählen Sie auf der Designersymbolleiste " Speichern" aus.

Testen Ihres Workflows

Um Ihren Workflow auszuführen, wählen Sie im Menü "Workflow" 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 zeigen Häkchen an, während bei erfolglosen Schritten ein Ausrufezeichen (!) angezeigt werden.
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