jmsConnectionFactory - JMS-Verbindungsfactory (jmsConnectionFactory)

Definiert die Konfiguration einer JMS-Verbindungsfactory.

NameTypeDefaultDescription
idstringEine eindeutige Konfigurations-ID.
connectionManagerRefReferenz auf das connectionManager-Element (string) der höchsten Ebene.Verbindungsmanager für eine Verbindungsfactory.
containerAuthDataRefReferenz auf das authData-Element (string) der höchsten Ebene.Die Standardauthentifizierungsdaten für die containergesteuerte Authentifizierung, die gelten, wenn in Bindungen kein Authentifizierungsalias für eine Ressourcenreferenz mit res-auth=CONTAINER angegeben ist.
jndiNamestringDer JNDI-Name für eine Ressource.
recoveryAuthDataRefReferenz auf das authData-Element (string) der höchsten Ebene.Die Authentifizierungsdaten für die Transaktionswiederherstellung.

connectionManager

Verbindungsmanager für eine Verbindungsfactory.

NameTypeDefaultDescription
agedTimeoutZeitraum mit Genauigkeit in Sekunden-1Zeit, nach der eine Verbindung über die Poolwartung gelöscht werden kann. Der Wert -1 inaktiviert das Zeitlimit. Wenn Sie den Wert 0 angeben, werden alle Verbindungen verworfen, woraufhin das Verbindungspooling inaktiviert wird. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden.
connectionTimeoutZeitraum mit Genauigkeit in Sekunden30sZeit, nach der eine Verbindungsanforderungsüberschreitung ausgelöst wird. Der Wert -1 inaktiviert das Zeitlimit. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden.
maxIdleTimeZeitraum mit Genauigkeit in Sekunden30mZeit, nach der eine nicht verwendete oder inaktive Verbindung während der Poolwartung verworfen werden kann. Bei der Verkleinerung des Pools wird die Mindestgröße nicht unterschritten. Der Wert -1 inaktiviert das Zeitlimit. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden.
maxPoolSizeint
Min: 0
50Maximale Anzahl physischer Verbindungen für einen Pool. Der Wert 0 bedeutet uneingeschränkt.
minPoolSizeint
Min: 0
Mindestanzahl physischer Verbindungen, die im Pool verwaltet werden. Der Pool wird nicht vorab gefüllt. Das Alterszeitlimit kann den Mindestwert überschreiben.
purgePolicy
  • FailingConnectionOnly
  • ValidateAllConnections
  • EntirePool
EntirePoolGibt an, welche Verbindungen gelöscht werden sollen, wenn eine veraltete Verbindung in einem Pool gefunden wird.
FailingConnectionOnly
Wenn eine veraltete Verbindung erkannt wird, wird nur die als fehlerhaft markierte Verbindung geschlossen.
ValidateAllConnections
Wenn eine veraltete Verbindung erkannt wird, werden Verbindungen getestet und die als fehlerhaft eingestuften geschlossen.
EntirePool
Wenn eine veraltete Verbindung erkannt wird, werden alle Verbindungen im Pool als abgelaufen markiert und geschlossen, wenn sie nicht mehr verwendet werden.
reapTimeZeitraum mit Genauigkeit in Sekunden3mZeit zwischen Ausführungen des Wartungsthreads für den Pool. Der Wert -1 inaktiviert die Poolwartung. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden.
maxConnectionsPerThreadint
Min: 0
Begrenzt die Anzahl offener Verbindungen in jedem Thread.
numConnectionsPerThreadLocalint
Min: 0
Gibt die Anzahl an Verbindungen für jeden Thread an, die zwischengespeichert werden.
enableSharingForDirectLookupsbooleantrueWenn der Wert auf true gesetzt ist, werden Verbindungen gemeinsam genutzt. Ist der Wert auf false gesetzt, werden Verbindungen nicht gemeinsam genutzt.

containerAuthData

Die Standardauthentifizierungsdaten für die containergesteuerte Authentifizierung, die gelten, wenn in Bindungen kein Authentifizierungsalias für eine Ressourcenreferenz mit res-auth=CONTAINER angegeben ist.

NameTypeDefaultDescription
userstringDer Name des Benutzers, der für die Herstellung der Verbindung zum unternehmensweiten Informationssystem verwendet werden soll.
passwordUmkehrbar verschlüsseltes Kennwort (string)Das Kennwort des Benutzers, das für die Herstellung der Verbindung zum unternehmensweiten Informationssystem verwendet werden soll. Der Wert kann in Klartext oder in verschlüsselter Form gespeichert werden. Es wird empfohlen, das Kennwort zu verschlüsseln. Verwenden Sie dazu das Tool securityUtility mit der Option encode.

recoveryAuthData

Die Authentifizierungsdaten für die Transaktionswiederherstellung.

NameTypeDefaultDescription
userstringDer Name des Benutzers, der für die Herstellung der Verbindung zum unternehmensweiten Informationssystem verwendet werden soll.
passwordUmkehrbar verschlüsseltes Kennwort (string)Das Kennwort des Benutzers, das für die Herstellung der Verbindung zum unternehmensweiten Informationssystem verwendet werden soll. Der Wert kann in Klartext oder in verschlüsselter Form gespeichert werden. Es wird empfohlen, das Kennwort zu verschlüsseln. Verwenden Sie dazu das Tool securityUtility mit der Option encode.

properties.wasJms

Eine JMS-Verbindungsfactory wird verwendet, um Verbindungen zum zugeordneten JMS-Provider für JMS-Ziele für Punkt-zu-Punkt- und Publish/Subscribe-Messaging zu erstellen.

NameTypeDefaultDescription
busNamestringdefaultBusDer Name eines Busses, wenn eine Verbindung zum Service Integration Bus in einem vollständigen Profilserver hergestellt wird.
clientIDstringclientIDDie JMS-Client-ID, die für permanente (und für gemeinsam genutzte nicht permanente) Topicsubskriptionen in allen Verbindungen benötigt wird. Diese Kennung ist erforderlich, wenn die Anwendung permanentes (und gemeinsam genutztes nicht permanentes) Publish/Subscribe-Messaging durchführt.
durableSubscriptionHomestringdefaultMEDie Ausgangsposition für permanente Subskription definiert den Namen der Messaging-Engine, zu der eine Verbindung aufgebaut werden muss.
nonPersistentMapping
  • ReliableNonPersistent
  • ExpressNonPersistent
  • BestEffortNonPersistent
ExpressNonPersistentDie Zuverlässigkeit, die auf nicht persistente JMS-Nachrichten angewendet wird, die mit dieser Verbindungsfactory gesendet werden.
ReliableNonPersistent
ReliableNonPersistent
ExpressNonPersistent
ExpressNonPersistent
BestEffortNonPersistent
BestEffortNonPersistent
persistentMapping
  • ReliablePersistent
  • AssuredPersistent
ReliablePersistentDie Zuverlässigkeit, die auf persistente JMS-Nachrichten angewendet wird, die mit dieser Verbindungsfactory gesendet werden.
ReliablePersistent
ReliablePersistent
AssuredPersistent
AssuredPersistent
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
DefaultVorauslesen (Read Ahead) ist ein Optimierungsverfahren, das Nachrichten präventiv Konsumenten zuordnet. Bei diesem Verfahren werden Konsumentenanforderungen schneller verarbeitet.
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
remoteServerAddressstringDie Adresse des fernen Servers, die aus einer durch Kommas getrennten Liste mit Triplets in der Syntax Hostname:Portnummer:Kettenname besteht, die zum Herstellen der Verbindung zu einem Bootstrap-Server verwendet werden, z. B. Merlin:7276:BootstrapBasicMessaging. Wenn kein Hostname angegeben ist, wird standardmäßig localhost verwendet. Wenn keine Portnummer angegeben ist, wird der Standardwert 7276 verwendet. Wenn kein Kettenname angegeben ist, wird der Standardwert BootstrapBasicMessaging verwendet. Weitere Informationen finden Sie im Information Center.
temporaryQueueNamePrefixstringtempDas maximal zwölfstellige Präfix, das für die temporären Warteschlangen verwendet wird, die von Anwendungen erstellt werden, die diese Warteschlangenverbindungsfactory verwenden.
temporaryTopicNamePrefixstringtempDas maximal zwölfstellige Präfix, das für die temporären Topics verwendet wird, die von Anwendungen erstellt werden, die diese Topicverbindungsfactory verwenden.
passwordUmkehrbar verschlüsseltes Kennwort (string)Es wird empfohlen, einen containergesteuerten Authentifizierungsalias zu verwenden, anstatt diese Eigenschaft zu konfigurieren.
shareDurableSubscriptionstringSteuert, ob eine permanente Subskription von mehreren Verbindungen gemeinsam genutzt werden kann.
targetTransportChainstringTransportketten geben die Kommunikationsprotokolle an, die für die Kommunikation mit dem Service Integration Bus in einem vollständigen Profilserver verwendet werden können.
userNamestringEs wird empfohlen, einen containergesteuerten Authentifizierungsalias zu verwenden, anstatt diese Eigenschaft zu konfigurieren.

properties.wmqJms

JMS-Verbindungsfactory von WebSphere MQ

NameTypeDefaultDescription
portint
Min: 1
1414Der Port, an dem der Warteschlangenmanager empfangsbereit ist. Die Eigenschaften hostname und port werden durch die Eigenschaft ConnectionNameList außer Kraft gesetzt, wenn diese angegeben ist.
providerVersion
  • unspecified
  • 6
  • 7
unspecifiedDie Version, das Release, die Modifikationsstufe und das Fixpack des Warteschlangenmanagers, zu dem die Anwendung eine Verbindung herstellen möchte.
unspecified
unspecified
6
6
7
7
shareConvAllowedbooleantrueGibt an, ob eine Clientverbindung ihren Socket mit anderen JMS-Verbindungen der Ausgangsebene von demselben Prozess zu demselben Warteschlangenmanager teilen kann, wenn die Kanaldefinitionen übereinstimmen.
targetClientMatchingbooleantrueGibt an, ob eine Antwortnachricht, die an die im Headerfeld JMSReplyTo einer eingehenden Nachricht angegebene Warteschlange gesendet wird, nur dann einen MQRFH2-Header enthält, wenn die eingehende Nachricht einen MQRFH2-Header enthält.
transportType
  • BINDINGS
  • CLIENT
CLIENTGibt an, ob eine Verbindung zu einem Warteschlangenmanager den Clientmodus oder den Bindungsmodus verwendet. Wenn Sie den Wert BINDINGS_THEN_CLIENT angeben, versucht der Ressourcenadapter zuerst, eine Verbindung im Bindungsmodus herzustellen. Sollte diese Verbindung fehlschlagen, versucht der Ressourcenadapter, eine Verbindung im Clientmodus herzustellen.
BINDINGS
BINDINGS
CLIENT
CLIENT
CCSIDint
Min: 1
819Die ID des codierten Zeichensatzes für eine Verbindung.
failIfQuiescebooleantrueGibt an, ob Aufrufe bestimmter Methoden fehlschlagen, wenn der Warteschlangenmanager gerade stillgelegt wird.
headerCompression
  • SYSTEM
  • NONE
NONEEine Liste der Techniken, die für die Komprimierung von Headerdaten in einer Verbindung verwendet werden.
SYSTEM
SYSTEM
NONE
NONE
messageCompression
  • RLE
  • NONE
NONEEine Liste der Techniken, die für die Komprimierung von Nachrichtendaten in einer Verbindung verwendet werden können.
RLE
RLE
NONE
NONE
rescanIntervalZeitraum mit Genauigkeit in Millisekunden5sWenn ein Nachrichtenkonsument in der Punkt-zu-Punkt-Domäne einen Nachrichtenselektor verwendet, um die zu empfangenden Nachrichten auszuwählen, suchen die WebSphere-MQ-Klassen für JMS in der mit dem Attribut MsgDeliverySequence der Warteschlange definierten Reihenfolge in der WebSphere-MQ-Warteschlange nach geeigneten Nachrichten. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m), Sekunden (s) und Millisekunden (ms). Geben Sie 500 Millisekunden beispielsweise als 500ms an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1s500ms entspricht beispielsweise 1,5 Sekunden.
sslResetCountint
Min: 0

Max: 999999999
0Die Gesamtanzahl der von einer SSL-Verbindung gesendeten und empfangenen Bytes, bevor die von SSL verwendeten geheimen Schlüssel erneut verhandelt werden.
cleanupLevel
  • NONDUR
  • FORCE
  • SAFE
  • NONE
  • STRONG
SAFEDie Bereinigungsstufe für einen brokerbasierten Subskriptionsspeicher.
NONDUR
NONDUR
FORCE
FORCE
SAFE
SAFE
NONE
NONE
STRONG
STRONG
cloneSupport
  • DISABLED
  • ENABLED
DISABLEDGibt an, ob zwei oder mehr Instanzen desselben permanenten Subskribenten für das Topic gleichzeitig ausgeführt werden können.
DISABLED
DISABLED
ENABLED
ENABLED
messageSelection
  • BROKER
  • CLIENT
CLIENTLegt fest, ob die Nachrichtenauswahl von WebSphere MQ Classes for JMS oder vom Broker vorgenommen wird.
BROKER
BROKER
CLIENT
CLIENT
pubAckIntervalint
Min: 0
25Die Anzahl der Nachrichten, die von einem Publisher veröffentlicht werden, bevor WebSphere MQ Classes for JMS eine Bestätigung vom Broker anfordert.
sparseSubscriptionsbooleanfalseSteuert die Richtlinie für den Nachrichtenabruf eines TopicSubscriber-Objekts.
statusRefreshIntervalZeitraum mit Genauigkeit in Millisekunden1mDas Intervall (in Millisekunden) für die Aktualisierung einer Transaktion mit langer Laufzeit, bei dem festgestellt wird, ob die Verbindung des Subskribenten zum Warteschlangenmanager unterbrochen ist. Diese Eigenschaft ist nur relevant, wenn für SUBSTORE der Wert QUEUE festgelegt ist. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m), Sekunden (s) und Millisekunden (ms). Geben Sie 500 Millisekunden beispielsweise als 500ms an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1s500ms entspricht beispielsweise 1,5 Sekunden.
subscriptionStore
  • BROKER
  • MIGRATE
  • QUEUE
BROKERBestimmt, ob WebSphere MQ Classes for JMS persistente Daten über aktive Subskriptionen speichert.
BROKER
BROKER
MIGRATE
MIGRATE
QUEUE
QUEUE
wildcardFormat
  • CHAR
  • TOPIC
TOPICGibt die zu verwendende Version der Platzhaltersyntax an.
CHAR
CHAR
TOPIC
TOPIC
applicationNamestringDer Name, unter dem eine Anwendung beim Warteschlangenmanager registriert wird.
ccdtURLstringEin URL, der den Namen und die Position der Datei angibt, die die Definitionstabelle für Clientkanäle angibt und festlegt, wie auf die Datei zugegriffen werden kann.
channelstringDer Name des zu verwendenden MQI-Kanals.
clientIdstringDie Client-ID für eine Verbindung.
connectionNameListstringEine Liste mit TCP/IP-Verbindungsnamen (Hostname(Port)), die für die Kommunikation verwendet werden. ConnectionNameList setzt die Eigenschaften hostname und port außer Kraft.
hostNamestringDer Hostname oder die IP-Adresse des Systems, auf dem sich der Warteschlangenmanager befindet. Die Eigenschaften hostname und port werden durch die Eigenschaft ConnectionNameList außer Kraft gesetzt, wenn diese angegeben ist.
passwordUmkehrbar verschlüsseltes Kennwort (string)Das Standardkennwort, das beim Erstellen einer Verbindung zum Warteschlangenmanager verwendet wird. (Es wird empfohlen, einen containergesteuerten Authentifizierungsalias zu verwenden, anstatt diese Eigenschaft zu konfigurieren.)
queueManagerstringDer Name des Warteschlangenmanagers, zu dem eine Verbindung hergestellt werden soll.
temporaryModelstringDer Name der Modellwarteschlange, aus der temporäre JMS-Warteschlangen erstellt werden. SYSTEM.JMS.TEMPQ.MODEL kann von der JMS-Schicht verwendet werden, um Warteschlangen zu erstellen, die persistente Nachrichten akzeptiert, was mit dem Standardwert nicht möglich ist. SYSTEM.DEFAULT.MODEL.QUEUE kann nur ein einziges Mal geöffnet werden. SYSTEM.JMS.TEMPQ.MODEL kann mehrfach geöffnet werden. SYSTEM.DEFAULT.MODEL.QUEUE ist veraltet.
tempQPrefixstringDas Präfix, das verwendet wird, um den Namen einer dynamischen WebSphere-MQ-Warteschlange zu bilden.
tempTopicPrefixstringBeim Erstellen temporärer Topics generiert JMS eine Topiczeichenfolge mit dem Format TEMP/TEMPTOPICPRÄFIX/eindeutige_ID bzw. mit dem einfachen Format TEMP/eindeutige_ID, wenn diese Eigenschaft mit dem Standardwert übernommen wird. Wenn Sie ein nicht leeres TEMPTOPICPRÄFIX angeben, können bestimmte Modellwarteschlangen für die Erstellung der verwalteten Warteschlangen für Subskribenten temporärer Topics, die unter dieser Verbindung erstellt werden, definiert werden.
userNamestringDer beim Herstellen einer Verbindung zu einem Warteschlangenmanager zu verwendende Standardbenutzername. (Es wird empfohlen, einen containergesteuerten Authentifizierungsalias zu verwenden, anstatt diese Eigenschaft zu konfigurieren.)
localAddressstringFür eine Verbindung zu einem Warteschlangenmanager gibt diese Eigenschaft einen oder beide der folgenden Werte an: (1) die zu verwendende lokale Netzschnittstelle, (2) den zu verwendenden lokalen Port oder Bereich lokaler Ports.
pollingIntervalZeitraum mit Genauigkeit in MillisekundenWenn alle Nachrichten-Listener in einer Sitzung keine geeignete Nachricht in ihrer Warteschlange haben, gibt dieser Wert die maximale Zeit (in Millisekunden) an, die vergehen kann, bevor die Nachrichten-Listener erneut versuchen, eine Nachricht aus ihrer Warteschlange abzurufen. Wenn es häufig vorkommt, dass keine geeigneten Nachrichten für die Nachrichten-Listener in einer Sitzung verfügbar sind, sollten Sie den Wert dieser Eigenschaft erhöhen. Diese Eigenschaft ist nur relevant, wenn TRANSPORT den Wert BIND oder CLIENT hat. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m), Sekunden (s) und Millisekunden (ms). Geben Sie 500 Millisekunden beispielsweise als 500ms an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1s500ms entspricht beispielsweise 1,5 Sekunden.
sendCheckCountint
Min: 0
Die Anzahl der Sendeaufrufe, die zwischen den Prüfungen auf Fehler innerhalb einer einzelnen JMS-Sitzung ohne Transaktion bei der asynchronen PUT-Operation zugelassen werden sollen.
sslCertStoresstringDie LDAP-Server (Lightweight Directory Access Protocol), die Zertifikatswiderruflisten für eine SSL-Verbindung enthalten.
sslCipherSuitestringDie für eine SSL-Verbindung zu verwendende Cipher-Suite.
sslFipsRequiredbooleanGibt an, ob eine SSL-Verbindung eine Cipher-Suite verwenden muss, die vom IBM Java-JSSE-FIPS-Provider (IBMJSSEFIPS) unterstützt wird.
sslPeerNamestringFür eine SSL-Verbindung eine Schablone, die verwendet wird, um den definierten Namen in dem vom Warteschlangenmanager bereitgestellten digitalen Zertifikat zu prüfen.
brokerCCSubQueuestringDer Name der Warteschlange, aus der ein Verbindungskonsument nicht permanente Subskriptionsnachrichten empfängt.
brokerControlQueuestringDer Name der Steuerwarteschlange des Brokers.
brokerPubQueuestringDer Name der Warteschlange, an die veröffentlichte Nachrichten gesendet werden (Datenstromwarteschlange).
brokerQueueManagerstringDer Name des Warteschlangenmanagers, in dem der Broker ausgeführt wird.
brokerSubQueuestringDer Name der Warteschlange, aus der ein Konsument nicht permanenter Nachrichten die Nachrichten empfängt.
brokerVersion
  • 1
  • 2
Die Version des verwendeten Brokers.
1
1
2
2
cleanupIntervalZeitraum mit Genauigkeit in MillisekundenDas Intervall, in Millisekunden, zwischen den Hintergrundausführungen des Publish/Subscribe-Bereinigungsdienstprogramms. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m), Sekunden (s) und Millisekunden (ms). Geben Sie 500 Millisekunden beispielsweise als 500ms an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1s500ms entspricht beispielsweise 1,5 Sekunden.
receiveExitstringGibt ein Empfangsexitprogramm oder eine Folge von Empfangsexitprogrammen für den Kanal an, die nacheinander ausgeführt werden sollen.
receiveExitInitstringDie Benutzerdaten, die an die Empfangsexitprogramme des Kanals gesendet werden, wenn diese aufgerufen werden.
securityExitstringGibt ein Sicherheitsexitprogramm für den Kanalan.
securityExitInitstringDie Benutzerdaten, die an ein Sicherheitsexitprogramm des Kanals übergeben werden, wenn dieses aufgerufen wird.
sendExitstringGibt ein Sendeexitprogramm oder eine Folge von Sendeexitprogrammen für den Kanal an, die nacheinander ausgeführt werden sollen.
sendExitInitstringDie Benutzerdaten, die an die Sendexitprogramme des Kanals gesendet werden, wenn diese aufgerufen werden.
arbitraryPropertiesstringIn diesem Feld können Sie Eigenschaften angeben, die an keiner anderen Stelle definiert sind.