1. インストールとユーザーズ・ガイド
  2. Oracle Database Gateway for WebSphere MQの構成
機械翻訳について

7 Oracle Database Gateway for WebSphere MQの構成

Oracle Database Gateway for WebSphere MQをインストールしたら、次のトピックの指示に従ってゲートウェイを構成します。

構成の概要

ゲートウェイは、OracleデータベースとWebSphere MQキュー間で通信するためのいくつかのコンポーネントと製品で動作します。

次に例を示します。

  • Oracle Net

    ゲートウェイとOracleデータベースは、Oracle Netを使用して、サーバーからサーバーの方法で通信します。 tnsnames.oraおよびlistener.oraファイルを構成してOracle Net通信を可能にするために、ゲートウェイおよびOracleデータベースを構成する必要があります。

  • ゲートウェイ初期化ファイルおよびパラメータ

    ゲートウェイには、使用するインストール用にカスタマイズが必要な初期化ファイルおよびパラメータがあります。 たとえば、ゲートウェイ・システム識別子(SID)を選択し、ゲートウェイ・ログ・ファイルの宛先などのその他の情報を提供する必要があります。

ゲートウェイの構成

ゲートウェイは、ゲートウェイSID、ディレクトリ名、ゲートウェイ・パラメータ設定のデフォルト値を使用して、インストールおよびプリインストールされます。

デフォルトSID値は次のとおりです。

  • dg4mqs

    これは、ゲートウェイがWebSphere MQと同一システム上にある場合に使用されるデフォルトSIDです。

  • dg4mqc

    これは、ゲートウェイがWebSphere MQと別のシステム上にある場合に使用されるデフォルトSIDです。 この場合、ゲートウェイはリモートWebSphere MQクライアントとして機能します。

基本的なゲートウェイ初期化ファイルもインストールされ、このファイル内の値がインストール・フェーズ中に入力した情報に基づいて設定されます。

デフォルト値でのゲートウェイの使用方法

ゲートウェイ・インスタンスを1つ構成し、どのデフォルト値も変更する必要がない場合、ほとんどのゲートウェイ構成プロセスはOracle Universal Installerによって完了します。

この場合、次のアクションを実行してください。

  1. 「"デフォルト値の変更"」の下のすべてのステップをスキップします。

  2. 「"ステップ1: ゲートウェイのOracle Net Oracle Net Listenerを構成"」をスキップ

  3. 「"ステップ2: ゲートウェイのOracle Net Listenerを停止して開始"」で始まり、章の最後に進みます。

デフォルト値以外でのゲートウェイの使用方法

このトピックでは、デフォルト値を変更する方法について説明します。

ゲートウェイの複数のインスタンスが構成されている場合、またはインストール段階で構成されたデフォルト値を変更する場合は、「"デフォルト値の変更"」のステップから始めて、この章の最後に進みます。

デフォルト値の変更

デフォルト値の変更の際、ゲートウェイSIDを選択してゲートウェイ初期化ファイルをカスタマイズしてください。

手順1: ゲートウェイのシステムIDの選択

ゲートウェイSIDは、ゲートウェイ・インスタンスを識別する1から64文字の英数文字列です。 SIDは、ゲートウェイ・ブート・ファイル内でゲートウェイ・パラメータ・ファイルのファイル名の一部として使用されます。

デフォルトのSIDと異なる、そしてdg4mqsおよびdg4mqcとは異なる、 SID を選択してください。

アクセスするそれぞれのキュー・マネージャに、個別のゲートウェイ・インスタンスが必要です。 異なる2つのキュー・マネージャにアクセスする場合、ゲートウェイのインスタンスに対して1つずつ、2つのゲートウェイSIDが必要です。 キュー・マネージャが1つあり、それにアクセスする際に、ゲートウェイ・パラメータ設定のあるセットを使用するときと、別のゲートウェイ・パラメータ設定を使用するときがある場合、1つのキュー・マネージャに複数のゲートウェイSIDを持つことで可能になります。

手順2: ゲートウェイ初期化ファイルのカスタマイズ

このトピックでは、ゲートウェイ初期設定ファイルをカスタマイズする方法について説明します。

ゲートウェイ初期化ファイル(init sid .ora)は、「ゲートウェイ初期化パラメータ」で説明されているすべてのデータベース・ゲートウェイ初期化パラメータをサポートします。 ゲートウェイの起動の際、初期化ファイルが使用可能である必要があります。

インストール中に、デフォルトの初期化のファイルはsidがdg4mqsまたはdg4mqcのデフォルトSIDであるUNIXベースのシステム上で、Microsoft Windowsと $ ORACLE_HOME/dg4mq/admin/init sid. oraにORACLE_HOME\dg4mq\admin\init sid .oraに作成されます。 デフォルトではないSIDを選択する場合、手順1: ゲートウェイのシステムIDの選択で選択したSIDを使用してこのファイル名を変更してください。 必要に応じ、デフォルト初期化ファイルをカスタマイズしてください。

次のエントリが、初期化ファイルに表示されます。

LOG_DESTINATION=log_file
QUEUE_MANAGER=manager_name
AUTHORIZATION_MODEL=auth_model
TRANSACTION_MODEL=tx_model
TRANSACTION_LOG_QUEUE=tx_queue_name
TRANSACTION_RECOVERY_USER=rec_user
TRANSACTION_RECOVERY_PASSWORD=rec_password
TRACE_LEVEL=0
MQSERVER=channel
MQCCSID=character_set

説明:

  • log_fileは、ゲートウェイ・ログファイルの絶対パス名を指定します。

  • manager_nameは、アクセスするWebSphere MQキュー・マネージャの名前です。

  • auth_modelは、使用する許可モデルです。 デフォルト値はRELAXEDです。

  • tx_modelは使用するトランザクション・モデルです。 デフォルトはSINGLE_SITEです。

  • tx_queue_nameは、分散トランザクションのトランザクションIDを記録するためのキューの名前です。 これは、tx_modelがCOMMIT_CONFIRMに設定されている場合にのみ使用されます。

  • rec_userは、ゲートウェイが分散トランザクションのリカバリを開始するために使用するユーザー名を指定します。 これは、auth_modelがSTRICTに設定され、tx_modelがCOMMIT_CONFIRMに設定されている場合にのみ使用されます。

  • rec_passwordは、ゲートウェイが分散トランザクションのリカバリを開始するために使用するユーザー名のパスワードを指定します。

  • channelは、WebSphere MQサーバーのロケーションと使用する通信方式を指定します。 チャネル書式は、次のとおりです。

    channel_name/connection_type/hostname [(port_number)]

    次に例を示します。

    MQSERVER=CHAN9/TCP/dolphin(1425)

  • character_setは、WebSphere MQキュー・マネージャと通信するときにゲートウェイが使用するコード化文字セット番号を指定します。 これはオプションのパラメータです。

    このパラメータは、WebSphere MQキュー・マネージャを実行中のシステムが、ゲートウェイを実行するシステムとは別のコード体系を使用する場合にのみ設定されます。 設定すると、character_setの値はゲートウェイ・システム上のWebSphere MQクライアント・ソフトウェアによって使用され、データが変換されます。

トランザクションとセキュリティ・モデルの詳細については、「ゲートウェイ実行環境」を参照してください。

関連項目:

「Oracle Databaseネット・サービス管理者ガイド」と「Oracle Databaseネット・サービス・リファレンス」

ゲートウェイへのOracle Netの構成

ゲートウェイには、Oracleデータベースへ、またはOracleデータベースからの透過的データ・アクセスを提供するために、Oracle Netが必要です。

Oracle Netは、Oracle Net Listenerを使用して、Oracle Netクライアントからの受信接続を受信します。 ゲートウェイの場合、Oracle Net Listenerは、Oracleデータベースからの受信リクエストをリスニングします。 Oracle Net Listenerでゲートウェイをリスニングするには、ゲートウェイに関する情報をOracle Net Listener構成ファイル(listener.ora)に追加する必要があります。 このファイルは、デフォルトでMicrosoft Windowsの場合 ORACLE_HOME/network/adminディレクトリに、UNIXベース・システムの場合ORACLE_HOME\network\adminディレクトリにあります。ここで、ORACLE_HOMEはゲートウェイがインストールされているディレクトリです。 このファイルのデフォルト値は、Oracle Universal Installerによるインストール・プロセスの際に設定されます。

デフォルト・ゲートウェイ値でのOracle Netの使用

ゲートウェイ・インスタンスを1つ構成し、どのデフォルト値も変更する必要がない場合、Oracle Netをさらに構成する必要はありません。

「"ステップ2: ゲートウェイのOracle Net Listenerを停止して開始"」のみ実行してください。

デフォルト・ゲートウェイ値を変更した場合のOracle Netの使用

Oracle Net Listenerを複数のゲートウェイ・インスタンスで使用する、またはインストール・フェーズで設定したデフォルト値のいくつかを変更する必要がある場合、この項の手順1および手順2を実行してください。

ステップ1では、Microsoft Windows場合ORACLE_HOME\network\adminの、UNIXベース・システムの場合ORACLE_HOME /network/adminのゲートウェイ・ディレクトリのlistener.oraファイルにデフォルト情報を追加したり変更したりします。

手順1: Oracle Net Oracle Net Listenerのゲートウェイへの構成

listener.oraファイルの構成。

2つのエントリをlistener.oraファイルに追加する必要があります:

  • Oracle Net ListenerがリスニングするOracle Netアドレスのリスト

  • 受信接続リクエストに応答してOracle Net Listenerが開始するゲートウェイ・プロセス

    注意:

    Oracle Net Listenerおよびゲートウェイは、同一のノードにある必要があります。 ノードでOracle Net Listenerをすでに実行中の場合、手順1および手順2で示すように既存のlistener.oraおよびtnsnames.oraファイルを変更する必要があります。

    変更を加えた後、lsnrctlユーティリティでreloadサブコマンドを実行すると、Oracle Net Listenerをシャットダウンすることなく、変更をリロードできます。

Oracle Net ListenerのOracle Netアドレスの指定

Oracle NetおよびTCP/IPプロトコル・アダプタを使用する場合、listener.oraファイルのエントリの構文は次のとおりです。 

LISTENER=
  (ADDRESS_LIST=
      (ADDRESS= 
          (PROTOCOL=TCP)
          (HOST=host_name)
          (PORT=port_number)
       )
  )

説明:

  • host_nameは、ゲートウェイがインストールされているシステムの名前です。

  • port_numberは、Oracle Net Listenerによって使用されるIPポート番号を指定します。 同じシステム上のOracleデータベースのリスナーなど、他のリスナーがhost_name上で実行されている場合、port_numberの値は他のリスナー・ポート番号と異なる必要があります。

Oracle Netおよびプロセス間ソケット・コール(ICP)・プロトコル・アダプタを使用する場合、listener.oraファイルのエントリの構文は次のとおりです。 

LISTENER=
  (ADDRESS_LIST=
     (ADDRESS= 
         (PROTOCOL=IPC)
         (KEY=key_name)
     )
   )

説明:

  • IPCは、接続に使用するプロトコルをIPCに指定します。

  • key_nameは一意のユーザー定義のサービス名です。

ゲートウェイのエントリ

Oracle Net Listenerを構成して受信接続リクエストのゲートウェイ・インスタンスをリスニングするには、次の構文を使用してlistener.oraファイルにエントリを追加してください。 

SID_LIST_LISTENER=
   (SID_LIST=
      (SID_DESC=
          (SID_NAME=gateway_sid)
          (ORACLE_HOME=gateway_directory)
          (PROGRAM=driver)
       )
    )

説明:

  • gateway_sidは、ゲートウェイのSIDを指定し、tnsnames.oraファイルの接続記述子エントリで指定されたゲートウェイSIDと一致します。

  • gateway_directoryは、ゲートウェイ・ソフトウェアが存在するゲートウェイ・ディレクトリを指定します。

  • driverは、ゲートウェイ実行可能ファイルの名前です。 ゲートウェイがローカルWebSphere MQサーバーを使用する場合、このファイル名はdg4mqsです。 ゲートウェイをWebSphere MQクライアントとして実行しリモートWebSphere MQサーバーにアクセスする場合、このファイル名はdg4mqcです。

複数のゲートウェイ・インスタンスにエントリを追加する場合、既存のSID_LIST構文にエントリを追加してください。 

SID_LIST_LISTENER=
 (SID_LIST=
      (SID_DESC=.
                .
                .
      )
      (SID_DESC=.
                .
                .
      )
      (SID_DESC= 
          (SID_NAME=gateway_sid)
          (ORACLE_HOME=gateway_directory)
          (PROGRAM=driver)
       )
  )

次に、listener.oraファイルに追加するエントリの例を示します。

Microsoft Windowsの場合:

(SID_DESC =
         (SID_NAME=dg4mqs)
         (ORACLE_HOME=gateway_directory)
         (PROGRAM=dg4mqs)
)

UNIXベース・システムの場合:

(SID_DESC =
         (SID_NAME=dg4mqs)
         (ORACLE_HOME=/oracle/app/oracle/product/dg4mq)
         (PROGRAM=dg4mqs)
)

関連トピック

関連項目:

listener.oraの変更に関する追加情報については、「Oracle Databaseネット・サービス管理者ガイド」および「Oracle Databaseネット・サービス・リファレンス」を参照してください。

手順2: ゲートウェイのOracle Net Listenerの停止および起動

新しい設定を初期化するには、Oracle Net Listenerを起動またはリロードする必要があります。

注意:

ゲートウェイがインストールされているOracleデータベース上で、Oracle Net Listenerをすでに実行中の場合、既存のlistener.oraおよびtnsnames.oraファイルを変更する必要があります。 変更後、lsnrctlユーティリティ内のreloadサブ・コマンドを実行すると、Oracle Net Listenerを停止せずに変更をリロードできます。

手順1: Oracle Net Oracle Net Listenerのゲートウェイへの構成の注意を参照してください。

  • ゲートウェイ・ディレクトリ名を設定します:

    Microsoft Windowsの場合:

    set TNS_ADMIN=c:\orant\network\admin

    BourneまたはKornシェルを使用している場合、次のように入力します。

    $ ORACLE_HOME=gateway_directory;export ORACLE_HOME

    Cシェルを使用している場合、次のように入力します。

    $ setenv ORACLE_HOME gateway_directory

    説明:

    gateway_directoryは、ゲートウェイ・ソフトウェアがインストールされているディレクトリを指定します。

  • リスナーがすでに実行中の場合、lsnrctlコマンドを使用してリスナーを新しい設定でリロードします。

    Microsoft Windowsの場合:

    c:\orant\bin> lsnrctl reload your_listener_name

    UNIXベース・システムの場合:

    $ cd $ORACLE_HOME/bin
$ ./lsnrctl reload your_listener_name

    説明:

    ORACLE_HOME は、ゲートウェイ・ソフトウェアがインストールされているディレクトリを指定します。

  • 新しい設定のリスナーのステータスを確認します。

    Microsoft Windowsの場合:

    c:\orant\bin> lsnrctl status your_listener_name

    UNIXベース・システムの場合:

    $ ./lsnrctl status listener_name

    次に、lsnrctlステータス・チェックの出力の例を示します。

Microsoft Windowsの場合:

Connecting to (ADDRESS=(PROTOCOL=IPC)(KEY=ORAIPC))
STATUS of the LISTENER
------------------------
Alias                     LISTENER
Version                   TNSLSNR for MS Windows: version 12.2.0.1.0 - Beta
Start Date                14-Sep-16 18:16:10
Uptime                    0 days 0 hr. 2 min. 19 sec
Trace Level               off
Security                  OFF
SNMP                      OFF
Listener Parameter File   \oracle\app\oracle\product\dg4mqs\network\admin\listener.ora
Listener Log File         \oracle\app\oracle\product\dg4mqs\network\log\listener.log
Services Summary...
  dg4mqs            has 1 service handler(s)
The command completed successfully

UNIXベース・システムの場合:

Connecting to (ADDRESS=(PROTOCOL=IPC)(KEY=ORAIPC))
STATUS of the LISTENER
------------------------
Alias                     LISTENER
Version                   TNSLSNR for Solaris: version 12.2.0.1.0 - Production
Start Date                14-Sep-16 10:16:10
Uptime                    0 days 0 hr. 2 min. 19 sec
Trace Level               off
Security                  OFF
SNMP                      OFF
Listener Parameter File   /oracle/app/oracle/product/dg4mqs/network/admin/listener.ora
Listener Log File         /oracle/app/oracle/product/dg4mqs/network/log/listener.log
Services Summary...
  dg4mqs            has 1 service handler(s)
The command completed successfully

例では、dg4mqsがインストール中に割り当てられたデフォルトSID値です。 いずれかの有効なIDをSIDに使用するか、デフォルトを維持してください。

注意:

構成される各ゲートウェイ・インスタンスに対して、tnsnames.oraファイル、listener.oraファイルおよびゲートウェイ初期化ファイルのGATEWAY_SID環境変数で同じSID値を使用する必要があります。

Oracle DatabaseのためのOracle Netの構成

Oracle Netを使用してゲートウェイと通信できるように、Oracleデータベースを構成する必要があります。

Oracleデータベースにアクセスを持つOracleアプリケーションは、ゲートウェイを通じてWebSphere MQにアクセスできます。 ゲートウェイを使用してWebSphere MQにアクセスする前に、Oracleデータベースを構成し、Oracle Netを使用してゲートウェイと通信できるようにする必要があります。 サーバーを構成するには、接続記述子をtnsnames.oraファイルに追加します。

ゲートウェイにアクセスするOracleデータベースでは、Oracleデータベースに接続方法を告げるため、Oracleデータベースにサーバー上のtnsnames.oraファイル内に、サービス名エントリまたは接続記述子名エントリが必要です。 このファイルは、デフォルトでは、UNIXベースのシステムの場合はMicrosoft WindowsおよびORACLE_HOME/network/adminディレクトリのORACLE_HOME \network\adminディレクトリにあります。ORACLE_HOMEは、Oracleデータベースがインストールされているディレクトリです。 tnsnames.oraファイルがゲートウェイにアクセスするOracle Databaseに必要ですが、ゲートウェイには必要ありません。

関連トピック

関連項目:

tnsnames.oraファイルの変更の詳細については、「Oracle Databaseネット・サービス管理者ガイド」および「Oracle Databaseネット・サービス・リファレンス」を参照してください。

デフォルト・ゲートウェイ値の使用

Oracle Universal Installerは、tnsnames.oraファイルを作成して事前構成します。ORACLE_HOMEは、ゲートウェイ・ソフトウェアがインストールされているディレクトリです。

Oracle Universal Installerは、tnsnames.oraファイルをORACLE_HOME/network/adminディレクトリに作成して事前構成します。Microsoft Windowsの場合は、ORACLE_HOME/network/adminディレクトリに、UNIXシステムの場合はORACLE_HOME/network/adminディレクトリにあり、ここで、ORACLE_HOMEはゲートウェイ・ソフトウェアがインストールされているディレクトリです。 デフォルト値を使用する場合、および追加のゲートウェイ・インスタンスを構成する必要がない場合、ゲートウェイにアクセスする各Oracleデータベースのtnsnames.oraファイルにこのファイルの内容を追加できます。

デフォルト・ゲートウェイ値の変更

いくつかのデフォルト設定を変更する必要がある場合、この項で説明する例を使用してください。

  • 「TCP/IPの例」
    これは、TCP/IPプロトコル・アダプタを使用する例です。
  • 「IPCの例」
    これは、IPCプロトコル・アダプタを使用した例です。
TCP/IPの例

これは、TCP/IPプロトコル・アダプタを使用する例です。

Oracleデータベースは、Oracle NetおよびTCP/IPプロトコル・アダプタを使用してゲートウェイにアクセスします。 tnsnames.ora内の接続記述子エントリの構文は次のとおりです。 

tns_name_entry=
  (DESCRIPTION=
     (ADDRESS=
          (PROTOCOL=TCP)
          (HOST=host_name)
          (PORT=port_number)
     )
     (CONNECT_DATA=
     (SID=gateway_sid)
     )
     (HS=OK)
)

この例では、次のようになります。

  • tns_name_entryは、CREATE DATABASE LINK文のtns_name_entryです。

  • TCP/IPは、接続に使用するプロトコルをTCP/IPに指定します。

  • port_numberは、ゲートウェイをリッスンするOracle Net Oracle Net Listenerによって使用されるポート番号です。 この番号は、Oracle Net Listenerで使用するlistener.oraファイルにあります。

  • host_nameは、ゲートウェイが実行されているシステムを指定します。 Oracle Net Listenerホスト名は、ゲートウェイをリスニングするOracle Net Listenerで使用するlistener.oraファイルにあります。

  • gateway_sidは、ゲートウェイのSIDを指定し、ゲートウェイをリスンするOracle Net Listenerのlistener.oraファイルで指定されているSIDと一致します。

IPCの例

これは、IPCプロトコル・アダプタを使用した例です。

Oracleデータベースは、Oracle NetおよびIPCプロトコル・アダプタを使用してゲートウェイにアクセスします。 tnsnames.ora内の接続記述子エントリの構文は次のとおりです。 

tns_name_entry=
    (DESCRIPTION=
        (ADDRESS=
        (PROTOCOL=IPC)
        (KEY=key_name)
    )
    (CONNECT_DATA=
        (SID=gateway_sid)
    )
     (HS=OK)
  )

説明:

  • tns_name_entryは、CREATE DATABASE LINK文のtns_name_entryです。

  • IPCは、接続に使用するプロトコルをIPCに指定します。

  • key_nameはサービス名です。

  • gateway_sidは、ゲートウェイのSIDを指定し、ゲートウェイをリッスンしているOracle Net Listenerのlistener.oraファイルで指定されているSIDと一致します。

トランザクション・ログ・キューの作成

ゲートウェイ初期構成ファイルのTRANSACTION_MODELパラメータが分散トランザクションを可能にするためにCOMMIT_CONFIRMに構成されている場合は、追加の構成ステップが必要です。

この ステップは以下の目的で必要です:

  • WebSphere MQキューの作成

  • ゲートウェイ初期化ファイル内でのTRANSACTION_LOG_QUEUE、TRANSACTION_RECOVERY_USERおよびTRANSACTION_RECOVERY_PASSWORDパラメータの作成

関連項目:

キューの作成および構成の詳細は、IBMのドキュメントを参照してください。

ゲートウェイで分散トランザクションをリカバリするには、WebSphere MQシステム管理者が、リカバリ・アカウントおよびキューをキュー・マネージャに設定する必要があります。 このアカウントは、有効なWebSphere MQユーザーを持ち、リカバリ・キューへのアクセスを認可されている必要があります。

ゲートウェイは、ゲートウェイによりキュー・マネージャで起動され、このキューにログインした失敗したトランザクションのステータスを、リカバリ・キューを使用して確認します。 このキュー内の情報はリカバリ・プロセスで有効で、ゲートウェイ以外が使用、アクセスまたは更新できません。

関連トピック

データベース・リンク別名ライブラリの管理

ゲートウェイへの接続は、Oracleセッションでゲートウェイが初めて使用されるときに、データベース・リンクを介して確立されます。

ここで、connectionは、Oracleデータベースとゲートウェイ間の接続を指します。  接続は、Oracleセッションが終了するまで持続します。 別のセッションまたはユーザーは、同一のデータベース・リンクにアクセスし、ゲートウェイおよびキュー・マネージャに別個に接続できます。

データベース・リンクは、ゲートウェイ・セッションの継続中はアクティブです。 セッション中にデータベース・リンクを閉じる場合、ALTER SESSION文を使用します。

関連項目:

データベース・リンクの使用の詳細については、「Oracle Database管理者ガイド」を参照してください。

データベース・リンクの使用

Oracle Database Gateway for WebSphere MQは、別名ライブラリを使用して、Oracle Database Gateway for WebSphere MQとインストールされている共有ライブラリにアクセスします。

別名ライブラリは、PL/SQL内のライブラリを表すスキーマ・オブジェクトです。 別名ライブラリを作成するには、CREATE LIBRARY PRIVILEGEが必要です。 Oracle Database Gateway for WebSphere MQで使用する別名ライブラリはlibdg4mqで、これはpgmobj.sqlスクリプトで定義され、Oracle Database Gateway for WebSphere MQデプロイ・スクリプトの実行の際に作成されます。

データベース・リンクの作成

データベース・リンクを作成するには、CREATE DATABASE LINK文を使用します。

USING 句は、tnsnames.oraファイル内の接続記述子を指します。 CONNECT TO句では、セキュリティ・モデルがAUTHORIZATION_MODELパラメータでSTRICTに定義された場合、WebSphere MQユーザーIDとパスワードを指定します。 CONNECT TO句を含めない場合、現行のユーザーIDおよびパスワードが使用されます。

AUTHORIZATION_MODELパラメータがRELAXEDに設定された場合、Oracleデータベースは、ゲートウェイのOracle Net Listenerを起動したユーザー・アカウントのユーザーIDおよびパスワードを使用するため、ユーザーIDおよびパスワードを指定する必要はありません。 CONNECT TO句でユーザーIDおよびパスワードを指定すると、Oracleデータベースおよびゲートウェイはこれらの値を無視します。

CREATE DATABASE LINK構文は次のとおりです。 

CREATE [PUBLIC] DATABASE LINK dblink [CONNECT TO userid IDENTIFIED
              BY password] USING 'tns_name_entry';

説明:

  • dblinkはデータベース・リンク名です。

  • useridは、キュー・マネージャでセッションを確立するために使用されるユーザーIDです。 これは、AUTHORIZATION_MODELがinit sidのSTRICTに設定されている場合にのみ使用されます。oraファイル。 ユーザーIDは、すべてのWebSphere MQオブジェクトへのアクセスに対して認証され、PL/SQLコマンド内のデータベース・オブジェクト参照を使用する必要があります。

    useridは、WebSphere MQとゲートウェイがインストールされているコンピュータのパスワード・ファイルになければなりません。 それ以外の場合は、WebSphere MQとゲートウェイが異なるシステムにインストールされている場合は、userid をUNIXネットワーク情報サービス(NIS)に公開する必要があります。 useridに小文字または英数字以外の文字が含まれている場合は、useridを引用符( ")で囲む必要があります。 useridの詳細は、WebSphere MQのドキュメントを参照してください。

  • passwordは、キュー・マネージャでセッションを確立するために使用されるパスワードです。 これは、AUTHORIZATION_MODELがinit sidのSTRICTに設定されている場合にのみ使用されます。oraファイル。

    passwordは、WebSphere MQおよびゲートウェイがインストールされているシステム上のパスワード・ファイル内にある必要があります。 そうでなければ、WebSphere MQおよびゲートウェイが別のシステムにインストールされている場合、passwordは、WindowsまたはUNIXネットワーク情報サービス(NIS)で公開される必要があります。

    passwordに小文字または英数字以外の文字が含まれている場合は、passwordを引用符( ")で囲みます。

  • tns_name_entryは、tnsnames.oraファイルで指定されたOracle Net TNS接続記述子の名前です。

関連トピック

データベース・リンクの削除

DROP DATABASE LINK文を使用すると、データベース・リンクを削除できます。

たとえば、dblinkという名前のデータベース・リンクを削除するには、次のようにします。 

DROP [PUBLIC] DATABASE LINK dblink;

インダウト分散トランザクションを解決する必要がある場合は、データベース・リンクを削除しないでください。

関連項目:

データベース・リンクを削除する方法の詳細は、「Oracle Database SQL言語リファレンス」を参照してください。

使用可能なデータベース・リンクの調査

各データベースのデータ・ディクショナリには、そのデータベースに関するすべてのデータベース・リンクの定義が格納されます。

USER_DB_LINKSビューには、ユーザー用に定義されたデータベース・リンクが表示されます。 ALL_DB_LINKSデータ・ディクショナリ・ビューには、定義済のすべてのデータベース・リンクが表示されます。

アクティブなデータベース・リンク数の制限

OPEN_LINKSパラメータを使用すると、ユーザー・プロセスからリモート・データベースへの接続数を制限できます。

このパラメータで、単一のユーザー・プロセスが単一のユーザー・セッションで使用できるリモート接続数を制御します。

関連項目:

アクティブなデータベース・リンクの数を制限する方法の詳細は、「Oracle Database管理者ガイド」を参照してください。

別名ライブラリの作成

Oracle Database Gateway for WebSphere MQデプロイ・スクリプトを使用して、Oracle Database Gateway for WebSphere MQ別名ライブラリ、libdg4mqを作成してください。

インストール時に、適切な共有ライブラリ名が、選択したDG4MQモデルに基づくUXIXベースのシステムの ORACLE_HOME\dg4mq\admin\deploy\pgmobj.sql on Microsoft Windows and ORACLE_HOME /dg4mq/admin/deploy/pgmobj.sqlに定義されています。

リモート・モデルの場合、libdg4mqc.so共有ライブラリが使用されます。 次に例を示します。 

CREATE OR REPLACE LIBRARY libdg4mq AS 'ORACLE_HOME/lib/libdg4mqc.so' TRANSACTIONAL;

ローカル・モデルの場合、libdg4mqs.so共有ライブラリが使用されます。 次に例を示します。 

CREATE OR REPLACE LIBRARY libdg4mq AS 'ORACLE_HOME/lib/libdg4mqs.so' TRANSACTIONAL;

注意:

HP-UX上の共有ライブラリのファイル拡張子は .slです。 たとえば、libdg4mqc.sl

別名ライブラリの削除

アンデプロイ・スクリプトを使用して、libdg4mqOracle Database Gateway for WebSphere MQ別名ライブラリを削除してください。

Oracle Visual Workbenchリポジトリのインストール

この項の手順に従い、Oracle Visual Workbenchリポジトリをインストールしてください。

Oracle Visual Workbenchを使用する予定がない場合、またはVisual Workbenchリポジトリを必要としない代わりにOracle Database Gateway for WebSphere MQデプロイメントが必要な本番Oracleデータベースを準備する場合は、Oracle Visual Workbenchリポジトリのインストールをスキップできます。

関連トピック

インストール前のタスク

これらのステップでは、インストール前の作業について説明します。

手順1: リポジトリ・サーバーの選択

このステップでは、リポジトリ・サーバーの選択方法について説明します。

リポジトリ・サーバーは、Visual WorkbenchリポジトリがインストールされているOracleデータベースです。

手順2: 初期化スクリプトの検出

このステップでは、インストール・スクリプトの検索方法について説明します。

Visual Workbenchリポジトリのインストール・スクリプトは、Visual Workbenchとともにインストールされます。 リポジトリをOracle Visual Workbenchと同じシステムにインストールする場合は、リポジトリ・サーバーにすでに必要なすべてのインストール・スクリプトがあります。 手順3に進みます。

  1. スクリプト・ディレクトリのリポジトリ・サーバーにディレクトリを作成します。 次に例を示します。

    Microsoft Windowsの場合:

    > md %ORACLE_HOME%\dg4mqadmin\repo

    UNIXベース・システムの場合:

    $ mkdir $ORACLE_HOME/dg4mq/admin/repo
$ chmod 777 $ORACLE_HOME/dg4mq/admin/repo
  2. ファイル転送プログラムを使用して、Visual Workbenchシステムのリポジトリzipファイル(repos XXX. zip、XXXはリリース番号)を転送するか、または.sqlサフィクス付きのすべてのスクリプト・ファイルをVisual Workbenchワークベンチのスクリプト・ファイル・ディレクトリ (Windowsでは(ORACLE_HOME\dg4mqvwb\server\admin) からリポジトリ・サーバー・システム上のスクリプト・ファイル・ディレクトリのに移動します)
手順3: Visual Workbenchリポジトリのアップグレード

このステップでは、Visual Workbenchリポジトリのインストール・スクリプトをアップグレードする方法について説明します。

pgm xxxをコピーして、既存のVisual Workbenchリポジトリ・インストール・スクリプトをアップグレードします。Oracle Database Gateway for WebSphere MQでORACLE_HOME\dg4mq\admin\deployディレクトリにOracle Database Gateway for WebSphere MQでインストールされたsqlファイルを、Microsoft Windows上にインストールし、UNIXベース・システム上のORACLE_HOME/dg4mq/admin/deployディレクトリをリポジトリ・サーバー・システム上のスクリプト・ファイル・ディレクトリにインストールします。

手順4: UTL_RAWパッケージがインストール済であることの確認

このステップでは、UTL_RAWパッケージがインストールされていることを確認する方法を説明します。

Visual Workbenchで生成されたマッピング・パッケージは、ロー・データ操作のルーチンを提供するUTL_RAWパッケージを使用します。

SQL*Plusから、SYSユーザーとして、次の文を発行してください。 

SQL> DESCRIBE UTL_RAW

DESCRIBE文が成功の場合、リポジトリ・サーバーにUTL_RAWがインストール済のため、手順4に進んでください。

DESCRIBE文が失敗の場合、UTL_RAWをインストールしてください。

SQL*Plusから、SYSユーザーとして、UNIXベースのシステムのMicrosoft WindowsおよびORACLE_HOME /rdbms/adminディレクトリのORACLE_HOME\rdbms\adminディレクトリにあるutlraw.sqlおよび prvtrawb.plbスクリプトを実行します。 utlraw.sqlスクリプトを先に実行する必要があります。 

SQL> @utlraw.sql
SQL> @prvtrawb.plb
手順5: DBMS_OUTPUTパッケージが使用可能であることの確認

このステップでは、DBMS_OUTPUTパッケージが有効になっていることを確認する方法を説明します。

配布CD-ROMのサンプル・プログラムおよびインストール検証プログラムは、DBMS_OUTPUTパッケージを使用します。

SQL*Plusから、SYSユーザーとして、次の文を発行してください。 

SQL> DESCRIBE DBMS_OUTPUT

DESCRIBE文が成功の場合、リポジトリ・サーバーにDBMS_OUTPUTがインストール済のため、手順6に進んでください。

DESCRIBE文が失敗の場合、DBMS_OUTPUTをインストールしてください。

関連項目:

詳細は、『Oracle Database管理者ガイド』を参照してください。

手順6: データベース・リンクの作成

このステップでは、データベース・リンクの作成方法について説明します。

Oracle本番システム・サーバー上にデータベース・リンクを作成して、Oracle Database Gateway for WebSphere MQにアクセスしてください。

まだデータベース・リンクがない場合は、データベース・リンクの作成の詳細は、「"データベース・リンク別名ライブラリの管理"」を参照してください。

Visual Workbenchリポジトリ・インストール・タスク

pgvwbrepos.sqlを使用してVisual Workbenchリポジトリをインストールします。

pgvwbrepos.sqlを使用してOracle 10g以降にVisual Workbenchリポジトリをインストールします。 pgvwbrepos.sqlを実行するには、UNIXベースのシステムでMicrosoft WindowsおよびORACLE_HOME /dg4mq/admin/repoディレクトリの ORACLE_HOME\dg4mq\admin\repoディレクトリにあることを確認してから、次のコマンドを入力します: 

sqlplus /nolog @pgvwbrepos.sql

注意:

Oracle8i以前にVisual Workbenchリポジトリをインストールする場合は、pgvwbrepos8.sqlを使用する必要があります。 この項で説明する例はすべて、Oracle9i以降にインストールする前提で提供されています。

スクリプトには、次の手順があります。

手順1: データベース接続情報の入力

このステップでは、データベース接続情報の入力方法について説明します。

[Enter]を押して、LOCALのデフォルト値を使用します。 次に、OracleデータベースのSYSTEMおよびSYSアカウントのパスワードの入力を求められます。 各パスワードの入力後、[Enter]を押します。

情報が正しくない場合、スクリプトは停止します。 スクリプトを再実行する前に、情報を検証してください。

手順2: 既存のWorkbenchリポジトリの確認

このステップでは、既存のVisual Workbenchリポジトリをチェックする方法について説明します。

スクリプトは、既存のVisual Workbenchリポジトリおよびデータ・ディクショナリを検索します。 どちらも見つからない場合、スクリプトは次の手順3に進みます。

データ・ディクショナリが存在する場合、スクリプトは停止します。 別のOracleデータベースを選択し、「"ステップ1: リポジトリ・サーバーの選択"」からスクリプトを再実行します。

Visual Workbenchが存在する場合、スクリプトには次のオプションがあります。

  • 既存のプライベート・リポジトリをパブリック・リポジトリにアップグレードし、手順3に進みます。

  • 既存のリポジトリを新規プライベート・リポジトリに更新し、手順3に進みます。

  • スクリプトを停止します。

手順3: 必要なPL/SQLパッケージの確認

このステップでは、必要なPL/SQLパッケージをチェックする方法を説明します。

スクリプトは、Oracleデータベース内で、UTL_RAW、DBMS_OUTPUTおよびDBMS_PIPEを検索します。 このソフトウェアが見つかった場合、スクリプトは手順4に進みます。

ソフトウェアが存在しない場合、スクリプトは停止します。 不足しているソフトウェアについては、「Oracle Database管理者ガイド」を参照してください。 ソフトウェアをインストールしたら、スクリプトを再実行します。

手順4: UTL_PGパッケージのインストール

このステップでは、UTL_PGパッケージのインストール方法について説明します。

スクリプトは、UTL_PGパッケージを検索します。 見つからない場合、UTL_PGがインストールされています。 スクリプトは、手順5に進みます。

UTL_PGが見つかった場合、再インストールを求められます。 戻るを押して、UTL_PGを再インストールしてください。

手順5: 管理ユーザーおよびすべてのリポジトリ表の作成

このステップでは、PGMADMINの初期パスワードを使用してVisual Workbenchリポジトリの管理ユーザーをPGMADMINとして作成する方法を説明します。

このユーザーは、リポジトリ内のすべてのオブジェクトを所有します。

この手順の後、PGMADMINユーザーのみがアクセスできるPGM_SUP、PGM_BQMおよびPGM_UTL8パッケージを含むプライベートVisual Workbenchリポジトリが、Oracle Database内に作成されます。

手順6: パブリック・シノニムおよび開発ツールの作成

このオプションのステップでは、Visual Workbenchリポジトリのプライベート・アクセス権限を変更する方法について説明します。

プライベート・ステータスは、PGMADMINユーザーだけがリポジトリにアクセスできるようにします。 Nを入力し、[Enter]を押すと、リポジトリのステータスはプライベートのままです。

パブリック・ステータスにより、PGMADMINではない他のユーザーにアクセス権限が付与されます。 リポジトリにパブリック・ステータスを与える場合、Yを入力し、[Enter]を押します。

リポジトリの作成後

Visual Workbenchリポジトリの作成後、別のオプションの手順で、Visual Workbenchリポジトリの開発権限がユーザーに付与されます。

PGMADMINユーザー以外のユーザーにVisual Workbenchリポジトリで開発操作の実行を許可するには、PGMADMINに必要な権限を付与する必要があります。 そのための手順は、次のとおりです。

  1. リポジトリにパブリック・ステータスがあることを確認します。 pgvwbrepos.sqlスクリプトの手順1から6でリポジトリを作成した場合、パブリック・ステータスがあります。 手順6を使用していない場合、スクリプトに戻ってください。 スクリプトの手順2で、プライベート・リポジトリをパブリック・ステータスにアップグレードするプロンプトで、Aを入力します。
  2. SQL*Plusを使用して、PGMADMINユーザーとして接続し、PGMADEVロールを各ユーザーに付与します。 例: 
    SQL> GRANT PGMDEV TO SCOTT;

Visual Workbenchリポジトリの削除

リポジトリ・スクリプトpgvwbremove.sqlを使用してVisual Workbenchをアンインストールします。

pgvwbremove.sqlを使用して、Oracle10g上のVisual Workbenchリポジトリを削除してください。 このスクリプトを実行するには、Oracleデータベース、Microsoft Windowsの場合ORACLE_HOME\dg4mq\admin\repoディレクトリおよびUNIXベース・システムの場合ORACLE_HOME/dg4mq/admin/repoディレクトリ(スクリプトをコピーした場所)にいることを確認して、次のコマンドを入力します: 

sqlplus /nolog @pgvwbremove.sql

注意:

Oracle8i以前のVisual Workbenchリポジトリを削除する場合、pgvwbremove8.sqlを使用してください。 この項で説明する例はすべて、Oracle9i以降にインストールする前提で提供されています。

スクリプトには、次の手順があります。

手順1: データベース接続情報の入力

このステップでは、データベース接続情報の入力方法について説明します。

[Enter]を押して、LOCALのデフォルト値を使用します。

次に、OracleデータベースのSYSTEM、SYSおよびPGMADMINアカウントのパスワードの入力を求められます。 各パスワードの入力後、[Enter]を押します。

情報が正しくない場合、スクリプトは停止します。 スクリプトを再実行する前に、情報を検証してください。

手順2: 既存のWorkbenchリポジトリの確認

このステップでは、既存のWorkbenchリポジトリを確認する方法について説明します。

パブリック・シノニムおよび開発ロールを削除するプロンプトで、Yを入力し、[Enter]を押します。 これにより、リポジトリはプライベート・ステータスに戻ります。 Nを入力して[Enter]を押し、スクリプトを終了するか、次のプロンプトに進みます。

プライベート・リポジトリを確実に削除する場合、Yを入力し、[Enter]を押します。 スクリプトにより、すべてのリポジトリ表および関連するパッケージが削除されます。

本番Oracleデータベースの準備

これには、本番データベースのPL/SQLパッケージの準備、インストールおよび削除が含まれます。

概要

このセクションでは、pgmdeploy.sqlおよびpgmundeploy.sqlスクリプトの実行方法について説明します。

本番OracleデータベースでMIPをコンパイルする前に、次のPL/SQLパッケージが本番Oracleデータベースに存在している必要があります。

  • DBMS_PIPE, DBMS_OUTPUT, and UTL_RAW

    これらのパッケージは、各Oracleデータベースとともに出荷され、通常、事前インストールされています。

  • PGM、PGM_BQM、PGM_SUP 、およびUTL_PG

    これらのパッケージは、Oracle Database Gateway for WebSphere MQとともに出荷されます。 これらは、Visual Workbenchリポジトリの作成プロセス中にインストールされます。 デプロイ・スクリプトを、インストール済のVisual WorkbenchリポジトリのOracleデータベース上で実行しないでください。 リポジトリに使用されるOracleデータベースが、本番環境で使用されるOracleデータベースと異なる場合、これらのパッケージを本番Oracleデータベース上にインストールする必要があります。

この項では、次のスクリプトの実行方法を説明します。

  • pgmdeploy.sql

    必要なPL/SQLパッケージの存在を検証するために使用され、本番Oracleデータベースに存在しない場合はパッケージをインストールするデプロイ・スクリプトです。

  • pgmundeploy.sql

    本番データベースからPL/SQLパッケージを削除するスクリプトです。

PL/SQLパッケージの検証およびインストール

このトピックでは、PL/SQLパッケージの検証とインストールについて説明します。

  1. 次のスクリプトを検出します。

    • pgm.sql

    • pgmbqm.sql

    • pgmdeploy.sql

    • pgmsup.sql

    • pgmundeploy.sql

    • prvtpg.sql

    • utlpg.sql

    これらのスクリプトは、ORACLE_HOMEがゲートウェイのホーム・ディレクトリであるUNIXベースのシステムでは、ORACLE_HOME\dg4mq\admin\deployディレクトリのORACLE_HOME\dg4mq\admin\deployディレクトリおよびORACLE_HOME /dg4mq/admin/deployディレクトリにインストールされます。

  2. 本番Oracleデータベースがゲートウェイとは異なるシステム上にある場合は、FTPなどのファイル転送メソッドを使用して、Microsoft Windowsの場合はORACLE_HOME\dg4mq\admin\deployディレクトリに、UNIXベースのシステムの場合はORACLE_HOME/dg4mq/admin/deployディレクトリにファイルを転送します。ここで、ORACLE_HOMEはゲートウェイ・システムのホーム・ディレクトリです。 使用する本番Oracleデータベース・システム上で、転送したデプロイ・スクリプトを含んでいるディレクトリにディレクトリを変更し、手順4にスキップします。
  3. 本番環境のOracleデータベースがゲートウェイと同じシステム上にある場合は、ORACLE_HOMEがゲートウェイのホーム・ディレクトリである場合は、ディレクトリをORACLE_HOME\dg4mq\admin\deployディレクトリ(Microsoft Windowsの場合)およびORACLE_HOME/dg4mq/admin/deploy (UNIXベースのシステムの場合)に変更します。
  4. pgmdeploy.sqlスクリプトを、次のようにして実行します。
    $ sqlplus /nolog @pgmdeploy.sql
  5. スクリプト・プロンプトで、Oracleデータベースの接続文字列LOCALを入力し、[Enter]を押してデフォルト値のLOCALを使用します。
  6. スクリプト・プロンプトで、必要なOracleデータベースのパスワードを入力し、SYSアカウントのパスワードを入力します。

スクリプトがSYSアカウント・パスワードを検証すると、本番Oracleデータベースに接続します。 スクリプトは、ここにインストールされているPL/SQLパッケージを検証し、レポートします。

  • DBMS_OUTPUT、DBMS_PIPEまたはUTL_RAWのOracleデータベースのパッケージのどれかが足りない場合、スクリプトは停止します。 使用するDBAに足りないパッケージをインストールし、デプロイ・スクリプトを再実行してください。

  • Oracle パッケージ、PGM、PGM_BQM、PGM_SUP、およびUTL_PGのいずれかが欠落している場合、スクリプトはそれらを本番Oracleデータベースにインストールします。

PL/SQLパッケージの削除

このトピックでは、PL/SQLパッケージの削除について説明します。

本番環境のアプリケーションがMIPを使用していない場合、pgmdeploy.sqlスクリプトでインストールされたPL/SQLパッケージを削除できます。 次の手順に従って、これらのパッケージを削除してください。

  1. 使用する本番Oracleデータベースで、次のコマンドを入力してデプロイ・スクリプトを含んでいるディレクトリに変更します。

    Microsoft Windowsの場合:

    > cd ORACLE_HOME\dg4mq\admin\deploy

    UNIXベース・システムの場合:

    $ cd $ORACLE_HOME/dg4mq/admin/deploy
  2. pgmundeploy.sqlを、次のようにして実行します。
    $ sqlplus /nolog @pgmundeploy.sql
  3. スクリプト・プロンプトで、Oracleデータベースの接続文字列LOCALを入力し、[Return]を押してデフォルト値のLOCALを使用します。
  4. スクリプト・プロンプトで、必要なOracleデータベースのパスワードを入力し、SYSアカウントのパスワードを入力します。

スクリプトがSYSアカウント・パスワードを検証すると、本番Oracleデータベースに接続し、pgmdeploy.sqlスクリプトでインストールされたパッケージを削除します。

pgmundeploy.sqlスクリプトの正常な完了後、ここでコンパイルされるMIPへ参照を試みると、本番Oracleデータベースのアプリケーションは失敗します。