IMS-programma's integreren in IBM mainframes met Standard-werkstromen in Azure Logic Apps

Artikel
01/10/2024

Van toepassing op: Azure Logic Apps (Standard)

Als u IBM mainframe-apps wilt openen en uitvoeren op IMS-systemen (Information Management System) vanuit Standard-werkstromen in Azure Logic Apps, kunt u de ingebouwde, op serviceprovider gebaseerde connector voor IMS-programmaoproep gebruiken. IMS biedt een TP-monitor (Transaction Program) met een geïntegreerde Transaction Manager (TM) en hiërarchische database. De connector communiceert met IBM IMS-transactieprogramma's met behulp van IMS-Verbinding maken, een IMS TM-netwerkonderdeel. Dit onderdeel biedt krachtige communicatie voor IMS-systemen tussen een of meer TCP/IP-clients en een of meer IMS-systemen. De IMS-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 IMS-connector beschreven:

Waarom de IMS-connector gebruiken in Azure Logic Apps
Vereisten en installatie voor het gebruik van de IMS-connector
Stappen voor het toevoegen van IMS-connectoracties aan uw standaardwerkstroom voor logische apps

Waarom deze connector gebruiken?

IMS-systemen waren een van de eerste bedrijfskritieke systemen die worden uitgevoerd op mainframes. Microsoft Host Integration Server (HIS) biedt connectiviteit met IMS-systemen door twee modellen te volgen: IMS Verbinding maken en APPC LU6.2. Klanten hebben de HIS Transaction Integrator (TI) gebruikt om hun IMS-systemen al vele jaren te integreren met Windows on-premises. De IMS-programmaoproepconnector maakt gebruik van het IMS-Verbinding maken-model voor interactie met IMS-transactieprogramma's via TCP/IP.

In het volgende diagram ziet u hoe de IMS-connector communiceert met een IBM-mainframesysteem:

Om deze hybride cloudscenario's uit te breiden, werkt de IMS-connector in een standaardwerkstroom met de HIS Designer voor Logic Apps, die u kunt gebruiken om een programmadefinitie of programmakaart van het mainframe-transactieprogramma te maken. Voor deze taak converteert de HIS Designer die informatie naar metagegevens die door de IMS-connector worden 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 ims-connectoractie toevoegt. De connector leest het metagegevensbestand uit uw logische app-resource en geeft dynamisch de parameters weer die moeten worden gebruikt met de IMS-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.

Verbinding maken of technische naslaginformatie

In de volgende sectie worden de bewerkingen voor de IMS-connector beschreven, die momenteel alleen de volgende actie omvat:

Een IMS-programma aanroepen

Parameter	Vereist	Type	Omschrijving
HIDX-naam	Ja	String	Selecteer het IMS HIDX-bestand dat u wilt gebruiken.
Methodenaam	Ja	String	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.

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.

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.
Toegang tot het mainframe dat als host fungeert voor het IMS-systeem
Het HIDX-bestand (Host Integration Designer XML) dat de benodigde metagegevens biedt voor de IMS Program Call-connector om uw mainframe-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 mainframe-programma wilt aanroepen, moet uw werkstroom het type, de parameters en de retourwaarden van het mainframe-programma begrijpen. De IMS-connector beheert het proces en de gegevensconversies, die nodig zijn voor het leveren van invoergegevens van de werkstroom aan het mainframe-programma en voor het verzenden van uitvoergegevens die zijn gegenereerd vanuit het mainframe-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 kunt gebruiken. Met het hulpprogramma kunt u 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 TI Designer gebruiken om het HIDX-bestand te maken.
De werkstroom van de logische standaard-app die moet worden gebruikt voor integratie met het IMS-systeem

De IMS-connector heeft geen triggers, dus gebruik een trigger om uw werkstroom te starten, zoals de terugkeertrigger of aanvraagtrigger . Vervolgens kunt u de IMS-connectoracties 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.
Voeg nu een IMS-actie toe aan uw werkstroom.

Verderop in deze handleiding wordt u gevraagd om een verbinding te maken tussen uw werkstroom en het mainframesysteem wanneer u voor het eerst een actie van de ims-programmaaanroepconnector toevoegt aan uw werkstroom. 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 IMS-actie 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 de aanvraagtrigger voortgezet met de naam Wanneer een HTTP-aanvraag wordt ontvangen.
Als u een ims-connectoractie wilt toevoegen, volgt u deze algemene stappen om de ingebouwde connectoractie IMS-programmaaanroep toe te voegen met de naam Een IMS-programma aanroepen.

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
De IMS-systeem-id	Ja	<IMS-system-ID>	De naam van het IMS-systeem waarin het IMS-Verbinding maken-model binnenkomende aanvragen doorsturen
NAAM VAN ITOC-afsluit	Nee	<ITOC-exit-name>	De naam van de afsluitroutine die door IMS wordt gebruikt om binnenkomende aanvragen af te handelen
MFS Mod-naam	Nee	<MFS-Mod-Name>	De naam die is gekoppeld aan de uitgaande IMS-berichtuitvoerdescriptor
De HWSO1-beveiligingsafsluiter gebruiken	Nee	Waar of niet waar	De server gebruikt de HWSO1-beveiligingsafsluiter.
Algemene naam van servercertificaat	Nee	<server-cert-common-name>	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	<password>	Het optionele gebruikerswachtwoord voor verbindingsverificatie
Poortnummer	Ja	<poortnummer>	Het poortnummer dat moet worden gebruikt voor verbindingsverificatie
Servernaam	Ja	<servernaam>	De servernaam
Time-out	Nee	<time-out>	De time-outperiode in seconden terwijl wordt gewacht op antwoorden van de server
Gebruikersnaam	Nee	<gebruikersnaam>	De optionele gebruikersnaam voor verbindingsverificatie
TLS gebruiken	Nee	Waar of niet waar	Beveilig de verbinding met TLS (Transport Security Layer).
Servercertificaat valideren	Nee	Waar of niet waar	Valideer het certificaat van de 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 IMS 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.

Bijvoorbeeld:

HIDX-bestand en -methode selecteren

Geavanceerde parameters selecteren

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.