Una specifica di attivazione JMS viene associata a uno o più MDB (Message Driven Bean) e fornisce la configurazione necessaria perché ricevano messaggi.
Una specifica di attivazione JMS viene creata se si desidera utilizzare un MDB per comunicare con il provider dei messaggi predefinito tramite JCA (Java EE Connector Architecture) 1.5. JCA fornisce una connettività Java tra server delle applicazioni come WebSphere Application Server e sistemi di informazioni enterprise. Esso fornisce un metodo standard per l'integrazione dei provider JMS con i server delle applicazioni Java EE e fornisce una struttura per lo scambio di dati con i sistemi enterprise, in cui i dati vengono trasferiti sotto forma di messaggi.
Tutte le proprietà di configurazione della specifica di attivazione, tranne Nome, Nome JNDI, Nome JNDI di destinazione e Alias di autenticazione vengono sovrascritte dalle proprietà di attivazione-configurazione denominate in maniera appropriata nel descrittore di distribuzione di un MDB (Message-Driven Beab) EJB 2.1 o successivo associato. Per un MDB EJB 2.0, le proprietà Tipo destinazione, Durata sottoscrizione, Modalità riconoscimento e Selettore messaggi vengono sostituite dai corrispondenti elementi nel descrittore distribuzione. Per ciascun tipo di bean, la proprietà Nome JNDI di destinazione può essere sostituita da un valore specificato nei bind MDB.
Le proprietà della specifica di attivazione influiscono sul modo in cui il provider dei messaggi predefinito sceglie il motore di messaggistica a cui si connette l'applicazione MDB (message-driven bean). Per impostazione predefinita, l'ambiente collega automaticamente le applicazioni ad un motore di messaggistica disponibile sul bus. È tuttavia possibile specificare dettagli di configurazione aggiuntivi per controllare il processo di connessione; ad esempio, per identificare speciali server di avvio o per limitare la connessione a un sottogruppo di motori di messaggistica disponibili o per migliorare la disponibilità o le prestazioni oppure per garantire l'elaborazione sequenziale dei messaggi ricevuti. Per informazioni su come e perché eseguire questa operazione, fare riferimento alla sezione Modalità tramite cui le applicazioni JMS si connettono ad un motore di messaggistica su un bus.
La scheda Configurazione mostra le proprietà di configurazione per questo oggetto. Questi valori delle proprietà vengono mantenuti anche se l'ambiente di runtime viene arrestato e riavviato. Vedere le descrizioni delle attività del centro informazioni per i dettagli su come applicare le modifiche di configurazione all'ambiente di runtime.
Specifica il livello topologico più alto su cui i server delle applicazioni possono utilizzare questo oggetto di risorse.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Specifica un provider JMS che abilita la messaggistica asincrona in base a Java Message Service (JMS). Fornisce factory di connessione J2EE per creare connessioni per specifiche destinazioni code o argomenti JMS. Gli oggetti amministrativi dei provider JMS vengono utilizzati per gestire le risorse JMS per i provider JMS associati.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Specifica il nome di visualizzazione richiesto della risorsa.
| Informazioni | Valore |
|---|---|
| Obbligatorio | Sì |
| Tipo dati | Stringa |
Il nome JNDI per la risorsa.
| Informazioni | Valore |
|---|---|
| Obbligatorio | Sì |
| Tipo dati | Stringa |
Una descrizione facoltativa della risorsa.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Area di testo |
Specifica se l'MDB (Message Driven Bean) utilizza una destinazione coda o argomento.
| Informazioni | Valore |
|---|---|
| Obbligatorio | Sì |
| Tipo dati | elenco a discesa |
| Intervallo |
|
Nome JNDI della destinazione
Selezionare il tipo di destinazione sulla proprietà Tipo destinazione.
Per gli adattatori di risorse che supportano JMS, è necessario associare javax.jms.Destinations ad una specifica di attivazione, in modo che l'adattatore di risorse possa supportare i messaggi dalla destinazione JMS. In questo caso, l'amministratore configura un oggetto gestito J2C che implementa l'interfaccia javax.jms.Destination e ne esegue il bind all'interno di JNDI.
È possibile configurare un oggetto gestito J2C per l'utilizzo di una classe ActivationSpec che implementi un metodo setDestination(javax.jms.Destination). In questo caso, è possibile specificare il nome JNDI di destinazione (ovvero, il nome JNDI dell'oggetto gestito J2C che implementa l'interfaccia javax.jms.Destination).
Durante l'avvio dell'applicazione, quando è in corso l'inizializzazione della specifica di attivazione come parte dell'attivazione dell'endpoint, il server utilizza il nome JNDI di destinazione per ricercare l'oggetto gestito di destinazione e quindi impostarlo nell'istanza della specifica di attivazione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | Sì |
| Tipo dati | Stringa |
Il selettore messaggi JMS utilizzato per determinare i messaggi che riceve l'MDB (Message Driven Bean). Il valore è una stringa utilizzata per selezionare un sottoinsieme dei messaggi disponibili. La sintassi è basata su un sottoinsieme della sintassi di espressione condizionale SQL 92, come descritto nella specifica JMS. Fare riferimento al centro informazioni per ulteriori informazioni.
JMSType='car' AND color='blue' AND weight>2500
La stringa del selettore può riferirsi a campi nell'intestazione dei messaggi JMS e nelle proprietà dei messaggi. I selettori messaggi non possono riferirsi a valori del corpo del messaggio.
Un valore null (una stringa vuota) indica che non vi è alcun selettore messaggi per l'utente dei messaggi.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Il nome del bus a cui connettersi.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Personalizzato |
Modalità con cui la sessione riconosce i messaggi ricevuti.
La notifica viene inviata quando il messaggio viene eliminato.
Il messaggio viene eliminato quando il bean si avvia se la qualità del servizio è impostata su Miglior impegno non persistente. Per tutte le altre qualità di servizio, il messaggio viene eliminato al termine del bean.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | elenco a discesa |
| Intervallo |
|
Il nome di una destinazione che identifica un gruppo di motori di messaggistica. Specificare il tipo di destinazione utilizzando la proprietà Tipo di destinazione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Il tipo di destinazione definito nella proprietà di destinazione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | elenco a discesa |
| Intervallo |
|
Questa proprietà specifica l'importanza del gruppo destinazione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | elenco a discesa |
| Intervallo |
|
Il nome della catena di trasporto in entrata che deve essere utilizzata dall'applicazione durante la connessione a un motore di messaggistica in un processo separato dall'applicazione. Se viene scelto un motore di messaggistica in un altro processo, una connessione è possibile solo se il motore di messaggistica si trova in un server in cui è in esecuzione la catena di trasporto in entrata specificata. Fare riferimento al centro informazioni per ulteriori informazioni.
Se il motore di messaggistica si trova sullo stesso server sul quale si trova l'applicazione, viene effettuata una connessione diretta nel processo e questa proprietà della catena di trasporto viene ignorata.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Un elenco separato da virgole di gruppi endpoint costituiti da tre nomi, con la sintassi hostName:portNumber:chainName, si connetteva ad un server di avvio. Esempio: Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Se non si specifica il nome host, localhost viene utilizzato come valore predefinito.
Se non si specifica il numero porta, viene utilizzato 7276 come valore predefinito.
Se non si specifica il protocollo, viene utilizzata una catena predefinita, come ad esempio BootstrapBasicMessaging, come valore predefinito.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Area di testo |
Il numero massimo di messaggi ricevuti dal motore di messaggistica in un singolo batch.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Numero intero |
| Intervallo | Da 1 a 2147483647 |
Il numero massimo di endpoint a cui vengono consegnati i messaggi contemporaneamente.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Numero intero |
| Intervallo | Da 1 a 2147483647 |
Questi parametri consentono l'arresto automatico di un endpoint quando il numero di messaggi in errore sequenziale raggiunge un limite specificato. Ciò consente di distinguere tra uno o due messaggi che subiscono un errore a causa di problemi con i messaggi stessi e un problema di risorse di sistema che provoca numerosi messaggi che non riescono in sequenza.
Quando un endpoint viene arrestato automaticamente, il relativo stato sul pannello della console di gestione è rosso. Esso dovrà essere riavviato manualmente facendo clic sul pulsante Ripresa.
Una volta riavviato un endpoint, qualsiasi messaggio che ha subito un errore che ha causato l'arresto dell'endpoint viene tentato di nuovo. In questo caso, verranno spostati su una destinazione eccezioni (se ne è stata configurata una).
Abilita un arresto automatico di un endpoint basato sui parametri di seguito riportati.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Valore booleano |
L'endpoint verrà arrestato quando il numero di messaggi non riusciti consecutivamente raggiunge il limite impostato. In base alle dipendenze di elaborazione in MDB, il numero effettivo di messaggi elaborati può superare questo valore.
Questa proprietà non è abilitata a meno che non sia abilitata la proprietà Interruzione automatica di endpoint su messaggi di errore ripetuti.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Numero intero |
Qualsiasi messaggio che non riesce ad essere elaborato da MDB, ma che non ha raggiunto il limite massimo di consegne non riuscite, sarà rielaborato solo dopo che è trascorso questo periodo di tempo (espresso in millisecondi). Altri messaggi possono essere elaborati durante questo periodo, a meno che la soglia di errori consecutivi e la simultaneita massima non siano impostate su 1.
L'impostazione di un ritardo tra tentativi non riusciti di invio messaggi riduce il numero di messaggi che vengono spostati senza necessità nella destinazione eccezioni prima che l'MDB venga arrestato. Per ridurre al minimo il numero di messaggi spostati, impostare questo ritardo su un valore maggiore rispetto all'intervallo di tempo previsto tra i messaggi che arrivano a destinazione.
Questa proprietà non è abilitata a meno che non sia abilitata la proprietà Interruzione automatica di endpoint su messaggi di errore ripetuti.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Numero intero |
| Intervallo | Il tempo, in millisecondi. Un valore uguale a 0 indica che non vi è alcun ritardo tra nuovi tentativi. |
Specifica se una sottoscrizione topic JMS è duratura oppure non duratura.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | elenco a discesa |
| Intervallo |
|
Il nome della sottoscrizione necessario per le sottoscrizioni argomenti durevoli. Campo obbligatorio quando si utilizza una sottoscrizione argomenti duratura.
Tale nome sottoscrizione deve essere univoco nell'identificativo client specificato.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
L'identificativo client JMS necessario per le sottoscrizioni durature di topic in tutte le connessioni create utilizzando questa specifica di attivazione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Il nome del motore di messaggistica utilizzato per memorizzare i messaggi consegnati alle sottoscrizioni durature per gli oggetti creati da questa specifica di attivazione JMS. Questo è un campo obbligatorio quando si utilizza una sottoscrizione duratura di topic.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Stringa |
Quando abilitata, Object i messaggi ricevuti attraverso questa specifica di attivazione solo avrà i dati del messaggio serializzati dal sistema quando assolutamente necessario. I dati ottenuti da questi messaggi devono essere trattati dalle applicazioni come readOnly.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Valore booleano |
Quando abilitata, Object/Bytes i messaggi inoltrati attraverso questa specifica di attivazione che presentano il loro payload modificato non vedranno i loro dati copiati quando questa opzione è impostata nel messaggio e il sistema solo serializzerà i dati del messaggio quando assolutamente necessario. Le applicazioni che inviano tali messaggi non devono modificare i dati dopo che tali dati sono stati impostati nel messaggio.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Valore booleano |
La lettura anticipata è un'ottimizzazione che assegna preventivamente messaggi agli utenti. In questo modo si ottimizza il tempo necessario per soddisfare le richieste degli utenti
I messaggi assegnati a un consumer vengono bloccati sul server e non possono essere utilizzati da altri consumer di quella destinazione. I messaggi assegnati a un consumer, ma non utilizzati prima dell'arresto di tale consumer, vengono successivamente sbloccati sul server e resi disponibili per la ricezione da parte di altri consumer.
È possibile sovrascrivere questa proprietà per destinazioni JMS singole impostando la proprietà Lettura anticipata sulla destinazione JMS.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | elenco a discesa |
| Intervallo |
|
Questa proprietà viene utilizzata soltanto quando l'applicazione MDB è in esecuzione su un server membro bus utilizzato dall'applicazione come destinazione. Non ha alcun effetto quando MDB è in esecuzione su un server che non è membro bus di destinazione.
Se l'applicazione MDB è in esecuzione su un server membro bus di destinazione, l'abilitazione di tale opzione consente all'applicazione MDB di elaborare i messaggi indipendentemente dal fatto che il server ospiti un motore di messaggistica in esecuzione. Se questa opzione non è abilitata, le applicazioni MDB su server che non dispongono di un motore di messaggistica locale non elaborano i messaggi.
Per ulteriori informazioni, fare riferimento a Modalità di connessione degli MDB (message-driven bean) in un cluster.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Valore booleano |
Il ritardo (espresso in secondi) che intercorre tra i tentativi eseguiti per connettersi ad un motore di messaggistica, sia per la connessione iniziale che per i successivi tentativi eseguiti per stabilire una migliore connessione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | Numero intero |
| Intervallo | Da 1 a 2147483647 |
Il nome di un alias di autenticazione J2C utilizzato per l'autenticazione gestita del componente delle connessioni al SIB (Service integration bus).
Un alias di autenticazione Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) specifica l'ID utente e la password utilizzati per autenticare la creazione di una nuova connessione al provider JMS.
I campi delle proprietà personalizzate del nome utente e della password non devono essere specificati se viene utilizzato il campo dell'alias di autenticazione. Le proprietà dell'alias di autenticazione impostate come parte della distribuzione dell'applicazione hanno la precedenza sulle proprietà impostate su un oggetto di gestione della specifica di attivazione.
Solo l'alias di autenticazione non viene mai scritto su file in un formato non codificato, anche per scopi di registrazione del ripristino delle transazioni. Il servizio di sicurezza viene utilizzato per proteggere il nome utente effettivo e la password.
Durante l'avvio dell'applicazione, quando è in corso l'inizializzazione della specifica di attivazione come parte dell'attivazione dell'endpoint, il server utilizza l'alias di autenticazione per richiamare il nome utente effettivo e la password dalla sicurezza e quindi impostarli nell'istanza della specifica di attivazione.
| Informazioni | Valore |
|---|---|
| Obbligatorio | No |
| Tipo dati | elenco a discesa |