Nodo AggregateControl

Questo argomento contiene le seguenti sezioni:

Scopo

Utilizzare il nodo AggregateControl per contrassegnare l'inizio di un fan-out di richieste che fanno parte di un'aggregazione.

L'aggregazione è un'estensione del modello di applicazione di richiesta/replica. Essa unisce la creazione e il fan-out di un numero di richieste correlate al fan-in delle repliche corrispondenti e compila tali repliche in un singolo messaggio di replica aggregato.

La funzione di aggregazione è fornita dai tre seguenti nodi:

  1. Il nodo AggregateControl contrassegna l'inizio di un fan-out di richieste che fanno parte di un'aggregazione. Esso invia un messaggio di controllo che viene utilizzato dal nodo AggregateReply per la corrispondenza con le diverse richieste fatte. Le informazioni trasmesse dal terminale control includono l'identificativo del broker, la proprietà nome aggregazione e la proprietà timeout. Le informazioni relative all'aggregazione, aggiunte al componente Environment del messaggio dal nodo AggregateControl non vanno modificate.
  2. Il nodo AggregateRequest registra il fatto che i messaggi di richiesta sono stati inviati. Esso raccoglie anche informazioni che sono di supporto al nodo AggregateReply nella creazione del messaggio di replica aggregato. Le informazioni aggiunte al componente Environment del messaggio dal nodo AggregateRequest vanno conservate altrimenti l'aggregazione avrà esito negativo.
  3. Il nodo AggregateReply contrassegna la fine del fan-in di un'aggregazione. Esso raccoglie le repliche e le combina in un singolo messaggio di replica aggregato.

Il nodo AggregateControl è rappresentato nel workbench dalla seguente icona:

Icona del nodo AggregateControl

Utilizzo di questo nodo in un flusso di messaggi

Fare riferimento ai seguenti esempi per capire come utilizzare questo nodo: esempio per capire come utilizzare questo nodo:

Configurazione del nodo AggregateControl

Una volta inserita un'istanza del nodo AggregateControl 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 AggregateControl come segue:

  1. Immettere un valore per Nome aggregazione. Questo nome è utilizzato per associare il flusso di messaggi fan-out con il flusso di messaggi fan-in. Questo valore deve essere contestualmente univoco all'interno del broker. Questa proprietà è obbligatoria; è necessario immettere un valore.
  2. Immettere un valore per Timeout. Il valore va specificato in secondi. E' necessario immettere un valore (o accettare il valore iniziale indicato, 0) poiché questa proprietà è obbligatoria. Se si accetta il valore, il timeout è disabilitato per i fan-out da questo nodo (cioè, si attendono le repliche per un tempo indeterminato). Se non si ricevono tutte le risposte, il flusso di messaggi continua l'attesa e non viene completato. Quindi, si consiglia di impostare un valore maggiore di 0. Fare riferimento alla sezione Nodo AggregateReply per ulteriori informazioni circa i timeout.
  3. Selezionare Descrizione nel Navigator della finestra di dialogo delle proprietà per immettere una descrizione breve, una descrizione completa o entrambe.
  4. Fare clic su Applica per effettuare le modifiche al nodo AggregateControl 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à.

Terminali e proprietà

I terminali del nodo AggregateControl sono descritti nella seguente tabella.

Terminale Descrizione
In Il terminale di input che accetta un messaggio affinché venga elaborato dal nodo.
Out Il terminale di output a cui è instradato il messaggio originale quando l'elaborazione è completata con esito positivo.
Control Il terminale di output a cui è instradato un messaggio di controllo. Il messaggio di controllo è inviato al nodo AggregateReply corrispondente.
Nota: il terminale Control è considerato obsoleto nella Versione 6.0, per utilizzare le connessioni dal terminale Control, consultare Utilizzo dei messaggi di controllo nei flussi di aggregazione.

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à base del nodo AggregateControl sono descritte nella seguente tabella.

Proprietà O C Valore predefinito Descrizione
Nome aggregazione   Un nome che può essere utilizzato per associare il flusso di messaggi fan-out al flusso di messaggi fan-in.
Timeout (sec) No 0 Il periodo di tempo, in secondi, in cui si attende l'arrivo delle repliche nel fan-in.
Nota: su z/OS, se la proprietà Timeout non è impostata su zero, impostare il parametro del gestore code EXPRYINT su 5.

Le proprietà Descrizione del nodo AggregateControl 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.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ac04740_