Entwerfen von Metadatenartefakten für CICS- oder IMS-Hostanwendungen

In diesem Leitfaden erfahren Sie, wie Sie Metadatenartefakte für CICS- oder IMS-Hostanwendungen entwerfen. Anschließend können Sie diese Metadatenartefakte als HIDX-Dateien (Host Integration Server Definition XML) speichern, um sie mit den integrierten Dienstanbieter-basierten CICS- und IMS-Connectors in Azure Logic Apps zu verwenden.

Voraussetzungen

• Herunterladen und Installieren von Visual Studio. Stellen Sie nach der Installation sicher, dass Sie auch die Workload mit dem Namen Desktopentwicklung mit C++ in Visual Studio installieren. Andernfalls erhalten Sie den Fehler Ausnahme von HRESULT 0x800A007C.

• Laden Sie die HIS-Designer für Azure Logic Apps herunter, und installieren Sie sie. Die einzige Voraussetzung ist Microsoft .NET Framework 4.8.

• Aktivieren Sie die Visual Studio-Unterstützung für den Flatfileprozessor in Azure Logic Apps. Führen Sie diese Aufgabe in folgenden Schritten aus:

  1. Öffnen Sie Visual Studio. Öffnen Sie auf der Symbolleiste das Menü Extras , und wählen Sie Optionen aus.

  2. Erweitern Sie in der Liste Optionen den Eintrag Host Integration Server, und wählen Sie Hostdateien aus.

  3. Wählen Sie auf der Registerkarte Hostumgebungdie Option Unterstützung für Flatfileprozessor und Logik-Apps einschließen aus.

     

Erstellen eines Hostanwendungsprojekts

In Visual Studio können Sie die Projektvorlage Hostanwendung verwenden, um Metadatenartefakte zu erstellen. Sie können diese Artefakte dann mit den integrierten CICS- und IMS-Connectors auf Dienstanbieterbasis in Standardworkflows für Azure Logic Apps verwenden. Führen Sie die folgenden Schritte aus, um ein neues Hostanwendungsprojekt zu erstellen:

1. Wählen Sie in Visual Studio im Menü Datei die Option Neues>Neues Projekt aus.

2. Wählen Sie in der Liste der Projektvorlagen die Option Hostanwendung>Weiter aus.

3. Ändern Sie im Feld Neues Projekt konfigurieren die gewünschten Details, und wählen Sie Erstellen aus.

   

Hinzufügen einer .NET-Clientdefinition

Um die CICS- und IMS-Connectors in Azure Logic Apps zu unterstützen, müssen Sie eine .NET-Clientdefinition hinzufügen.

1. Öffnen Sie in Projektmappen-Explorer das Kontextmenü des neuen Hostanwendungsprojekts, und wählen Sie .NET-Clientdefinition hinzufügen> aus.

2. Wenn das Feld Neues Element hinzufügen angezeigt wird, geben Sie in der Eigenschaft Name einen Namen für die .NET-Clientdefinition an, und wählen Sie Hinzufügen aus.

   Diese Schritte werden mit dem Beispielnamen NetClnt1 fortgesetzt.

3. Geben Sie nach dem Starten des .NET-Clientdefinitions-Assistenten im Feld Bibliothek einen Namen für die Schnittstelle an, die zum Identifizieren der zu erstellenden .NET-Clientbibliothek verwendet werden soll.

   Dieses Beispiel wird mit dem Schnittstellennamen IInterface1 fortgesetzt:

   

4. Klicken Sie auf Weiter, wenn Sie fertig sind.

5. Geben Sie im Feld Remoteumgebung die Remote mainframe- oder midrange-Umgebung und das zu verwendende Programmiermodell an, indem Sie die folgenden Informationen angeben:

   Parameter	Wert oder Aktion
   Hersteller	Microsoft
   Protokoll	Wählen Sie das geeignete Netzwerkprotokoll für den Zugriff auf das Mainframe- oder Midrangesystem aus: - TCP - HTTP - LU 6.2 (für Azure Logic Apps-Connectors nicht unterstützt)
   Zielumgebung	Wählen Sie das Zielsystem aus: - CICS - IMS - System i - System Z - System i Distributed Program Call
   Programmiermodell	Wählen Sie ein Programmiermodell aus.
   Hostsprache	Wählen Sie die verwendete Sprache aus: COBOL oder RPG
   Zulassen von 32K In/Out	Wählen Sie diese Option aus, um die vollständigen 32K des COMMAREA-Datenbereichs zu verwenden, wenn Sie das LINK-Modell verwenden.

6. Wählen Sie Erstellen, wenn Sie fertig sind.

Nachdem Sie den Assistenten abgeschlossen haben, wird die Standard Entwurfsansicht angezeigt, in der Sie Metadatenartefakte manuell erstellen oder importieren können. Fahren Sie für diese Aufgabe mit dem nächsten Abschnitt fort.

Entwerfen eines Metadatenartefakts

In diesem Abschnitt wird gezeigt, wie Sie manuell ein Metadatenartefakt erstellen. Informationen zum Importieren einer Hostdefinition finden Sie unter Importieren von Hostdefinitionen.

In der folgenden Tabelle sind die Komponenten der Standard Entwurfsansicht aufgeführt:

Komponente	Beschreibung
Komponentenknoten	Der Stamm des Metadatenartefakts. Speichert Informationen zur Clientbibliothek und zur Remoteumgebung.
Schnittstellenknoten	Gruppiert alle Methoden in einer Komponente.
Ordner "Datentabellen"	Gruppiert Datentabellen in der Assembly.
Ordner "Strukturen"	Gruppiert Variablen mit freigegebenen Attributen.
Ordner "Unions"	Stellt das Äquivalent von COBOL-Unions dar.

Hinzufügen einer Methode

Für Ihr Metadatenartefakt können Sie eine Methode hinzufügen, um die Geschäftslogik des Mainframeprogramms für Workflows in Azure Logic Apps verfügbar zu machen.

1. Öffnen Sie in der entwurfsansicht Standard das Kontextmenü der neuen Schnittstelle, und wählen Sie Methode hinzufügen aus.

   

2. Öffnen Sie das Kontextmenü der Methode, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften der Methode basierend auf dem Artikel Methodeneigenschaften an.

Hinzufügen eines Parameters oder Rückgabewerts

Nachdem Sie eine Methode hinzugefügt haben, können Sie Parameter und einen Rückgabewert definieren, um Daten zwischen dem Mainframeprogramm und Workflows in Azure Logic Apps zu übergeben und zu empfangen.

1. Öffnen Sie in der entwurfsansicht Standard das Kontextmenü der neuen Methode, und wählen Sie Parameter hinzufügen aus.

   

2. Öffnen Sie das Kontextmenü des Parameters, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften des Parameters basierend auf der folgenden Tabelle an:

   Eigenschaft	Beschreibung oder Wert
   Is Array	Wenn true, müssen Sie die Arraydimensionen festlegen, die Arrays mit bis zu 7 Dimensionen und 16.777.215 Elementen unterstützen. Sie müssen auch Werte für die Arrayeigenschaften Eintrittsanzahl in und Tritt abhängig von eingeben.
   Datentyp	Der .NET-Datentyp des Parameters
   Name	Der Name des Parameters
   Parameterrichtung	Richtung des Methodenparameters: In, In/Out oder Out
   Fehlerbehandlung	Lösen Sie einen Fehler aus, runden oder abschneiden.
   Hostdatentyp	Der COBOL- oder RPG-Datentyp des Parameters
   Genauigkeit	Die Datengenauigkeit des Parameters
   Nachgestellter Füllstoff	Bei Parametern, bei denen die Länge kleiner als das angegebene Maximum ist, müssen Sie die Füllgröße angeben.

   

3. Öffnen Sie das Kontextmenü der neuen Methode, und wählen Sie Rückgabewert hinzufügen aus.

   

4. Öffnen Sie das Kontextmenü des Rückgabewerts, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften des Rückgabewerts basierend auf der folgenden Tabelle an:

   Eigenschaft	Beschreibung oder Wert
   Ist Array	Wenn true, müssen Sie die Arraydimensionen festlegen, die Arrays mit bis zu 7 Dimensionen und 16.777.215 Elementen unterstützen. Sie müssen auch Werte für die Arrayeigenschaften Eintrittsanzahl in und Tritt abhängig von eingeben.
   Rückgabetyp	Der .NET-Datentyp des Rückgabewerts
   Rückgabewert nach	Geben Sie die Position des Rückgabewerts relativ zu den Parametern an.
   Verwenden des TICS-Arbeitsbereichs	Ein boolescher Wert, der angibt, einen Arbeitsbereich mit 256 Byte zu verwenden, der über persistente Verbindungen beibehalten und am Anfang der Daten platziert wird.
   Fehlerbehandlung	Lösen Sie einen Fehler aus, runden oder abschneiden.
   Hostdatentyp	Der COBOL- oder RPG-Datentyp des Rückgabewerts
   Genauigkeit	Die Datengenauigkeit des Parameters
   Nachgestellter Füllstoff	Bei Parametern, bei denen die Länge kleiner als das angegebene Maximum ist, müssen Sie die Füllgröße angeben.

   

Hinzufügen einer Datentabelle

1. Öffnen Sie in der Standard Entwurfsansicht das Kontextmenü DataTables, und wählen Sie DataTable hinzufügen aus.

   

2. Öffnen Sie das Kontextmenü der neuen Datentabelle, und wählen Sie DataTable-Spalte hinzufügen aus. Wiederholen Sie diesen Schritt nach Bedarf.

3. Öffnen Sie das Kontextmenü der neuen Spalte, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften jeder Spalte basierend auf der folgenden Tabelle an:

   Eigenschaft	Beschreibung oder Wert
   Datentyp	Der .NET-Datentyp der Spalte
   Name	Der Name der Spalte
   Fehlerbehandlung	Lösen Sie einen Fehler aus, runden oder abschneiden.
   Hostdatentyp	Der COBOL- oder RPG-Datentyp der Spalte
   Genauigkeit	Die Datengenauigkeit der Spalte
   Nachgestellter Füllstoff	Für Spalten, in denen die Länge kleiner als das angegebene Maximum ist, müssen Sie die Füllgröße angeben.

   

Hinzufügen einer Struktur

1. Öffnen Sie in der Standard Entwurfsansicht das Kontextmenü Strukturen, und wählen Sie Struktur hinzufügen aus.

   

   Der Designer erstellt eine Struktur mit einem Element.

2. Um ein weiteres Element hinzuzufügen, öffnen Sie das Kontextmenü der neuen Struktur, und wählen Sie Strukturelement hinzufügen aus. Wiederholen Sie diesen Schritt nach Bedarf.

3. Öffnen Sie das Kontextmenü des Mitglieds, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften jedes Elements basierend auf der folgenden Tabelle an:

   Eigenschaft	Beschreibung oder Wert
   Ist Array	Wenn true, müssen Sie die Arraydimensionen festlegen, die Arrays mit bis zu 7 Dimensionen und 16.777.215 Elementen unterstützen. Sie müssen auch Werte für die Arrayeigenschaften Eintrittsanzahl in und Tritt abhängig von eingeben.
   Datentyp	Der .NET-Datentyp des Members
   Name	Der Name des Mitglieds
   Fehlerbehandlung	Lösen Sie einen Fehler aus, runden oder abschneiden.
   Hostdatentyp	Der COBOL- oder RPG-Datentyp des Elements
   Genauigkeit	Die Datengenauigkeit des Elements
   Nachgestellter Füllstoff	Für Elemente, bei denen die Länge unter dem angegebenen Maximum liegt, müssen Sie die Füllgröße angeben.

   

Hinzufügen einer Union

1. Öffnen Sie in der Standard Entwurfsansicht das Kontextmenü Unions, und wählen Sie Union hinzufügen aus.

   

   Der Designer erstellt eine Union mit zwei Elementen.

2. Um ein weiteres Mitglied hinzuzufügen, öffnen Sie das Kontextmenü der neuen Union, und wählen Sie Union-Mitglied hinzufügen aus. Wiederholen Sie diesen Schritt nach Bedarf.

3. Öffnen Sie das Kontextmenü des Mitglieds, und wählen Sie Eigenschaften aus. Geben Sie Werte für die Eigenschaften jedes Elements basierend auf der folgenden Tabelle an:

   Eigenschaft	Beschreibung oder Wert
   Ist Array	Wenn true, müssen Sie die Arraydimensionen festlegen, die Arrays mit bis zu 7 Dimensionen und 16.777.215 Elementen unterstützen. Sie müssen auch Werte für die Arrayeigenschaften Eintrittsanzahl in und Tritt abhängig von eingeben.
   Datentyp	Der .NET-Datentyp des Members. Dieser Wert kann Strukturen enthalten, die im vorherigen Abschnitt definiert wurden.
   Name	Der Name des Mitglieds
   Fehlerbehandlung	Lösen Sie einen Fehler aus, runden oder abschneiden.
   Hostdatentyp	Der COBOL- oder RPG-Datentyp des Elements
   Genauigkeit	Die Datengenauigkeit des Elements
   Nachgestellter Füllstoff	Für Elemente, bei denen die Länge unter dem angegebenen Maximum liegt, müssen Sie die Füllgröße angeben.

   

4. Wenn Sie fertig sind, fahren Sie mit dem nächsten Abschnitt fort, um die Bibliothek zu erstellen, in der der Entwurf der Metadaten gespeichert wird.

Erstellen des Host Integration Definition XML (HIDX) oder Metadatenartefakts

In diesem Abschnitt wird beschrieben, wie Sie die Bibliothek erstellen, in der der Entwurf des Metadatenartefakts gespeichert wird.

1. Um das Metadatenartefakt zu generieren, wählen Sie im Menü oder der Symbolleiste von Visual Studio Allespeichern aus. (Tastatur: Drücken Sie STRG+UMSCHALT+S)

   

2. Navigieren Sie zum Ordner Ihrer Hostanwendung, um die generierte HIDX-Datei zu finden.

   

Verwandte Inhalte

• Importieren von Hostdefinitionen