Adapter BizTalk per la configurazione DB2 - HIS

Informazioni generali

L'adapter Microsoft BizTalk per DB2 connette BizTalk Server ai dati vitali archiviati in IBM mainframe DB2 per z/OS, IBM midrange DB2 per IBM i e IBM server DB2 in esecuzione nei sistemi operativi Linux, UNIX e Windows. L'adattatore si basa sul provider di dati Microsoft ADO.NET per DB2 e supporta un'ampia gamma di funzioni, tra cui porta di invio e porta di ricezione con transazioni distribuite tra connessioni di rete SNA e TCP/IP. Usando i comandi SQL definiti nelle procedure guidate di configurazione delle porte, i professionisti IT possono creare facilmente soluzioni che integrano in modo efficiente i database DB2 senza scrivere codice.

L'adattatore svolge due funzioni principali:

  • Per le operazioni send (One Way e Solicit Response), l'adapter invia comandi SQL e stored procedure a un'istanza db2, con l'opzione di richiedere una risposta.

  • Per le operazioni di ricezione (solo unidirezionale), l'adapter crea un comando SQL o una stored procedure che esegue il polling di oggetti DB2 e crea messaggi per riga, che vengono quindi inviati al sistema di messaggi BizTalk.

    Inoltre, l'adapter BizTalk per DB2 usa lo strumento di traccia dell'adapter BizTalk standard come meccanismo di risoluzione dei problemi.

Creare una porta di trasmissione DB2

Accedere con un account membro del gruppo Amministratori di BizTalk Server.

  1. In Amministrazione bizTalk Server espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione.

  2. Fare clic con il pulsante destro del mouse su Porte di trasmissione, selezionare Nuovo e quindi porta di trasmissione statica unidirezionale.

  3. Nelle proprietà della porta di trasmissione impostare Il tipo di trasporto su DB2. Selezionare Configura e immettere le proprietà seguenti:

    Usare questo Per farlo
    BulkCopyBatchSize La proprietà BulkCopyBatchSize indica all'adapter il numero di righe da elaborare per transazione batch. Questa proprietà facoltativa accetta un valore intero . Il valore predefinito è 20. Il valore 0 indica all'adapter di elaborare tutte le righe in un singolo batch.
    CommandTimeout La proprietà CommandTimeout imposta il tempo di attesa prima che l'adapter termini un tentativo di eseguire un comando e quindi generare un errore. Questa proprietà facoltativa accetta un valore intero . Il valore predefinito è 30 secondi. Il valore 0 indica che non è previsto alcun limite (un tentativo di esecuzione di un comando attenderà un tempo illimitato).
    stringa di connessione Nome di una stringa di connessione utilizzata per connettersi al database DB2.

    Per configurare una stringa di connessione nuova o esistente, fare clic sui puntini di sospensione (...). Verrà avviata la Creazione guidata di origine dati.

    Per accedere alla Guida, fare clic su Guida nelle pagine della procedura guidata o aprire la Guida di Host Integration Server e consultare la sezione Creazione guidata origine dati (DB2).
    Set di registri DB2 La proprietà DB2 Set Registers indica all'adapter di eseguire una o più istruzioni SQL SET. Questa proprietà facoltativa accetta un valore stringa . Il valore predefinito è una stringa vuota, che indica nessuna istruzione. La sintassi supportata è un elenco delimitato da punti e virgola di comandi dell'istruzione SET con un elenco separato da virgole di valori dell'istruzione SET "<SET comando 1> spazio <SET valore 1> punto e virgola; <SET comando 2> spazio <SET valore a> virgola <SET valore b> punto e virgola"). Ad esempio, immettere "SET CURRENT PATH 'DSN8910', 'HISDEMO'".
    Spazio dei nomi di destinazione del documento Spazio dei nomi di destinazione utilizzato nei documenti XML inviati a DB2.
    Response Root Element Name Nome dell'elemento radice utilizzato nei documenti XML ricevuti da DB2. Questa proprietà potrebbe essere vuota nel caso di una porta unidirezionale.
    URI Identificatore di risorsa uniforme. Un nome per identificare l'ubicazione della porta di invio. Il valore predefinito è DB2://.
    UseBulkCopy La proprietà UseBulkCopy indica all'adapter di elaborare i comandi INSERT della porta di trasmissione in modalità di copia bulk per migliorare le prestazioni. Questa proprietà facoltativa accetta un valore booleano . Il valore predefinito è false.
  4. Selezionare OK per salvare le modifiche.

  5. Per il gestore di invio, selezionare l'istanza host per eseguire l'adapter e selezionare la pipeline di invio.

  6. Selezionare OK per salvare le modifiche.

  7. In Porte di invio, fare clic con il pulsante destro del mouse sulla nuova porta di invio e selezionare Enlist e quindi Start.

Creare una porta di ricezione DB2

Accedere con un account membro del gruppo Amministratori di BizTalk Server.

  1. In Amministrazione bizTalk Server espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione.

  2. Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi porta di ricezione unidirezionale. Configurare le proprietà e selezionare OK.

  3. Fare clic con il pulsante destro del mouse su Percorsi di ricezione, scegliere Nuovo e quindi selezionare Posizione di ricezione unidirezionale. Selezionare la porta di ricezione appena creata e quindi fare clic su OK.

  4. Nelle proprietà della posizione di ricezione impostare il tipo di trasporto su DB2. Selezionare Configura e immettere le proprietà seguenti:

    Usare questo Per farlo
    CommandTimeout La proprietà CommandTimeout imposta il tempo di attesa prima che l'adapter termini un tentativo di eseguire un comando e quindi generare un errore. Questa proprietà facoltativa accetta un valore intero. Il valore predefinito è 30 secondi. Il valore 0 indica che non è previsto alcun limite (un tentativo di esecuzione di un comando attenderà un tempo illimitato).
    stringa di connessione Immettere il nome di una stringa di connessione che verrà usata per connettersi al database DB2.

    Per configurare una stringa di connessione nuova o esistente, fare clic sui puntini di sospensione (...). Questa operazione avvia la procedura guidata origine dati. Per accedere alla Guida, fare clic su Guida nelle pagine della procedura guidata oppure aprire la Guida di Host Integration Server e consultare Creazione guidata origine dati (DB2).
    Set di registri DB2 La proprietà DB2 Set Registers indica all'adapter di eseguire una o più istruzioni SQL SET. Questa proprietà facoltativa accetta un valore stringa. Il valore predefinito è una stringa vuota, che indica nessuna istruzione. La sintassi supportata è un elenco delimitato da punti e virgola dei comandi dell'istruzione SET con un elenco separato da virgole dei valori dell'istruzione SET "<SET command 1> spazio <SET valore 1> punto e virgola; <SET comando 2> spazio <SET valore a> virgola <SET valore b> punto e virgola"). Ad esempio, immettere "SET CURRENT PATH 'DSN8910', 'HISDEMO'".
    Nome dell'elemento radice del documento Nome dell'elemento radice utilizzato nei documenti XML ricevuti da DB2.
    Namespace di destinazione del documento Spazio dei nomi di destinazione utilizzato nei documenti XML ricevuti da DB2.
    Comando SQL Il comando SELECT o stored procedure che viene eseguito una volta per ogni intervallo di polling.
    Comando Aggiorna Comando eseguito dopo l'elaborazione di ogni riga nell'operazione di ricezione. Può trattarsi di un'istruzione delete che elimina la riga dalla tabella nel comando SQL o un comando di aggiornamento che modifica in modo statico una o più righe. Quando si specifica questa opzione, il comando SQL deve essere un'istruzione Select e deve accedere a una singola tabella.
    URI Nome che identifica la posizione della porta di ricezione. Il valore predefinito è DB2://.
    Intervallo di sondaggio Numero di unità tra le richieste di interrogazione. L'intervallo consentito è compreso tra 1 e 65535.
    Unità di misura del polling Unità di misura (secondi, minuti o ore) usata tra le richieste di polling. Il valore predefinito è secondi.
  5. Selezionare OK per salvare le modifiche.

  6. Per il gestore di ricezione, selezionare l'istanza host per eseguire l'adapter. Il gestore di ricezione deve essere in esecuzione in questo host. Selezionare la pipeline di ricezione. . Selezionare OK per salvare le modifiche.

  7. In Posizioni di ricezione, fare clic con il pulsante destro del mouse sulla posizione di ricezione e quindi Abilita.

Creare uno schema dell'adapter DB2

  1. Aprire il progetto di Visual Studio BizTalk.

  2. Fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi, selezionare Aggiungi elementi generati e quindi selezionare Aggiungi.

  3. Nella finestra di dialogo Aggiungi elementi generati selezionare Aggiungi metadati adapter.

  4. Nella procedura guidata Aggiungi adattatore, nella pagina Seleziona adattatore, selezionare DB2. Nell'elenco Porta selezionare una porta di trasmissione o un percorso di ricezione configurato e quindi selezionare Avanti.

  5. Nella procedura guidata di generazione dello schema adapter DB2:

    1. In Informazioni database creare una stringa di connessione o selezionare una stringa di connessione esistente.

    2. In Informazioni schema definire lo spazio dei nomi predefinito, gli elementi radice e il tipo di porta da usare nello schema.

      Se si seleziona Porta di ricezione, è necessario solo un nome dell'elemento radice del documento di richiesta. Se si seleziona Porta di trasmissione, sono necessari sia i nomi degli elementi radice del documento di richiesta che di risposta.

    3. In Informazioni sul tipo di istruzione selezionare il tipo di comando di database da rilasciare.

      Se sono state selezionate le porte di ricezione nella pagina precedente, è possibile scegliere un'istruzione SELECT SQL o una stored procedure. Se sono state selezionate porte di trasmissione nella pagina precedente, è possibile scegliere di rilasciare un updategram, una stored procedure o un'istruzione SELECT.

    4. In Informazioni sulla dichiarazione, immettere i dettagli relativi al database DB2. A seconda delle informazioni immesse in precedenza, sono disponibili le proprietà seguenti:

      1. Ricevi istruzione SELECT nella finestra di dialogo Informazioni istruzione, digita un'istruzione SQL SELECT nella casella di immissione dello script SQL. Facoltativamente, fare clic su Sfoglia per caricare un file di testo contenente un'istruzione .

      2. Ricevi una stored procedure nella finestra di dialogo Informazioni sull'istruzione, fare clic su un nome di stored procedure. Nell'elenco Parametri fare clic sulla casella di controllo Valore per ogni parametro necessario.

      3. Invia Updategram nella finestra di dialogo Informazioni istruzione, fare clic su un nome di tabella. Nell'elenco Parametri fare clic sulla casella di controllo Valore per ogni colonna richiesta. Quando si usa BulkCopy, è necessario fare clic su ogni casella di controllo Valore per selezionare tutte le colonne.

      4. Invia stored procedure nella finestra di dialogo Informazioni istruzione fare clic su un nome stored procedure. Nell'elenco Parametri fare clic sulla casella di controllo Valore per ogni parametro necessario.

      5. Invia istruzione Select nella finestra di dialogo Informazioni sull'istruzione, digitare un'istruzione SQL SELECT nella casella di modifica dello script SQL. Facoltativamente, fare clic su Sfoglia per caricare un file di testo contenente un'istruzione .

  6. Selezionare Fine per completare la procedura guidata.

A questo momento è disponibile uno schema.