Von Linux und UNIX-Systemen aus mithilfe der DataDirect-Treiber eine Verbindung zu einer Datenbank herstellen

Definieren Sie den ODBC-Datenquellennamen (DSN) für die Datenbank, damit ein Broker eine Verbindung zu der Datenbank herstellen kann.

Die folgenden Informationen betreffen nur DB2-, Informix-, Oracle-, Sybase- und SQLServer-Datenbanken. Zu allen anderen unterstützten Datenbanken beachten Sie bitte den Abschnitt Von Linux- und UNIX-Systemen aus mithilfe des WebSphere Message Broker ODBC Database Extenders (IE02) eine Verbindung zu einer Datenbank herstellen.

Vorbereitungen:
  1. Kopieren Sie die Beispieldatei odbc.ini aus dem Verzeichnis install_dir/ODBC/V6.0 in eine Speicherposition Ihrer Wahl. Kopieren Sie die Datei beispielsweise nach /var/mqsi, das Benutzerverzeichnis für WebSphere Message Broker und die bevorzugte Position für diese Dateikopie. Somit kann jede Benutzer-ID des Broker-Service im System eigene DSN-Definitionen verwenden.

    Den Inhalt der Musterdatei finden Sie im Abschnitt DataDirect-Musterdatei 'odbc.ini'.

  2. Vergewissern Sie sich, dass die Datei odbc.ini über das Eigentumsrecht mqm:mqbrkrs und über dieselben Berechtigungen wie die bereitgestellte Beispieldatei verfügt.
  3. Setzen Sie die Umgebungsvariable ODBCINI so, dass sie auf die Datei odbc.ini zeigt. Geben Sie hierfür einen vollständigen Pfad und Dateinamen an. Vergewissern Sie sich, dass Sie auf die Kopie und nicht auf die Datei odbc.ini in den Installationsverzeichnissen zeigen.
  4. Legen Sie bei einer Verbindung zu DB2- oder Informix-Datenbanken die Umgebungsvariable für den Bibliothekssuchpfad so fest, dass sie auf die Speicherposition der Bibliotheken für den von Ihnen verwendeten Datenbankmanager zeigt.

    Weitere Informationen zum Bibliothekssuchpfad erhalten Sie bei Ihrem Datenbankadministrator oder in der Dokumentation zu Ihrem Datenbankmanager.

    Die Umgebungsvariable des Bibliothekssuchpfads hängt von Ihrer Plattform ab:
    • Linux platformSolaris platform Legen Sie unter Linux und Solaris LD_LIBRARY_PATH fest.
    • HP-UX platform Legen Sie unter HP-UX SHLIB_PATH fest.
    • AIX platform Legen Sie unter AIX LIBPATH fest.

    Für andere unterstützte Datenbanken sind keine Aktualisierungen des Bibliothekssuchpfads erforderlich.

  5. Wenn Sie eine DB2-Datenbankinstanz verwenden, die unter AIX installiert ist, kann ein einzelner Prozess unter Verwendung von gemeinsam genutztem Speicher maximal 10 Verbindungen zu einer DB2-Datenbank herstellen. Stellen Sie mit dem TCP/IP-Modus eine Verbindung zur Datenbankinstanz her (siehe Beim Herstellen einer Verbindung zu DB2 wird die DB2-Fehlernachricht SQL1224N ausgegeben).
  6. Bearbeiten Sie die letzte Zeilengruppe in der Datei odbc.ini (die Zeilengruppe [ODBC]), um den Standort des ODBC-Treibermanagers anzugeben und die Tracefunktion zu steuern. Die genauen Details in der Zeilengruppe hängen von der Plattform ab.
    Um sicherzugehen, dass Sie tatsächlich die korrekte Datei odbc.ini bearbeiten, können Sie die Datei mit dem folgenden Befehl im vi-Texteditor öffnen:
    vi $ODBCINI
    1. Fügen Sie in InstallDir das WebSphere Message Broker-Installationsverzeichnis hinzu, um den vollständig qualifizierten Pfad zum ODBC-Verzeichnis zu vervollständigen. Wenn Sie diesen Wert nicht korrekt angeben, funktioniert die ODBC-Definition nicht.
    2. Geben Sie in TraceFile den vollständig qualifizierten Pfad und Namen der Datei ein, in die das ODBC-Trace geschrieben wird. Tracedateien können sehr groß werden. Geben Sie daher ein Verzeichnis mit viel freiem Plattenspeicher an.
    3. Fügen Sie in TraceDll das WebSphere Message Broker-Installationsverzeichnis hinzu, um den vollständig qualifizierten Pfad zur ODBC-Trace-DLL-Datei zu vervollständigen.
    4. Akzeptieren Sie für alle anderen Einträge in der Zeilengruppe die in der Beispieldatei odbc.ini angezeigten Standardwerte.
      Ein Beispiel für AIX:
      ;##########################################
      ;###### Mandatory information stanza ######
      ;##########################################
      
      [ODBC]
      ;# To turn on ODBC trace set Trace=1
      Trace=0
      TraceOptions=3
      TraceFile=<Verzeichnis mit genügend freiem Speicherplatz für die
      Traceausgabe>/odbctrace.out
      TraceDll=<Broker-Installationsverzeichnis>/ODBC/V6.0/lib/odbctrac.so
      InstallDir=<Broker-Installationsverzeichnis>/ODBC/V6.0
      UseCursorLib=0
      IANAAppCodePage=4
      UNICODE=UTF-8
  7. Bearbeiten Sie die erste Zeilengruppe in der Datei odbc.ini, die Zeilengruppe [ODBC-Datenquellen], um für jede einzelne Datenbank den DSN aufzulisten.
    Ein Beispiel für AIX:
    ;##########################################
    ;###### List of data sources stanza #######
    ;##########################################
    [ODBC Data Sources]
    DB2DB=IBM DB2 ODBC Driver
    ORACLEDB=DataDirect 6.0 Oracle Wire Protocol
    ORACLERACDB=DataDirect 6.0 Oracle Wire Protocol (Real Application Clusters)
    SYBASEDB=DataDirect 6.0 Sybase Wire Protocol
    SYBASEDBUTF8=DataDirect 6.0 Sybase UTF8 Wire Protocol
    SQLSERVERDB=DataDirect 6.0 SQL Server Wire Protocol
    INFORMIXDB=IBM Informix ODBC Driver
    

    Listen Sie alle DSNs unabhängig vom Datenbankmanager in der Datei odbc.ini auf. Für Oracle und Sybase können Sie mehrere DSNs definieren, die in dieselbe Datenbank aufgelöst werden; da dies allerdings bei der globalen Koordination von Transaktionen Datenintegritätsprobleme verursachen kann, sollten Sie diese Option nicht verwenden.

  8. Erstellen Sie für jede in der Zeilengruppe [ODBC-Datenquellen] aufgeführte Datenbank in der odbc.ini-Datei eine Zeilengruppe hinter der Zeilengruppe [ODBC-Datenquellen]. Die Einträge in der Zeilengruppe hängen vom Datenbankmanager ab. Es bestehen außerdem leichte Unterschiede zwischen den Betriebssystemen, beispielsweise bei den Dateipfaden zu den Treibern.
    Bei einer DB2-Datenbankinstanz:
    Für Linux on x86:
    1. Geben Sie für Driver das vollständige Verzeichnis Ihrer DB2-Installation an.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie für Database den DB2-Aliasnamen ein. Der Name der Datenquelle muss mit dem Datenbankaliasnamen identisch sein. Bei Verwendung einer fernen DB2-Datenbank müssen Sie Ihre Client-Server-Verbindung entsprechend konfigurieren, dass dieser Aliasname in die korrekte Datenbank aufgelöst wird.

      Wenn mehrere Zeilengruppen benötigt werden, die auf dieselbe DB2-Datenbank verweisen, müssen in DB2 mit dem DB2-Befehl CATALOG Aliasnamen erstellt werden. Anschließend können für diese Aliasnamen in der Datei ODBCINI eigene Zeilengruppen definiert werden.

      Es ist nicht möglich, mithilfe der Datei ODBCINI Aliasnamen für DB2 einzurichten.

      Weitere Informationen hierzu finden Sie in der DB2-Dokumentation.

      Beispiel:

      ;# DB2 stanza
      [DB2DB]
      Driver=<DB2-Installationsverzeichnis>/lib32/libdb2.so
      Description=DB2 ODBC Database
      Database=DB2DB
    Für alle anderen Plattformen:
    1. Akzeptieren Sie für Driver den in der Beispieldatei odbc.ini angegebenen Wert.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie für Database den DB2-Aliasnamen ein. Der Name der Datenquelle muss mit dem Datenbankaliasnamen identisch sein. Bei Verwendung einer fernen DB2-Datenbank müssen Sie Ihre Client-Server-Verbindung entsprechend konfigurieren, dass dieser Aliasname in die korrekte Datenbank aufgelöst wird. Weitere Informationen hierzu finden Sie in der DB2-Dokumentation.

      Wenn mehrere Zeilengruppen benötigt werden, die auf dieselbe DB2-Datenbank verweisen, müssen in DB2 mit dem DB2-Befehl CATALOG Aliasnamen erstellt werden. Anschließend können für diese Aliasnamen in der Datei ODBCINI eigene Zeilengruppen definiert werden.

      Es ist nicht möglich, mithilfe der Datei ODBCINI Aliasnamen für DB2 einzurichten.

      Ein Beispiel für AIX:

      ;# DB2 stanza
      [DB2DB]
      DRIVER=<DB2-Installationsverzeichnis>/lib64/db2o.o
      Description=DB2DB DB2 ODBC Database
      Database=DB2DB
    Bei einer Oracle-Datenbank:
    Bei allen Plattformen:
    1. Fügen Sie für Driver das WebSphere Message Broker-Installationsverzeichnis hinzu, um den vollständig qualifizierten Pfad zu dem in der Beispieldatei odbc.ini angezeigten Treiber zu vervollständigen.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie in HostName den Namen oder die IP-Adresse des Systems ein, das als Host für das Oracle-System fungiert.
    4. Geben Sie unter PortNumber die Nummer des Ports ein, an dem Ihr Oracle-Server auf dem System, das Sie unter HostName angegeben haben, empfangsbereit ist.
    5. Geben Sie unter SID den Oracle-Servicenamen ein, zu dem Sie auf dem System, das Sie unterHostName angegeben haben, eine Verbindung herstellen möchten.
    6. Akzeptieren Sie für alle anderen Einträge in der Zeilengruppe die in der Beispieldatei odbc.ini angezeigten Standardwerte.
      Ein Beispiel für AIX:
      ;# Oracle stanza
      [ORACLEDB]
      Driver=<Broker-Installationsverzeichnis>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Name des Oracle-Servers>
      PortNumber=<Port, an dem Oracle auf Hostname empfangsbereit ist>
      SID=<Oracle-SID>
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Bei einer Oracle-Datenbank, die Real Application Clusters verwendet:
    Bei allen Plattformen:
    1. Fügen Sie für Driver das WebSphere Message Broker-Installationsverzeichnis hinzu, um den vollständig qualifizierten Pfad zu dem in der Beispieldatei odbc.ini angezeigten Treiber zu vervollständigen.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie in HostName den Namen oder die IP-Adresse des Systems ein, das als Host für die primäre (bevorzugte) Oracle-Instanz fungiert.
    4. Geben Sie unter PortNumber die Nummer des Ports ein, an dem Ihr Oracle-Server auf dem System, das Sie unter HostName angegeben haben, empfangsbereit ist.
    5. Geben Sie in ServiceName den Servicenamen von Oracle Real Application Cluster ein, zu dem Sie in der Instanz, die Sie unter HostName angegeben haben, eine Verbindung herstellen möchten.
    6. Geben Sie für den Fall, dass die in HostName definierte primäre Position nicht zur Verfügung steht, in AlternateServers eine Liste mit Alternativpositionen für diesen Service an. Jede Positionsangabe besteht aus drei Bereichen, die durch Doppelpunkte getrennt werden. Geben Sie diese Werte als eine fortlaufende Zeichenfolge ein; der Text in diesem Beispiel wurde zur besseren Lesbarkeit getrennt.
      HostName=<Name des alternativen Hosts>
      :PortNumber=<Oracle-Empfangsprogrammport auf Alternativserver>
      :ServiceName=<Servicename auf dem Alternativserver>
      Wenn Sie mehrere Alternativserver angeben möchten, trennen Sie jede weitere Positionsangabe durch ein Komma. Sobald eine neue Datenbankverbindung erforderlich ist, beispielsweise nach dem Failover einer Oracle-Instanz, wird zuerst die primäre Position verwendet. Wenn jedoch die primäre Position nicht verfügbar ist, geht der Treiber die Liste mit den alternativen Positionen durch.
    7. Akzeptieren Sie für alle anderen Einträge in der Zeilengruppe die in der Beispieldatei odbc.ini angezeigten Standardwerte.
      Ein Beispiel für AIX:
      ;# Oracle Real Application Clusters stanza
      [ORACLERACDB]
      Driver=<Broker-Installationsverzeichnis>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Name des Oracle-Servers>
      PortNumber=<Port, an dem Oracle auf Hostname empfangsbereit ist>
      ServiceName=<Oracle Real Application Cluster Service-Name>
      AlternateServers=(HostName=<Ihr alternativer Hostname>:PortNumber=<Port, an
      dem Oracle auf dem alternativen Host empfangsbereit ist>:ServiceName=<Ihr
      Oracle Real Application Cluster Service-Name>)
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Bei einer Sybase-Datenbank:
    Für alle Plattformen mit Ausnahme von Linux on System z:
    1. Fügen Sie für Driver das WebSphere Message Broker-Installationsverzeichnis hinzu, um den vollständig qualifizierten Pfad zu dem in der Beispieldatei odbc.ini angezeigten Treiber zu vervollständigen.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie in Database den Namen der Datenbank ein, zu der Sie standardmäßig eine Verbindung herstellen möchten. Wenn Sie keinen Wert angeben, wird standardmäßig die Datenbank verwendet, die vom Systemadministrator für den jeweiligen Benutzer definiert wurde.
    4. Geben Sie in NetworkAddress die Netzadresse Ihres Sybase-ASE-Servers ein (diese Adresse ist für lokale und ferne Datenbanken erforderlich). Geben Sie eine IP-Adresse oder einen Servernamen wie folgt an:
      <Ihr Sybase-Servername oder die IP-Adresse>,<Ihre Sybase-Portnummer>

      Beispiel: Sybaseserver,5000. Sie können auch die IP-Adresse direkt angeben, z. B. 199.226.224.34,5000. Sie finden die Portnummer in der Sybase-Schnittstellendatei, die interfaces heißt.

    5. Akzeptieren Sie für alle anderen Einträge in der Zeilengruppe die in der Beispieldatei odbc.ini angezeigten Standardwerte.
      Ein Beispiel für AIX:
      ;# Sybase Stanza
      [SYBASEDB]
      Driver=<Broker-Installationsverzeichnis>/ODBC/V6.0/lib/UKase24.so
      Description=DataDirect 6.0 Sybase Wire Protocol
      Database=<Datenbankname>
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      SelectMethod=0
      NetworkAddress=<Sybase-Servername>,<Sybase-Portnummer>
      SelectUserName=1
      ColumnSizeAsCharacter=1
      EnableSPColumnTypes=2
      LoginTimeout=0
      TimestampTruncationBehavior=1
      XAConnOptBehaviour=3
      Wenn Sie eine UNICODE UTF8 Sybase-Datenquelle verwenden möchten, fügen Sie am Ende der Sybase-Zeilengruppe die folgende Zeile hinzu:
      Charset=UTF8
    Für Fernzugriff auf eine SQL Server-Datenbank
    Für alle Plattformen mit Ausnahme von Linux on POWER, Linux on System z und Solaris on x86-64:
    1. Fügen Sie für Driver das WebSphere Message Broker-Installationsverzeichnis hinzu, um den vollständig qualifizierten Pfad zu dem in der Beispieldatei odbc.ini angezeigten Treiber zu vervollständigen.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie in Address eine der folgenden Angaben ein:
      1. Geben Sie wie folgt eine IP-Adresse oder einen Servernamen und eine Portnummer für die Suche nach der SQLServer-Datenbank ein, zu der Sie eine Verbindung herstellen möchten:
        <Ihr SQLServer-Systemname oder die IP-Adresse>,<Ihre SQLServer-Portnummer>
        oder
      2. Geben Sie wie folgt eine IP-Adresse oder einen Servernamen und einen Instanznamen für die Suche nach der SQLServer-Datenbank ein, zu der Sie eine Verbindung herstellen möchten:
        <Ihr SQLServer-Systemname oder die
        IP-Adresse>\<Ihr SQLServer-Instanzname>
        Wenn Ihr Instanzname leer ist, geben Sie stattdessen <Ihr SQLServer-Systemname oder die IP-Adresse> an.
    4. Geben Sie in Database den Namen der Datenbank ein, zu der Sie standardmäßig eine Verbindung herstellen möchten. Wenn Sie keinen Wert angeben, wird standardmäßig die Datenbank verwendet, die vom Systemadministrator für den jeweiligen Benutzer definiert wurde.
    5. Akzeptieren Sie für alle anderen Einträge in der Zeilengruppe die in der Beispieldatei odbc.ini angezeigten Standardwerte.
      Ein Beispiel für AIX:
      ;# UNIX to SQLServer stanza
      [SQLSERVERDB]
      Driver=<Broker-Installationsverzeichnis>/ODBC/V6.0/lib/UKmsss24.so
      Description=DataDirect 6.0 SQL Server Wire Protocol
      Address=<SQLServer-Systemname>,<SQLServer-Portnummer>
      ;# Alternative Suche nach dem Server mithilfe eines Instanznamens
      ;# Address=<SQLServer-Systemname>\<SQLServer-Instanzname>
      AnsiNPW=Yes
      Database=db
      QuotedId=No
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Bei einer Informix-Datenbank
    Für Linux on x86:
    1. Fügen Sie für Driver den vollständig qualifizierten Pfad der Informix Client-Bibliothek hinzu.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie in ServerName den Namen des Informix-IDS-Servers ein.
    4. Geben Sie in Database den Namen der Datenbank ein, zu der Sie standardmäßig eine Verbindung herstellen möchten. Wenn Sie keinen Wert angeben, wird standardmäßig der Name der Datenbank verwendet, die vom Systemadministrator für die einzelnen Benutzer definiert wurde.
      Beispielsweise
      ;# Informix Stanza
      [INFORMIXDB]
      Driver=<Informix-Clientverzeichnis>/lib/cli/iclit09b.so
      Description=IBM Informix ODBC Driver
      ServerName=<Informix-Servername>
      Database=<Datenbankname>
    Für alle anderen Plattformen:
    1. Akzeptieren Sie für Driver den in der Beispieldatei odbc.ini angegebenen Wert.
    2. Geben Sie in Description eine aussagefähige Beschreibung zur Datenbank ein. Dieses Feld dient nur zur Information und hat keinerlei Auswirkung auf die Verbindung.
    3. Geben Sie in ServerName den Namen des Informix-IDS-Servers ein.
    4. Geben Sie in Database den Namen der Datenbank ein, zu der Sie standardmäßig eine Verbindung herstellen möchten. Wenn Sie keinen Wert angeben, wird standardmäßig der Name der Datenbank verwendet, die vom Systemadministrator für die einzelnen Benutzer definiert wurde.
      Ein Beispiel für AIX:
      ;# Informix Stanza
      [INFORMIXDB]
      Driver=libinfWrapper.so
      Description=IBM Informix ODBC Driver
      ServerName=<Informix-Servername>
      Database=<Datenbankname>
  9. Vergewissern Sie sich, dass Sie alle drei Teile der Datei odbc.ini bearbeitet haben:
    • Die Zeilengruppe [ODBC Data Source] zu Beginn der Datei odbc.ini.
    • Eine Zeilengruppe für jede Datenquelle.
    • Die Zeilengruppe [ODBC] am Ende der Datei odbc.ini.
    Wenn nicht alle drei Teile korrekt konfiguriert werden, funktionieren die ODBC-DSNs nicht, und der Broker kann keine Verbindung zur Datenbank herstellen.
Damit haben Sie Datenbankverbindungen unter Linux und UNIX konfiguriert.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-08-06 17:59:57


TaskthemaTaskthema | Version 7.0.0.5 | bh26080_