Ein JDBC-Provider-Service kann mit dem Befehl mqsicreateconfigurableservice oder dem Befehl mqsichangeproperties konfiguriert werden.
Zuordnungs-
oder einen benutzerdefinierten Java-Knoten in einen Nachrichtenfluss aufnehmen und es in diesem Knoten zu einer Interaktion mit einer Datenbank kommt, muss der Broker eine Verbindung zu der Datenbank herstellen, damit die Operationen des Knotens ausgeführt werden können. Sie müssen einen konfigurierbaren JDBCProvider-Service definieren, um
den Broker mit den Informationen zu versorgen, die er zum Herstellen der Verbindung benötigt.Ein konfigurierbarer JDBCProvider-Service unterstützt nur Verbindungen zu einer einzigen Datenbank. Sie müssen also für jede Datenbank, zu der die Knoten bzw. die Java-Anwendungen eine Verbindung herstellen, einen Service erstellen.
Informationen zur Konfiguration eines JDBC-Providers für Verbindungen vom Typ 4 unter Verwendung des WebSphere Message Broker Explorers finden Sie im Abschnitt Neuen konfigurierbaren Service erstellen.
Zur Konfiguration eines JDBC-Providers für Verbindungen vom Typ 4 unter Verwendung der Befehle mqsicreateconfigurableservice bzw. mqsichangeproperties führen Sie die folgenden Schritte aus:
Die unterstützten JDBC-Treiber und Datenbanken sind im Abschnitt Unterstützte Datenbanken aufgelistet. Die Unterstützung für global koordinierte Transaktionen (XA) ist auf einigen Plattformen und für einige Datenbanken eingeschränkt.
mqsireportproperties Brokername -c JDBCProviders -a -o AllReportableEntityNames
In der Befehlsausgabe werden alle definierten konfigurierbaren JDBCProvider-Services aufgelistet. Wenn Sie keine eigenen Definitionen erstellt haben, enthält die Liste die folgenden standardmäßig bereitgestellten Services:
Hinweise für Verbindungen zu einer Informix-Datenbank:
mqsireportproperties Brokername -c JDBCProviders -o Oracle -r
In der Befehlsausgabe werden alle Eigenschaften der Oracle-Definition aufgelistet. Sofern Sie diese Definition nicht geändert haben, sind die Eigenschaften auf ihre Anfangswerte gesetzt. Einige davon müssen Sie ändern, um eine funktionsfähige Definition zu erstellen. Beispielsweise ist die Eigenschaft databaseName auf Standarddatenbankname gesetzt. Sie müssen diesen Namen durch den Namen der spezifischen Datenbank ersetzen, zu der eine Verbindung hergestellt werden soll.
Ein JDBCProvider-Service hat folgende Eigenschaften:
jdbc:db2://[Servername]:[Portnummer]/[Datenbankname]:user=[Benutzer];password=[Kennwort];
Das Muster wird vom Broker während der Ausführung beim Erstellen einer Verbindung zur Datenbank verwendet und vervollständigt. Die Werte in eckigen Klammern, zum Beispiel [Servername], werden vom Broker im Muster durch die im Befehl mqsicreateconfigurableservice, mqsichangeproperties bzw. mqsisetdbparms angegebenen Werte ersetzt.
Bei der Ersetzung der Benutzer-ID und des Kennworts im Muster verwendet der Broker die folgenden Werte in der angegebenen Reihenfolge:
Unter Windows:
Die Benutzer-ID und das Kennwort des Broker-Service, die Sie mit dem Befehl mqsicreatebroker angegeben haben.
Unter Linux und UNIX: Die Benutzer-ID mqsiUser und
das Kennwort ******** (diese Werte sind festgelegt).
Unter z/OS: Die Benutzer-ID "" und das Kennwort "".Wenn Sie einen der bereitgestellten JDBCProvider-Services verwenden, darf mit dem Befehl mqsichangeproperties nicht das Muster selbst geändert werden, da solche Änderungen zu unvorhersehbaren Ergebnissen führen könnten.
Wenn Sie mit dem Befehl mqsicreateconfigurableservice Ihren eigenen JDBCProvider-Service definieren, prüfen Sie mit dem Befehl mqsireportproperties, ob der Inhalt der Zeichenfolge connectionUrlFormat genau dem Standard des bereitgestellten Providers für den von Ihnen verwendeten Datentyp entspricht.
Wenn Sie unter z/OS arbeiten und die JCL-Dateien BIPCRCS und BIPCHPR für die Definition Ihres JDBCProvider-Service verwenden, stellen Sie sicher, dass Ihr 3270-Emulator für die Nutzung derselben Codepage konfiguriert ist, die auch für die Brokerausführung verwendet wird. Wenn die Codepages nicht übereinstimmen, wird das von Ihnen definierte connectionUrlFormat Zeichenfolgemuster möglicherweise nicht richtig vom Broker erkannt.
Für den Verzeichnispfad kann auch ein Datenträger eines Speicherbereichsnetzes verwendet werden. Es ist jedoch nicht möglich, ein zugeordnetes Netzlaufwerk für einen fernen Computer zu verwenden.
Erstellen Sie eine Sicherheitsidentität und verwenden Sie hierfür den Befehl mqsisetdbparms (siehe Beschreibung im Abschnitt JDBC-Verbindung des Typs 4 sichern). Der Wert für securityIdentity (beispielsweise mysecurityIdentity) muss dem Wert entsprechen, der in diesem Befehl im Anschluss an das Präfix jdbc:: für den Parameter -n angegeben wird.
Die Sicherheitsidentität stellt ein Wertepaar des Typs 'Benutzer-ID/Kennwort' für den Zugriff auf die angegebene, für einen bestimmten JDBCProvider-Service-Eintrag definierte Datenquelle bereit. Diese Eigenschaft wird ignoriert, wenn die Verbindungs-URL nicht ein Benutzer-ID/Kennwort-Paar enthält, das die Ersetzung der Eigenschaftswerte verlangt.
Die Standardwerte, die Sie durch Angabe eines Werts für ResourceName von jdbc::JDBC im Befehl mqsisetdbparms festlegen können, werden unter folgenden Bedingungen verwendet:
jdbcProviderXASupport. Eine optionale Eigenschaft, die steuert,
ob der Broker über das XA-Protokoll eine Verbindung zu einem Datenbankserver herstellt. Diese
Eigenschaft ist standardmäßig auf 'true' gesetzt. Wenn der Datenbankserver nicht für das
XA-Protokoll aktiviert ist oder koordinierte Transaktionen nicht erforderlich sind, setzen Sie den
Wert auf 'false'. In diesem Fall wird der Typ-4-Treiber, der in der Eigenschaft
type4DriverClassName angegeben ist, verwendet und nicht die Typ-4-Datenquelle,
die in der Eigenschaft type4DatasourceClassName angegeben ist.
mqsicreateconfigurableservice Brokername -c JDBCProviders -o Providername
-n Eigenschaftsliste -v Werteliste
Geben Sie den Befehl in einer einzigen Zeile ein. Das Beispiel wurde lediglich zur besseren Lesbarkeit aufgeteilt.
Geben Sie alle Eigenschaften an, die vom ausgewählten Datenbankanbieter angefordert werden. Wenn Sie eine Liste aus Eigenschaften und Werten angeben, trennen Sie die Elemente nach jedem Attribut durch ein Komma. Beispiel: -n databaseName,databaseType -v MitarbeiterDB,DB2. Falls Sie in dem Befehl mqsicreateconfigurableservice nicht alle Eigenschaften angeben, können Sie diese später mit dem Befehl mqsichangeproperties aktualisieren.
Copyright IBM Corporation 1999, 2012.
Letzte Aktualisierung
: 2012-08-06 17:57:28
Taskthema |
Version 7.0.0.5
| ah61310_