Integrare 3270 app basate sullo schermo in mainframe IBM con Azure usando App per la logica di Azure e il connettore IBM 3270

  • Articolo

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

Per accedere ed eseguire app mainframe IBM, in genere eseguite spostandosi tra le schermate dell'emulatore 3270, dai flussi di lavoro a consumo e standard in App per la logica di Azure, è possibile usare il connettore IBM 3270. In questo modo, è possibile integrare le app IBM mainframe con Azure, Microsoft e altre app, servizi e sistemi creando flussi di lavoro automatizzati con App per la logica di Azure. Il connettore comunica con i mainframe IBM usando il protocollo TN3270. Il connettore IBM 3270 è 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 3270 :

  • Perché usare il connettore IBM 3270 in App per la logica di Azure

  • In che modo il connettore IBM 3270 esegue app basate sullo schermo 3270

  • Prerequisiti e configurazione per l'uso del connettore IBM 3270

  • Passaggi per l'aggiunta di azioni del connettore IBM 3270 al flusso di lavoro

Perché usare questo connettore?

Per accedere alle app nei mainframe IBM, in genere si usa un emulatore di terminale 3270, spesso denominato "schermo verde". Questo metodo è un modo testato nel tempo, ma presenta limitazioni. Anche se Host Integration Server (HIS) consente di lavorare direttamente con queste app, talvolta la separazione dello schermo e della logica di business potrebbe non essere possibile. In alternativa, forse non si hanno più informazioni sul funzionamento delle applicazioni host.

Per estendere questi scenari, il connettore IBM 3270 in App per la logica di Azure funziona con lo strumento di progettazione 3270, usato per registrare o "acquisire", le schermate host usate per un'attività specifica, definire il flusso di spostamento per tale attività tramite l'app mainframe e definire i metodi con parametri di input e output per tale attività. Lo strumento di progettazione converte tali informazioni in metadati usati dal connettore 3270 durante l'esecuzione di un'azione nel flusso di lavoro.

Dopo aver generato il file di metadati dallo strumento di progettazione 3270, tale file viene aggiunto come artefatto mappa alla risorsa dell'app per la logica Standard o all'account di integrazione collegato per un'app per la logica a consumo in App per la logica di Azure. In questo modo, il flusso di lavoro può accedere ai metadati dell'app quando si aggiunge un'azione del connettore IBM 3270 . Il connettore legge il file di metadati dalla risorsa dell'app per la logica (Standard) o dall'account di integrazione (consumo), gestisce lo spostamento tra le schermate 3270 e presenta dinamicamente i parametri da usare con il connettore 3270 nel flusso di lavoro. È quindi possibile fornire dati all'applicazione host e il connettore restituisce i risultati al flusso di lavoro. Di conseguenza, è possibile integrare le app legacy con Azure, Microsoft e altre app, servizi e sistemi supportati App per la logica di Azure.

Riferimento tecnico Connessione or

Il connettore IBM 3270 ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.

App per la logica Ambiente versione di Connessione ion
Consumo App per la logica di Azure multi-tenant Connettore gestito, visualizzato nella finestra di progettazione sotto l'etichetta Enterprise . Questo connettore fornisce solo un'azione singola e nessun trigger. Per altre informazioni, vedere Informazioni di riferimento sul connettore gestito IBM 3270.
Standard App per la logica di Azure a tenant singolo e ambiente del servizio app v3 (A edizione Standard v3 solo con piani di Windows) Connettore gestito, visualizzato nella raccolta connettori in Runtime>Condiviso e connettore predefinito basato su provider di servizi, visualizzato nella raccolta connettori in Runtime>in-App. La versione predefinita è diversa nei modi seguenti: -

- Il connettore predefinito richiede di caricare il file HIDX nella risorsa dell'app per la logica Standard, non in un account di integrazione.

- Il connettore predefinito può connettersi direttamente a un server 3270 e accedere alle reti virtuali di Azure usando un stringa di connessione.

- La versione predefinita supporta l'autenticazione server con crittografia TLS (SSL) per i dati in transito, la codifica dei messaggi per il funzionamento e l'integrazione della rete virtuale di Azure.

Per altre informazioni, vedere la documentazione seguente:

- Informazioni di riferimento sul connettore gestito IBM 3270
- Informazioni di riferimento sul connettore predefinito IBM 3270

Informazioni di riferimento sul connettore predefinito

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

Eseguire un piano di spostamento

Parametro Richiesto Digita Descrizione
Nome HIDX Sì Stringa Selezionare il file HIDX 3270 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.

Prerequisiti

  • Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.

  • Accesso al server TN3270 che ospita l'app guidata dallo schermo 3270

  • File XML di Host Integration Designer (HIDX) che fornisce i metadati necessari per il connettore IBM 3270 per eseguire l'app guidata dallo schermo 3270.

    Per creare questo file HIDX, scaricare e installare lo strumento di progettazione 3270. L'unico prerequisito è Microsoft .NET Framework 4.8.

    Questo strumento consente di registrare schermate, percorsi di spostamento, metodi e parametri per le attività nell'app aggiunte ed eseguite come azioni del connettore 3270. Lo strumento genera un file XML di Host Integration Designer (HIDX) che fornisce i metadati necessari per il connettore per eseguire l'app guidata dallo schermo 3270.

    Dopo aver scaricato e installato questo strumento, seguire questa procedura per connettersi al server host TN3270, progettare l'artefatto di metadati richiesto e generare il file HIDX.

  • La risorsa e il flusso di lavoro dell'app per la logica standard o a consumo in cui si vuole eseguire l'app basata sullo schermo 3270

    Il connettore IBM 3270 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 3270.

  • Un account di integrazione, necessario in base alla versione del connettore 3270 usata ed è una risorsa di Azure in cui è possibile archiviare centralmente elementi B2B, ad esempio partner commerciali, contratti, mappe, schemi e certificati da usare con azioni specifiche del flusso di lavoro.

    Workflow Descrizione
    Standard - 3270 connettore predefinito: caricare il file HIDX nella risorsa dell'app per la logica Standard.

    - Connettore gestito 3270: caricare il file HIDX nella risorsa dell'app per la logica Standard o nell'account di integrazione collegato.
    Consumo Connettore gestito 3270: caricare il file HIDX nell'account di integrazione collegato.

    Per altre informazioni, vedere Caricare il file HIDX.

Caricare il file HIDX

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

  1. Passare alla cartella in cui è stato salvato il file HIDX e copiare il file.

  2. Nella portale di Azure scegliere i passaggi seguenti, in base alla versione del connettore:

  3. Aggiungere ora un'azione IBM 3270 al flusso di lavoro.

Più avanti in questa guida, quando si aggiunge un'azione del connettore IBM 3270 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 IBM 3270

Un flusso di lavoro di app per la logica Standard può usare il connettore gestito IBM 3270 e il connettore predefinito IBM 3270. Tuttavia, un flusso di lavoro dell'app per la logica a consumo può usare solo il connettore gestito IBM 3270. Ogni versione ha azioni diverse. In base al fatto che si disponga di un flusso di lavoro di app per la logica a consumo o standard, seguire la procedura corrispondente:

  1. Nella portale di Azure aprire la risorsa dell'app per la logica Standard e il flusso di lavoro in cui è già stato aggiunto un trigger.

  2. Se non è già stato aggiunto un trigger, seguire questa procedura generale per aggiungere il trigger desiderato al flusso di lavoro.

    Questo esempio continua con il trigger Request denominato Quando viene ricevuta una richiesta HTTP.

  3. Seguire questi passaggi generali per aggiungere l'azione connettore predefinita IBM 3270 denominata Esegui un piano di spostamento.

  4. Quando viene visualizzata la casella delle informazioni di connessione, specificare i valori dei parametri necessari seguenti:

    Proprietà Richiesto Valore Descrizione
    Nome connessione Sì <nome connessione> Nome della connessione
    Tabella codici No <tabella codici> Numero della tabella codici per l'host da utilizzare per la conversione del testo. Se lasciato vuoto, il connettore usa 37 come valore predefinito.
    Tipo di dispositivo No <IBM-terminal-model> Nome o numero del modello per il terminale IBM da emulare. Se lasciato vuoto, il connettore usa i valori predefiniti.
    Schermate delle eccezioni del log No Vero o falso Registrare la schermata host se si verifica un errore durante lo spostamento dello schermo.
    Nome unità logica No <logical-unit-name> Nome dell'unità logica specifica da richiedere dall'host
    Numero di porta No <TN3270-server-port> Porta usata dal server TN3270. Se lasciato vuoto, il connettore usa 23 come valore predefinito.
    Server Sì <TN3270-server-name> Nome del server per il servizio TN3270
    Timeout No <timeout-seconds> Durata del timeout in secondi durante l'attesa delle schermate
    Usare TLS No Attivato o disattivato Attivare o disattivare la crittografia TLS.
    Convalidare il certificato del server TN3270 No Attivato o disattivato Attivare o disattivare la convalida per il certificato del server.

    Ad esempio:

    Screenshot shows Azure portal, Standard workflow designer, and IBM 3270 connection properties.

  5. Al termine, selezionare Crea nuovo.

  6. Quando viene visualizzata la casella delle informazioni sull'azione, specificare i valori dei parametri necessari:

    Proprietà Richiesto Valore Descrizione
    Nome HIDX Sì <HIDX-file-name> Selezionare il file HIDX 3270 da usare.
    Nome metodo Sì <method-name> Selezionare il metodo nel file HIDX da usare. Dopo aver selezionato un metodo, viene visualizzato l'elenco Aggiungi nuovo parametro in modo da poter selezionare i parametri da usare con tale metodo.
    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 HIDX

    Screenshot shows Standard workflow designer, 3270 action, and selected HIDX file.

    Selezionare il metodo

    Screenshot shows Standard workflow designer, 3270 action, and selected method.

    Selezionare i parametri

    Screenshot shows Standard workflow designer, 3270 action, and more parameters.

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

Testare il flusso di lavoro

  1. Per eseguire il flusso di lavoro, nella finestra di progettazione selezionare il menu flusso di lavoro, selezionare Panoramica. 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 (!).

  2. Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.

  3. Per esaminare gli output, selezionare Visualizza output non elaborati.

  4. Per esaminare gli input e gli output per ogni passaggio, espandere tale passaggio.

  5. Per esaminare gli output, selezionare Visualizza output non elaborati.

Passaggi successivi