Nodo MQReply

Questo argomento contiene le seguenti sezioni:

Scopo

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:

Icona del nodo MQReply

Utilizzo di questo nodo in un flusso di messaggi

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.

Configurazione del nodo MQReply

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:

  1. Selezionare la casella di spunta Segmentazione consentita se si desidera che WebSphere MQ suddivida il messaggio in segmenti nel gestore code, se appropriato. E' necessario anche impostare MQMF_SEGMENTATION_ALLOWED nel campo MsgFlags in MQMD affinché si verifichi la segmentazione.

    Ulteriori informazioni sulle opzioni legate a questa proprietà sono disponibili nel manuale WebSphere MQ Application Programming Reference.

  2. Selezionare la Modalità permanenza che si desidera per il messaggio di output.
    • Se si seleziona Automatico (impostazione predefinita), la permanenza è quella specificata nel messaggio in entrata.
    • Se si seleziona , il messaggio è inserito in modo permanente.
    • Se si seleziona No, il messaggio è inserito in modo non permanente.
    • Se si seleziona Come definito per la coda, la permanenza del messaggio è impostata come quella definita per la coda WebSphere MQ.
  3. Selezionare la Modalità transazione che si desidera per il messaggio di output.
    • Se si seleziona Automatico (valore predefinito), la transazionalità del messaggio deriva da come è stata specificata nel nodo MQInput.
    • Se si seleziona , il messaggio è inserito in modo transazionale.
    • Se si seleziona No, il messaggio è inserito in modo non transazionale.
  4. Selezionare Convalida nel Navigator della finestra di dialogo delle proprietà se si desidera che il programma di analisi MRM convalidi il contenuto dei messaggi rispetto al dizionario generato dalla serie di messaggi. (Se un messaggio è trasmesso al terminale failure del nodo, non viene convalidato.)

    Per ulteriori dettagli fare riferimento a Convalida dei messaggi e Proprietà della convalida per i messaggi nel dominio MRM.

  5. Selezionare Descrizione nel Navigator della finestra di dialogo delle proprietà per immettere una descrizione breve, una descrizione completa o entrambe.
  6. Fare clic su Applica per effettuare le modifiche al nodo MQReply senza chiudere la finestra di dialogo delle proprietà. Fare clic su OK per applicare le modifiche e chiudere la finestra di dialogo delle proprietà.

    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.

Connessione dei terminali di output ad un altro nodo

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:

  • Nome coda
  • Nome gestore code
  • Identificativo replica del messaggio (impostato sullo stesso valore dell'ID del messaggio)
  • ID Messaggio (da MQMD)
  • ID correlazione (da MQMD)

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.

Configurazione delle transazioni coordinate

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:

  • Se si seleziona , il messaggio è scritto nel punto di sincronizzazione (cioè, all'interno di un'unità di lavoro WebSphere MQ).
  • Se si seleziona Automatico (valore predefinito), il messaggio è scritto nel punto di sincronizzazione, se il messaggio di input in entrata è contrassegnato come permanente.
  • Se si seleziona No, il messaggio non è scritto 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:

  • Se si seleziona , il messaggio è contrassegnato come permanente.
  • Se si seleziona Automatico (valore predefinito) la permanenza del messaggio è determinata dalle proprietà del messaggio in entrata, come impostato in MQMD (il descrittore del messaggio WebSphere MQ).
  • Se si seleziona No, il messaggio non è contrassegnato come permanente.
  • Se si seleziona Come definito per la coda, la permanenza del messaggio è impostata come definito nella coda WebSphere MQ dal nodi MQReply specificando l'opzione MQPER_PERSISTENCE_AS_Q_DEF in MQMD.

Terminali e proprietà

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 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 No Automatico Indica se il messaggio è inserito in modo permanente. I valori validi sono Automatico, , No e Come definito per la coda.
Modalità transazione No Automatico Indica se il messaggio è inserito in modo transazionale. I valori validi sono Automatico, 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 Eredita Indica se viene effettuata la convalida. I valori validi sono Nessuno, Contenuto e valore, Contenuto ed Eredita.
Azione in caso di errore 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 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 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.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ac04580_