Condividi tramite

Progettazione di artefatti di metadati per applicazioni host CICS o IMS

  • Articolo

Questa guida illustra come progettare artefatti di metadati per applicazioni host CICS o IMS. È quindi possibile salvare questi artefatti di metadati come file HIDX (Host Integration Server Definition XML) da usare con i connettori incorporati CICS e IMS predefiniti del provider di servizi in App per la logica di Azure.

Prerequisiti

  • Scaricare e installare Visual Studio. Dopo l'installazione, assicurarsi di installare anche il carico di lavoro denominato Sviluppo desktop con C++ in Visual Studio. In caso contrario, viene visualizzato l'errore Eccezione dal 0x800A007C HRESULT.

  • Scaricare e installare l'Designer HIS per App per la logica di Azure. L'unico prerequisito è Microsoft .NET Framework 4.8.

  • Abilitare il supporto di Visual Studio per il processore di file flat in App per la logica di Azure. Per eseguire questa attività, seguire questa procedura:

    1. Aprire Visual Studio. Sulla barra degli strumenti aprire il menu Strumenti e selezionare Opzioni.

    2. Nell'elenco Opzioni espandere Host Integration Server e selezionare File host.

    3. Nella scheda Ambiente host selezionare Includi supporto per Processore file flat e App per la logica.

      Includere il supporto per la finestra di dialogo Processore file flat e App per la logica

Creare un progetto di applicazione host

In Visual Studio è possibile usare il modello di progetto Applicazione host per creare artefatti di metadati. È quindi possibile usare questi artefatti con i connettori predefiniti CICS e IMS basati su provider di servizi nei flussi di lavoro Standard per App per la logica di Azure. Per creare un nuovo progetto di applicazione host, seguire questa procedura:

  1. In Visual Studio scegliere Nuovo>progetto dal menu File.

  2. Nell'elenco dei modelli di progetto selezionare Applicazione> hostAvanti.

  3. Nella casella Configura il nuovo progetto modificare i dettagli desiderati e selezionare Crea.

    Screenshot che mostra Visual Studio e i dettagli per Configurare il nuovo progetto.

Aggiungere una definizione del client .NET

Per supportare i connettori CICS e IMS in App per la logica di Azure, è necessario aggiungere una definizione client .NET.

  1. In Esplora soluzioni aprire il menu di scelta rapida del nuovo progetto applicazione host e selezionare Aggiungi aggiungi>definizione client .NET.

  2. Quando viene visualizzata la casella Aggiungi nuovo elemento , nella proprietà Name specificare un nome per la definizione del client .NET e selezionare Aggiungi.

    Questi passaggi continuano con il nome di esempio NetClnt1.

  3. Dopo l'avvio della definizione guidata client .NET, nella casella Libreria specificare un nome per l'interfaccia da usare per identificare la libreria client .NET che si vuole creare.

    Questo esempio continua con il nome dell'interfaccia IInterface1:

    Screenshot che mostra la procedura guidata Definizione client .NET e la casella Libreria.

  4. Al termine, selezionare Avanti.

  5. Nella casella Ambiente remoto identificare il mainframe remoto o l'ambiente midrange e il modello di programmazione da usare fornendo le informazioni seguenti:

    Parametro Valore o azione
    Fornitore Microsoft
    Protocollo Selezionare il protocollo di rete appropriato per accedere al sistema mainframe o midrange:

    - TCP
    - HTTP
    - LU 6.2 (non supportato per i connettori di App per la logica di Azure)
    Ambiente di destinazione Selezionare il sistema di destinazione:

    - CICS
    - IMS
    - System i
    - System Z
    - Chiamata al programma distribuito di sistema i
    Modello di programmazione Selezionare un modello di programmazione.
    Lingua host Selezionare la lingua in uso: COBOL o RPG
    Consenti 32K in/out Selezionare questa opzione per usare l'intera 32K dell'area dati COMMAREA quando si usa il modello LINK.

  6. Al termine, selezionare Crea.

Al termine della procedura guidata, viene visualizzata la visualizzazione struttura principale per creare o importare manualmente gli artefatti dei metadati. Per questa attività, passare alla sezione successiva.

Progettare un artefatto di metadati

Questa sezione illustra come creare manualmente un artefatto di metadati. Per importare invece una definizione host, vedere Importazione di definizioni host.

Nella tabella seguente sono elencati i componenti della visualizzazione struttura principale:

Componente Descrizione
Nodo componente Radice dell'artefatto di metadati. Archivia informazioni sulla libreria client e sull'ambiente remoto.
Nodo dell'interfaccia Raggruppa tutti i metodi in un componente.
Cartella Tabelle dati Raggruppa le tabelle dati nell'assembly.
Cartella Strutture Raggruppa le variabili con attributi condivisi.
Cartella Unions Rappresenta l'equivalente delle unioni COBOL.

Aggiungere un metodo

Per l'artefatto di metadati, è possibile aggiungere un metodo per esporre la logica di business del programma mainframe ai flussi di lavoro in App per la logica di Azure.

  1. Nella visualizzazione struttura principale aprire il menu di scelta rapida della nuova interfaccia e selezionare Aggiungi metodo.

    Screenshot che mostra la visualizzazione struttura principale, il menu di scelta rapida dell'interfaccia e l'opzione selezionata per Aggiungi metodo.

  2. Aprire il menu di scelta rapida del metodo e selezionare Proprietà. Specificare i valori per le proprietà del metodo in base alle proprietà del metodo dell'articolo.

Aggiungere un parametro o un valore restituito

Dopo aver aggiunto un metodo, è possibile definire i parametri e un valore restituito per passare e ricevere dati tra il programma mainframe e i flussi di lavoro in App per la logica di Azure.

  1. Nella visualizzazione struttura principale aprire il menu di scelta rapida del nuovo metodo e selezionare Aggiungi parametro.

    Screenshot che mostra la visualizzazione struttura principale, il menu di scelta rapida del metodo e l'opzione selezionata per Aggiungi parametro.

  2. Aprire il menu di scelta rapida del parametro e selezionare Proprietà. Specificare i valori per le proprietà del parametro in base alla tabella seguente:

    Proprietà Descrizione o valore
    Matrice is Se true, è necessario impostare le dimensioni della matrice, che supportano matrici con un massimo di 7 dimensioni e 16.777.215 elementi. È inoltre necessario immettere i valori per le proprietà della matrice Si verifica conteggio in e si verifica a seconda di.
    Tipo di dati Tipo di dati .NET del parametro
    Nome Nome del parametro
    Direzione parametro Direzione del parametro del metodo: In, In/Out o Out
    Gestione degli errori Attivare un errore, arrotondare o troncare.
    Tipo di dati host Tipo di dati COBOL o RPG del parametro
    Precisione Precisione dei dati del parametro
    Riempimento finale Per i parametri in cui la lunghezza è minore del valore massimo specificato, è necessario specificare le dimensioni del riempimento.

    Screenshot che mostra nuovi parametri e proprietà.

  3. Aprire il menu di scelta rapida del nuovo metodo e selezionare Aggiungi valore restituito.

    Screenshot che mostra la visualizzazione struttura principale, il menu di scelta rapida del metodo e l'opzione selezionata per Aggiungi valore restituito.

  4. Aprire il menu di scelta rapida del valore restituito e selezionare Proprietà. Specificare i valori per le proprietà del valore restituito in base alla tabella seguente:

    Proprietà Descrizione o valore
    Matrice is Se true, è necessario impostare le dimensioni della matrice, che supportano matrici con un massimo di 7 dimensioni e 16.777.215 elementi. È inoltre necessario immettere i valori per le proprietà della matrice Si verifica conteggio in e si verifica a seconda di.
    Tipo restituito Tipo di dati .NET del valore restituito
    Valore restituito posizionato dopo Indicare la posizione del valore restituito rispetto ai parametri.
    Usare l'area di lavoro TICS Valore booleano che specifica di utilizzare un'area di lavoro a 256 byte, che viene mantenuta su connessioni persistenti e viene inserita all'inizio dei dati.
    Gestione degli errori Attivare un errore, arrotondare o troncare.
    Tipo di dati host Tipo di dati COBOL o RPG del valore restituito
    Precisione Precisione dei dati del parametro
    Riempimento finale Per i parametri in cui la lunghezza è minore del valore massimo specificato, è necessario specificare le dimensioni del riempimento.

    Screenshot che mostra il nuovo valore restituito e le nuove proprietà.

Aggiungere una tabella dati

  1. Nella visualizzazione struttura principale aprire il menu di scelta rapida DataTables e selezionare Aggiungi DataTable.

    Screenshot che mostra la visualizzazione struttura principale, il menu di scelta rapida DataTable e l'opzione selezionata per Aggiungi DataTable.

  2. Aprire il menu di scelta rapida della nuova tabella dati e selezionare Aggiungi colonna DataTable. Ripetere questo passaggio in base alle esigenze.

  3. Aprire il menu di scelta rapida della nuova colonna e selezionare Proprietà. Specificare i valori per le proprietà di ogni colonna in base alla tabella seguente:

    Proprietà Descrizione o valore
    Tipo di dati Tipo di dati .NET della colonna
    Nome Nome della colonna
    Gestione degli errori Attivare un errore, arrotondare o troncare.
    Tipo di dati host Tipo di dati COBOL o RPG della colonna
    Precisione Precisione dei dati della colonna
    Riempimento finale Per le colonne in cui la lunghezza è inferiore al valore massimo specificato, è necessario specificare le dimensioni del riempimento.

    Screenshot che mostra nuove proprietà e colonne.

Aggiungere una struttura

  1. Nella visualizzazione struttura principale aprire il menu di scelta rapida Strutture e selezionare Aggiungi Struct.

    Screenshot che mostra la visualizzazione struttura principale, il menu di scelta rapida Strutture e l'opzione selezionata per Aggiungi Struct.

    La finestra di progettazione crea una struttura con un membro.

  2. Per aggiungere un altro membro, aprire il menu di scelta rapida della nuova struttura e selezionare Aggiungi membro struttura. Ripetere questo passaggio in base alle esigenze.

  3. Aprire il menu di scelta rapida del membro e selezionare Proprietà. Specificare i valori per le proprietà di ogni membro in base alla tabella seguente:

    Proprietà Descrizione o valore
    Matrice is Se true, è necessario impostare le dimensioni della matrice, che supportano matrici con un massimo di 7 dimensioni e 16.777.215 elementi. È inoltre necessario immettere i valori per le proprietà della matrice Si verifica conteggio in e si verifica a seconda di.
    Tipo di dati Tipo di dati .NET del membro
    Nome Nome del membro
    Gestione degli errori Attivare un errore, arrotondare o troncare.
    Tipo di dati host Tipo di dati COBOL o RPG del membro
    Precisione Precisione dei dati del membro
    Riempimento finale Per i membri in cui la lunghezza è minore del valore massimo specificato, è necessario specificare le dimensioni del riempimento.

    Screenshot che mostra il nuovo membro e le proprietà della struttura.

Aggiungere un'unione

  1. Nella visualizzazione struttura principale aprire il menu di scelta rapida Unions e selezionare Aggiungi unione.

    Screenshot che mostra la visualizzazione struttura principale, il menu di scelta rapida Unions e l'opzione selezionata per Aggiungi unione.

    La finestra di progettazione crea un'unione con due membri.

  2. Per aggiungere un altro membro, aprire il menu di scelta rapida della nuova unione e selezionare Aggiungi membro unione. Ripetere questo passaggio in base alle esigenze.

  3. Aprire il menu di scelta rapida del membro e selezionare Proprietà. Specificare i valori per le proprietà di ogni membro in base alla tabella seguente:

    Proprietà Descrizione o valore
    Matrice is Se true, è necessario impostare le dimensioni della matrice, che supportano matrici con un massimo di 7 dimensioni e 16.777.215 elementi. È inoltre necessario immettere i valori per le proprietà della matrice Si verifica conteggio in e si verifica a seconda di.
    Tipo di dati Tipo di dati .NET del membro. Questo valore può includere strutture definite nella sezione precedente.
    Nome Nome del membro
    Gestione degli errori Attivare un errore, un round o un troncamento.
    Tipo di dati host Tipo di dati COBOL o RPG del membro
    Precisione Precisione dei dati del membro
    Riempimento finale Per i membri in cui la lunghezza è minore del massimo specificato, è necessario specificare le dimensioni del riempimento.

    Screenshot che mostra il nuovo membro e le proprietà dell'unione.

  4. Al termine, continuare alla sezione successiva per creare la libreria che archivia la progettazione dei metadati.

Creare l'elemento XML di definizione di integrazione host (HIDX) o metadati

Questa sezione descrive come creare la libreria che archivia la progettazione dell'artefatto dei metadati.

  1. Per generare l'artefatto dei metadati, nel menu o nella barra degli strumenti file di Visual Studio selezionare Salva tutto. (Tastiera: premere CTRL+MAIUSC+S)

    Screenshot che mostra la barra degli strumenti di Visual Studio con l'opzione di selezione salva tutto.

  2. Per trovare il file HIDX generato, passare alla cartella dell'applicazione host.

    Screenshot che mostra la finestra Output di Visual Studio con il percorso del file HIDX.

Contenuti correlati