Questo argomento contiene le seguenti sezioni:
Utilizzare il nodo MQeInput per ricevere i messaggi dai client che si connettono al broker utilizzando il protocollo WebSphere MQ Mobile Transport.
Il nodo MQeInput riceve messaggi inseriti in un flusso di messaggi proveniente da una coda bridge specificata sul gestore di code WebSphere MQ Everyplace del broker. Il nodo stabilisce inoltre l'ambiente di elaborazione per i messaggi. E' necessario creare e configurare il gestore code WebSphere MQ Everyplace prima di distribuire un flusso di messaggi contenente questo nodo.
I flussi di messaggi che gestiscono i messaggi ricevuti attraverso le connessioni WebSphere MQ Everyplace devono sempre iniziare con un nodo MQeInput. E' possibile impostare le proprietà del nodo MQeInput per controllare il modo in cui vengono ricevuti i messaggi. Ad esempio, è possibile indicare che un messaggio venga elaborato sotto il controllo della transazione.
Quando si distribuiscono i flussi di messaggi contenenti nodi WebSphere MQ Everyplace su un broker, è necessario distribuirli su un singolo gruppo di esecuzione, indipendentemente dal numero di flussi di messaggi. I nodi WebSphere MQ Everyplace nei flussi devono specificare tutti lo stesso nome gestore code WebSphere MQ Everyplace. Se questa restrizione non viene rispettata, durante la distribuzione si verifica un errore.
Il nodo MQeInput gestisce i messaggi nei seguenti domini di messaggi:
Se si include un nodo di output in un flusso di messaggi che inizia con un nodo MQeInput, questo può essere un nodo di output qualsiasi tra quelli supportati, compresi i nodi di output definiti dall'utente; non è necessario includere un nodo MQeOutput. E' possibile creare un flusso di messaggi che riceve i messaggi dai client WebSphere MQ Everyplace e crea messaggi per i client che utilizzano uno qualsiasi dei trasporti supportati per connettersi al broker, poiché è possibile configurare il flusso di messaggi per richiedere al broker di fornire tutte le conversioni necessarie.
WebSphere MQ Everyplace Versione 1.2.6 è utilizzato da WebSphere Message Broker. E' compatibile con le versioni successive di WebSphere MQ Everyplace. I client che utilizzano versioni successive di WebSphere MQ Everyplace, ad esempio, la Versione 2.0, operano correttamente quando sono connessi a questo nodo, sebbene la funzionalità aggiuntiva non supportata nella Versione 1.2.6 (ad esempio il supporto JMS) non sia operativa.
I gestori code non sono intercambiabili tra le diverse versioni di WebSphere MQ Everyplace. I nodi devono utilizzare un gestore code creato con la Versione 1.2.6. Allo stesso modo, il client deve utilizzare il proprio livello di coda quando crea un gestore code.
Non è possibile utilizzare i nodi MQeInput nei flussi di messaggi distribuiti sui sistemi z/OS.
Se si crea un flusso di messaggi da utilizzare come flusso secondario, non è possibile utilizzare un nodo di input standard: è necessario utilizzare un'istanza del nodo Input come primo nodo per creare un terminale in per il flusso secondario.
Se il flusso di messaggi non riceve messaggi attraverso le connessioni WebSphere MQ, è possibile scegliere uno tra questi altri nodi di input.
Il nodo MQeInput è rappresentato nel workbench dalla seguente icona:
Per avere un esempio di come utilizzare questo nodo, immaginare un agricoltore che controlli i suoi campi per vedere se sono ben irrigati. L'agricoltore sta portando un'unità PDA con WebSphere MQ Everyplace installato. Individua un'area del campo che ha bisogno di acqua, quindi, utilizzando l'unità PDA e un link Global Satellite Navigation, invia un messaggio ad un nodo MQeInput. I dati vengono manipolati utilizzando un nodo Compute e viene pubblicato un messaggio da un nodo Publication in modo che l'unità remota SCADA possa ricevere il messaggio e azionare gli impianti di irrigazione. L'agricoltore assisterà all'irrigazione del campo in pochi minuti dall'invio del messaggio.
E' possibile trovare ulteriori informazioni su WebSphere MQ Everyplace e sulle proprietà del nodo, nella documentazione di WebSphere MQ Everyplace sulla pagina Web WebSphere MQ.
Una volta inserita un'istanza del nodo MQeInput in un flusso di messaggi, è possibile configurarla. Fare clic con il tasto destro del mouse sul nodo nella vista dell'editor e fare clic su Proprietà. Le proprietà predefinite del nodo vengono visualizzate nella finestra di dialogo delle proprietà.
Tutte le proprietà obbligatorie, per le quali è necessario immettere un valore (quelle per le quali non è specificato un valore predefinito), sono contrassegnate con un asterisco nella finestra di dialogo delle proprietà.
Configurare il nodo MQeInput come segue:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type> <Fmt>XML</Fmt></mcd>
Se si impostano i valori e quei valori sono diversi da quelli nell'intestazione MQRFH2, i valori dell'intestazione MQRFH2 hanno la precedenza.
Lasciare il campo Serie di messaggi vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Lasciare il campo Tipo messaggio vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME, BLOB e IDOC.
Lasciare il campo Formato del messaggio vuoto per i programmi di analisi XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Se si imposta il livello di traccia su Debug o Completo, questo avrà effetto sulle prestazioni di WebSphere MQ Everyplace ed è possibile che siano generati dei file di traccia significativi. Utilizzare queste opzioni solo per brevi periodi di tempo.
Se si seleziona la casella di spunta, la definizione di tutte le proprietà viene estratta dal file identificato da Nome file di configurazione (descritto sotto) tranne:
Può essere supportato solo un gestore code WebSphere MQ Everyplace. Solo un gruppo di esecuzione può contenere i nodi MQeInput o MQeOutput. Questa proprietà deve essere quindi impostata sullo stesso valore in ogni nodo MQeInput incluso in ogni flusso di messaggi che si distribuisce allo stesso broker.
Poiché i canali sono entità logiche permanenti che durano più a lungo rispetto a una singola richiesta del gestore code e possono sopravvivere alle interruzioni di rete, potrebbe essere necessario far scadere i canali che sono stati inattivi per un periodo di tempo.
Fare clic su Annulla per chiudere la finestra di dialogo ed eliminare tutte le modifiche apportate alle proprietà.
MQeInput instrada ogni messaggio che richiama con esito positivo al terminale out. Se questa operazione non riesce, si ripete il messaggio. Se il timeout per i nuovi tentativi scade (come definito dall'attributo BackoutThreshold della coda di input), il messaggio viene instradato al terminale failure; è possibile connettere nodi a questo terminale per gestire tale condizione. Se il terminale failure non è stato connesso, il messaggio viene scritto nella coda di ripristino allo stato precedente.
Se il messaggio viene rilevato da questo nodo dopo che è stata generata un'eccezione nel successivo avanzamento del flusso di messaggi, il messaggio viene instradato al terminale catch. Se il terminale catch non è stato connesso, il messaggio entra in loop continuo attraverso il nodo fino alla risoluzione del problema. E' necessario definire una coda di ripristino allo stato precedente o una coda DLQ (dead-letter queue) per impedire il loop continuo del messaggio nel nodo.
Quando si include un nodo MQeInput in un flusso di messaggi, il valore che si imposta per la proprietà Modalità transazione definisce l'eventuale ricezione dei messaggi nel punto di sincronizzazione:
(Il nodo MQOutput è l'unico nodo di output che è possibile configurare per sovrascrivere questa opzione.)
I terminali del nodo MQeInput sono descritti nella seguente tabella.
Terminale | Descrizione |
---|---|
Failure | Il terminale di output a cui è instradato il messaggio se si verifica un errore. |
Out | Il terminale di output a cui è instradato il messaggio, se è richiamato con esito positivo dalla coda WebSphere MQ Everyplace. |
Catch | Il terminale di output a cui è instradato il messaggio se viene generata un'eccezione nel proseguimento dell'elaborazione e questo nodo la rileva. |
Le seguenti tabelle descrivono le proprietà del nodo; la colonna con l'intestazione O indica se la proprietà è obbligatoria (contrassegnata con un asterisco nella finestra di dialogo delle proprietà, se è necessario immettere un valore quando non è specificato un valore predefinito), la colonna con l'intestazione C indica se la proprietà è configurabile (è possibile modificare il valore quando si aggiunge un flusso di messaggi a un file bar per distribuirlo).
Le proprietà Predefinite del nodo MQeInput sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Dominio messaggi | No | No | Il dominio che sarà utilizzato per analizzare il messaggio in entrata. | |
Serie di messaggi | No | No | Il nome o identificativo della serie di messaggi in cui è definito il messaggio in entrata. | |
Tipo messaggio | No | No | Il nome del messaggio in entrata. | |
Formato del messaggio | No | No | Il nome del formato fisico del messaggio in entrata. | |
Argomento | No | Sì | L'argomento predefinito per il messaggio di input. |
Le proprietà Generali del nodo MQeInput sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Nome coda | Sì | Sì | Il nome della coda bridge WebSphere MQ Everyplace da cui questo nodo richiama i messaggi per l'elaborazione da parte di questo flusso di messaggi. | |
Traccia | Sì | No | Nessuno | Il livello di traccia richiesto per questo nodo. I valori validi sono Nessuno, Standard, Debug e Completo. |
Nome file di traccia | Sì | Sì | \MQeTraceFile.trc | Il nome del file su cui sono scritti i record di traccia. |
Modalità transazione | Sì | No | Sì | Indica se il messaggio in entrata viene ricevuto nel punto di sincronizzazione. I valori validi sono Automatico, Sì e No. |
Utilizza file di configurazione | Sì | No | Deselezionata | Utilizzare un file di configurazione per questo nodo. Questa azione viene eseguita se si seleziona la casella di spunta. |
Nome file di configurazione | Sì | Sì | \MQeconfig.ini | Il nome del file di configurazione da utilizzare se la casella di spunta Utilizza file di configurazione è selezionata. |
Nome gestore code | Sì | Sì | ServerQM1 | Il nome del gestore code WebSphere MQ Everyplace. |
Le proprietà Canale del nodo MQeInput sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Numero massimo di canali | Sì | No | 0 | Il numero massimo di canali supportati dal gestore code WebSphere MQ Everyplace. |
Le proprietà Registro del nodo MQeInput sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Tipo | Sì | Sì | Registro file | Il tipo di informazioni registro da utilizzare. I valori validi sono Registro file e Registro privato. |
Directory | Sì | Sì | \ServerQM1\registry | La directory in cui è presente il file di registro (valido solo se Registro file è selezionato). |
PIN | Sì | Sì | Il PIN associato al gestore code WebSphere MQ Everyplace (valido solo se Registro privato è selezionato). | |
PIN di richiesta certificato | Sì | Sì | Il PIN utilizzato per richiedere l'autenticazione (valido solo se Registro privato è selezionato). | |
Password di keyring | Sì | Sì | La password utilizzata per visualizzare le chiavi crittografiche (valido solo se Registro privato è selezionato). | |
Host Certificato | Sì | Sì | Il nome del server dei certificati (valido solo se Registro privato è selezionato). | |
Porta Certificato | Sì | Sì | La porta del server dei certificati (valido solo se Registro privato è selezionato). |
Le proprietà Listener del nodo MQeInput sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Tipo listener | Sì | Sì | Http | Il tipo di adattatore per il listener. I valori validi sono Http, Lunghezza e Cronologia. |
Nome Host | Sì | Sì | 127.0.0.1 | Il nome host del server. |
Porta | Sì | Sì | 8081 | La porta su cui WebSphere MQ Everyplace è in ascolto. |
Intervallo di Tempo | Sì | Sì | 300 | L'intervallo di polling di WebSphere MQ Everyplace, specificato in secondi. |
Le proprietà Descrizione del nodo MQeInput sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Descrizione breve | No | No | Una breve descrizione del nodo. | |
Descrizione completa | No | No | Testo che descrive lo scopo del nodo nel flusso di messaggi. |