Analysieren und Generieren von Hostdateien aus IBM-Großrechnern für Standardworkflows in Azure Logic Apps

Gilt für: Azure Logic Apps (Standard)

Um neue IBM-Hostdateien und physische Dateien der i-Serie von Standardworkflows in Azure Logic Apps zu analysieren und zu generieren, können Sie den integrierten, dienstanbieterbasierten Connector von IBM Host File verwenden. Seit der Einführung von Großrechnersystemen nutzten Entwickler überall vorhandene Hostdateien, um umfangreiche Daten für unternehmenskritische Systeme zu speichern. Obwohl dieser Connector keinen Zugriff auf ein IBM-Mainframe- oder Midrange-System erfordert, müssen Sie die Hostdatei einem Standardworkflow zur Verfügung stellen. Sie können die Datei über FTP, Azure Blob Storage, Host Integration Server oder eine Partnersoftware-Appliance verfügbar machen. Der IBM Host File 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 IBM Host File Connectors beschrieben:

• Szenarien für die Verwendung des IBM Host File Connectors in Azure Logic Apps
• Voraussetzungen und Einrichtung für die Verwendung des IBM Host File Connectors
• Schritte zum Hinzufügen der IBM Host File Konnektoraktionen zu Ihrem Standard-Logik-App-Workflow

Überprüfen der Nutzungsszenarien für Konnektoren

Auf IBM-Großrechnern verarbeiten Zugriffsmethoden, die spezielle Komponenten im Betriebssystem sind, die Dateiverarbeitung. In den 1970er Jahren wurde virtual Storage Access Method (VSAM) gebaut und wurde zur am häufigsten verwendeten Zugriffsmethode auf IBM-Großrechnern. VSAM stellt bestimmte Dateitypen bereit, einschließlich eintragssequenzierte Datensätze, schlüssel-sequenzierte Datensätze und relative Datensatz-Dateien.

Der aktuelle Markt bietet mehrere Lösungen, die direkt eine Verbindung mit Hostdateien herstellen und Datenvorgänge ausführen. Viele Lösungen erfordern die Installation von Software auf dem Großrechnersystem. Obwohl diese Option für einige Kunden gut funktioniert, möchten andere den Fußabdruck in ihren Großrechnersystemen vermeiden.

Microsoft Host Integration Server (HIS) stellt einen verwalteten Adapter für Hostdateien bereit und erfordert keine Installation von Software auf dem Mainframe. Das HIS erfordert jedoch, dass Sie das IBM Distributed File Manager (DFM) -Subsystem aktivieren, das das Logical Unit (LU)-Protokoll 6.2 erfordert. Dieser verwaltete Anbieter erfordert außerdem, dass Sie ein HIS System Network Architecture (SNA)-Gateway konfigurieren, das Zugriff auf das DFM ermöglicht.

In den meisten Arten funktioniert der verwaltete Anbieter als normaler Datenanbieter. Sie können eine Verbindung mit einem Hostdateisystem herstellen, Befehle ausführen und Daten abrufen. Obwohl diese Option für einige Kunden eine großartige Alternative ist, erfordert der IBM Host File Connector, dass Sie IBM-Hostdateien im Binärformat für Standardworkflows in Azure Logic Apps verfügbar machen. Diese Anforderung reduziert die Komplexität der Lösung und ermöglicht Ihnen die Verwendung Ihrer Tools für den Zugriff auf und die Verwaltung von Daten in Hostdateien. Nachdem Sie die Hostdatei an einem Ort verfügbar machen, an dem der Standardworkflow einen Trigger zum Lesen der Datei verwenden kann, kann der IBM Host File Connector-Vorgang die Datei analysieren.

Für Kunden, die auf Datenbanken in ihren Großrechnerumgebungen wie SQL Server oder Azure Cosmos DB zugreifen und diese verwenden möchten, bietet der IBM Host File Connector die Möglichkeit, Hostdateien im JSON-Format zu generieren. Mit diesem Ansatz können Sie die Hostdateien in Ihrer gewünschten Clouddatenbank verwenden und die Daten als Hostdatei an Ihre Mainframe- oder Midrange-Umgebungen zurücksenden.

Das folgende Diagramm zeigt, wie der IBM Host File Connector in Azure Logic Apps mit anderen Systemen interagiert, um Hostdateiinhalte zu lesen, zu analysieren und zu generieren:

Um Hybrid-Cloud-Szenarien zu erweitern, arbeitet der IBM Host File Connector mit dem HIS Designer für Logik-Apps zusammen, mit dem Sie eine Datendefinition oder Datenzuordnung der Mainframehostdatei erstellen können. Für diese Aufgabe konvertiert der HIS Designer die Daten in Metadaten, die der IBM Host File Connector zum Ausführen von Aktionen in Ihrem Workflow verwendet. Der Connector führt die Datentypkonvertierungen aus, die zum Empfangen von Eingaben aus vorherigen Workflowvorgängen und zum Senden der Ausgabe für die Verwendung durch nachfolgende Workflowaktionen erforderlich sind. Der Connector stellt auch tabellarische Datendefinition und Codepage-Übersetzung bereit.

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. Mit diesem Ansatz kann Ihr Workflow auf die Metadaten Ihrer App zugreifen, wenn Sie eine IBM Host File Connector-Aktion hinzufügen. Der Connector liest die Metadatendatei aus Ihrer Logik-App-Ressource und stellt die Struktur der Binärdatei dynamisch dar, die mit den IBM Host File Connector-Aktionen in Ihrem Workflow verwendet werden soll.

Technische Referenz für den Connector

In diesem Abschnitt werden die verfügbaren Vorgänge für den IBM Host File Connector beschrieben. Derzeit werden zwei Aktionen unterstützt: Analysieren von Hostdateiinhalten und Generieren von Hostdateiinhalten.

Aktion „Hostdateiinhalte analysieren“

In der folgenden Tabelle sind die Parameter für die Aktion " Hostdateiinhalte analysieren" zusammengefasst:

Aktion „Hostdateiinhalte generieren“

In der folgenden Tabelle sind die Parameter für die Aktion "Hostdateiinhalte generieren " zusammengefasst:

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.

• Die HOST Integration Designer XML (HIDX)-Datei, die die erforderlichen Metadaten für den IBM Host File Connector bereitstellt, um die Hostdateidatenstruktur zu erkennen.

  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 Hostdateien effektiv zu analysieren und zu generieren, muss Ihr Workflow die Metadaten der Hostdatei verstehen. Als wichtiger Unterschied zwischen einer Hostdatei und einer Datenbanktabelle verfügt die Hostdatei jedoch nicht über die Metadaten, die die Datenstruktur beschreiben. Verwenden Sie zum Erstellen dieser Metadaten den HIS-Designer für Logik-Apps. Mit diesem Tool können Sie die von Ihrem Workflow verwendete Hostdateistruktur manuell erstellen. Sie können auch COBOL-Definitionen (Copybooks) importieren, die diese Datenstrukturen bereitstellen.

  Das Tool generiert eine HOST Integration Designer XML (HIDX)-Datei, die die erforderlichen Metadaten für den Connector bereitstellt, um die Hostdateidatenstruktur zu erkennen. Wenn Sie das HIS verwenden, können Sie den HIS Transaction Integrator (TI)-Designer verwenden, um die HIDX-Datei zu erstellen.

• Der Standardlogik-App-Workflow, in dem Sie die Hostdatei analysieren oder generieren möchten.

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

Einschränkungen

Derzeit erfordert dieser Connector, dass Sie Ihre HIDX-Datei direkt in Ihre Standardlogik-App-Ressource hochladen, nicht in 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. Laden Sie im Azure-Portaldie HIDX-Datei als Zuordnung zu Ihrer Standardlogik-App-Ressource hoch.

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

Wenn Sie später in diesem Handbuch die Aktion " Hostdateiinhalte analysieren" zum ersten Mal zu Ihrem Workflow hinzufügen, werden Sie aufgefordert, eine Verbindung zu erstellen. Nachdem Sie die Verbindung erstellt haben, können Sie die zuvor hinzugefügte HIDX-Datei, das Schema und die zu verwendenden Parameter auswählen.

Hinzufügen eines Vorgangs zum Analysieren des Hosts-Dateiinhalts

Führen Sie die folgenden Schritte aus, um eine Aktion zum Analysieren von Hostdateiinhalten hinzuzufügen:

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 den eingebauten, serviceanbieterbasierten Trigger von Azure Blob Storage fort, der den Namen Wenn ein Blob hinzugefügt oder aktualisiert wird trägt:

   

3. Um den Inhalt aus dem hinzugefügten oder aktualisierten Blob abzurufen, fügen Sie die integrierte Azure Blob Storage-Connectoraktion namens "Blob-Inhalt lesen " hinzu, indem Sie die folgenden allgemeinen Schritte ausführen.

4. Fügen Sie die integrierte Connectoraktion "IBM Host File " mit dem Namen "Parse Host File Contents " hinzu, indem Sie die folgenden allgemeinen Schritte ausführen.

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

   Parameter	Erforderlich	Wert	Description
   Verbindungsname	Yes	< Verbindungsname>	Der Name für Ihre Verbindung.
   Codepage	Nein	< Codeseite>	Die Codeseitenzahl, die zum Konvertieren von Text verwendet werden soll.
   Von iSeries	Nein	< mf-iseries>	Geben Sie an, ob die Datei von einem i Series-Server stammt.

   Beispiel:

   

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

7. 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 Mainframe-Hostdatei HIDX aus, die Sie verwenden möchten.
   Schemaname	Yes	< Schemaname>	Wählen Sie das Schema in der HIDX-Datei aus, das Sie verwenden möchten.
   Binäre Inhalte	Yes	< Binärinhalte>	Wählen Sie die Binärdaten mit einem Datensatz mit fester Länge aus, der vom Host extrahiert wurde.

   Die folgende Abbildung zeigt z. B. Visual Studio mit einer Beispielhostdatei (HIDX), die eine CUSTOMER-Tabelle und CUSTOMER_RECORD Schema im HIS Designer für Logik-Apps enthält:

   

   1. Konfigurieren Sie den HIDX-Namen und den Schemanamen mit Werten aus der HIDX-Datei:

      

   2. Wählen Sie zunächst für die binären Inhalte die dynamische Inhaltsliste (Blitzsymbol) und dann die Option Antwort aus der Aktion „Blob-Inhalt lesen“ aus:

      

      Die vollständige Parse Host File Contents-Aktion sieht wie im folgenden Beispiel aus:

      

   3. Fügen Sie nun eine weitere Aktion zum Behandeln des Ergebnisses hinzu:

      In diesem Beispiel wird eine Aktion zum Erstellen einer Datei auf einem FTP-Server (File Transfer Protocol) hinzugefügt, indem Sie die folgenden allgemeinen Schritte ausführen:

      

8. 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 zu bestätigen, dass der Workflow wie erwartet ausgeführt wird:

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

   Nachdem der Workflow abgeschlossen ist, wird der Workflowausführungsverlauf 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.

Hinzufügen einer Aktion zum Generieren von Hostdateiinhalten

Führen Sie die folgenden Schritte aus, um eine Aktion zum Generieren von Hostdateiinhalten hinzuzufügen:

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 den eingebauten, serviceanbieterbasierten Trigger von Azure Blob Storage fort, der den Namen Wenn ein Blob hinzugefügt oder aktualisiert wird trägt:

   

3. Um den Inhalt aus dem hinzugefügten oder aktualisierten Blob abzurufen, fügen Sie die integrierte Azure Blob Storage-Connectoraktion namens "Blob-Inhalt lesen " hinzu, indem Sie die folgenden allgemeinen Schritte ausführen.

4. Fügen Sie die integrierte Connectoraktion "IBM Host File " mit dem Namen "Hostdateiinhalte generieren " hinzu, indem Sie die folgenden allgemeinen Schritte ausführen.

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

   Parameter	Erforderlich	Wert	Description
   Verbindungsname	Yes	< Verbindungsname>	Der Name für Ihre Verbindung.
   Codepage	Nein	< Codeseite>	Die Codeseitenzahl, die zum Konvertieren von Text verwendet werden soll.
   Von iSeries	Nein	< mf-iseries>	Geben Sie an, ob die Datei von einem i Series-Server stammt.

   Beispiel:

   

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

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

   Parameter	Erforderlich	Wert	Description
   HIDX-Name	Yes	< HIDX-Dateiname>	Geben Sie den Namen der Haupt-Hostdatei HIDX an, die Sie verwenden möchten.
   Schemaname	Yes	< Schemaname>	Geben Sie den Namen für das Schema in der HIDX-Datei an, die Sie verwenden möchten.
   Zeilen	Yes	< Reihen>	Stellen Sie ein Array von Datensätzen bereit, die in das IBM-Format konvertiert werden sollen. Führen Sie die folgenden Schritte aus, um die Ausgabe aus einem vorherigen Workflowvorgang auszuwählen: 1. Wählen Sie im Feld Zeilen die Option 'Dynamischer Inhalt' (Blitz) aus. 2. Wählen Sie in der Liste dynamischer Inhalte die Ausgabe aus einer vorherigen Aktion aus. Wählen Sie z. B. im Abschnitt Blob-Inhalt lesen die Option Antwort aus der Aktion „Blob-Inhalt lesen“ aus. Tipp: Um ein gesamtes Datenobjekt im JSON-Format einzugeben, wählen Sie die Option Wechseln zu gesamte Array-Eingabe aus.

   Die folgende Abbildung zeigt z. B. Visual Studio mit einer HIDX-Beispieldatei im HIS Designer für Logik-Apps:

   

   1. Konfigurieren Sie den HIDX-Namen und den Schemanamen mit Werten aus der HIDX-Datei:

      

   2. Wählen Sie zunächst für das Rows>Rows Item - 1-Feld die dynamische Inhaltsliste (Blitzsymbol) und dann die Option Antwort aus der Aktion „Blob-Inhalt lesen“ aus:

      

      Die vollständige Aktion "Hostdateiinhalte generieren " sieht wie im folgenden Beispiel aus:

      

   3. Fügen Sie nun eine weitere Aktion zum Behandeln des Ergebnisses hinzu.

      In diesem Beispiel wird eine Aktion zum Erstellen einer Datei auf einem FTP-Server (File Transfer Protocol) hinzugefügt, indem Sie die folgenden allgemeinen Schritte ausführen:

      

8. 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 zu bestätigen, dass der Workflow wie erwartet ausgeführt wird:

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

   Nachdem der Workflow abgeschlossen ist, wird der Workflowausführungsverlauf 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