COBOL- en RPG-programma's integreren in IBM midrange-systemen met Standard-werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Standard)

Als u COBOL- en RPG-programma's wilt openen en uitvoeren op IBM midrange-systemen vanuit Standard-werkstromen in Azure Logic Apps, kunt u de ingebouwde, op serviceprovider gebaseerde connector van IBM i Program Call gebruiken. Het IBM i-besturingssysteem biedt een DPC-server (Distributed Program Calls). De connector communiceert met de IBM i DPC-server om COBOL- en RPG-programma's uit te voeren met behulp van TCP/IP. De IBM i-connector is beschikbaar in alle Azure Logic Apps-regio's, met uitzondering van Azure Government en Microsoft Azure beheerd door 21Vianet.

In dit artikel worden de volgende aspecten van de IBM i-connector beschreven:

• Scenario's voor het gebruik van de IBM i-connector in Azure Logic Apps
• Vereisten en installatie voor het gebruik van de IBM i-connector
• Stappen voor het toevoegen van IBM i-connectoracties aan uw standaardwerkstroom voor logische apps

De gebruiksscenario's van de connector bekijken

Meer dan 50 jaar geleden bracht IBM de eerste midrange systemen uit. IBM heeft ze geadverteerd als "Klein in grootte, klein in prijs en Big in prestaties. Het is een systeem voor nu en voor de toekomst." In de loop der jaren ontwikkelden de middelgrote systemen zich en werden ze uitgebreid in middelgrote bedrijven of in grote ondernemingen om mainframe-omgevingen uit te breiden. Midrange-systemen waarop IBM i, meestal Power Systems, wordt uitgevoerd, ondersteunen TCP/IP en SNA.

Het IBM i-systeem bevat de DPC-serverfunctie waarmee de meeste IBM i-toepassingen kunnen communiceren met clients zoals Azure Logic Apps met behulp van het door de client geïnitieerde alleen aanvraagantwoordpatroon met minimale wijzigingen. DPC is een gedocumenteerd protocol dat ondersteuning biedt voor programma-naar-programma-integratie op een IBM i-systeem, waartoe clienttoepassingen eenvoudig toegang hebben met behulp van het TCP/IP-netwerkprotocol.

Microsoft Host Integration Server (HIS) biedt connectiviteit met IBM i-systemen met behulp van TCP/IP en APPC LU6.2. Al vele jaren hebben klanten de HIS Transaction Integrator gebruikt om on-premises IBM i-systemen en Windows te integreren. De IBM i Program Call-connector maakt gebruik van het TCP/ IP-programmeermodel om te communiceren met IBM i COBOL- en RPG-programma's.

In het volgende diagram ziet u hoe de IBM i-connector communiceert met een IBM i-systeem:

Om deze hybride cloudscenario's uit te breiden, werkt de IBM i-connector in een Standard-werkstroom met de HIS Designer voor Logic Apps, die u kunt gebruiken om een programmadefinitie of programmakaart van het COBOL- of RPG-programma te maken. Voor deze taak gebruikt de HIS Designer een programmeermodel dat de kenmerken van de gegevensuitwisseling tussen het middenbereik en de werkstroom bepaalt. De HIS Designer converteert die informatie naar metagegevens die de IBM i-connector gebruikt bij het uitvoeren van een actie in uw werkstroom.

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 IBM i-connectoractie toevoegt. De connector leest het metagegevensbestand uit uw logische app-resource en geeft dynamisch parameters weer die u kunt gebruiken met de IBM i-connector in uw werkstroom. U kunt vervolgens parameters opgeven voor de hosttoepassing en de connector retourneert de resultaten naar uw werkstroom. Als gevolg hiervan kunt u uw verouderde apps integreren met Azure, Microsoft, andere apps, services en systemen die door Azure Logic Apps worden ondersteund.

Technische naslaggids voor connector

Er is momenteel één bewerking beschikbaar voor de IBM i-connector: een IBM i-programma aanroepen. De volgende tabel bevat een overzicht van het gebruik voor deze actie:

Deze bewerking bevat ook geavanceerde parameters, die worden weergegeven nadat u een methode hebt geselecteerd, zodat u deze kunt selecteren en gebruiken met de geselecteerde methode. Deze parameters variëren op basis van uw HIDX-bestand en de methode die u selecteert.

Vereiste voorwaarden

• Een Azure-account en -abonnement. Als u nog geen abonnement op Azure hebt, registreer u dan nu voor een gratis Azure-account.

• Toegang tot de midrange-server die als host fungeert voor het IBM i-systeem.

• Het HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens biedt voor de IBM i Program Call-connector om uw midrange-programma uit te voeren.

  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 een midrange-programma wilt aanroepen, moet uw werkstroom inzicht hebben in het type, de parameters en de retourwaarden van het midrange-programma. De IBM i-connector beheert dit proces en de gegevensconversies. Deze vereiste conversies bieden invoergegevens van de werkstroom naar het midrange-programma en verzenden uitvoergegevens die zijn gegenereerd vanuit het midrange-programma naar de werkstroom. De connector biedt ook tabellaire gegevensdefinitie en codepaginavertaling. Voor dit proces vereist Azure Logic Apps dat u deze informatie opgeeft als metagegevens.

  Gebruik de HIS Designer voor Logic Apps om deze metagegevens te maken. Met dit hulpprogramma kunt u handmatig de methoden, parameters en retourwaarden maken die u in uw werkstroom gebruikt. U kunt ook COBOL- of RPG-programmadefinities (copybooks) importeren die deze informatie verstrekken.

  Het hulpprogramma genereert een HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens voor de connector levert. Als u HIS gebruikt, kunt u de HIS Transaction Integrator (TI) Designer gebruiken om het HIDX-bestand te maken.

• De standaard-logica-app werkstroom waarin u wilt integreren met het IBM i-systeem.

  De IBM i-connector heeft geen triggers, dus gebruik een trigger om uw werkstroom te starten, zoals de terugkeertrigger of aanvraagtrigger . Vervolgens kunt u de IBM i-connector-actie toevoegen. Om te beginnen maakt u een lege workflow in de standaardbron voor Logic Apps.

Beperkingen

Op dit moment moet u voor de IBM i-connector uw HIDX-bestand rechtstreeks uploaden naar uw standaard logische app resource en niet naar een integratieaccount.

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 voor het gebruik van het HIDX-bestand in uw werkstroom:

1. Ga naar de map waarin u het HIDX-bestand hebt opgeslagen en kopieer het bestand.

2. Open in de Azure portal uw standaard logische app-resource.

3. Upload in het menu van de logische app onder Artefactenhet HIDX-bestand als een kaart naar de resource van de logische app.

4. Ga door naar de volgende sectie om een IBM i-actie toe te voegen aan uw werkstroom.

Verderop in deze handleiding, wanneer u voor het eerst een IBM i Program Call connector-actie toevoegt aan uw werkstroom, wordt u gevraagd om een verbinding te maken tussen uw werkstroom en het midrangesysteem. Nadat u de verbinding hebt gemaakt, kunt u het eerder toegevoegde HIDX-bestand selecteren, de methode die moet worden uitgevoerd en de parameters die u wilt gebruiken.

Een IBM i-actie toevoegen

Volg deze stappen om een IBM i-actie toe te voegen en de benodigde parameters te configureren:

1. Open in de Azure Portal de resource en werkstroom van uw standaard Logic Apps in de designer.

2. Als u geen trigger hebt om uw werkstroom te starten, volgt u deze algemene stappen om de gewenste trigger toe te voegen.

   Dit voorbeeld gaat verder met de aanvraagtrigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen:

   

3. Als u een IBM i-connectoractie wilt toevoegen, volgt u deze algemene stappen om de ingebouwde connectoractie IBM i Program Call toe te voegen met de naam Een IBM i-programma aanroepen.

4. Nadat het deelvenster met verbindingsgegevens wordt weergegeven, geeft u de volgende informatie op, zoals de naam van de hostserver en informatie over de configuratie van het IBM i-systeem:

   Maatstaf	Verplicht	Waarde	Beschrijving
   Naam verbinding	Ja	< verbindingsnaam>	De naam voor uw verbinding.
   Algemene naam van servercertificaat	Nee.	< server-cert-gemeenschappelijke-naam>	De naam van het TLS-certificaat (Transport Security Layer) dat moet worden gebruikt.
   Codepagina	Nee.	< codepagina>	Het codepaginanummer dat moet worden gebruikt voor het converteren van tekst.
   Wachtwoord	Nee.	< wachtwoord>	Het optionele gebruikerswachtwoord voor verbindingsverificatie.
   Poortnummer	Ja	< poortnummer>	Het poortnummer dat moet worden gebruikt voor verbindingsverificatie.
   Servernaam	Ja	< servernaam>	De servernaam.
   Time-out	Nee.	< Timeout>	De time-outperiode in seconden voor het wachten op antwoorden van de server.
   Gebruikersnaam	Nee.	< gebruikersnaam>	De optionele gebruikersnaam voor verbindingsverificatie.
   TLS gebruiken	Nee.	Waar of onwaar	Beveilig de verbinding met TLS (Transport Security Layer).
   Servercertificaat valideren	Nee.	Waar of onwaar	Valideer het certificaat van de server.

   Voorbeeld:

   

5. Wanneer u klaar bent, selecteert u Nieuwe maken.

6. Nadat het detailvenster van de actie wordt weergegeven, geeft u in de sectie Parameters de vereiste informatie op:

   Maatstaf	Verplicht	Waarde	Beschrijving
   HIDX-naam	Ja	< HIDX-bestandsnaam>	Selecteer het IBM i HIDX-bestand dat u wilt gebruiken.
   Methodenaam	Ja	< method-name>	Selecteer de methode in het HIDX-bestand dat u wilt gebruiken.
   Geavanceerde parameters	Nee.	Varieert	Deze lijst wordt weergegeven nadat u een methode hebt geselecteerd, zodat u andere parameters kunt toevoegen die u met de geselecteerde methode kunt gebruiken. De beschikbare parameters variëren op basis van uw HIDX-bestand en de methode die u selecteert.

   Voorbeeld:

   HIDX-bestand en -methode selecteren

   

   Geavanceerde parameters selecteren

   

7. Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

Uw werkstroom testen

Volg deze stappen om uw werkstroom te controleren en de uitvoer te bevestigen:

1. Als u uw werkstroom wilt uitvoeren, selecteert u Uitvoeren>Uitvoeren op de werkbalk van de ontwerper.

   Nadat de werkstroom is uitgevoerd, wordt de uitvoeringsgeschiedenis van de werkstroom weergegeven. Bij geslaagde stappen worden vinkjes weergegeven, terwijl mislukte stappen een uitroepteken (!) weergeven.

2. Als u de invoer en uitvoer voor elke stap wilt bekijken, vouwt u die stap uit.

3. Als u de uitvoer wilt bekijken, selecteert u Onbewerkte uitvoer weergeven.

Verwante inhoud

• Werkstroomstatus controleren, uitvoeringsgeschiedenis weergeven 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