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

Dotyczy: Azure Logic Apps (Standardowa)

Aby uzyskać dostęp do i uruchamiać aplikacje mainframe IBM w systemach systemu zarządzania informacjami (IMS) z przepływów pracy w warstwie Standardowa w usłudze Azure Logic Apps, możesz użyć wbudowanego łącznika wywołania programu IMS opartego na dostawcy usług. Usługa IMS udostępnia monitor programu transakcji (TP) ze zintegrowaną bazą danych Menedżera transakcji (TM) i hierarchiczną bazą danych. Łącznik komunikuje się z programami transakcji IBM IMS przy użyciu usługi IMS Połączenie, który jest składnikiem sieciowym usługi IMS TM. Ten składnik zapewnia komunikację o wysokiej wydajności dla systemów IMS między co najmniej jednym klientem TCP/IP i co najmniej jednym systemem IMS. Łącznik IMS 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 usługi IMS:

  • Dlaczego warto używać łącznika IMS w usłudze Azure Logic Apps

  • Wymagania wstępne i konfiguracja korzystania z łącznika usługi IMS

  • Kroki dodawania akcji łącznika usługi IMS do przepływu pracy aplikacji logiki w warstwie Standardowa

Dlaczego warto używać tego łącznika?

Systemy IMS 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 IMS, wykonując dwa modele: imS Połączenie i APPC LU6.2. Klienci korzystali z integratora transakcji HIS (TI) do integracji systemów IMS z systemem Windows w środowisku lokalnym od wielu lat. Łącznik wywołania programu IMS używa modelu Połączenie IMS do interakcji z programami transakcji IMS za pośrednictwem protokołu TCP/IP.

Na poniższym diagramie pokazano, jak łącznik IMS współdziała z systemem mainframe IBM:

Conceptual diagram shows how the IMS Program Call connector works with IBM mainframe system.

Aby rozszerzyć te scenariusze chmury hybrydowej, łącznik IMS w przepływie pracy w warstwie Standardowa współpracuje z Projektant HIS dla usługi Logic Apps, których można użyć do utworzenia definicji programu lub mapy programu transakcji mainframe. W tym zadaniu Projektant HIS konwertuje te informacje na metadane używane przez łącznik IMS 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 standardowej aplikacji logiki. Dzięki temu przepływ pracy może uzyskiwać dostęp do metadanych aplikacji podczas dodawania akcji łącznika IMS. Łącznik odczytuje plik metadanych z zasobu aplikacji logiki i dynamicznie przedstawia parametry do użycia z łącznikiem IMS 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 IMS, który obecnie obejmuje tylko następującą akcję:

Wywoływanie programu IMS

Parametr Wymagania Pisz Opis
Nazwa HIDX Tak Ciąg Wybierz plik IMS 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 IMS

  • Plik HIDX (Host Integration Integration Projektant XML), który udostępnia metadane niezbędne dla łącznika wywołania programu IMS 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 IMS zarządza procesami 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órych można użyć w przepływie pracy. Narzędzie umożliwia również importowanie definicji programów COBOL lub RPG (copybook), które dostarczają 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 do użycia do integracji z systemem IMS

    Łącznik usługi IMS 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 IMS. 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:

  1. Przejdź do folderu, w którym zapisano plik HIDX, i skopiuj plik.

  2. W witrynie Azure Portal przekaż plik HIDX jako mapę do zasobu aplikacji logiki w warstwie Standardowa.

  3. Teraz dodaj akcję IMS do przepływu pracy.

W dalszej części tego przewodnika po dodaniu akcji łącznika wywołania programu IMS 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 IMS

  1. W witrynie Azure Portal otwórz zasób aplikacji logiki w warstwie Standardowa i przepływ pracy w projektancie.

  2. 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.

    Screenshot shows Azure portal, Standard workflow designer, and Request trigger.

  3. Aby dodać akcję łącznika IMS, wykonaj następujące ogólne kroki, aby dodać akcję wbudowanego łącznika wywołania programu IMS o nazwie Wywołaj program IMS.

  4. Po pojawieniu się okienka szczegółów połączenia podaj następujące informacje:

    Parametr Wymagania Wartość Opis
    Nazwa połączenia Tak <nazwa połączenia> Nazwa połączenia
    Identyfikator systemu IMS Tak <IMS-system-ID> Nazwa systemu IMS, w którym model imS Połączenie kieruje żądania przychodzące
    Nazwa zakończenia ITOC Nie. <ITOC-exit-name> Nazwa procedury zakończenia używanej przez usługę IMS do obsługi żądań przychodzących
    Nazwa moda MFS Nie. <MFS-Mod-Name> Nazwa skojarzona z deskryptorem wyjściowym wychodzącego komunikatu IMS
    Korzystanie z zakończenia zabezpieczeń HWSO1 Nie. Prawda czy fałsz Serwer korzysta z zakończenia zabezpieczeń HWSO1.
    Nazwa pospolita certyfikatu serwera Nie. <server-cert-common-name> 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. <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.

    Przykład:

    Screenshot shows IMS action's connection properties.

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

  6. 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 IMS 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 IMS action with selected HIDX file and method.

    Wybieranie parametrów zaawansowanych

    Screenshot shows IMS action with all parameters.

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

Testowanie przepływu pracy

  1. 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 (!).

  2. Aby przejrzeć dane wejściowe i wyjściowe dla każdego kroku, rozwiń ten krok.

  3. Aby przejrzeć dane wyjściowe, wybierz pozycję Zobacz nieprzetworzone dane wyjściowe.

Następne kroki