機械翻訳について

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とは異なる SID を選択し、dg4mqsおよびdg4mqcとは異なります。

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

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

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

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

インストール時に、UNIXベースのシステムでは、のデフォルトの初期化ファイルがMicrosoft WindowsのORACLE_HOME\dg4mq\admin\init sid .oraに、sidがdg4mqsまたはdg4mqcのデフォルトのSIDである $ 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 Net Services管理者ガイド」および「Oracle Database Net Servicesリファレンス」

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

ゲートウェイでは、Oracle NetがOracleデータベースとの間の透過的なデータ・アクセスを提供する必要があります。

Oracle Netは、Oracle Net Listenerを使用してOracle Netクライアントから受信接続を受信します。 ゲートウェイの場合、Oracle Net Listenerは、Oracleデータベースからの受信リクエストをリスニングします。 Oracle Net Listenerがゲートウェイをリスニングするには、ゲートウェイに関する情報をOracle Net Listener構成ファイル (listener.ora)に追加する必要があります。 このファイルは、デフォルトではUNIXベースのシステムのMicrosoft WindowsおよびORACLE_HOME\network\adminディレクトリにある 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のlistener.oraファイルでデフォルト情報を変更し、UNIXベースのシステムではORACLE_HOME /network/adminを変更します。

ステップ1: ゲートウェイ用のOracle Net Oracle Net Listenerの構成

listener.oraファイルの構成。

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

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

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

    ノート:

    Oracle Net Listenerおよびゲートウェイは、同一のノードにある必要があります。 すでにノード上でOracle Net Listenerを実行している場合は、ステップ1および2で提案されている変更を既存のlistener.oraおよびtnsnames.oraファイルに対して実行する必要があります。

    変更を行った後、Oracle Net Listenerを停止せずに、lsnrctlユーティリティでreloadサブコマンドを実行して変更を再ロードできます。

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および プロセス間ソケット・コール(IPC)プロトコル・アダプタを使用している場合、 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 Net Services管理者ガイド」および「Oracle Database Net Servicesリファレンス」を参照してください。

ステップ2: ゲートウェイ用のOracle Net Listenerの停止および起動

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

ノート:

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

「ステップ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データベースに指示するために、サーバー上のtnsnames.oraファイルのサービス名エントリまたは接続記述子名のエントリが必要です。 このファイルは、デフォルトでは、Microsoft WindowsのORACLE_HOME \network\adminディレクトリおよびUNIXベースのシステムのORACLE_HOME/network/adminディレクトリにあります。ORACLE_HOMEは、Oracleデータベースがインストールされているディレクトリです。 tnsnames.oraファイルは、ゲートウェイ自体ではなく、ゲートウェイにアクセスしているOracleデータベースで必要です。

関連トピック

関連項目:

tnsnames.oraファイルの変更の詳細は、「Oracle Database Net Services管理者ガイド」および「Oracle Database Net Servicesリファレンス」を参照してください。

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

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

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

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

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

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=
     (SERVICE_NAME=service_name)
     )
     (HS=OK)
)

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

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

  • TCP は、接続に使用されるプロトコルがTCP/IPであることを指定します。

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

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

  • service_nameは、ゲートウェイ・サービス名を指定し、ゲートウェイをリスニングする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=
        (SERVICE_NAME=service_name)
    )
     (HS=OK)
  )

説明:

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

  • IPC は、接続に使用されるプロトコルがIPCであることを指定します。

  • key_nameはサービス名です。

  • service_nameは、ゲートウェイ・サービス名を指定し、ゲートウェイをリスニングしている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セッションでゲートウェイが初めて使用されるときに、データベース・リンクを介して確立されます。

このコンテキストでは、「接続」は、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ファイル内の接続記述子を指します。 セキュリティ・モデルがAUTHORIZATION_MODELパラメータでSTRICTとして定義されている場合、CONNECT TO句は、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です。 これは、init sid.oraファイルでAUTHORIZATION_MODELがSTRICTに設定されている場合にのみ使用されます。 ユーザーIDは、すべてのWebSphere MQオブジェクトへのアクセスに対して認証され、PL/SQLコマンド内のデータベース・オブジェクト参照を使用する必要があります。

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

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

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

    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です

別名ライブラリの削除

アンデプロイ・スクリプトを使用して、libdg4mq Oracle 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. ファイル転送プログラムを使用して、リポジトリzipファイル(repos XXX. zip、XXXはリリース番号)を転送するか、Visual Workbenchシステムの スクリプト・ファイル・ディレクトリ(ORACLE_HOME\dg4mqvwb\server\adminから.sqlサフィクスを持つすべてのスクリプト・ファイルをリポジトリ・サーバー・システムのスクリプト・ファイル・ディレクトリに移動します。
ステップ3: Visual Workbenchリポジトリのアップグレード

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

既存のVisual Workbenchリポジトリのインストール・スクリプトをアップグレードするには、pgm xxx.sqlファイルを、UNIXベースのシステムのMicrosoft WindowsおよびORACLE_HOME/dg4mq/admin/deployディレクトリのORACLE_HOME\dg4mq\admin\deployディレクトリにあるOracle Database Gateway for WebSphere MQとともにインストールし、リポジトリ・サーバー・システムのスクリプト・ファイル・ディレクトリにコピーします。

ステップ4: UTL_RAWパッケージがインストールされていることの確認

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

ビジュアル・ワークベンチによって生成されるすべてのデータ・マッピング・パッケージでは、RAWデータを操作するためのルーチンを提供する 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を使用して、ビジュアル・ワークベンチ・リポジトリをOracle10g以上にインストールします。 pgvwbrepos.sqlを実行するには、UNIXベースのシステムのMicrosoft WindowsおよびORACLE_HOME /dg4mq/admin/repoディレクトリにある ORACLE_HOME\dg4mq\admin\repoディレクトリにいることを確認してから、次のコマンドを入力します: 

sqlplus /nolog @pgvwbrepos.sql

ノート:

ビジュアル・ワークベンチ・リポジトリをOracle8 i以前にインストールする場合は、pgvwbrepos8.sqlを使用する必要があります。 この項で説明する例はすべて、Oracle9i以降にインストールする前提で提供されています。

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

ステップ1: データベース接続情報の入力

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

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

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

ステップ2: 既存のワークベンチ・リポジトリのチェック

このステップでは、既存の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が存在する場合は、再インストールするように求められます。 Returnキーを押してUTL_PGを再インストールします。

ステップ5: 管理ユーザーおよびすべてのリポジトリ表の作成

このステップでは、初期パスワードPGMADMINを使用して、ビジュアル・ワークベンチ・リポジトリの管理ユーザーをPGMADMINとして作成する方法について説明します。

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

このステップの後、PGM_SUP 、 PGM_BQMおよびPGM_UTL8パッケージを含むプライベート・ビジュアル・ワークベンチ・リポジトリがOracleデータベースに作成されます。このリポジトリにはPGMADMINユーザーのみがアクセスできます。

ステップ6: パブリック・シノニムおよび開発ロールの作成

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

プライベート・ステータスでは、PGMADMINユーザーのみがリポジトリにアクセスできます。 Nと入力して「入力」を押すと、リポジトリはプライベート・ステータスを保持します。

パブリック・ステータスを使用すると、PGMADMIN以外の他のユーザーにアクセス権限を付与できます。 リポジトリにパブリック・ステータスを与える場合、Yを入力し、[Enter]を押します。

リポジトリの作成後

ビジュアル・ワークベンチ・リポジトリの作成後、ユーザーにビジュアル・ワークベンチ・リポジトリの開発権限を付与するオプションのステップが1つあります。

で、PGMADMINユーザー以外のユーザーがビジュアル・ワークベンチ・リポジトリで開発操作を実行できるようにするには、PGMADMINで必要な権限を付与する必要があります。 そのための手順は、次のとおりです。

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

Visual Workbenchリポジトリの削除

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

Visual Workbench リポジトリをOracle10gにアンインストールするには、リポジトリ・スクリプトpgvwbremove.sqlを使用します。 このスクリプトを実行するには、現在UNIXベースのシステム(スクリプトをコピーした場所)のOracleデータベースのORACLE_HOME\dg4mq\admin\repo directory on Microsoft Windows and ORACLE_HOME /dg4mq/admin/repoディレクトリにいることを確認し、次のコマンドを入力します: 

sqlplus /nolog @pgvwbremove.sql

ノート:

Oracle8 i以前でビジュアル・ワークベンチ・リポジトリをアンインストールする場合は、pgvwbremove8.sqlを使用する必要があります。 この項で説明する例はすべて、Oracle9i以降にインストールする前提で提供されています。

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

ステップ1: データベース接続情報の入力

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

「入力」を押して、LOCALのデフォルト値を使用します。

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

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

ステップ2: 既存のワークベンチ・リポジトリの確認

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

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

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

本番Oracle Databaseの準備

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

概要

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

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

  • DBMS_PIPE、 DBMS_OUTPUTおよび 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

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

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

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

  • Oracleデータベース パッケージDBMS_OUTPUT、DBMS_PIPEまたはUTL_RAWのいずれかがない場合、スクリプトは停止します。 使用する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. スクリプト・プロンプトで: Enter the connect string for the Oracle database... [LOCAL]、[ Return ]を押して、デフォルトのLOCALを使用します。
  4. スクリプト・プロンプトのenter the required Oracle database passwordsに、SYSアカウントのパスワードを入力します。

スクリプトは、SYSアカウントのパスワードを確認した後、本番Oracleデータベースに接続し、pgmdeploy.sqlスクリプトによってインストールされたパッケージを削除します。

pgmundeploy.sqlスクリプトが正常に完了すると、本番Oracleデータベース上のアプリケーションは、そこでコンパイルされたいずれかのMIPを参照しようとすると失敗します。