Hostbestanden parseren en genereren van IBM mainframes voor Standard-werkstromen in Azure Logic Apps
Van toepassing op: Azure Logic Apps (Standard)
Als u nieuwe IBM-hostbestanden en fysieke i Series-bestanden wilt parseren en genereren op basis van Standard-werkstromen in Azure Logic Apps, kunt u de ingebouwde, op serviceproviders gebaseerde connector van IBM Host File gebruiken. Sinds de introductie van mainframesystemen worden alomtegenwoordige hostbestanden gebruikt voor het opslaan van overvloedige gegevens voor essentiële systemen. Hoewel voor deze connector geen toegang tot een IBM-mainframe of midrangesysteem is vereist, moet u het hostbestand beschikbaar maken voor een standaardwerkstroom met behulp van andere mechanismen zoals FTP, blobopslag, Host Integration Server of een partnersoftwareapparaat. De IBM Host File-connector is beschikbaar in alle Azure Logic Apps-regio's, met uitzondering van Azure Government en Microsoft Azure beheerd door 21Vianet.
In deze instructiegids worden de volgende aspecten van de IBM Host File-connector beschreven:
Waarom de IBM Host File-connector gebruiken in Azure Logic Apps
Vereisten en installatie voor het gebruik van de IBM Host File-connector
Stappen voor het toevoegen van de acties van de IBM Host File-connector aan uw standaardwerkstroom voor logische apps
Waarom deze connector gebruiken?
Op IBM mainframes verwerken toegangsmethoden, die speciale onderdelen in het besturingssysteem zijn, bestandsverwerking. In de jaren 1970 werd Virtual Storage Access Method (VSAM) gebouwd en werd het de meest gebruikte toegangsmethode op IBM mainframes. VSAM biedt de volgende typen bestanden: ingegeven gegevenssets, sleutelreeksgegevenssets en relatieve recordgegevenssets.
Tegenwoordig heeft de markt meerdere oplossingen die rechtstreeks verbinding maken met hostbestanden en gegevensbewerkingen uitvoeren. Voor veel oplossingen moet u software installeren op het mainframe-systeem. Hoewel deze optie goed werkt voor sommige klanten, willen anderen voorkomen dat de footprint in hun mainframesystemen groeit.
Microsoft Host Integration Server (HIS) biedt een beheerde adapter voor hostbestanden en vereist geen software op het mainframe. HIS vereist echter dat u het mainframesubsysteem IBM Distributed File Manager (DFM) inschakelt. Hiervoor is LU 6.2 vereist. Voor deze beheerde provider moet u ook een SNA-gateway (HIS System Network Architecture) configureren die toegang biedt tot de DFM.
Op de meeste manieren werkt de beheerde provider als een normale gegevensprovider. U kunt verbinding maken met een hostbestandssysteem, opdrachten uitvoeren en gegevens ophalen. Hoewel een goed alternatief voor sommige klanten, vereist de IBM Host File-connector dat u IBM-hostbestanden beschikbaar maakt in binaire indeling voor Standard-werkstromen in Azure Logic Apps. Deze vereiste vermindert de complexiteit van deze oplossing en stelt u in staat uw keuze aan hulpprogramma's te gebruiken voor toegang tot en beheer van gegevens in hostbestanden. Nadat u het hostbestand beschikbaar hebt gesteld op een plaats waar de Standaardwerkstroom een trigger kan gebruiken om het bestand te lezen, kan de bewerking van de IBM Host File Connector dat bestand parseren.
Voor klanten die geïnteresseerd zijn in het openen en gebruiken van databases, zoals SQL Server of Cosmos DB, biedt de IBM Host File-connector de mogelijkheid om hostbestanden te genereren in JSON-indeling. Op die manier kunt u deze hostbestanden naar keuze gebruiken in uw clouddatabase en de gegevens terugsturen als een hostbestand naar uw mainframe of midrange-omgevingen.
In het volgende diagram ziet u hoe de IBM Host File-connector in Azure Logic Apps communiceert met andere systemen:
Voor het uitbreiden van hybride cloudscenario's werkt de IBM Host File-connector met de HIS Designer voor Logic Apps, die u kunt gebruiken om een gegevensdefinitie of gegevenstoewijzing van het mainframe-hostbestand te maken. Voor deze taak converteert de HIS Designer die gegevens naar metagegevens die de IBM Host File-connector gebruikt bij het uitvoeren van een actie in uw werkstroom. De connector voert de conversies van het gegevenstype uit, die nodig zijn om invoer te ontvangen van voorgaande werkstroombewerkingen en om uitvoer te verzenden voor gebruik door volgende werkstroomacties. De connector biedt ook tabellaire gegevensdefinitie en codepaginavertaling.
Nadat u het metagegevensbestand hebt gegenereerd als een HIDX-bestand (Host Integration Designer XML) van de HIS Designer, kunt u dat bestand toevoegen als een toewijzingsartefact aan de resource van uw standaard logische app. Op die manier heeft uw werkstroom toegang tot de metagegevens van uw app wanneer u een actie voor ibm-hostbestandsconnector toevoegt. De connector leest het metagegevensbestand uit uw logische app-resource en geeft dynamisch de structuur van het binaire bestand weer voor gebruik met de acties van de IBM Host File-connector in uw werkstroom.
Verbinding maken of technische naslaginformatie
In de volgende sectie worden de bewerkingen voor de IBM Host File-connector beschreven, die momenteel alleen de volgende acties bevat:
Actie Hostbestandsinhoud parseren
| Parameter | Vereist | Type | Omschrijving |
|---|---|---|---|
| HIDX-naam | Ja | String | Selecteer het HIDX-bestand van de mainframe-host dat u wilt gebruiken. |
| Schemanaam | Ja | String | Selecteer het hostbestandsschema in het HIDX-bestand dat u wilt gebruiken. |
| Binaire inhoud | Ja | Binary | Selecteer de binaire gegevens met een record met een vaste lengte die is geëxtraheerd uit het mainframe. |
Actie Inhoud van hostbestand genereren
| Parameter | Vereist | Type | Omschrijving |
|---|---|---|---|
| HIDX-naam | Ja | String | Selecteer het HIDX-bestand van de mainframe-host dat u wilt gebruiken. |
| Schemanaam | Ja | String | Selecteer het hostbestandsschema in het HIDX-bestand dat u wilt gebruiken. |
| Rijen | Ja | JSON | Selecteer de matrix of afzonderlijke rijen. Als u een volledig gegevensobject in JSON-indeling wilt invoeren, kunt u de optie Overschakelen selecteren om de hele matrixoptie in te voeren. |
Beperkingen
Op dit moment moet u voor deze connector uw HIDX-bestand rechtstreeks uploaden naar uw resource voor de logische standaard-app, niet naar een integratieaccount.
Vereisten
Een Azure-account en -abonnement. Als u nog geen abonnement op Azure hebt, registreer u dan nu voor een gratis Azure-account.
Het HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens biedt voor de IBM Host File-connector om de structuur van de hostbestandsgegevens te herkennen.
Als u dit HIDX-bestand wilt maken, downloadt en installeert u de HIS Designer voor Azure Logic Apps. De enige vereiste is Microsoft .NET Framework 4.8.
Als u hostbestanden effectief wilt parseren en genereren, moet uw werkstroom inzicht hebben in de metagegevens van het hostbestand. Als belangrijk verschil tussen een hostbestand en een databasetabel beschikt het hostbestand echter niet over de metagegevens die de gegevensstructuur beschrijven. Gebruik de HIS Designer voor Logic Apps om deze metagegevens te maken. Met dit hulpprogramma kunt u handmatig de hostbestandsstructuur maken die door uw werkstroom wordt gebruikt. U kunt ook COBOL-definities (copybooks) importeren die deze gegevensstructuren bieden.
Het hulpprogramma genereert een HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens biedt voor de connector om de structuur van de hostbestandsgegevens te herkennen. Als u HIS gebruikt, kunt u de TI Designer gebruiken om het HIDX-bestand te maken.
De werkstroom van de logische standaard-app waarin u het hostbestand wilt parseren of genereren.
De IBM Host File-connector heeft geen triggers, dus gebruik een trigger om uw werkstroom te starten, zoals de terugkeertrigger of De Azure Blob Storage-trigger . Vervolgens kunt u de acties van de IBM Host File Connector toevoegen. Als u wilt beginnen, maakt u een lege werkstroom in de resource van uw standaard logische app.
Metagegevens definiëren en genereren
Nadat u de HIS Designer voor Azure Logic Apps hebt gedownload en geïnstalleerd, volgt u deze stappen om het HIDX-bestand te genereren op basis van het metagegevensartefact.
Het HIDX-bestand uploaden
Voer de volgende stappen uit om uw werkstroom te gebruiken voor het gebruik van het HIDX-bestand:
Ga naar de map waarin u het HIDX-bestand hebt opgeslagen en kopieer het bestand.
Upload in Azure Portal het HIDX-bestand als een kaart naar de resource van uw standaard logische app.
Verderop in deze handleiding, wanneer u de actie Hostbestandsinhoud parseren voor het eerst aan uw werkstroom toevoegt, wordt u gevraagd een verbinding te maken. Nadat u de verbinding hebt gemaakt, kunt u het eerder toegevoegde HIDX-bestand, het schema en de parameters selecteren die u wilt gebruiken.
Een actie Hostbestandsinhoud parseren toevoegen
Open in Azure Portal de resource en werkstroom van uw standaard logische app in de ontwerpfunctie.
Als u nog geen trigger hebt toegevoegd om uw werkstroom te starten, volgt u deze algemene stappen om de gewenste trigger toe te voegen.
In dit voorbeeld wordt verdergegaan met de ingebouwde trigger van Azure Blob Storage met de naam Wanneer een blob wordt toegevoegd of bijgewerkt.
Als u de inhoud wilt ophalen uit de toegevoegde of bijgewerkte blob, volgt u deze algemene stappen om de ingebouwde connectoractie van Azure Blob Storage toe te voegen met de naam Blob-inhoud lezen.
Volg deze algemene stappen om de ingebouwde connectoractie IBM-hostbestand met de naam Hostbestandsinhoud parseren toe te voegen.
Nadat het deelvenster met verbindingsgegevens wordt weergegeven, geeft u de volgende informatie op:
Parameter Vereist Weergegeven als Omschrijving Naam verbinding Ja <verbindingsnaam> De naam voor uw verbinding Codepagina Nee <codepagina> Het codepaginanummer dat moet worden gebruikt voor het converteren van tekst Van iSeries Nee <mf-iseries> Of het bestand afkomstig is van een i Series-server Bijvoorbeeld:
Wanneer u klaar bent, selecteert u Nieuwe maken.
Nadat het detailvenster van de actie wordt weergegeven, geeft u in de sectie Parameters de vereiste informatie op:
Parameter Vereist Weergegeven als Omschrijving HIDX-naam Ja <HIDX-bestandsnaam> Selecteer het HIDX-bestand van de mainframe-host dat u wilt gebruiken. Schemanaam Ja <schemanaam> Selecteer het schema in het HIDX-bestand dat u wilt gebruiken. Binaire inhoud Ja <binaire inhoud> Selecteer de binaire gegevens met een record met een vaste lengte die is geëxtraheerd uit de host. In de volgende afbeelding ziet u bijvoorbeeld Visual Studio met een HIDX-voorbeeldhostbestand met een CUSTOMER-tabel en CUSTOMER_RECORD schema in de HIS Designer voor Logic Apps:
HIDX-bestand en -schema opgeven
Binaire gegevens selecteren die u wilt lezen uit blob
Wanneer u klaar bent, ziet de actie Hostbestandinhoud parseren eruit zoals in het volgende voorbeeld met een volgende actie waarmee een bestand op een SFTP-server wordt gemaakt:
Sla uw werkstroom op wanneer u klaar bent. Selecteer Opslaan op de werkbalk van de ontwerpfunctie.
Een actie Hostbestandsinhoud genereren toevoegen
Open in Azure Portal de resource en werkstroom van uw standaard logische app in de ontwerpfunctie.
Als u nog geen trigger hebt toegevoegd om uw werkstroom te starten, volgt u deze algemene stappen om de gewenste trigger toe te voegen.
In dit voorbeeld wordt verdergegaan met de ingebouwde trigger van Azure Blob Storage met de naam Wanneer een blob wordt toegevoegd of bijgewerkt.
Als u de inhoud wilt ophalen uit de toegevoegde of bijgewerkte blob, volgt u deze algemene stappen om de ingebouwde connectoractie van Azure Blob Storage toe te voegen met de naam Blob-inhoud lezen.
Volg deze algemene stappen om de ingebouwde connectoractie IBM-hostbestand met de naam Hostbestandinhoud genereren toe te voegen.
Nadat het deelvenster met verbindingsgegevens wordt weergegeven, geeft u de volgende informatie op:
Parameter Vereist Weergegeven als Omschrijving Naam verbinding Ja <verbindingsnaam> De naam voor uw verbinding Codepagina Nee <codepagina> Het codepaginanummer dat moet worden gebruikt voor het converteren van tekst Van iSeries Nee <mf-iseries> Of het bestand afkomstig is van een i Series-server Bijvoorbeeld:
Wanneer u klaar bent, selecteert u Nieuwe maken.
Nadat het detailvenster van de actie wordt weergegeven, geeft u in de sectie Parameters de vereiste informatie op:
Parameter Vereist Weergegeven als Omschrijving HIDX-naam Ja <HIDX-bestandsnaam> Geef de naam op voor het HIDX-bestand van het mainframe-hostbestand dat u wilt gebruiken. Schemanaam Ja <schemanaam> Geef een naam op voor het schema in het HIDX-bestand dat u wilt gebruiken. Rijen Ja <Rijen> Geef een matrix met records op die moeten worden geconverteerd naar de IBM-indeling. Als u de uitvoer van een voorgaande werkstroombewerking wilt selecteren, voert u de volgende stappen uit:
1. Selecteer in het vak Rijen en selecteer vervolgens de optie voor dynamische inhoud (bliksemschicht).
2. Selecteer in de lijst met dynamische inhoud de uitvoer van een voorgaande actie. Selecteer bijvoorbeeld in de sectie Blob-inhoud lezen de optie Antwoord uit de actie Inhoud van de leesblob.
Tip: Als u een volledig gegevensobject in JSON-indeling wilt invoeren, selecteert u de optie Overschakelen naar de volledige matrixoptie .In de volgende afbeelding ziet u bijvoorbeeld Visual Studio met een VOORBEELD-HIDX-bestand in de HIS Designer voor Logic Apps:
HIDX-bestand en -schema opgeven
Rijen selecteren uit blob om te lezen en te converteren
Wanneer u klaar bent, ziet de actie Hostbestandinhoud genereren eruit als in het volgende voorbeeld met een volgende actie waarmee een bestand op een SFTP-server wordt gemaakt:
Sla uw werkstroom op wanneer u klaar bent. Selecteer Opslaan op de werkbalk van de ontwerpfunctie.
Uw werkstroom testen
Als u uw werkstroom wilt uitvoeren, selecteert u Overzicht in het werkstroommenu. Selecteer Uitvoeren>uitvoeren op de werkbalk Overzicht.
Nadat de werkstroom is uitgevoerd, wordt de uitvoeringsgeschiedenis van uw werkstroom weergegeven. Bij geslaagde stappen worden vinkjes weergegeven, terwijl mislukte stappen een uitroepteken (!) weergeven.
Als u de invoer en uitvoer voor elke stap wilt bekijken, vouwt u die stap uit.
Als u de uitvoer wilt bekijken, selecteert u Onbewerkte uitvoer weergeven.
Volgende stappen
- De uitvoeringsstatus van de werkstroom bewaken, de uitvoeringsgeschiedenis van de trigger en de werkstroom controleren en waarschuwingen instellen in Azure Logic Apps
- Metrische gegevens weergeven voor werkstroomstatus en -prestaties in Azure Logic Apps
- Diagnostische gegevens bewaken en verzamelen voor werkstromen in Azure Logic Apps
- Verbeterde telemetrie in Application Insights inschakelen en weergeven voor Standard-werkstromen in Azure Logic Apps