Linux- und UNIX-Systeme: Warteschlangenmanager für die Koordination von JMS-Ressourcen konfigurieren

Bearbeiten Sie die qm.ini-Datei des Warteschlangenmanagers, um den Warteschlangenmanager zu konfigurieren.

Sie müssen in der .ini-Datei des Broker-Warteschlangenmanagers für jeden JMS-Provider, den Sie verwenden möchten, eine Zeilengruppe angeben. Es muss für jeden neuen JMS-Provider eine Zeilengruppe vorhanden sein, wobei der JMS-Provider von jedem JMSEmpfangs- oder JMSSendeknoten in einem Nachrichtenfluss, der auf diesem Broker ausgeführt wird, angegeben werden kann.

Die in XAOpenString übergebenen Parameter sind durch Kommas getrennt und positionsgebunden. Fehlende optionale Parameter müssen durch ein Komma dargestellt werden, wenn weiter hinten in der Zeichenfolge sonstige Parameter angegeben werden.

Der folgende Zeilengruppeneintrag ist ein Beispiel, das Sie bei Verwendung von WebSphere MQ Java als JMS-Provider hinzufügen können:
XAResourceManager:
	Name=WBIWMQJMS 
    SwitchFile=/<Installationspfad>/lib/JMSSwitch.so
    XAOpenString=<Ausgangskontextfactory>,
              <Position der JNDI-Bindungen>'
              <LDAP-Principal>,
              <LDAP-Berechtigungsnachweise>,
              <Name der Wiederherstellungs-Verbindungsfactory>,
              <JMS-Principal>,
              <JMS-Berechtigungsnachweise>  
              ThreadOfControl=THREAD 
Dabei gilt:
<Installationspfad>
Gibt das Verzeichnis der WebSphere Message Broker-Installation an. Dieser Wert ist obligatorisch, wenn keine LDAP-Parameter übergeben werden, zur Wiederherstellung jedoch eine benutzerdefinierte Warteschlangenverbindungsfactory angegeben wird.
<Ausgangskontextfactory>
Gibt die Kennung der Ausgangskontextfactory für den JMS-Provider an; dieser Wert ist erforderlich.
<Position der JNDI-Bindungen>
Gibt entweder den Dateipfad zur Bindungsdatei oder den Pfad des LDAP-Verzeichnisses der von JNDI verwalteten Objekte an, die zum Erstellen einer Ausgangskontextfactory für die JMS-Verbindung verwendet werden können. Schließen Sie in die Angabe des Dateipfads nicht den Dateinamen ein. Die Abschnitte zum JMSEmpfangs- und JMSSendeknoten enthalten ausführliche Informationen zum Erstellen der von JNDI verwalteten Objekte. Dieser Wert ist erforderlich.
<LDAP-Principal>
Dies ist ein optionaler Parameter zur Angabe des Principals (Benutzer-ID), der erforderlich sein kann, wenn eine LDAP-Datenbank zum Speichern der von JNDI verwalteten Objekte verwendet wird.
<LDAP-Berechtigungsnachweise>
Dies ist ein optionaler Parameter zur Angabe des Berechtigungsnachweise (Kennwort), die erforderlich sein können, wenn eine kennwortgeschützte LDAP-Datenbank zum Speichern der von JNDI verwalteten Objekte verwendet wird.
<Name der Wiederherstellungs-Verbindungsfactory>
Dies ist ein optionaler Parameter zur Angabe des Namens eines Warteschlangenverbindungsfactory-Objekts in den von JNDI verwalteten Objekten zu Wiederherstellungszwecken, wenn der vom Standard abweichende Name erforderlich ist.
<JMS-Principal>
Dies ist ein optionaler Parameter zur Angabe der Benutzer-ID, die für die Verbindung mit einem JMS-Provider unter Verwendung einer sicheren JMS-Verbindungsfactory erforderlich ist.
<JMS-Berechtigungsnachweise>
Dies ist ein optionaler Parameter zur Angabe des Kennworts, das zusammen mit dem JMS-Principal für die Verbindung mit demselben JMS-Provider erforderlich ist.

Die Werte für 'Ausgangskontextfactory' und 'Position der JNDI-Bindungen' in der Zeilengruppe müssen den Werten entsprechen, die in den JMSEmpfangs- oder JMSSendeknoten in den Nachrichtenflüssen angegeben sind.

Alle LDAP-Parameter müssen denen entsprechen, die mit dem Befehl mqsicreatebroker oder mqsichangebroker für diesen Broker angegeben wurden.

Der Name der Wiederherstellungsfactory muss dem Namen einer Warteschlangenverbindungsfactory entsprechen, die in den von JNDI verwalteten Objekten erstellt wurde. Wird kein Wert angegeben, wird eine Standardwertfactory mit der Bezeichnung recoverXAQCF verwendet. In beiden Fällen muss dieser Wert auf ein JNDI-verwaltetes Objekt verweisen, das bereits erstellt wurde.

Der JMS-Principal und die JMS-Berechtigungsnachweise müssen gemeinsam konfiguriert werden.

Es folgt ein Beispielformat für eine Zeilengruppe in der Datei qm.ini, in der ein JMS-Provider für globale Transaktionen beschrieben wird:
XAResourceManager:
    Name=XAJMS_PROVIDER1 
    SwitchFile=/opt/var/mqsi/lib/JMSSwitch.so
    XAOpenString= com.sun.jndi.fscontext.RefFSContextFactory,
              /Bindings/JMSProvider1_Bindings_Directory,
              ,
              ,
              ,  
              myJMSuser1,
              passwd 
              ThreadOfControl=THREAD
   
Dabei gilt:
XAJMS_PROVIDER1
Ist der benutzerdefinierte Name für den Ressourcenmanager.
/opt/var/mqsi
Ist der <Installationspfad>.
com.sun.jndi.fscontext.RefFSContextFactory
Ist die <Ausgangskontextfactory>.
/Bindings/JMSProvider1_Bindings_Directory
Ist die Position der Bindungen.
myJMSuser1
Ist der <JMS-Principal>.
passwd
Ist das in <JMS-Berechtigungsnachweise> verwendete Kennwort.
In diesem Beispiel sind die optionalen Felder <LDAP-Principal>, <LDAP-Berechtigungsnachweise> und <Name der Wiederherstellungs-Verbindungsfactory> nicht erforderlich. Deshalb sind in der Zeilengruppe XAOpenString nur die positionsgebundenen Kommabegrenzer konfiguriert.
Zugehörige Tasks
JMSInput- und JMSOutput-Knoten zur Unterstützung von globalen Transaktionen konfigurieren
Zugehörige Verweise
Befehl 'mqsicreatebroker'
Befehl 'mqsichangebroker'
JMSInput-Knoten
JMSOutput-Knoten
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac28610_