jmsActivationSpec - Specifica di attivazione JMS (jmsActivationSpec)

Definisce una configurazione di specifica di attivazione JMS.

NameTypeDefaultDescription
idstringaUn ID di configurazione univoco.
authDataRefUn riferimento allelemento di livello più alto {0} (stringa).Dati di autenticazione predefiniti per una specifica di attivazione.
maxEndpointsint
Min: 0
500Il numero massimo di endpoint da inviare.
autoStartbooleanotrueConfigura se gli endpoint messaggio associati a questa specifica di attivazione si avviano automaticamente o devono essere avviati manualmente utilizzando il comando di ripresa.

authData

Dati di autenticazione predefiniti per una specifica di attivazione.

NameTypeDefaultDescription
userstringIl nome dell'utente da utilizzare durante la connessione a EIS.
passwordPassword codificata reversibilmente (stringa)La password dell'utente da utilizzare durante la connessione a EIS. Il valore può essere memorizzato come testo in chiaro oppure in formato codificato. Si consiglia di codificare la password. Per eseguire tale operazione, utilizzare lo strumento securityUtility con l'opzione encode.

properties.wasJms

Una specifica di attivazione JMS è associata ad uno o più MDB e fornisce la configurazione a loro necessaria per ricevere i messaggi.

NameTypeDefaultDescription
acknowledgeMode
  • Auto-acknowledge
  • Dups-ok-acknowledge
Auto-acknowledgeLa modalità riconoscimento indica il modo in cui deve essere riconosciuto un messaggio ricevuto da un MDB.
Auto-acknowledge
Auto-acknowledge
Dups-ok-acknowledge
Dups-ok-acknowledge
busNamestringdefaultBusIl nome di un bus quando si esegue la connessione al SIB (Service Integration Bus) in un server del profilo completo.
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.QueueIl tipo di destinazione, che è javax.jms.Queue o javax.jms.Topic.
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
maxConcurrencyint
Min: 1

Max: 2147483647
5Il numero massimo di endpoint a cui vengono consegnati i messaggi contemporaneamente. L'aumento del numero può migliorare le prestazioni ma aumenta anche il numero di thread utilizzati all'ora specificata. Se l'ordine dei messaggi deve essere conservato per tutte le consegne non riuscite, impostare il valore di numero massimo di endpoint simultanei su 1.
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
DefaultLa lettura anticipata è un'ottimizzazione che assegna preventivamente i messaggi ai consumer. Essa elabora le richieste dei consumer più velocemente.
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
retryIntervalUn periodo di tempo con precisione al secondo30sIl ritardo (in secondi) tra i tentativi di connessione ad un motore di messaggistica, per la connessione iniziale e per i successivi tentativi di stabilire una connessione migliore. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m) o secondi (s). Ad esempio, specificare 30 secondi come 30s. È possibile includere più valori in una singola immissione. Ad esempio, 1m30s è equivalente a 90 secondi.
subscriptionDurability
  • NonDurableShared
  • Durable
  • DurableShared
  • NonDurable
NonDurableIl tipo di sottoscrizione argomento MS. Il valore può essere uno dei seguenti: Durable DurableShared NonDurable NonDurableShared
NonDurableShared
NonDurableShared
Durable
Durable
DurableShared
DurableShared
NonDurable
NonDurable
targetTransportChain
  • InboundBasicMessaging
  • InboundSecureMessaging
InboundBasicMessagingLe catene di trasporto specificano i protocolli di comunicazione che è possibile utilizzare per comunicare con il SIB in un server dei profili completo.
InboundBasicMessaging
InboundBasicMessaging
InboundSecureMessaging
InboundSecureMessaging
clientIdstringL'identificativo client JMS necessario per sottoscrizioni argomenti durevoli (e per i non durevoli condivisi) su tutte le connessioni. Questo identificativo è richiesto se l'applicazione sta eseguendo la messaggistica di pubblicazione/sottoscrizione durevole (e non durevole condivisa).
connectionFactoryLookupstringQuesta proprietà può essere utilizzata per specificare il nome di ricerca di un oggetto javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory o javax.jms.TopicConnectionFactory definito amministrativamente utilizzato per la connessione al provider JMS da cui l'endpoint (MDB - message-driven bean) può ricevere messaggi.
destinationstringRiferimento per una destinazione JMS
destinationLookupstringQuesta proprietà può essere utilizzata per specificare il nome di ricerca degli oggetti javax.jms.Queue o javax.jms.Topic definiti amministrativamente che definiscono il topic o la coda JMS da cui l'endpoint (MDB - message-driven bean) può ricevere messaggi.
destinationRefUn riferimento allelemento di livello più alto {0} (stringa).Riferimento per una destinazione JMS
maxBatchSizeint
Min: 1

Max: 2147483647
Il numero massimo di messaggi ricevuti dal motore di messaggistica in un singolo batch.
messageSelectorstringIl selettore messaggi JMS utilizzato per determinare i messaggi ricevuti dall'MDB (Message-Driven Bean). Il valore è una stringa utilizzata per selezionare un insieme secondario di messaggi disponibili.
remoteServerAddressstringL'indirizzo del server remoto che presenta elementi costituiti da tre voci separati da una virgola, con la sintassi Nomehost:Numeroporta:Nomecatena, utilizzati per connettersi a un server di avvio. Ad esempio, Merlin:7276:BootstrapBasicMessaging. Se hostName non è specificato, il valore predefinito è localhost. Se portNumber non è specificato, il valore predefinito è 7276. Se chainName non è specificato, il valore predefinito è BootstrapBasicMessaging. Per ulteriori informazioni, fare riferimento al centro informazioni.
shareDurableSubscriptionstringControlla se la sottoscrizione durevole può essere o meno condivisa tra le connessioni.
subscriptionNamestringIl nome della sottoscrizione necessario per le sottoscrizioni argomenti durevoli (e non durevoli condivisi). Campo obbligatorio quando si utilizza una sottoscrizione argomenti durevole (e non durevole condivisa). Questo nome sottoscrizione deve essere univoco nell'ID client specificato.

properties.wmqJms

Specifica di attivazione JMS WebSphere MQ

NameTypeDefaultDescription
destinationRefUn riferimento allelemento di livello più alto {0} (stringa).Destinazione
CCSIDint
Min: 1
819L'identificativo della serie di caratteri codificati per una connessione.
channelstringSYSTEM.DEF.SVRCONNIl nome del canale MQI da utilizzare.
cloneSupport
  • DISABLED
  • ENABLED
DISABLEDIndica se due o più istanze dello stesso sottoscrittore argomento durevole possono essere eseguite contemporaneamente
DISABLED
DISABLED
ENABLED
ENABLED
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.QueueIl tipo di destinazione - javax.jms.Queue o javax.jms.Topic
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
headerCompression
  • SYSTEM
  • NONE
NONEUn elenco delle tecniche che è possibile utilizzare per comprimere i dati di intestazione durante una connessione
SYSTEM
SYSTEM
NONE
NONE
hostNamestringlocalhostIl nome host o l'indirizzo IP del sistema sul quale si trova il gestore code. Le proprietà hostname e port vengono sostituite dalla proprietà ConnectionNameList quando specificata.
messageCompression
  • RLE
  • NONE
NONEUn elenco delle tecniche che possono essere utilizzate per comprimere i dati dei messaggi durante una connessione
RLE
RLE
NONE
NONE
pollingIntervalUn periodo di tempo con precisione al millisecondo5sSe ciascun listener messaggi in una sessione non dispone di alcun messaggio adatto nella propria coda, questo valore è l'intervallo massimo, in millisecondi, che trascorre prima che ciascun listener messaggi provi di nuovo ad ottenere un messaggio dalla propria coda. Se accade di frequente che non vi siano messaggi adeguati disponibili per i listener messaggi in una sessione, si consideri la possibilità di aumentare il valore di questa proprietà. Questa proprietà è rilevante solo se TRANSPORT ha il valore BIND o CLIENT. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
poolTimeoutUn periodo di tempo con precisione al millisecondo5mIl tempo, in millisecondi, per il quale una sessione server non utilizzata viene mantenuta aperta nel pool di sessioni server prima di essere chiusa per inattività. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
portint
Min: 1
1414La porta sulla quale è in ascolto il gestore code. Le proprietà hostname e port vengono sostituite dalla proprietà ConnectionNameList quando specificata.
providerVersion
  • unspecified
  • 6
  • 7
unspecifiedLa versione, la release, il livello di modifica e il fix pack del gestore code al quale l'applicazione intende connettersi.
unspecified
unspecified
6
6
7
7
rescanIntervalUn periodo di tempo con precisione al millisecondo5sQuando un consumer di messaggi nel dominio point-to-point utilizza un selettore messaggi per selezionare quali messaggi desidera ricevere, WebSphere MQ classes for JMS ricerca nella coda WebSphere MQ messaggi adatti nella sequenza determinata dall'attributo MsgDeliverySequence della coda. Quando WebSphere MQ classes for JMS trova un messaggio e lo consegnano al consumer, WebSphere MQ classes for JMS riprende la ricerca per il successivo messaggio adatto dalla posizione corrente nella coda. WebSphere MQ classes for JMS continua la ricerca nella coda in questo modo fino a raggiungere la fine della coda oppure fino alla scadenza, determinata dal valore di questa proprietà, dell'intervallo di tempo in millisecondi. In ciascun caso, WebSphere MQ classes for JMS ritorna all'inizio della coda per continuare la propria ricerca e parte un nuovo intervallo di tempo. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
shareConvAllowedbooleanotrueIndica se una connessione client può condividere il proprio socket con altre connessioni JMS di livello superiore dallo stesso processo allo stesso gestore code, se le definizioni di canale corrispondono
startTimeoutUn periodo di tempo con precisione al millisecondo10sConfigura la durata di tempo (in millisecondi) in cui l'esecuzione deve avviarsi. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
transportType
  • BINDINGS
  • CLIENT
CLIENTIndica se una connessione a un gestore code utilizza la modalità client o la modalità di bind.
BINDINGS
BINDINGS
CLIENT
CLIENT
failIfQuiescebooleanotrueIndica se le chiamate a determinati metodi non riescono quando il gestore code si trova in uno stato di quiesce.
maxMessagesint
Min: 0
1Il numero massimo di messaggi che è possibile assegnare a una sessione server contemporaneamente. Se la specifica di attivazione consegna messaggi a un MDB in una transazione XA, viene utilizzato il valore 1 anziché l'impostazione di questa proprietà.
maxPoolDepthint
Min: 0
10La proprietà maxPoolDepth sulla specifica di attivazione definisce il numero di istanze MDB (Message Driven Bean) disponibili. Diminuendo il valore di questa proprietà diminuisce il numero di messaggi che possono essere consegnati simultaneamente.
messageSelection
  • BROKER
  • CLIENT
CLIENTDetermina se la selezione dei messaggi viene eseguita da WebSphere MQ classes for JMS o dal broker.
BROKER
BROKER
CLIENT
CLIENT
receiveCCSIDint
Min: 0
0La proprietà che imposta il CCSI di destinazione per la conversione dei messaggi del gestore code. Il valore viene ignorato a meno che RECEIVECONVERSION non sia impostato su WMQ_RECEIVE_CONVERSION_QMG
receiveConversion
  • QMGR
  • CLIENT_MSG
CLIENT_MSGProprietà di destinazione che determina se la conversione dei dati verrà eseguita dal gestore code.
QMGR
QMGR
CLIENT_MSG
CLIENT_MSG
sslResetCountint
Min: 0

Max: 999999999
0Il numero totale di byte inviati e ricevuti da una connessione SSL prima della rinegoziazione delle chiavi segrete utilizzate da SSL
cleanupLevel
  • NONDUR
  • FORCE
  • SAFE
  • NONE
  • STRONG
SAFEIl livello di ripulitura per un archivio di sottoscrizioni su base broker.
NONDUR
NONDUR
FORCE
FORCE
SAFE
SAFE
NONE
NONE
STRONG
STRONG
sparseSubscriptionsbooleanofalseControlla la politica di richiamo dei messaggi di un oggetto TopicSubscriber
statusRefreshIntervalUn periodo di tempo con precisione al millisecondo1mL'intervallo, in millisecondi, tra gli aggiornamenti della transazione a esecuzione prolungata che rileva quando un sottoscrittore perde la connessione al gestore code. Questa proprietà è rilevante solo se subscriptionStore è impostato su QUEUE. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
subscriptionStore
  • BROKER
  • MIGRATE
  • QUEUE
BROKERDetermina il punto in cui WebSphere MQ classes for JMS memorizza dati persistenti relativi a sottottoscrizioni attive.
BROKER
BROKER
MIGRATE
MIGRATE
QUEUE
QUEUE
wildcardFormat
  • CHAR
  • TOPIC
TOPICQuale versione della sintassi con caratteri jolly deve essere utilizzata.
CHAR
CHAR
TOPIC
TOPIC
applicationNamestringIl nome con il quale un'applicazione viene registrata con il gestore code.
ccdtURLstringUn URL che identifica il nome e l'ubicazione del file contenente la CCDT (Client Channel Definition Table) e che specifica il modo in cui è possibile accedere al file.
clientIdstringL'identificativo client per una connessione
connectionNameListstringUn elenco di nomi di connessione TCP/IP (nome host(porta)) utilizzati per le comunicazioni. ConnectionNameList sostituisce le proprietà hostname e port.
localAddressstringPer una connessione a un gestore code, questa proprietà specifica uno o entrambi i seguenti elementi: (1) L'interfaccia di rete locale da utilizzare, (2) La porta locale o l'intervallo di porte locali, da utilizzare
messageBatchSizeint
Min: 0
Numero massimo di messaggi da elaborare in un batch.
queueManagerstringIl nome del gestore code a cui connettersi
subscriptionDurability
  • Durable
  • NonDurable
Se si utilizza una sottoscrizione durevole o non durevole per consegnare messaggi a un MDB che esegue la sottoscrizione a questo argomento
Durable
Durable
NonDurable
NonDurable
subscriptionNamestringIl nome della sottoscrizione durevole
messageRetentionbooleanoSe il consumer della connessione conserva i messaggi non desiderati nella coda di input
messageSelectorstringDetermina se la selezione dei messaggi viene eseguita da WebSphere MQ classes for JMS o dal broker. La selezione dei messaggi da parte del broker non è supportata quando il valore di brokerVersion è 1
sslCertStoresstringI server LDAP (Lightweight Directory Access Protocol) che detengono i CRL (Certificate Revocation List) per l'uso durante una connessione SSL
sslCipherSuitestringLa suite di cifratura da utilizzare per una connessione SSL
sslFipsRequiredbooleanoIndica se una connessione SSL deve utilizzare una suite di cifratura che sia supportata da un provider IBMJSSEFIPS (IBM Java JSSE FIPS).
sslPeerNamestringPer una connessione SSL, un template che viene utilizzato per controllare il DN (Distinguished Name) nel certificato digitale fornito dal gestore code
brokerCCDurSubQueuestringIl nome della coda da cui i messaggi di sottoscrizione non durevoli vengono richiamati per un consumer della connessione
brokerCCSubQueuestringIl nome della coda da cui un consumer della connessione riceve messaggi di sottoscrizione non durevoli
brokerControlQueuestringIl nome della coda di controllo broker
brokerPubQueuestringIl nome della coda in cui vengono inviati i messaggi pubblicati (la coda flussi)
brokerQueueManagerstringIl nome del gestore code sul quale il broker è in esecuzione
brokerSubQueuestringIl nome della coda da cui il consumer di messaggi non durevoli riceve i messaggi
brokerVersion
  • 1
  • 2
La versione del broker utilizzato
1
1
2
2
cleanupIntervalUn periodo di tempo con precisione al millisecondoL'intervallo, in millisecondi, tra le singole esecuzioni in background dell'utility di ripulitura di pubblicazione/sottoscrizione. Specificare un numero intero positivo seguito da un'unità di tempo, che può essere ore (h), minuti (m), secondi (s) o millisecondi (ms). Ad esempio, specificare 500 millisecondi come 500ms. È possibile includere più valori in una singola immissione. Ad esempio, 1s500ms è equivalente a 1,5 secondi.
receiveExitstringIdentifica un programma di uscita ricezione canale o una sequenza di programmi di uscita ricezione da eseguire in successione
receiveExitInitstringI dati utente che vengono trasmessi ai programmi di uscita ricezione canale quando vengono richiamati
securityExitstringIdentifica un programma di uscita di sicurezza canale
securityExitInitstringI dati utente che vengono trasmessi a un programma di uscita di sicurezza canale quando viene richiamato
sendExitstringIdentifica un programma di uscita invio canale o una sequenza di programmi di uscita invio da eseguire in successione
sendExitInitstringI dati utente che vengono trasmessi ai programmi di uscita invio canale quando vengono richiamati