Integrowanie programów CICS na mainframe'ach IBM z Standardowymi przepływami pracy w usłudze Azure Logic Apps

2025-04-09

Dotyczy: Azure Logic Apps (Standard)

Aby uzyskać dostęp do aplikacji mainframe IBM i je uruchamiać w systemach Customer Information Control System (CICS) ze standardowych przepływów pracy w Azure Logic Apps, możesz użyć wbudowanego łącznika CICS Program Call opartego na dostawcy usług. CICS udostępnia monitor programu transakcyjnego (TP) ze zintegrowanym menedżerem transakcji (TM). Łącznik komunikuje się z programami transakcji IBM CICS przy użyciu protokołu TCP/IP. Łącznik CICS 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 dotyczące łącznika CICS:

Scenariusze korzystania z łącznika CICS w usłudze Azure Logic Apps
Wymagania wstępne i konfiguracja używania łącznika CICS
Kroki, aby dodać akcje łącznika CICS do standardowego przepływu pracy aplikacji logicznych

Przeglądanie scenariuszy użycia łącznika

Systemy CICS były jednym z pierwszych systemów o znaczeniu krytycznym, które działają na komputerach mainframe. Program Microsoft Host Integration Server (HIS) zapewnia łączność z systemami CICS przy użyciu protokołów TCP/IP, HTTP i APPC LU6.2. Klienci korzystali z integratora transakcji HIS do integracji systemów CICS z lokalnym systemem Windows od wielu lat. Łącznik wywołania programu CICS używa modeli programowania TCP/IP i HTTP do interakcji z programami transakcji CICS.

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

Aby rozszerzyć te scenariusze chmury hybrydowej, łącznik CICS w standardowym przepływie pracy współpracuje z projektantem HIS dla usługi Logic Apps, którego można użyć do utworzenia definicji programu lub mapy programu transakcji mainframe. W tym zadaniu projektant HIS używa modelu programowania , który określa charakterystykę wymiany danych między elementem mainframe a przepływem pracy. Projektant HIS przekształca te informacje w metadane, których łącznik CICS używa podczas wykonywania akcji w Twoim 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 uzyskiwać dostęp do metadanych aplikacji, gdy dodasz akcję łącznika CICS. Łącznik odczytuje plik metadanych z zasobu aplikacji logiki i dynamicznie przedstawia parametry do użycia z łącznikiem CICS 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 CICS: Wywoływanie programu CICS. Poniższa tabela zawiera podsumowanie użycia tej akcji:

Parametr	Wymagane	Typ	Opis
Nazwa HIDX	Tak	Sznurek	Wybierz plik CICS 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 komputera mainframe, który hostuje system CICS.
Plik XML (HIDX) projektanta integracji z hostem, który udostępnia niezbędne metadane dla łącznika wywołania programu CICS, aby wykonać program mainframe.

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 mainframe, przepływ pracy musi zrozumieć typ, parametry i zwracane wartości programu mainframe. Łącznik CICS zarządza tym procesem i konwersjami danych. Konwersje dostarczają dane wejściowe z przepływu pracy do programu mainframe i wysyłają wszelkie dane wyjściowe wygenerowane przez program mainframe 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 Logic App, w którym chcesz zintegrować się z systemem CICS.

Łącznik CICS nie ma wyzwalaczy, dlatego użyj dowolnego wyzwalacza, aby uruchomić przepływ pracy, taki jak wyzwalacz cykliczny lub wyzwalacz żądania. Następnie możesz dodać akcje łącznika CICS. Aby rozpocząć, utwórz pusty przepływ pracy w zasobie standardowej aplikacji logiki.

Ograniczenia

Obecnie łącznik CICS wymaga przekazania pliku HIDX bezpośrednio do zasobu aplikacji logicznej w trybie Standard, a nie zasobu konta 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 portalu Azure przekaż plik HIDX jako mapę do zasobu aplikacji logicznej w wersji Standard.
Przejdź do następnej sekcji, aby dodać akcję CICS do przepływu pracy.

W dalszej części tego artykułu, gdy po raz pierwszy dodasz akcję łącznika Wywołanie Programu CICS do swojego przepływu pracy, pojawi się monit o utworzenie połączenia między przepływem pracy a systemem mainframe. Po utworzeniu połączenia możesz wybrać wcześniej dodany plik HIDX, metodę do uruchomienia i parametry do użycia.

Dodaj akcję CICS

Wykonaj następujące kroki, aby dodać akcję CICS 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 CICS, wykonaj następujące ogólne kroki, aby dodać wbudowaną akcję łącznika CICS Program Call o nazwie Call a CICS Program (Wywoływanie programu CICS).

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

Parametr	Wymagane	Wartość	Opis
Nazwa połączenia	Tak	< nazwa połączenia>	Nazwa połączenia.
Model programowania	Tak	< MODEL programowania CICS>	Wybrany model programowania CICS. Aby uzyskać więcej informacji, zobacz Modele programowania.
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.	< Timeout>	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.
Nazwa pospolita certyfikatu serwera	Nie.	< nazwa-powszechna-certyfikatu-serwera>	Nazwa certyfikatu transport security layer (TLS) do użycia.
Użyj formatu nagłówka żądania IBM	Nie.	Prawda lub fałsz	Skonfiguruj serwer, aby oczekiwał nagłówków ELM lub TRM w formacie IBM.

Na 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 CICS 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.

Na 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 działania przepływu pracy zostanie wyświetlona historia przebiegu. 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.