Integrare programmi IMS in mainframe IBM con flussi di lavoro Standard in App per la logica di Azure

Articolo
01/10/2024

Si applica a: App per la logica di Azure (standard)

Per accedere ed eseguire app mainframe IBM in sistemi IMS (Information Management System) da flussi di lavoro Standard in App per la logica di Azure, è possibile usare il connettore predefinito IMS Program Call predefinito basato sul provider di servizi. IMS fornisce un monitoraggio di Transaction Program (TP) con un database integrato di Transaction Manager (TM) e gerarchico. Il connettore comunica con i programmi di transazione IBM IMS usando IMS Connessione, che è un componente di rete TM IMS. Questo componente fornisce comunicazioni ad alte prestazioni per i sistemi IMS tra uno o più client TCP/IP e uno o più sistemi IMS. Il connettore IMS è disponibile in tutte le aree App per la logica di Azure ad eccezione di Azure per enti pubblici e Microsoft Azure gestito da 21Vianet.

Questa guida pratica descrive gli aspetti seguenti relativi al connettore IMS:

Perché usare il connettore IMS in App per la logica di Azure
Prerequisiti e configurazione per l'uso del connettore IMS
Passaggi per l'aggiunta di azioni del connettore IMS al flusso di lavoro dell'app per la logica Standard

Perché usare questo connettore?

I sistemi IMS sono stati uno dei primi sistemi cruciali eseguiti su mainframe. Microsoft Host Integration Server (HIS) fornisce la connettività ai sistemi IMS seguendo due modelli: IMS Connessione e APPC LU6.2. I clienti hanno usato HIS Transaction Integrator (TI) per integrare i propri sistemi IMS con Windows in locale per molti anni. Il connettore IMS Program Call usa il modello di Connessione IMS per interagire con i programmi di transazione IMS tramite TCP/IP.

Il diagramma seguente mostra come il connettore IMS interagisce con un sistema mainframe IBM:

Per estendere questi scenari cloud ibridi, il connettore IMS in un flusso di lavoro Standard funziona con HIS Designer for Logic Apps, che è possibile usare per creare una definizione di programma o una mappa di programma del programma di transazione mainframe. Per questa attività, la finestra di progettazione HIS converte tali informazioni in metadati usati dal connettore IMS durante l'esecuzione di un'azione nel flusso di lavoro.

Dopo aver generato il file di metadati come file HIDX (Host Integration Designer) da HIS Designer, è possibile aggiungere tale file come artefatto mappa alla risorsa dell'app per la logica Standard. In questo modo, il flusso di lavoro può accedere ai metadati dell'app quando si aggiunge un'azione del connettore IMS. Il connettore legge il file di metadati dalla risorsa dell'app per la logica e presenta dinamicamente i parametri da usare con il connettore IMS nel flusso di lavoro. È quindi possibile fornire parametri all'applicazione host e il connettore restituisce i risultati al flusso di lavoro. Di conseguenza, è possibile integrare le app legacy con Azure, Microsoft, altre app, servizi e sistemi supportati da App per la logica di Azure.

Riferimento tecnico Connessione or

La sezione seguente descrive le operazioni per il connettore IMS, che attualmente include solo l'azione seguente:

Chiamare un programma IMS

Parametro	Richiesto	Digita	Descrizione
Nome HIDX	Sì	Stringa	Selezionare il file HIDX IMS da usare.
Nome metodo	Sì	Stringa	Selezionare il metodo nel file HIDX da usare.
Parametri avanzati	No	Variabile	Questo elenco viene visualizzato dopo aver selezionato un metodo in modo che sia possibile aggiungere altri parametri da usare con il metodo selezionato. I parametri disponibili variano in base al file HIDX e al metodo selezionato.

Questa operazione include anche parametri avanzati, visualizzati dopo aver selezionato un metodo, per poter selezionare e usare con il metodo selezionato. Questi parametri variano in base al file HIDX e al metodo selezionato.

Limiti

Attualmente, questo connettore richiede di caricare il file HIDX direttamente nella risorsa dell'app per la logica Standard, non in un account di integrazione.

Prerequisiti

Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
Accesso al mainframe che ospita il sistema IMS
File XML (HIDX) di Progettazione integrazione host che fornisce i metadati necessari per il connettore di chiamata al programma IMS per eseguire il programma mainframe.

Per creare questo file HIDX, scaricare e installare HIS Designer per App per la logica di Azure. L'unico prerequisito è Microsoft .NET Framework 4.8.

Per richiamare un programma mainframe, il flusso di lavoro deve comprendere il tipo, i parametri e i valori restituiti del programma mainframe. Il connettore IMS gestisce il processo e le conversioni dei dati, necessarie per fornire i dati di input dal flusso di lavoro al programma mainframe e per l'invio di tutti i dati di output generati dal programma mainframe al flusso di lavoro. Il connettore fornisce anche la definizione dei dati tabulari e la conversione della tabella codici. Per questo processo, App per la logica di Azure richiede di fornire queste informazioni come metadati.

Per creare questi metadati, usare la finestra di progettazione his per app per la logica. Con questo strumento è possibile creare manualmente i metodi, i parametri e i valori restituiti che è possibile usare nel flusso di lavoro. Lo strumento consente anche di importare definizioni di programma COBOL o RPG (copybook) che forniscono queste informazioni.

Lo strumento genera un file HIDX (Host Integration Designer XML) che fornisce i metadati necessari per il connettore. Se si usa HIS, è possibile usare TI Designer per creare il file HIDX.
Flusso di lavoro dell'app per la logica Standard da usare per l'integrazione con il sistema IMS

Il connettore IMS non dispone di trigger, quindi usare qualsiasi trigger per avviare il flusso di lavoro, ad esempio il trigger Ricorrenza o il trigger Richiesta. È quindi possibile aggiungere le azioni del connettore IMS. Per iniziare, creare un flusso di lavoro vuoto nella risorsa dell'app per la logica Standard.

Definire e generare metadati

Dopo aver scaricato e installato HIS Designer per App per la logica di Azure, seguire questa procedura per generare il file HIDX dall'artefatto dei metadati.

Caricare il file HIDX

Per consentire al flusso di lavoro di usare il file HIDX, seguire questa procedura:

Passare alla cartella in cui è stato salvato il file HIDX e copiare il file.
Nella portale di Azure caricare il file HIDX come mappa alla risorsa dell'app per la logica Standard.
Aggiungere ora un'azione IMS al flusso di lavoro.

Più avanti in questa guida, quando si aggiunge un'azione del connettore di chiamata al programma IMS al flusso di lavoro per la prima volta, viene richiesto di creare una connessione tra il flusso di lavoro e il sistema mainframe. Dopo aver creato la connessione, è possibile selezionare il file HIDX aggiunto in precedenza, il metodo da eseguire e i parametri da usare.

Aggiungere un'azione IMS

Nella portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica Standard nella finestra di progettazione.
Se non è già stato aggiunto un trigger per avviare il flusso di lavoro, seguire questa procedura generale per aggiungere il trigger desiderato.

Questo esempio continua con il trigger Request denominato Quando viene ricevuta una richiesta HTTP.
Per aggiungere un'azione del connettore IMS, seguire questa procedura generale per aggiungere l'azione predefinita Chiamare un programma IMS denominata Chiamare un programma IMS.

Dopo aver visualizzato il riquadro dei dettagli della connessione, specificare le informazioni seguenti:

Parametro	Richiesto	Valore	Descrizione
Nome connessione	Sì	<nome connessione>	Nome per la connessione
ID di sistema IMS	Sì	<IMS-system-ID>	Nome del sistema IMS in cui il modello ims Connessione indirizza le richieste in ingresso
Nome uscita ITOC	No	<ITOC-exit-name>	Nome della routine di uscita utilizzata da IMS per gestire le richieste in ingresso
MFS Mod Name	No	<MFS-Mod-Name>	Nome associato al descrittore di output del messaggio IMS in uscita
Usare l'uscita di sicurezza HWSO1	No	Vero o falso	Il server usa l'uscita di sicurezza HWSO1.
Nome comune del certificato del server	No	<server-cert-common-name>	Nome del certificato TLS (Transport Security Layer) da usare
Tabella codici	No	<tabella codici>	Numero della tabella codici da utilizzare per la conversione del testo
Password	No	<password>	Password utente facoltativa per l'autenticazione della connessione
Numero di porta	Sì	<numero di porta>	Numero di porta da usare per l'autenticazione della connessione
Nome server	Sì	<server-name>	Nome del server
Timeout	No	<Timeout>	Periodo di timeout in secondi durante l'attesa delle risposte dal server
Nome utente	No	<user-Name>	Nome utente facoltativo per l'autenticazione della connessione
Usare TLS	No	Vero o falso	Proteggere la connessione con Transport Security Layer (TLS).
Convalida certificato server	No	Vero o falso	Convalidare il certificato del server.

Ad esempio:

Al termine, selezionare Crea nuovo.

Dopo aver visualizzato il riquadro dei dettagli dell'azione, nella sezione Parametri specificare le informazioni necessarie:

Parametro	Richiesto	Valore	Descrizione
Nome HIDX	Sì	<HIDX-file-name>	Selezionare il file HIDX IMS da usare.
Nome metodo	Sì	<method-name>	Selezionare il metodo nel file HIDX da usare.
Parametri avanzati	No	Variabile	Questo elenco viene visualizzato dopo aver selezionato un metodo in modo che sia possibile aggiungere altri parametri da usare con il metodo selezionato. I parametri disponibili variano in base al file HIDX e al metodo selezionato.

Ad esempio:

Selezionare il file e il metodo HIDX

Selezionare i parametri avanzati

Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Testare il flusso di lavoro

Per eseguire il flusso di lavoro, scegliere Panoramica dal menu del flusso di lavoro. Sulla barra degli strumenti Panoramica selezionare Esegui>esegui.

Al termine dell'esecuzione del flusso di lavoro, viene visualizzata la cronologia di esecuzione del flusso di lavoro. I passaggi riusciti mostrano i segni di spunta, mentre i passaggi non riusciti mostrano un punto esclamativo (!).
Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.
Per esaminare gli output, selezionare Visualizza output non elaborati.