Questo argomento contiene le seguenti sezioni:
Utilizzare il nodo MQReply per inviare una risposta all'origine del messaggio di input. MQReply è una forma specializzata del nodo MQOutput che inserisce il messaggio di output nella coda WebSphere MQ identificata dal campo ReplyToQ dell'intestazione del messaggio di input. Se appropriato, è possibile definire la coda come coda cluster o coda condivisa WebSphere MQ.
Il nodo MQReply applica le opzioni impostate nel campo relativo al prospetto in MQMD. Per impostazione predefinita (se non sono impostate opzioni), il nodo MQReply genera un nuovo MsgID e CorrelID nel messaggio di replica. Se l'applicazione di ricezione prevede altri valori in questi campi è necessario assicurarsi che l'applicazione che inserisce il messaggio nella coda di input del flusso di messaggi imposti le opzioni di prospetto richieste o che si impostino le opzioni appropriate all'interno di MQMD durante l'elaborazione del messaggio nel flusso di messaggi. Ad esempio, utilizzare un nodo Compute per impostare le opzioni Prospetto nel messaggio.
E' possibile trovare ulteriori informazioni sul campo Prospetto nel manuale WebSphere MQ Application Programming Reference.
Il nodo MQReply è rappresentato nel workbench dalla seguente icona:
Fare riferimento al seguente esempio per capire come utilizzare questo nodo:
Potrebbe essere appropriato utilizzare questo nodo quando si riceve un ordine da un cliente. Quando il messaggio relativo all'ordine viene elaborato, viene inviata una risposta al cliente che conferma la ricezione dell'ordine e fornisce una data possibile per la consegna.
Una volta inserita un'istanza del nodo MQReply 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à. Vengono visualizzate le proprietà base del nodo.
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 MQReply come segue:
Ulteriori informazioni sulle opzioni legate a questa proprietà sono disponibili nel manuale WebSphere MQ Application Programming Reference.
Per ulteriori dettagli fare riferimento a Convalida dei messaggi e Proprietà della convalida per i messaggi nel dominio MRM.
Fare clic su Annulla per chiudere la finestra di dialogo ed eliminare tutte le modifiche apportate alle proprietà.
Il messaggio di replica viene inserito (utilizzando MQPUT) nella coda denominata nell'MQMD del messaggio di input come coda ReplyTo. Non è possibile modificare questa destinazione.
Connettere il terminale out o failure di questo nodo ad un altro nodo in questo flusso di messaggi se si desidera elaborare ulteriormente il messaggio, elaborare errori o inviare il messaggio ad una destinazione aggiuntiva.
Se si connette uno di questi terminali di output ad un altro nodo nel flusso di messaggi, la struttura ad albero LocalEnvironment associata al messaggio viene arricchita con le seguenti informazioni per ogni destinazione in cui il messaggio è stato inserito:
Questi valori sono scritti in WrittenDestination all'interno della struttura ad albero LocalEnvironment.
Se non si connette uno di questi terminali di output, la struttura ad albero LocalEnvironment rimane immutata.
Se si utilizza l'aggregazione nei flussi di messaggi, è necessario utilizzare questi terminali out.
Quando si definisce un nodo MQReply, l'opzione che si seleziona per la proprietà Modalità transazione definisce l'eventuale scrittura del messaggio nel punto di sincronizzazione:
Un'altra proprietà del nodo MQReply, Modalità permanenza, definisce se il messaggio di output è contrassegnato come permanente quando è inserito sulla coda di output:
I terminali del nodo MQReply sono descritti nella seguente tabella.
Terminale | Descrizione |
---|---|
In | Il terminale di input che accetta un messaggio affinché venga elaborato dal nodo. |
Failure | Il terminale di output a cui è instradato il messaggio se si rileva un errore quando il messaggio è inserito nella coda di output. |
Out | Il terminale di output a cui il messaggio è instradato se è stato inserito nella coda di output con esito positivo e se è richiesta ulteriore elaborazione all'interno di questo flusso di messaggi. |
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à Avanzate del nodo MQReply sono descritte nella seguente tabella.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Segmentazione consentita | Sì | No | Deselezionata | Se appropriato, WebSphere MQ suddivide il messaggio in segmenti nel gestore code. Questa azione viene eseguita se si seleziona la casella di spunta. |
Modalità permanenza | Sì | No | Automatico | Indica se il messaggio è inserito in modo permanente. I valori validi sono Automatico, Sì, No e Come definito per la coda. |
Modalità transazione | Sì | No | Automatico | Indica se il messaggio è inserito in modo transazionale. I valori validi sono Automatico, Sì e No. |
Le proprietà Convalida del nodo MQReply sono descritte nella seguente tabella.
Fare riferimento a Proprietà della convalida per i messaggi nel dominio MRM per una descrizione completa di queste proprietà.
Proprietà | O | C | Valore predefinito | Descrizione |
---|---|---|---|---|
Convalida | Sì | Sì | Eredita | Indica se viene effettuata la convalida. I valori validi sono Nessuno, Contenuto e valore, Contenuto ed Eredita. |
Azione in caso di errore | Sì | No | Eccezione | Indica cosa accade se la convalida ha esito negativo. E' possibile impostare questa proprietà solo se si imposta Convalida su Contenuto o Contenuto e valore. I valori validi sono Traccia utente, Registrazione errori locale, Eccezione ed Elenco di eccezioni. |
Includi tutti i vincoli valore | Sì | No | Selezionata | Questa proprietà non può essere modificata. L'azione predefinita, indicata dalla casella di spunta selezionata, è che i controlli del vincolo del valore base sono inclusi nella convalida Contenuto e valore. |
Correzione | Sì | No | Nessuno | Questa proprietà non può essere modificata. |
Le proprietà Descrizione del nodo MQReply 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. |
Il nodo MQReply inoltre ha le seguenti proprietà a cui non è possibile avere accesso e che non si possono modificare attraverso l'interfaccia workbench. Tuttavia, questi valori sono utilizzati dal broker quando il messaggio viene elaborato nel flusso di messaggi.
Proprietà | Descrizione |
---|---|
Nome gestore code | Il nome del gestore code WebSphere MQ in cui è definita la coda di output, identificata in Nome coda. Questo nome è richiamato dal campo ReplyTo di MQMD del messaggio di input. |
Nome coda | Il nome della coda WebSphere MQ in cui è inserito il messaggio di output. Questo nome è richiamato dal campo ReplyTo di MQMD del messaggio di input. |
Destinazione | Questa proprietà ha sempre il valore replica. |