Come configurare una porta di ricezione e un percorso di ricezione per l'adapter MQSC

Configurare una porta di ricezione e un percorso di ricezione per l'adapter BizTalk per WebSphere MQ usando la console di amministrazione di BizTalk Server. È necessario accedere con un account membro del gruppo Amministratori BizTalk Server. Inoltre, è necessario disporre delle autorizzazioni appropriate nel database Single Sign-On (SSO).

Per configurare una porta di ricezione e un percorso di ricezione

1. In Programmi selezionare Microsoft BizTalk Server e quindi BizTalk Server Amministrazione.

2. Nell'albero della console espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione per cui si vuole creare una porta di ricezione.

3. Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi fare clic su Porta di ricezione unidirezionale.

4. Nella finestra Proprietà porta di ricezione configurare le proprietà per la porta e quindi fare clic su OK.

5. Nell'albero della console fare clic con il pulsante destro del mouse su Posizioni di ricezione, scegliere Nuovo e quindi fare clic su Posizione di ricezione unidirezionale.

6. Nella finestra Seleziona porta di ricezione fare clic sulla porta di ricezione creata nel passaggio precedente e quindi fare clic su OK.

7. Nella finestra Proprietà posizione di ricezione selezionare l'adattatore MQSC come Tipo di trasporto e quindi fare clic su Configura.

8. Nella finestra Proprietà trasporto dell'adattatore configurare le proprietà della posizione di ricezione ( fare riferimento alle tabelle alla fine di questa procedura).

   Nota

   Per configurare un percorso di ricezione sono necessarie le proprietà seguenti:

   Nome canale (proprietà con distinzione tra maiuscole e minuscole).

   Connection Name (Nome connessione)

   Tipo di trasporto

   Queue (proprietà con distinzione tra maiuscole e minuscole).

   Gestione code (si tratta di una proprietà con distinzione tra maiuscole e minuscole).

   Se non si specifica una proprietà Channel Name, è necessario specificare un file di definizione del canale client per abilitare il client MQ WebSphere installato nel computer BizTalk Server per comunicare con i gestori code remoti. È inoltre necessario specificare un file di definizione del canale client se si configura Secure Sockets Layer (SSL) per l'uso della messaggistica transazionale. Per altre informazioni, vedere Come configurare un file di definizione del canale client.

9. Al termine della configurazione delle proprietà, fare clic su OK.

10. Nell'elenco Gestore di ricezione della finestra Proprietà percorso di ricezione selezionare l'istanza dell'host BizTalk Server in cui verrà eseguito il percorso di ricezione.

    Il gestore di ricezione deve essere in esecuzione su questo host.

11. Nell'elenco Pipeline di ricezione selezionare la pipeline di ricezione da usare per ricevere messaggi in questo percorso di ricezione.

12. Fare clic su OK.

13. Nella finestra Percorsi di ricezione fare clic con il pulsante destro del mouse sul percorso di ricezione nella colonna Nome e scegliere Abilita.

    Proprietà della posizione di ricezione

    Nella sezione Avanzate della finestra Proprietà trasporto è possibile impostare le proprietà seguenti.

    Usare	Per
    Offset dati per intestazioni	L'adattatore usa i valori delle intestazioni MQSeries (le strutture MQMD, MQXQH, MQIIH e MQCIH) e popola i valori corrispondenti nelle proprietà del contesto BizTalk Server. Per impostazione predefinita queste proprietà MQSeries vengono rimosse dal corpo del messaggio. Impostare su No per mantenere le proprietà nel corpo del messaggio. Impostazione predefinita: Sì
    Soglia di errore registro eventi	Numero massimo dello stesso errore da registrare per determinate condizioni di errore. L'adattatore continua a funzionare e, se l'adapter viene ripristinato, registra l'evento nel registro applicazioni. Valore predefinito: 10
    Ordinato	Impostare su Sì per mantenere l'ordine dei messaggi ricevuti dalla coda MQSeries e inviati al BizTalk Server MessageBox. Per il lato di invio, l'adapter invia il messaggio alla coda nello stesso ordine in cui lo riceve dalla finestra di messaggio. Impostare su No per non mantenere l'ordine dei messaggi. Per l'ordinamento sul lato invio, se non si usa Orchestrazione, è necessario abilitare Recapito ordinato nelle opzioni avanzate trasporto della configurazione della porta di trasmissione. Per l'ordinamento sul lato ricezione, se si usa Orchestration, è necessario impostare anche la proprietà Recapito ordinato su True nell'orchestrazione per la posizione di ricezione. Il recapito ordinato può ridurre le prestazioni; a meno che non sia necessario il recapito ordinato, non è consigliabile. Impostazione predefinita: No
    Arresta in caso di errore	Impostare su Sì per interrompere l'elaborazione se si verifica un errore. La transazione viene terminata e l'indirizzo di ricezione viene disabilitato in caso di errore. Impostazione predefinita: No
    Sospendi come non ripristinabile	Impostare su Sì per spostare un messaggio nella coda sospesa quando si verifica un errore e indicare se è ripristinabile o meno. L'abilitazione di questo valore non mantiene il recapito ordinato quando si verifica un errore, ma consente al percorso di ricezione di continuare a ricevere messaggi. Impostazione predefinita: No
    Transazione supportata	Se impostato su Sì, l'adattatore MQSC funziona insieme al client transazionale esteso (Extended-Client) di WebSphere MQ nel computer BizTalk Server per evitare la perdita di messaggi e garantire il recapito una sola volta dei messaggi. Se impostato su No, può verificarsi la duplicazione dei messaggi. In questo caso, l'adapter usa il client MQ (Base-Client) non transazionale per l'integrazione con MQSeries. Impostazione predefinita: No
    Wait Interval	Quando MQGet viene eseguito per recuperare i messaggi dalla coda MQSeries, è possibile impostare l'opzione MQGMO per Intervallo di attesa. Se nella coda non sono presenti messaggi, l'adapter attende il tempo specificato (in secondi) prima di chiudere la richiesta client. Non appena arrivano i messaggi nella coda, l'adapter inizia a recuperare i messaggi. Impostazione predefinita: 3

    Nella sezione Definizione canale del Finestra Proprietà Transport è possibile impostare le proprietà seguenti.

    Usare	Per
    Nome canale	Nome del canale definito nel computer server MQSeries con cui comunica il client. Deve essere un tipo di canale "Connessione server". Si noti che si tratta di una proprietà con distinzione tra maiuscole e minuscole.
    Connection Name (Nome connessione)	Nome del server MQSeries contenente gestione code e code da cui l'adapter MQSC riceve i messaggi. Per il tipo di trasporto TCP, il formato da specificare è SERVERNAME(PORT). Il numero di porta equivale al numero di porta definito nel listener associato a Gestione code. Il nome del server può anche essere specificato come indirizzo IP. Per LU6.2, specificare il nome lu o il nome del pool LU configurato in Host Integration Server.
    Battito cardiaco	Numero di secondi tra i controlli per verificare che la connessione client/server funzioni. Predefinito: 300
    Password	Password che può essere usata dall'mca quando si tenta di avviare una sessione lu 6.2 sicura con un contratto del cliente microsoft remoto. Il valore iniziale di questa proprietà facoltativa è Null.
    Specifica di crittografia SSL	Definisce un singolo cipherSpec per una connessione SSL che verrà utilizzata dall'endpoint configurato nell'adattatore. Entrambe le estremità di una definizione di canale SSL DI WebSphere MQ devono includere l'attributo e il valore specificato qui deve corrispondere al nome specificato nella fine del server del canale. Il valore è una stringa con una lunghezza massima di 32 caratteri. Obbligatorio solo quando SSL è configurato per la comunicazione tra il client MQSeries e i gestori di code remoti.
    Nome peer SSL	Usato per controllare il nome distinto (noto anche come DN) del certificato dal gestore code peer o dal client all'altra estremità di un canale MQ Di WebSphere. Se il nome distinto ricevuto dal peer non corrisponde a questo valore, il canale non viene avviato. Obbligatorio solo quando SSL è configurato per la comunicazione tra il client MQSeries e gli strumenti di gestione code.
    Tipo di trasporto	TCP e LU6.2 sono supportati. Impostazione predefinita: TCP
    ID utente	Identificatore utente MCA usato da MQSeries MCA per l'autorizzazione ad accedere alle risorse MQSeries. Il valore iniziale è Null. Questa è una proprietà facoltativa. Quando questo attributo è vuoto, il Contratto del cliente microsoft usa l'identificatore utente predefinito.

    Nella sezione MQSeries del Finestra Proprietà Transport è possibile impostare le proprietà seguenti.

    Usare	Per
    Set di caratteri	Set di caratteri su cui convertire il messaggio quando i messaggi vengono ricevuti dalla coda MQSeries. Se questa proprietà è impostata su un valore diverso da Nessuno, l'adattatore imposta l'opzione MQGMO CONVERT durante l'esecuzione di mqGet. Nessuno: non eseguire la conversione. UCS-2 e UTF-16: convertire in questi set di caratteri. In MQSeries non viene fatta distinzione tra essi. UTF-8: convertire nel set di caratteri UTF-8. Predefinito: nessuno
    Segmentazione consentita	Impostare MQSeries in modo che i messaggi segmentati vengano assemblati oppure vengano ricevuti così come sono. Utilizzare Nessuna azione per leggere i messaggi della coda MQSeries senza abilitare la segmentazione. Utilizzare Messaggio completo se si desidera che i messaggi segmentati vengano assemblati da MQSeries prima di essere passati all'adapter. Impostazione predefinita: nessuna azione

    Nella sezione Prestazioni della Finestra Proprietà Trasporto è possibile impostare le proprietà seguenti.

    Usare	Per
    Dimensioni massime batch	Dimensioni massime di un batch di messaggi in KB. Questa proprietà e Il numero massimo di messaggi in Batch interagiscono in modo che il limite sia il valore che l'adapter raggiunge per primo. Predefinito: 100
    Numero massimo messaggi batch	Numero massimo di messaggi da 1 a 10.000 in un batch. Questa proprietà e Dimensioni massime batch interagiscono in modo che il limite sia il valore raggiunto per primo dall'adattatore. Valore predefinito: 10
    Thread	Numero di thread usati per ogni posizione di ricezione. Valore predefinito: 2

    Nella sezione Definizione coda del Finestra Proprietà Trasporto è possibile impostare le proprietà elencate nella tabella seguente.

    Usare	Per
    Coda	Coda MQSeries da cui l'adapter riceverà i messaggi MQGet. Sono supportate code di trasmissione, code locali, code alias. Si noti che si tratta di una proprietà con distinzione tra maiuscole e minuscole.
    Gestione code	Nome di MQSeries Queue Manager che contiene le code da cui l'adapter recupererà i messaggi. Sono supportati i gestori code in cluster. Si noti che si tratta di una proprietà con distinzione tra maiuscole e minuscole.

14. Fare clic su OK.

Vedere anche

Adattatore BizTalk per WebSphere MQ
Come configurare un file di definizione del canale client
Come configurare una porta di trasmissione per l'adapter MQSC