Integrera IMS-program på IBM-stordatorer med Standard-arbetsflöden i Azure Logic Apps

Artikel
01/10/2024

Gäller för: Azure Logic Apps (Standard)

Om du vill komma åt och köra IBM-stordatorappar i IMS-system (Information Management System) från Standard-arbetsflöden i Azure Logic Apps kan du använda den inbyggda, tjänstleverantörsbaserade anslutningsappen för IMS-programsamtal . IMS tillhandahåller en TP-övervakare (Transaction Program) med en integrerad transaktionshanterare (TM) och en hierarkisk databas. Anslutningsappen kommunicerar med IBM IMS-transaktionsprogram med hjälp av IMS-Anslut, som är en IMS TM-nätverkskomponent. Den här komponenten tillhandahåller kommunikation med höga prestanda för IMS-system mellan en eller flera TCP/IP-klienter och ett eller flera IMS-system. IMS-anslutningstjänsten är tillgänglig i alla Azure Logic Apps-regioner förutom Azure Government och Microsoft Azure som drivs av 21Vianet.

Den här instruktionsguiden beskriver följande aspekter av IMS-anslutningstjänsten:

Därför kan du använda IMS-anslutningstjänsten i Azure Logic Apps
Krav och installation för att använda IMS-anslutningstjänsten
Steg för att lägga till IMS-anslutningsåtgärder i ditt standardarbetsflöde för logikappar

Varför ska du använda den här anslutningsappen?

IMS-system var ett av de första verksamhetskritiska systemen som körs på stordatorer. Microsoft Host Integration Server (HIS) tillhandahåller anslutning till IMS-system genom att följa två modeller: IMS Anslut och APPC LU6.2. Kunder har använt HIS Transaction Integrator (TI) för att integrera sina IMS-system med Windows lokalt i många år. IMS Program Call Connector använder IMS Anslut-modellen för att interagera med IMS-transaktionsprogram via TCP/IP.

Följande diagram visar hur IMS-anslutningstjänsten interagerar med ett IBM-stordatorsystem:

För att utöka dessa hybridmolnscenarier fungerar IMS-anslutningstjänsten i ett Standard-arbetsflöde med HIS Designer for Logic Apps, som du kan använda för att skapa en programdefinition eller programkarta över stordatorns transaktionsprogram. För den här uppgiften konverterar HIS-designern informationen till metadata som IMS-anslutningstjänsten använder när du kör en åtgärd i arbetsflödet.

När du har genererat metadatafilen som en HIDX-fil (Host Integration Designer) från HIS Designer kan du lägga till den filen som en kartartefakt i din standardlogikappresurs. På så sätt kan arbetsflödet komma åt appens metadata när du lägger till en ims-anslutningsåtgärd. Anslutningsappen läser metadatafilen från logikappens resurs och visar dynamiskt de parametrar som ska användas med IMS-anslutningstjänsten i arbetsflödet. Du kan sedan ange parametrar för värdprogrammet och anslutningsappen returnerar resultatet till arbetsflödet. Därför kan du integrera dina äldre appar med Azure, Microsoft, andra appar, tjänster och system som Azure Logic Apps stöder.

Anslut eller teknisk referens

I följande avsnitt beskrivs åtgärderna för IMS-anslutningstjänsten, som för närvarande endast innehåller följande åtgärd:

Anropa ett IMS-program

Parameter	Obligatoriskt	Type	Description
HIDX-namn	Ja	String	Välj den IMS HIDX-fil som du vill använda.
Metodnamn	Ja	String	Välj den metod i HIDX-filen som du vill använda.
Avancerade parametrar	Inga	Det varierar	Den här listan visas när du har valt en metod så att du kan lägga till andra parametrar som ska användas med den valda metoden. De tillgängliga parametrarna varierar beroende på din HIDX-fil och vilken metod du väljer.

Den här åtgärden innehåller även avancerade parametrar, som visas när du har valt en metod, så att du kan välja och använda med den valda metoden. Dessa parametrar varierar beroende på din HIDX-fil och vilken metod du väljer.

Begränsningar

För närvarande kräver den här anslutningsappen att du laddar upp DIN HIDX-fil direkt till standardlogikappresursen, inte till ett integrationskonto.

Förutsättningar

Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.
Åtkomst till stordatorn som är värd för IMS-systemet
FILEN HOST Integration Designer XML (HIDX) som tillhandahåller nödvändiga metadata för anslutningsappen för IMS-programanrop för att köra stordatorprogrammet.

Om du vill skapa den här HIDX-filen laddar du ned och installerar HIS Designer för Azure Logic Apps. Det enda kravet är Microsoft .NET Framework 4.8.

För att anropa ett stordatorprogram måste arbetsflödet förstå stordatorprogrammets typ, parametrar och returvärden. IMS-anslutningstjänsten hanterar processen och datakonverteringarna, som krävs för att tillhandahålla indata från arbetsflödet till stordatorprogrammet och för att skicka utdata som genererats från stordatorprogrammet till arbetsflödet. Anslutningsappen innehåller även tabelldatadefinition och kodsideöversättning. För den här processen kräver Azure Logic Apps att du anger den här informationen som metadata.

Om du vill skapa dessa metadata använder du HIS Designer för Logic Apps. Med det här verktyget kan du manuellt skapa de metoder, parametrar och returvärden som du kan använda i arbetsflödet. Med verktyget kan du också importera COBOL- eller RPG-programdefinitioner (copybooks) som ger den här informationen.

Verktyget genererar en HIDX-fil (Host Integration Designer) som tillhandahåller nödvändiga metadata för anslutningsappen. Om du använder HIS kan du använda TI Designer för att skapa HIDX-filen.
Standard logic app workflow to use for integrating with the IMS system to use for integrating with the IMS system (Standard logic app workflow to use for integrating with the IMS system to use for integrating with the IM

IMS-anslutningstjänsten har inga utlösare, så använd någon utlösare för att starta arbetsflödet, till exempel utlösaren Upprepning eller Utlösare för begäran . Du kan sedan lägga till åtgärder för IMS-anslutningstjänsten. Kom igång genom att skapa ett tomt arbetsflöde i standardlogikappresursen.

Definiera och generera metadata

När du har laddat ned och installerat HIS Designer för Azure Logic Apps följer du de här stegen för att generera HIDX-filen från metadataartefakten.

Ladda upp HIDX-filen

Följ dessa steg för att arbetsflödet ska använda HIDX-filen:

Gå till mappen där du sparade HIDX-filen och kopiera filen.
I Azure-portalen laddar du upp HIDX-filen som en karta till din standardlogikappresurs.
Lägg nu till en IMS-åtgärd i arbetsflödet.

Senare i den här guiden uppmanas du att skapa en anslutning mellan arbetsflödet och stordatorsystemet när du lägger till en anslutningsåtgärd för IMS-programsamtal i arbetsflödet för första gången. När du har skapat anslutningen kan du välja din tidigare tillagda HIDX-fil, vilken metod som ska köras och de parametrar som ska användas.

Lägga till en IMS-åtgärd

Öppna din standardlogikappresurs och ditt arbetsflöde i designern i Azure-portalen.
Om du inte redan har lagt till en utlösare för att starta arbetsflödet följer du de här allmänna stegen för att lägga till den utlösare som du vill använda.

Det här exemplet fortsätter med utlösaren Förfrågning med namnet När en HTTP-begäran tas emot.
Om du vill lägga till en ims-anslutningsåtgärd följer du dessa allmänna steg för att lägga till den inbyggda anslutningsåtgärden IMS Program Call med namnet Anropa ett IMS-program.

När fönstret med anslutningsinformation visas anger du följande information:

Parameter	Obligatoriskt	Värde	Description
Anslutningsnamn	Ja	<anslutningsnamn>	Namnet på anslutningen
IMS-system-ID:t	Ja	<IMS-system-ID>	Namnet på IMS-systemet där IMS-Anslut-modellen dirigerar inkommande begäranden
ITOC-avslutningsnamn	Inga	<ITOC-exit-name>	Namnet på slutrutinen som IMS använder för att hantera inkommande begäranden
MFS Mod Name	Inga	<MFS-Mod-Name>	Namnet som är associerat med utgående IMS-meddelandeutdatabeskrivning
Använda HWSO1-säkerhetsavslutet	Inga	Sant eller falskt	Servern använder HWSO1-säkerhetsavslutet.
Eget namn på servercertifikat	Inga	<server-cert-common-name>	Namnet på TLS-certifikatet (Transport Security Layer) som ska användas
Kodsida	Inga	<kodsida>	Det kodsidenummer som ska användas för att konvertera text
Lösenord	Inga	<Lösenord>	Det valfria användarlösenordet för anslutningsautentisering
Portnummer	Ja	<portnummer>	Portnumret som ska användas för anslutningsautentisering
Servernamn	Ja	<servernamn>	Servernamnet
Tidsgräns	Inga	<Timeout>	Tidsgränsen i sekunder i väntan på svar från servern
Användarnamn	Inga	<användarnamn>	Det valfria användarnamnet för anslutningsautentisering
Använda TLS	Inga	Sant eller falskt	Skydda anslutningen med TLS (Transport Security Layer).
Verifiera servercertifikat	Inga	Sant eller falskt	Verifiera serverns certifikat.

Till exempel:

När du är klar väljer du Skapa ny.

När åtgärdsinformationsfönstret visas anger du nödvändig information i avsnittet Parametrar :

Parameter	Obligatoriskt	Värde	Description
HIDX-namn	Ja	<HIDX-file-name>	Välj den IMS HIDX-fil som du vill använda.
Metodnamn	Ja	<method-name>	Välj den metod i HIDX-filen som du vill använda.
Avancerade parametrar	Inga	Det varierar	Den här listan visas när du har valt en metod så att du kan lägga till andra parametrar som ska användas med den valda metoden. De tillgängliga parametrarna varierar beroende på din HIDX-fil och vilken metod du väljer.

Till exempel:

Välj HIDX-fil och -metod

Välj avancerade parametrar

Spara arbetsflödet när du är klar. I designerverktygsfältet väljer du Spara.

Testa arbetsflödet

Om du vill köra arbetsflödet går du till arbetsflödesmenyn och väljer Översikt. I verktygsfältet Översikt väljer du Kör>kör.

När arbetsflödet har körts visas arbetsflödets körningshistorik. Lyckade steg visar bockmarkeringar, medan misslyckade steg visar ett utropstecken (!).
Om du vill granska indata och utdata för varje steg expanderar du det steget.
Om du vill granska utdata väljer du Visa råutdata.