Integrowanie programów COBOL i RPG w systemach ibm midrange z standardowymi przepływami pracy w usłudze Azure Logic Apps

2025-04-21

Dotyczy: Azure Logic Apps (Standard)

Aby uzyskać dostęp do programów COBOL i RPG w systemach ibm midrange z standardowych przepływów pracy w usłudze Azure Logic Apps, możesz użyć wbudowanego łącznika IBM i Program Call opartego na dostawcy usług. System operacyjny IBM i udostępnia serwer wywołań programów rozproszonych (DPC). Łącznik komunikuje się z serwerem IBM i DPC w celu wykonywania programów COBOL i RPG przy użyciu protokołu TCP/IP. Łącznik IBM i jest dostępny we wszystkich regionach usługi Azure Logic Apps z wyjątkiem platformy Azure Government i platformy Microsoft Azure obsługiwanych przez firmę 21Vianet.

W tym artykule opisano następujące aspekty łącznika IBM i:

Scenariusze korzystania z łącznika IBM i w usłudze Azure Logic Apps
Wymagania wstępne i konfiguracja korzystania z łącznika IBM i
Kroki dodawania akcji łącznika IBM i do przepływu pracy aplikacji Logic Apps w warstwie Standard.

Przeglądanie scenariuszy użycia łącznika

Ponad 50 lat temu IBM wprowadził na rynek pierwsze systemy klasy średniej. IBM reklamował je jako "Mały rozmiar, mały w cenie i duży w wydajności." Jest to system na razie i na przyszłość." W ciągu lat systemy średniej klasy ewoluowały i stały się wszechobecne w średnich firmach lub w dużych przedsiębiorstwach w celu rozszerzenia środowisk mainframe. Systemy midrange z systemem IBM i, zazwyczaj Power Systems, obsługują protokoły TCP/IP i SNA.

System IBM i zawiera funkcję serwera DPC, która umożliwia większości aplikacji IBM i interakcję z klientami, takimi jak Azure Logic Apps, przy użyciu wzorca odpowiedzi inicjowanych przez klienta tylko z minimalnymi modyfikacjami. DPC to udokumentowany protokół, który obsługuje integrację programów-program w systemie IBM i, do którego aplikacje klienckie mogą łatwo uzyskiwać dostęp przy użyciu protokołu sieciowego TCP/IP.

Program Microsoft Host Integration Server (HIS) zapewnia łączność z systemami IBM i przy użyciu protokołów TCP/IP i APPC LU6.2. Od wielu lat klienci korzystali z integratora transakcji HIS do integracji lokalnych systemów IBM i i Windows. Łącznik IBM i Program Call używa modelu programowania TCP/IP do interakcji z programami IBM i COBOL i RPG.

Na poniższym diagramie przedstawiono sposób interakcji łącznika IBM i z systemem IBM i:

Aby rozszerzyć te scenariusze chmury hybrydowej, łącznik IBM i w standardowym przepływie pracy współpracuje z projektantem HIS for Logic Apps, którego można użyć do utworzenia definicji programu lub mapy programu COBOL lub RPG. W tym zadaniu projektant HIS używa modelu programowania , który określa charakterystykę wymiany danych między średnikiem a przepływem pracy. Projektant HIS konwertuje te informacje na metadane używane przez łącznik IBM i podczas uruchamiania działania w przepływie pracy.

Po wygenerowaniu pliku metadanych jako pliku XML Host Integration Designer (HIDX) z HIS Designer, możesz dodać ten plik jako artefakt mapy do zasobu standardowej aplikacji logicznej. Dzięki temu przepływ pracy może mieć dostęp do metadanych aplikacji podczas dodawania działania łącznika IBM i. Łącznik odczytuje plik metadanych z zasobu aplikacji logiki i dynamicznie przedstawia parametry do użycia z łącznikiem IBM i w przepływie pracy. Następnie możesz podać parametry głównej aplikacji, a łącznik zwraca wyniki do twojego przepływu pracy. W związku z tym możesz zintegrować starsze aplikacje z platformą Azure, firmą Microsoft, innymi aplikacjami, usługami i systemami, które obsługuje usługa Azure Logic Apps.

Dokumentacja techniczna łącznika

Obecnie jedna operacja jest dostępna dla łącznika IBM i: Wywoływanie programu IBM i. Poniższa tabela zawiera podsumowanie użycia tej akcji:

Parametr	Wymagane	Typ	Opis
Nazwa HIDX	Tak	Sznurek	Wybierz plik IBM i HIDX, którego chcesz użyć.
Nazwa metody	Tak	Sznurek	Wybierz metodę w pliku HIDX, którego chcesz użyć.
Parametry zaawansowane	Nie.	Różni się	Ta lista zostanie wyświetlona po wybraniu metody, aby można było dodać inne parametry do użycia z wybraną metodą. Dostępne parametry różnią się w zależności od pliku HIDX i wybranej metody.

Ta operacja obejmuje również zaawansowane parametry, które są wyświetlane po wybraniu metody, aby można było je wybrać i stosować z tą metodą. Te parametry różnią się w zależności od pliku HIDX i wybranej metody.

Wymagania wstępne

Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.
Dostęp do serwera midrange, który hostuje system IBM i.
Plik XML projektanta integracji hosta (HIDX), który udostępnia metadane niezbędne do wykonania konektora "IBM i Program Call", który umożliwia uruchomienie programu średniego szczebla.

Aby utworzyć ten plik HIDX, pobierz i zainstaluj projektanta HIS dla usługi Azure Logic Apps. Jedynym wymaganiem wstępnym jest program Microsoft .NET Framework 4.8.

Aby wywołać program średniego zasięgu, przepływ pracy musi zrozumieć jego typ, parametry oraz wartości zwracane. Łącznik IBM i zarządza tym procesem i konwersjami danych. Te wymagane przekształcenia dostarczają dane wejściowe z przepływu pracy do programu średniej klasy oraz przesyłają wszelkie dane wyjściowe wygenerowane przez program średniej klasy z powrotem do przepływu pracy. Łącznik udostępnia również definicję danych tabelarycznych i tłumaczenie strony kodowej. W tym procesie usługa Azure Logic Apps wymaga podania tych informacji jako metadanych.

Aby utworzyć te metadane, użyj projektanta HIS dla usługi Logic Apps. Za pomocą tego narzędzia można ręcznie utworzyć metody, parametry i wartości zwracane, które są używane w przepływie pracy. Możesz również zaimportować definicje programów COBOL lub RPG (kopioksiążki), które zawierają te informacje.

Narzędzie generuje plik XML Host Integration Designer (HIDX), który dostarcza niezbędne metadane dla łącznika. Jeśli używasz funkcji HIS, możesz użyć projektanta integratora transakcji HIS (TI), aby utworzyć plik HIDX.
Standardowy przepływ pracy aplikacji logicznej, w którym chcesz zintegrować się z systemem IBM i.

Łącznik IBM i nie ma wyzwalaczy, dlatego użyj dowolnego wyzwalacza, aby uruchomić przepływ pracy, taki jak wyzwalacz powtarzalności lub wyzwalacz na żądanie. Następnie możesz dodać akcję łącznika IBM i. Aby rozpocząć, utwórz pusty przepływ pracy w zasobie standardowej aplikacji logiki.

Ograniczenia

Obecnie łącznik IBM i wymaga przekazania pliku HIDX bezpośrednio do zasobu aplikacji logiki w standardowym środowisku, a nie na konto integracji.

Definiowanie i generowanie metadanych

Po pobraniu i zainstalowaniu projektanta HIS dla usługi Azure Logic Apps wykonaj następujące kroki, aby wygenerować plik HIDX z artefaktu metadanych.

Przekazanie pliku HIDX

Aby przepływ pracy używał pliku HIDX, wykonaj następujące kroki:

Przejdź do folderu, w którym zapisano plik HIDX, i skopiuj plik.
W Azure portal otwórz zasób aplikacji logicznych standardowych.
W menu aplikacji logiki w obszarze Artefaktyprzekaż plik HIDX jako mapę do zasobu aplikacji logiki.
Przejdź do następnej sekcji, aby dodać akcję IBM i do przepływu pracy.

W dalszej części tego przewodnika, gdy po raz pierwszy dodasz akcję łącznika IBM i Program Call do swojego przepływu pracy, zostanie wyświetlony monit z prośbą o utworzenie połączenia między przepływem pracy a systemem średniej klasy. Po utworzeniu połączenia możesz wybrać wcześniej dodany plik HIDX, metodę do uruchomienia i parametry do użycia.

Dodawanie akcji IBM i

Wykonaj następujące kroki, aby dodać akcję IBM i i skonfigurować niezbędne parametry:

W portalu Azure otwórz zasób aplikacji logiki Standard i przepływ pracy w projektancie.
Jeśli nie masz wyzwalacza, aby uruchomić przepływ pracy, wykonaj następujące ogólne kroki, aby dodać odpowiedni wyzwalacz.

Ten przykład kontynuuje wyzwalacz żądania o nazwie Po odebraniu żądania HTTP:

Zrzut ekranu przedstawiający portal Azure, projektanta przepływu pracy w warstwie Standard i wyzwalacz żądania.
Aby dodać akcję łącznika IBM i, wykonaj następujące ogólne kroki, aby dodać wbudowaną akcję łącznika IBM i Program Call o nazwie Call an IBM i Program .

Po pojawieniu się okienka szczegółów połączenia podaj następujące informacje, takie jak nazwa serwera hosta i informacje o konfiguracji systemu IBM i:

Parametr	Wymagane	Wartość	Opis
Nazwa połączenia	Tak	< nazwa połączenia>	Nazwa połączenia.
Nazwa pospolita certyfikatu serwera	Nie.	< nazwa-powszechna-certyfikatu-serwera>	Nazwa certyfikatu transport security layer (TLS) do użycia.
Strona kodowa	Nie.	< strona kodowa>	Numer strony kodowej, który ma być używany do konwertowania tekstu.
Hasło	Nie.	< hasło>	Opcjonalne hasło użytkownika na potrzeby uwierzytelniania połączenia.
Numer portu	Tak	< numer portu>	Numer portu do użycia na potrzeby uwierzytelniania połączenia.
nazwa serwera	Tak	< nazwa serwera>	Nazwa serwera.
Przekroczenie limitu czasu	Nie.	< Limit czasu>	Limit czasu w sekundach podczas oczekiwania na odpowiedzi z serwera.
Nazwa użytkownika	Nie.	< nazwa użytkownika>	Opcjonalna nazwa użytkownika na potrzeby uwierzytelniania połączenia.
Korzystanie z protokołu TLS	Nie.	Prawda lub fałsz	Zabezpieczanie połączenia za pomocą protokołu Transport Security Layer (TLS).
Weryfikowanie certyfikatu serwera	Nie.	Prawda lub fałsz	Zweryfikuj certyfikat serwera.

Przykład:

Po zakończeniu wybierz pozycję Utwórz nowy.

Po pojawieniu się okienka szczegółów akcji w sekcji Parametry podaj wymagane informacje:

Parametr	Wymagane	Wartość	Opis
Nazwa HIDX	Tak	< HIDX-file-name>	Wybierz plik IBM i HIDX, którego chcesz użyć.
Nazwa metody	Tak	< nazwa-metody>	Wybierz metodę w pliku HIDX, którego chcesz użyć.
Parametry zaawansowane	Nie.	Różni się	Ta lista zostanie wyświetlona po wybraniu metody, aby można było dodać inne parametry do użycia z wybraną metodą. Dostępne parametry różnią się w zależności od pliku HIDX i wybranej metody.

Przykład:

Wybierz plik HIDX i metodę

Wybieranie parametrów zaawansowanych

Gdy wszystko będzie gotowe, zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Testowanie przepływu pracy

Wykonaj następujące kroki, aby sprawdzić przepływ pracy i potwierdzić dane wyjściowe:

Aby uruchomić przepływ pracy, na pasku narzędzi projektanta wybierz pozycję Uruchom>.

Po zakończeniu przepływu pracy widoczna jest jego historia uruchomień. Pomyślne kroki pokazują znaki kontrolne, a kroki zakończone niepowodzeniem wykrzyknik (!).
Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, rozwiń ten krok.
Aby przejrzeć dane wyjściowe, wybierz pozycję Zobacz nieprzetworzone dane wyjściowe.