Integrare programmi COBOL e RPG su sistemi IBM midrange con flussi di lavoro Standard in App per la logica di Azure

Articolo
03/09/2024

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

Per accedere ed eseguire programmi COBOL e RPG su sistemi IBM midrange da flussi di lavoro Standard in App per la logica di Azure, è possibile usare il connettore predefinito IBM i Program Call, basato su provider di servizi. Il sistema operativo IBM i fornisce un server DPC (Distributed Program Calls). Il connettore comunica con il server IBM i DPC per eseguire programmi COBOL e RPG tramite TCP/IP. Il connettore IBM i è 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 IBM i:

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

Perché usare questo connettore?

Più di 50 anni fa, IBM ha rilasciato i primi sistemi midrange. IBM li ha annunciati come "Small in size, small in price and Big in performance. È un sistema per il momento e per il futuro". Nel corso degli anni, i sistemi midrange si sono evoluti e sono diventati diffusi in aziende di medie dimensioni o in grandi imprese per estendere gli ambienti mainframe. I sistemi midrange che eseguono IBM i, in genere Power Systems, supportano TCP/IP e SNA.

Il sistema IBM i include la funzionalità server DPC che consente alla maggior parte delle applicazioni IBM i di interagire con i client, ad esempio App per la logica di Azure usando il modello di richiesta-risposta solo avviato dal client con modifiche minime. DPC è un protocollo documentato che supporta l'integrazione da programma a programma in un sistema IBM i, a cui le applicazioni client possono accedere facilmente usando il protocollo di rete TCP/IP.

Microsoft Host Integration Server (HIS) fornisce connettività ai sistemi IBM i usando TCP/IP e APPC LU6.2. Per molti anni, i clienti hanno usato HIS Transaction Integrator (TI) per integrare i sistemi IBM i e Windows in locale. Il connettore IBM i Program Call usa il modello di programmazione TCP/IP per interagire con i programmi IBM i COBOL e RPG.

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

Per estendere questi scenari cloud ibridi, il connettore IBM i 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 COBOL o RPG. Per questa attività, progettazione HIS usa un modello di programmazione che determina le caratteristiche dello scambio di dati tra il midrange e il flusso di lavoro. HIS Designer converte tali informazioni in metadati usati dal connettore IBM i 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 IBM i. Il connettore legge il file di metadati dalla risorsa dell'app per la logica e presenta in modo dinamico i parametri da usare con il connettore IBM i 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 IBM i, che attualmente include solo l'azione seguente:

Chiamare un programma IBM i

Parametro	Richiesto	Type	Descrizione
Nome HIDX	Sì	String	Selezionare il file IBM i HIDX da usare.
Nome metodo	Sì	String	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 midrange che ospita il sistema IBM i
File XML di Host Integration Designer (HIDX) che fornisce i metadati necessari per il connettore IBM i Program Call per eseguire il programma midrange.

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 midrange, il flusso di lavoro deve comprendere il tipo, i parametri e i valori restituiti del programma midrange. Il connettore IBM i gestisce questo processo e le conversioni di dati, necessarie per fornire i dati di input dal flusso di lavoro al programma midrange e per l'invio di tutti i dati di output generati dal programma midrange 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 nel flusso di lavoro. È anche possibile 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 in cui si vuole eseguire l'integrazione con il sistema IBM i

Il connettore IBM i 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 l'azione del connettore IBM i. 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 IBM i al flusso di lavoro.

Più avanti in questa guida, quando si aggiunge un'azione del connettore IBM i Program Call al flusso di lavoro per la prima volta, viene richiesto di creare una connessione tra il flusso di lavoro e il sistema midrange. 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 IBM i

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 IBM i, seguire questa procedura generale per aggiungere l'azione connettore predefinita IBM i Program Call denominata Call an IBM i Program.

Dopo aver visualizzato il riquadro dei dettagli della connessione, specificare le informazioni seguenti, ad esempio il nome del server host e le informazioni di configurazione del sistema IBM i:

Parametro	Richiesto	Valore	Descrizione
Nome connessione	Sì	<nome connessione>	Nome per la connessione
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 IBM i HIDX 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

Screenshot che mostra l'azione IBM i con il file e il metodo HIDX selezionati.

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.