Integrowanie programów CICS na komputerach mainframe FIRMY IBM z standardowymi przepływami pracy w usłudze Azure Logic Apps

Artykuł
11/08/2023

Dotyczy: Azure Logic Apps (Standardowa)

Aby uzyskać dostęp do i uruchamiać aplikacje mainframe IBM w systemach systemu kontroli informacji o klientach (CICS) z standardowych przepływów pracy w usłudze Azure Logic Apps, możesz użyć wbudowanego łącznika ciCS Program Call opartego na dostawcy usług. CiCS udostępnia monitor programu transakcji (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 przewodniku z instrukcjami opisano następujące aspekty dotyczące łącznika CICS:

Dlaczego warto używać łącznika CICS w usłudze Azure Logic Apps
Wymagania wstępne i konfiguracja używania łącznika CICS
Kroki dodawania akcji łącznika CICS do przepływu pracy aplikacji logiki w warstwie Standardowa

Dlaczego warto używać tego łą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 (TI) do integracji systemów CICS z systemem Windows lokalnie 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 przepływie pracy w warstwie Standardowa współpracuje z Projektant 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 konwertuje te informacje na metadane używane przez łącznik CICS podczas uruchamiania akcji w przepływie pracy.

Po wygenerowaniu pliku metadanych jako pliku integracji hosta Projektant XML (HIDX) z Projektant HIS możesz dodać ten plik jako artefakt mapy do zasobu aplikacji logiki w warstwie Standardowa. Dzięki temu przepływ pracy może uzyskiwać dostęp do metadanych aplikacji podczas dodawania akcji łą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 aplikacji hosta, a łącznik zwraca wyniki do 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 Połączenie or

W poniższej sekcji opisano operacje łącznika CICS, które obecnie obejmują tylko następującą akcję:

Wywoływanie programu CICS

Parametr	Wymagania	Pisz	Opis
Nazwa HIDX	Tak	Ciąg	Wybierz plik CICS HIDX, którego chcesz użyć.
Nazwa metody	Tak	Ciąg	Wybierz metodę w pliku HIDX, którego chcesz użyć.
Parametry zaawansowane	Nie.	Różne wartości	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 wybrać i użyć z wybraną metodą. Te parametry różnią się w zależności od pliku HIDX i wybranej metody.

Ograniczenia

Obecnie ten łącznik wymaga przekazania pliku HIDX bezpośrednio do zasobu aplikacji logiki w warstwie Standardowa, a nie konta integracji.

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) integration Projektant host, który udostępnia niezbędne metadane dla łącznika wywołania programu CICS w celu wykonania programu mainframe.

Aby utworzyć ten plik HIDX, pobierz i zainstaluj Projektant 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, które są wymagane do dostarczania danych wejściowych z przepływu pracy do programu mainframe i wysyłania wszelkich danych wyjściowych wygenerowanych z programu mainframe 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 Projektant 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 (copybook), które zawierają te informacje.

Narzędzie generuje plik XML (HIDX) integracji hosta Projektant, który udostępnia niezbędne metadane dla łącznika. Jeśli używasz funkcji HIS, możesz użyć Projektant TI, aby utworzyć plik HIDX.
Przepływ pracy standardowej aplikacji logiki, w którym chcesz zintegrować się z systemem CICS

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

Definiowanie i generowanie metadanych

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

Przekazywanie 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 witrynie Azure Portal przekaż plik HIDX jako mapę do zasobu aplikacji logiki w warstwie Standardowa.
Teraz dodaj akcję CICS do przepływu pracy.

W dalszej części tego przewodnika po dodaniu akcji łącznika wywołania programu CICS do przepływu pracy po raz pierwszy zostanie wyświetlony 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.

Dodawanie akcji CICS

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

W tym przykładzie jest kontynuowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.
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	Wymagania	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 i Wybieranie odpowiedniego modelu 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.	<Limitu 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 czy fałsz	Zabezpieczanie połączenia za pomocą protokołu Transport Security Layer (TLS).
Weryfikowanie certyfikatu serwera	Nie.	Prawda czy fałsz	Zweryfikuj certyfikat serwera.
Nazwa pospolita certyfikatu serwera	Nie.	<server-cert-common-name>	Nazwa certyfikatu transport security layer (TLS) do użycia
Korzystanie z formatu nagłówka żądania IBM	Nie.	Prawda czy fałsz	Serwer oczekuje nagłówków ELM lub TRM w formacie IBM

Przykład:

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

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

Parametr	Wymagania	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óżne wartości	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:

Wybieranie pliku i metody HIDX

Screenshot shows CICS action with selected HIDX file and method.

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

Aby uruchomić przepływ pracy, w menu przepływu pracy wybierz pozycję Przegląd. Na pasku narzędzi Przegląd wybierz pozycję Uruchom>.

Po zakończeniu działania przepływu pracy zostanie wyświetlona historia uruchamiania przepływu pracy. Pomyślne kroki pokazują znaczniki wyboru, podczas gdy kroki zakończone niepowodzeniem pokazują 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.

Udostępnij za pośrednictwem