Integrera COBOL- och RPG-program i IBM-mellanregistersystem med Standard-arbetsflöden i Azure Logic Apps
Gäller för: Azure Logic Apps (Standard)
Om du vill komma åt och köra COBOL- och RPG-program på IBM-mellanregistersystem från Standard-arbetsflöden i Azure Logic Apps kan du använda den inbyggda, tjänstleverantörsbaserade anslutningsappen IBM i Program Call . IBM i-operativsystemet tillhandahåller en DPC-server (Distributed Program Calls). Anslutningsappen kommunicerar med IBM i DPC-servern för att köra COBOL- och RPG-program med hjälp av TCP/IP. IBM i-anslutningsappen ä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 IBM i-anslutningsappen:
Varför använda IBM i-anslutningsappen i Azure Logic Apps
Krav och installation för att använda IBM i-anslutningsappen
Steg för att lägga till IBM i connector-åtgärder i ditt standardarbetsflöde för logikappar
Varför ska du använda den här anslutningsappen?
För mer än 50 år sedan släppte IBM de första mellanregistersystemen. IBM annonserade dem som "Liten i storlek, liten i pris och Stor i prestanda. Det är ett system för tillfället och för framtiden". Under årens lopp utvecklades och blev mellanregistersystemen genomgripande i medelstora företag eller i stora företag för att utöka stordatormiljöer. Mellanregistersystem som kör IBM i, vanligtvis Power Systems, stöder TCP/IP och SNA.
IBM i-systemet innehåller DPC-serverfunktionen som gör att de flesta IBM i-program kan interagera med klienter som Azure Logic Apps med hjälp av det klientinitierade endast mönstret för begäran-svar med minsta möjliga ändringar. DPC är ett dokumenterat protokoll som stöder program-till-program-integrering på ett IBM i-system, som klientprogram enkelt kan komma åt med hjälp av TCP/IP-nätverksprotokollet.
Microsoft Host Integration Server (HIS) tillhandahåller anslutning till IBM i-system med TCP/IP och APPC LU6.2. Under många år har kunder använt HIS Transaction Integrator (TI) för att integrera IBM i-system och Windows lokalt. IBM i Program Call Connector använder programmeringsmodellen TCP/IP för att interagera med IBM i COBOL- och RPG-program.
Följande diagram visar hur IBM i-anslutningsappen interagerar med ett IBM i-system:
För att utöka dessa hybridmolnscenarier fungerar IBM i-anslutningsappen 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 COBOL- eller RPG-programmet. För den här uppgiften använder HIS-designern en programmeringsmodell som avgör egenskaperna för datautbytet mellan mellanlagringen och arbetsflödet. HIS-designern konverterar informationen till metadata som IBM i-anslutningsappen använder när du kör en åtgärd i arbetsflödet.
När du har genererat metadatafilen som HIDX-fil (Host Integration Designer) från HIS Designer kan du lägga till filen som en kartartefakt i standardlogikappresursen. På så sätt kan arbetsflödet komma åt appens metadata när du lägger till en IBM i connector-åtgärd. Anslutningsappen läser metadatafilen från logikappens resurs och presenterar dynamiskt parametrar som ska användas med IBM i-anslutningsappen 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 IBM i-anslutningsappen, som för närvarande endast innehåller följande åtgärd:
Anropa ett IBM i-program
| Parameter | Obligatoriskt | Type | Beskrivning |
|---|---|---|---|
| HIDX-namn | Ja | String | Välj den IBM i HIDX-fil som du vill använda. |
| Metodnamn | Ja | String | Välj den metod i HIDX-filen som du vill använda. |
| Avancerade parametrar | Nej | 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 mellanregistret som är värd för IBM i-systemet
FILEN HOST Integration Designer XML (HIDX) som tillhandahåller nödvändiga metadata för IBM i Program Call Connector för att köra ditt mellanregisterprogram.
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 mellanregisterprogram måste arbetsflödet förstå mellanlagringsprogrammets typ, parametrar och returvärden. IBM i-anslutningsappen hanterar den här processen och datakonverteringar, som krävs för att tillhandahålla indata från arbetsflödet till mellanlagringsprogrammet och för att skicka utdata som genererats från mellanlagringsprogrammet 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 använder i arbetsflödet. Du kan också importera COBOL- eller RPG-programdefinitioner (copybooks) som innehåller 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.
Arbetsflödet för standardlogikappen där du vill integrera med IBM i-systemet
IBM i-anslutningsappen 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ärden IBM i connector. 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.
Senare i den här guiden, när du lägger till en IBM i Program Call Connector-åtgärd i arbetsflödet för första gången, uppmanas du att skapa en anslutning mellan arbetsflödet och mellanregistersystemet. 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 IBM i-å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 IBM i-anslutningsåtgärd följer du dessa allmänna steg för att lägga till den inbyggda anslutningsåtgärden IBM i Program Call med namnet Anropa ett IBM i-program.
När fönstret med anslutningsinformation visas anger du följande information, till exempel värdserverns namn och information om IBM i-systemkonfigurationen:
Parameter Obligatoriskt Värde beskrivning Anslutningsnamn Ja <anslutningsnamn> Namnet på anslutningen Eget namn på servercertifikat Nej <server-cert-common-name> Namnet på TLS-certifikatet (Transport Security Layer) som ska användas Kodsida Nej <kodsida> Det kodsidenummer som ska användas för att konvertera text Lösenord Nej <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 Nej <Timeout> Tidsgränsen i sekunder i väntan på svar från servern Användarnamn Nej <användarnamn> Det valfria användarnamnet för anslutningsautentisering Använda TLS Nej Sant eller falskt Skydda anslutningen med TLS (Transport Security Layer). Verifiera servercertifikat Nej 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 beskrivning HIDX-namn Ja <HIDX-file-name> Välj den IBM i 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 Nej 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.
Nästa steg
- Övervaka status för arbetsflödeskörning, granska körningshistorik för utlösare och arbetsflöden och konfigurera aviseringar i Azure Logic Apps
- Visa mått för arbetsflödets hälsa och prestanda i Azure Logic Apps
- Övervaka och samla in diagnostikdata för arbetsflöden i Azure Logic Apps
- Aktivera och visa förbättrad telemetri i Application Insights för Standard-arbetsflöden i Azure Logic Apps