jmsConnectionFactory - Factory di connessioni JMS (jmsConnectionFactory)

Definisce una configurazione del factory di connessione JMS.

NameTypeDefaultDescription
idstringaUn ID di configurazione univoco.
connectionManagerRefUn riferimento allelemento di livello più alto {0} (stringa).Il gestore connessioni per un factory di connessioni.
containerAuthDataRefUn riferimento allelemento di livello più alto {0} (stringa).Dati di autenticazione predefiniti per l'autenticazione gestita dal contenitore che si applica quando i bind non specificano un alias di autenticazione per un riferimento della risorsa con res-auth=CONTAINER.
jndiNamestringIl nome JNDI per una risorsa.
recoveryAuthDataRefUn riferimento allelemento di livello più alto {0} (stringa).I dati di autenticazione per il ripristino della transazione.

connectionManager

Il gestore connessioni per un factory di connessioni.

NameTypeDefaultDescription
agedTimeoutUn periodo di tempo con precisione al secondo-1La quantità di tempo prima che una connessione possa essere eliminata dalla manutenzione del pool. Un valore di -1 disabilita questo timeout. Il valore 0 elimina tutte le connessioni disabilitando il pool di connessioni. 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.
connectionTimeoutUn periodo di tempo con precisione al secondo30sL'intervallo di tempo dopo il quale scade una richiesta di connessione. Un valore di -1 disabilita questo timeout. 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.
maxIdleTimeUn periodo di tempo con precisione al secondo30mLa quantità di tempo per cui una connessione può essere non utilizzata o inattiva prima che possa essere eliminata durante la manutenzione del pool, se tale operazione non riduce il pool al di sotto della dimensione minima. Un valore di -1 disabilita questo timeout. 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.
maxPoolSizeint
Min: 0
50Il numero massimo di connessioni fisiche per un pool. Un valore 0 indica un numero illimitato.
minPoolSizeint
Min: 0
Il numero minimo di connessioni fisiche da gestire nel pool. Nel pool non sono preinseriti elementi. Il timeout superato può sostituire il minimo.
purgePolicy
  • FailingConnectionOnly
  • ValidateAllConnections
  • EntirePool
EntirePoolSpecifica quali connessioni eliminare quando in un pool viene rilevata una connessione obsoleta.
FailingConnectionOnly
Quando viene rilevata una connessione obsoleta, viene chiusa solo la connessione per la quale è stata rilevata una condizione di errore.
ValidateAllConnections
Quando viene rilevata una connessione obsoleta, le connessioni vengono sottoposte a test e quelle per cui viene rilevata una condizione di errore vengono chiuse.
EntirePool
Quando viene rilevata una connessione obsoleta, tutte le connessioni nel pool sono contrassegnate come obsolete e, quando non sono più utilizzate, vengono chiuse.
reapTimeUn periodo di tempo con precisione al secondo3mIntervallo di tempo tra le esecuzioni del thread di manutenzione pool. Un valore -1 disabilita la manutenzione pool. 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.
maxConnectionsPerThreadint
Min: 0
Limita il numero di connessioni aperte su ciascun thread.
numConnectionsPerThreadLocalint
Min: 0
Memorizza in cache il numero specificato di connessioni per ciascun thread.
enableSharingForDirectLookupsbooleanotrueSe impostato su true, le connessioni vengono condivise. Se impostato su false, le connessioni non vengono condivise.

containerAuthData

Dati di autenticazione predefiniti per l'autenticazione gestita dal contenitore che si applica quando i bind non specificano un alias di autenticazione per un riferimento della risorsa con res-auth=CONTAINER.

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.

recoveryAuthData

I dati di autenticazione per il ripristino della transazione.

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

Un factory di connessione JMS viene utilizzato per creare le connessioni al provider JMS associato delle destinazioni JMS, per la messaggistica point-to-point e di pubblicazione/sottoscrizione.

NameTypeDefaultDescription
busNamestringdefaultBusIl nome di un bus quando si esegue la connessione al SIB (Service Integration Bus) in un server del profilo completo.
clientIDstringclientIDL'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).
durableSubscriptionHomestringdefaultMELa home della sottoscrizione durevole definisce il nome ME con cui deve essere stabilita la connessione.
nonPersistentMapping
  • ReliableNonPersistent
  • ExpressNonPersistent
  • BestEffortNonPersistent
ExpressNonPersistentL'affidabilità applicata ai messaggi JMS non persistenti inviati mediante questo factory di connessione.
ReliableNonPersistent
ReliableNonPersistent
ExpressNonPersistent
ExpressNonPersistent
BestEffortNonPersistent
BestEffortNonPersistent
persistentMapping
  • ReliablePersistent
  • AssuredPersistent
ReliablePersistentL'affidabilità applicata ai messaggi JMS persistenti inviati mediante questo factory di connessione.
ReliablePersistent
ReliablePersistent
AssuredPersistent
AssuredPersistent
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
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.
temporaryQueueNamePrefixstringtempIl prefisso composto da un massimo di dodici caratteri utilizzato per le code temporanee create dalle applicazioni che utilizzano questo factory di connessione coda.
temporaryTopicNamePrefixstringtempIl prefisso composto da un massimo di dodici caratteri utilizzato per le code temporanee create dalle applicazioni che utilizzano questo factory di connessione argomento.
passwordPassword codificata reversibilmente (stringa)Si consiglia di utilizzare un alias di autenticazione gestito dal contenitore invece di configurazione questa proprietà.
shareDurableSubscriptionstringControlla se la sottoscrizione durevole può essere o meno condivisa tra le connessioni.
targetTransportChainstringLe catene di trasporto specificano i protocolli di comunicazione che è possibile utilizzare per comunicare con il SIB in un server dei profili completo.
userNamestringSi consiglia di utilizzare un alias di autenticazione gestito dal contenitore invece di configurazione questa proprietà.

properties.wmqJms

Factory di connessione JMS WebSphere MQ

NameTypeDefaultDescription
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
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
targetClientMatchingbooleanotrueIndica se un messaggio di risposta, inviato alla coda identificata dal campo di intestazione JMSReplyTo di un messaggio in entrata, ha un'intestazione MQRFH2 solo se il messaggio in entrata ha un'intestazione MQRFH2.
transportType
  • BINDINGS
  • CLIENT
CLIENTIndica se una connessione a un gestore code utilizza la modalità client o la modalità di bind. Se si specifica il valore BINDINGS_THEN_CLIENT, l'adattatore di risorse come prima cosa prova a stabilire una connessione in modalità di bind. Se questa connessione non riesce, prova a stabilire una connessione in modalità client.
BINDINGS
BINDINGS
CLIENT
CLIENT
CCSIDint
Min: 1
819L'identificativo della serie di caratteri codificati per una connessione.
failIfQuiescebooleanotrueIndica se le chiamate a determinati metodi non riescono quando il gestore code si trova in uno stato di quiesce.
headerCompression
  • SYSTEM
  • NONE
NONEUn elenco delle tecniche che è possibile utilizzare per comprimere i dati di intestazione durante una connessione
SYSTEM
SYSTEM
NONE
NONE
messageCompression
  • RLE
  • NONE
NONEUn elenco delle tecniche che è possibile utilizzare per comprimere i dati dei messaggi durante una connessione.
RLE
RLE
NONE
NONE
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. 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.
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
cloneSupport
  • DISABLED
  • ENABLED
DISABLEDIndica se è possibile eseguire contemporaneamente due o più istanze dello stesso sottoscrittore argomento durevole.
DISABLED
DISABLED
ENABLED
ENABLED
messageSelection
  • BROKER
  • CLIENT
CLIENTDetermina se la selezione dei messaggi viene eseguita da WebSphere MQ classes for JMS o dal broker.
BROKER
BROKER
CLIENT
CLIENT
pubAckIntervalint
Min: 0
25Il numero di messaggi pubblicati da un publisher prima che WebSphere MQ classes for JMS richieda un riconoscimento dal broker
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 il valore di SUBSTORE è 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 i dati persistenti relativi a sottoscrizioni 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.
channelstringIl nome del canale MQI da utilizzare.
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.
hostNamestringIl 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.
passwordPassword codificata reversibilmente (stringa)La password predefinita da utilizzare quando si crea una connessione al gestore code. Si consiglia di utilizzare un alias di autenticazione gestito dal contenitore anziché configurare questa proprietà.
queueManagerstringIl nome del gestore code a cui connettersi
temporaryModelstringIl nome della coda modello da cui vengono create le code temporanee JMS. SYSTEM.JMS.TEMPQ.MODEL può essere utilizzato dal livello JMS per creare code che accettano messaggi persistenti, in quanto il valore predefinito non può. SYSTEM.DEFAULT.MODEL.QUEUE può essere aperto solo una volta. SYSTEM.JMS.TEMPQ.MODEL può essere aperto più di una volta. SYSTEM.DEFAULT.MODEL.QUEUE è obsoleto.
tempQPrefixstringIl prefisso che viene utilizzato per creare il nome di una coda dinamica WebSphere MQ.
tempTopicPrefixstringQuando si creano argomenti temporanei, JMS genera una stringa argomento del modulo TEMP/TEMPTOPICPREFIX/unique_id oppure se per questa proprietà si lascia il valore predefinito, solo TEMP/unique_id. Specificando un TEMPTOPICPREFIX non vuoto, si consente la definizione di code modello specifiche per la creazione di code gestite per i sottoscrittori ad argomenti temporanei creati durante questa connessione.
userNamestringIl nome utente predefinito da utilizzare quando si stabilisce una connessione a un gestore code. Si consiglia di utilizzare un alias di autenticazione gestito dal contenitore anziché configurare questa proprietà.
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
pollingIntervalUn periodo di tempo con precisione al millisecondoSe 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.
sendCheckCountint
Min: 0
Il numero di chiamate di invio da consentire tra un controllo e l'altro di errori di put asincrono, entro una singola sessione JMS non sottoposta a transazione.
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.
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.
arbitraryPropertiesstringCapacità di specificare proprietà non definite altrove