Oracle Messaging Gatewayスタート・ガイド

18 Oracle Messaging Gatewayスタート・ガイド

次のトピックでは、Oracle Messaging Gateway (MGW)の前提条件と、メッセージ・ゲートウェイのロード、設定およびアンロード手順を説明します。また、mgw.ora初期化ファイルの設定および変更方法も説明します。

18.1 Oracle Messaging Gatewayの前提条件

メッセージ・ゲートウェイでは、メッセージ・ゲートウェイ・エージェントごとに1つのOracle Schedulerジョブを使用します。JOB_QUEUE_PROCESSESデータベース初期化パラメータの値がゼロの場合、Oracle Schedulerジョブは実行されません。値がゼロ以外の場合、事実上、この値は同時に実行できるSchedulerジョブおよびジョブ・キューのジョブの最大数です。

ゼロではない値が設定され、各メッセージ・ゲートウェイ・エージェントの起動をSchedulerジョブが処理するのに十分な大きさであることを確認してください。

18.2 Oracle Messaging Gatewayのロードおよび設定

メッセージ・ゲートウェイを実行する前に、次の手順を実行してください。

データベースへのデータベース・オブジェクトのロード
外部プロシージャのlistener.oraの変更
外部プロシージャのtnsnames.oraの変更
mgw.ora初期化ファイルの設定
Oracle Messaging Gateway管理者ユーザーの作成
Oracle Messaging Gatewayのエージェント・ユーザーの作成
Oracle Messaging Gateway接続情報の構成
Oracle RAC環境におけるOracle Messaging Gatewayの構成

注意:

この設定手順は、Windowsの32ビットおよび64ビット・バージョンとUNIXベースのオペレーティング・システムの64ビット・バージョン固有のものです。タスクは、「Windowsオペレーティング・システムのみ」または「Linux Operating Systemのみ」と表示されている以外は、WindowsおよびUNIXベースのオペレーティング・システム両方に適用されます。その他のオペレーティング・システムについては、オペレーティング・システム固有のドキュメントを参照してください。

18.2.1 データベースへのデータベース・オブジェクトのロード

SQL*Plusを使用して、ユーザーSYSまたはSYSDBAとしてORACLE_HOME/mgw/admin/catmgw.sqlを実行します。このスクリプトによって、ロール、表、ビュー、オブジェクト型およびPL/SQLパッケージを含む、メッセージ・ゲートウェイに必要なデータベース・オブジェクトがロードされます。これによって、メッセージ・ゲートウェイのPL/SQLパッケージのパブリック・シノニムが作成されます。MGW_ADMINISTRATOR_ROLEおよびMGW_AGENT_ROLE,という2つのロールが作成され、特定の権限が付与されます。すべてのオブジェクトは、SYSに所有されます。

注意:

CDB環境では、ORACLE_HOME/mgw/admin/catmgw.sqlをPDB rootとして実行します。

18.2.2 外部プロシージャのlistener.oraの変更

この手順は、UNIXベースのオペレーティング・システム専用です。Windowsオペレーティング・システムでは、リスナーについての静的サービス情報は必要ありません。

メッセージ・ゲートウェイのPL/SQLパッケージで外部プロシージャがコールされるように、listener.oraを変更する必要があります。

外部プロシージャのデフォルトのプロセス間通信(IPC)プロトコル・アドレスが設定されていることを確認します。
```
LISTENER = (ADDRESS_LIST=
(ADDRESS=(PROTOCOL=IPC)(KEY=EXTPROC))
```
手順1のリスナーの静的サービス情報を追加します。リスナーのSID_DESCを設定する必要があります。SID_DESCのうち、表18-1で説明されているパラメータはメッセージ・ゲートウェイで重要なため、使用環境にあわせて指定する必要があります。

例18-1 リスナーの静的サービス情報の追加

# Add a SID_DESC
SID_LIST_LISTENER= (SID_LIST=
(SID_DESC =
   (SID_NAME= mgwextproc)
   (ENVS=
     "LD_LIBRARY_PATH=JRE_HOME/lib/amd64:JRE_HOME/lib/amd64/server:ORACLE_HOME/lib")
   (ORACLE_HOME=ORACLE_HOME)
   (PROGRAM = extproc))

表18-1 SID_DESCパラメータ

パラメータ	説明
`SID_NAME`	`tnsnames.ora`のネット・サービス名で指定されているSID。次の例では、`SID_NAME`は`mgwextproc`です。
`ENVS`	外部プロシージャを実行するために必要な環境変数`LD_LIBRARY_PATH`を設定します。`LD_LIBRARY_PATH`には次のパスを含める必要があります。 JRE_HOME/lib/PLATFORM_TYPE JRE_HOME/lib/PLATFORM_TYPE/server ORACLE_HOME/lib サード・パーティのメッセージ・システムに必要な追加ライブラリも含まれる必要があります。「Oracle以外のメッセージ・システムの設定」を参照してください。 `ENVS`値は、`LD_LIBRARY_PATH_64` (Oracle Solaris on SPARC (64-Bit)およびOracle Solaris on x86-64 (64-Bit)の場合)、`LIBPATH` (IBM AIX on POWER Systemsの場合)、および`LD_LIBRARY_PATH` (他のプラットフォームの場合)です。
`ORACLE_HOME`	ユーザーのOracleホーム・ディレクトリ。`$ORACLE_HOME`を使用しても機能しません。
`PROGRAM`	外部プロシージャのエージェントの名前(`extproc`)。

注意:

ORACLE_HOMEがOracleインストレーションのルート・ディレクトリを表すように、JRE_HOMEはJREインストレーションのルート・ディレクトリを表します。Oracle DatabaseとともにインストールされたJREの使用をお薦めします。

例18-1では、SID_NAME mgwextprocをLinux x86用のlistener.oraファイルに追加します。

18.2.3 外部プロシージャのtnsnames.oraの変更

外部プロシージャに対して、tnsnames.oraで、例18-2で示したように、接続記述子がlistener.oraで構成された情報に一致するネット・サービス名MGW_AGENTを構成します。ネット・サービス名は、MGW_AGENTである必要があります(この値は固定)。KEYの値は、listener.oraでIPCプロトコルに対して指定されたKEYの値に一致する必要があります。SIDの値は、listener.oraでSID_DESCエントリのSID_NAMEに対して指定された値に一致する必要があります。

注意:

sqlnet.oraのnames.default_domainパラメータを使用してデフォルト・ドメインを設定した場合は、そのドメインをtnsnames.oraのネット・サービス名MGW_AGENTに追加する必要があります。たとえば、sqlnet.oraにエントリnames.default_domain=acme.comが含まれる場合、tnsnames.oraのネット・サービス名はMGW_AGENT.acme.comである必要があります。

例18-2 MGW_AGENTの構成

MGW_AGENT = 
(DESCRIPTION= 
   (ADDRESS_LIST= (ADDRESS= (PROTOCOL=IPC)(KEY=EXTPROC))) 
   (CONNECT_DATA= (SID=mgwextproc)))

18.2.4 mgw.ora初期化ファイルの設定

メッセージ・ゲートウェイのデフォルトの初期化ファイルORACLE_HOME/mgw/admin/mgw.oraは、テキスト・ファイルです。メッセージ・ゲートウェイの外部プロシージャは、その初期化ファイルを使用して初期化パラメータを取得し、メッセージ・ゲートウェイ・エージェントを起動します。ORACLE_HOME/mgw/admin/sample_mgw.oraをmgw.oraにコピーし、状況に応じて変更します。

次のプロシージャでは、メッセージ・ゲートウェイのすべてのアプリケーションに必要な環境変数およびその他のパラメータを設定します。

Windowsオペレーティング・システムのみ: MGW_PRE_PATH変数を設定します。この値は、次のjvm.dllライブラリへのパスです。
```
set MGW_PRE_PATH = JRE_HOME\bin\client
```
この変数は、メッセージ・ゲートウェイ・エージェントのプロセスによって継承されたパスの前に付けられます。
CLASSPATHには、少なくとも次のクラスが入っている必要があります。
- JREランタイム・クラス
```
JRE_HOME/lib/rt.jar
```
- Oracle JDBCクラス
```
ORACLE_HOME/jdbc/lib/ojdbc6.jar
```
- Oracle国際化クラス
```
ORACLE_HOME/jlib/orai18n.jar
```
- SQLJランタイム
```
ORACLE_HOME/sqlj/lib/runtime12.jar
```
- Java Message Service(JMS)インタフェース
```
ORACLE_HOME/rdbms/jlib/jmscommon.jar
```
- Oracle JMS実装クラス
```
ORACLE_HOME/rdbms/jlib/aqapi.jar
```
- JavaトランザクションAPI
```
ORACLE_HOME/jlib/jta.jar
```
- メッセージ・ゲートウェイがOracle以外のメッセージ・システムにアクセスするために必要な追加のクラス
  
  注意:
  
  ORACLE_HOMEには、該当する具体的な値を代入します。たとえば、$ORACLE_HOMEを使用しても機能しません。
  
  Windowsオペレーティング・システムのユーザーは、Windowsオペレーティング・システムのパス構文を使用してCLASSPATHを設定する必要があります。
  
  関連項目:
  
  Oracle以外のメッセージ・システムの設定

18.2.5 Oracle Messaging Gateway管理者ユーザーの作成

メッセージ・ゲートウェイの管理作業を実行するには、例18-3に示したように、MGW_ADMINISTRATOR_ROLE権限を所有するデータベース・ユーザーを作成する必要があります。

例18-3 メッセージ・ゲートウェイ管理者ユーザーの作成

CREATE USER admin_user IDENTIFIED BY admin_password;
GRANT CREATE SESSION to admin_user;
GRANT MGW_ADMINISTRATOR_ROLE to admin_user;

18.2.6 Oracle Messaging Gatewayのエージェント・ユーザーの作成

メッセージ・ゲートウェイ・エージェントからデータベースへの接続を確立するには、例18-4に示したように、MGW_AGENT_ROLE権限を所有するデータベース・ユーザーを作成する必要があります。

例18-4 メッセージ・ゲートウェイ・エージェント・ユーザーの作成

CREATE USER agent_user IDENTIFIED BY agent_password;
GRANT CREATE SESSION to agent_user;
GRANT MGW_AGENT_ROLE to agent_user;

18.2.7 Oracle Messaging Gateway接続情報の構成

メッセージ・ゲートウェイ・エージェント・ユーザーの作成後、管理ユーザーとしてDBMS_MGWADM.ALTER_AGENTを使用し、例18-5に示したように、メッセージ・ゲートウェイ・エージェントによるデータベースへの接続に使用されるユーザー名、パスワードおよびデータベース接続文字列でメッセージ・ゲートウェイを構成します。「Oracle Messaging Gatewayのエージェント・ユーザーの作成」で作成したメッセージ・ゲートウェイのユーザー名とパスワードを使用します。データベース接続文字列パラメータは、tnsnames.oraの新しいサービス名(パフォーマンスを向上させるにはIPCプロトコルを使用)またはNULLのいずれかに設定できます。NULLに設定する場合は、mgw.oraにoracle_sidパラメータを設定する必要があります。

このリリースの場合は、DBMS_MGWADM.ALTER_AGENTをコールするとき、常にデータベース接続文字列パラメータに対してNULL以外の値を指定してください。

例18-5 メッセージ・ゲートウェイの接続情報の構成

set echo off
set verify off
connect admin_user
 
ACCEPT password CHAR PROMPT 'Enter the password for AGENT_USER: ' HIDE

EXEC DBMS_MGWADM.ALTER_AGENT(
      agent_name  => 'default_agent', 
      username    => 'agent_user', 
      password    => '&password', 
      database    => 'agent_database');

18.2.8 Oracle RAC環境におけるOracle Messaging Gatewayの構成

この項の内容は次のとおりです。

18.2.8.1 メッセージ・ゲートウェイ・エージェント接続に使用する接続情報の構成

メッセージ・ゲートウェイ・エージェントによるすべてのデータベース接続先を、メッセージ・ゲートウェイ・エージェントのプロセスが実行中のインスタンスにする必要があります。これにより、Oracle RAC環境で確実に適切なフェイルオーバー動作が得られます。このように接続を構成するには、インスタンスで少し異なる方法でtnsnames.oraファイルを使用させます。各ファイルには同じネット・サービス名のエントリがありますが、接続データはそのtnsnames.oraファイルに関連付けられているインスタンスのみを参照します。共通のネット・サービス名は、DBMS_MGWADM.ALTER_AGENTを使用してメッセージ・ゲートウェイ・エージェントのデータベース接続情報を構成するときに、データベース・パラメータに使用されます。

たとえば、OraDB1およびOraDB2という2つのインスタンスで構成される2インスタンスOracle RAC環境で、ネット・サービス名AGENT_DBが使用される場合、インスタンスOraDB1のtnsnames.oraは次のようになります。

AGENT_DB =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = myhost1.mycorp.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = OraDB10.mycorp.com)
      (INSTANCE_NAME = OraDB1)
    )
  )

OraDB2のtnsnames.oraは次のようになります。

AGENT_DB =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = myhost2.mycorp.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = OraDB10.mycorp.com)
      (INSTANCE_NAME = OraDB2)
    )
  )

その後、次のコマンドを実行して、メッセージ・ゲートウェイ・エージェント・ユーザーの接続情報を構成します。

EXEC DBMS_MGWADM.ALTER_AGENT(
   agent_name   => 'default_agent', 
   username     => 'agent_user', 
   password     => 'agent_password', 
   database     => 'agent_db');

18.2.8.2 メッセージ・ゲートウェイ・エージェントに対するOracle RACインスタンスの設定

メッセージ・ゲートウェイは、Oracle Schedulerのデータベース・サービス・サポートを活用して、メッセージ・ゲートウェイ・エージェントの外部プロセスのサービス・アフィニティを指定します。デフォルトでは、メッセージ・ゲートウェイ・エージェントは、すべてのインスタンスにマップされているデフォルトのデータベース・サービスを使用します。メッセージ・ゲートウェイ・エージェントが、特定のグループのデータベース・インスタンスで起動するようにするには、これらのインスタンスにデータベース・サービスを作成し、DBMS_MGWADM.CREATE_AGENTまたはDBMS_MGWADM.ALTER_AGENTプロシージャのSERVICEパラメータを使用して、メッセージ・ゲートウェイ・エージェントに割り当てる必要があります。DBMS_MGWADM.STARTUPプロシージャによって、Oracle Schedulerジョブの実行時にメッセージ・ゲートウェイ・エージェントの外部プロセスを開始するSchedulerジョブが送られます。Schedulerジョブは、メッセージ・ゲートウェイ・エージェント用に構成されたデータベース・サービスを使用します。

SERVICEパラメータで指定されるデータベース・サービスは、Oracle Schedulerジョブのサービス・アフィニティ(メッセージ・ゲートウェイの外部プロセスのサービス・アフィニティを含む)にのみ使用されます。メッセージ・ゲートウェイ・エージェント・ユーザーによって作成されたデータベース接続には使用されません。それらのJDBCクライアント接続は、DATABASEおよびCONNTYPEパラメータに指定された値に基づきます。

18.3 Oracle以外のメッセージ・システムの設定

この項の内容は次のとおりです。

18.3.1 TIB/Rendezvousの設定

TIB/Rendezvous Javaクライアント・アプリケーションとして実行する場合、メッセージ・ゲートウェイ・エージェントには、メッセージ・ゲートウェイ・エージェントが実行されるコンピュータ上にTIB/Rendezvousソフトウェアをインストールする必要があります。この項では、TIBRV_HOMEはインストールされたTIB/Rendezvousソフトウェアの場所を参照します。

listener.oraの変更

Linux Operating Systemの場合は、メッセージ・ゲートウェイのエントリのLD_LIBRARY_PATHには、TIB/Rendezvous共有ライブラリ・ファイルにアクセスするためのエージェントのTIBRV_HOME/libを含める必要があります。

18.3.2 WebSphere MQ Base JavaまたはJMSの設定

JavaおよびJMSのWebSphere MQクライアントとWebSphere MQクラスは、メッセージ・ゲートウェイ・エージェントが作動するコンピュータ上にインストールする必要があります。この項では、MQ_HOMEはインストール済クライアントの場所を参照します。Linux Operating Systemの場合は、この場所は常に/opt/mqmです。Windowsオペレーティング・システムの場合は、インストール場所を変更できます。

listener.oraの変更

メッセージ・ゲートウェイによるWebSphere MQへのアクセスには、listener.oraの変更は必要ありません。

mgw.oraの変更

WebSphere MQ Base Java (JMS以外)インタフェースを使用する場合は、「mgw.ora初期化ファイルの設定」の設定以外に少なくとも次のパスを含むようにCLASSPATHを設定する必要があります。

MQ_HOME/java/lib/com.ibm.mq.jar
MQ_HOME/java/lib/connector.jar

WebSphere MQ JMSインタフェースを使用する場合は、CLASSPATHを設定して、「mgw.ora初期化ファイルの設定」の設定以外に少なくとも次のパスを含める必要があります。

MQ_HOME/java/lib/com.ibm.mqjms.jar
MQ_HOME/java/lib/com.ibm.mq.jar
MQ_HOME/java/lib/connector.jar

18.4 Oracle Messaging Gateway設定の検証

次の手順を実行して、設定を検証します。この手順には、メッセージ・ゲートウェイ・エージェントの単純な起動および停止が含まれます。

データベース・リスナーを起動します。

外部プロシージャに対するリスナーおよび通常のデータベース接続に対する他のリスナーを起動します。
メッセージ・ゲートウェイ・エージェント・ユーザーに対してデータベース接続文字列をテストします。

sqlplus agent_user/agent_password@agent_databaseを実行します。

正常に終了した場合、メッセージ・ゲートウェイ・エージェントをデータベースに接続できます。
Linux Operating Systemのみ: 外部プロシージャのコールに使用するネット・サービス・エントリをテストします。

sqlplus agent_user/agent_password@MGW_AGENTを実行します。

これは「ORA-28547: サーバーへの接続が失敗しました。Oracle Net管理エラーの可能性があります」を表示して失敗します。これ以外のエラーは、tnsnames.ora、listener.oraあるいはその両方が正しくないことを示します。
admin_userとして接続し、DBMS_MGWADM.STARTUPをコールしてメッセージ・ゲートウェイ・エージェントを起動します。
MGW_GATEWAYビューを使用して、AGENT_STATUSがRUNNINGに、AGENT_PINGがREACHABLEに変わるまで待ちます。
admin_userとして接続し、DBMS_MGWADM.SHUTDOWNをコールしてメッセージ・ゲートウェイ・エージェントを停止します。
MGW_GATEWAYビューを使用して、AGENT_STATUSがNOT_STARTEDに変わるまで待ちます。

18.5 Oracle Messaging Gatewayのアンロード

メッセージ・ゲートウェイをアンロードする手順は、次のとおりです。

メッセージ・ゲートウェイを停止します。
ペイロードがメッセージ・ゲートウェイ標準型(SYS.MGW_BASIC_MSG_Tなど)であるユーザー作成のキューを削除します。
SQL*Plusを使用して、ユーザーSYSまたはSYSDBAとしてORACLE_HOME/mgw/admin/catnomgw.sqlを実行します。

これによって、ロール、表、ビュー、パッケージ、オブジェクト型およびシノニムを含む、メッセージ・ゲートウェイによって使用されるデータベース・オブジェクトが削除されます。
listener.oraおよびtnsnames.oraで作成したメッセージ・ゲートウェイのエントリを削除します。

18.6 mgw.ora初期化ファイルについて

メッセージ・ゲートウェイ・エージェントを起動すると、メッセージ・ゲートウェイによって、テキスト・ファイルから初期化情報が読み込まれます。初期化ファイルには、初期化パラメータ、環境変数およびJavaプロパティを設定するための行が含まれています。各エントリは1行に指定する必要があります。先頭の空白は、すべての場合に切り捨てられます。

メッセージ・ゲートウェイの管理者は、DBMS_MGWADM.CREATE_AGENTおよびDBMS_MGWADM.ALTER_AGENTにより、メッセージ・ゲートウェイ・エージェントに使用される初期化ファイルを指定できます。初期化ファイルが指定されない場合、デフォルトの初期化ファイルが使用されます。

デフォルトのエージェントのデフォルト初期化ファイルは、ORACLE_HOME/mgw/admin/mgw.oraにあります。

指定されたエージェントのデフォルト初期化ファイルはORACLE_HOME/mgw/admin/mgw_AGENTNAME.oraで、AGENTNAMEは、メッセージ・ゲートウェイ・エージェントの名前を大文字で表記したものです。たとえば、エージェント名がmy_agentの場合、エージェントのデフォルト初期化ファイルはORACLE_HOME/mgw/admin/mgw_MY_AGENT.oraです。指定されたエージェントのデフォルトの初期化ファイルが検出されなかった場合、ORACLE_HOME/mgw/admin/mgw.oraが使用されます。

18.6.1 mgw.ora初期化パラメータ

通常、初期化パラメータは、「name=value<NL>」という書式の行で指定されます。ここで、nameはパラメータ名、valueはパラメータの値、<NL>は改行を表します。

log_directory

用途:

メッセージ・ゲートウェイのログ・ファイルまたはトレース・ファイルが作成されるディレクトリを指定します。

形式:

log_directory = value

デフォルト:

ORACLE_HOME/mgw/log

例:

log_directory = /private/mgwlog

log_level

用途:

メッセージ・ゲートウェイ・エージェントによって記録されるロギングの詳細レベルを指定します。ロギング・レベルは、メッセージ・ゲートウェイ・エージェントの実行中にDBMS_MGWADM.SET_LOG_LEVELをコールすることで動的に変更できます。Oracleでは、常にログレベル0(デフォルト値)を使用することをお薦めします。

形式:

log_level = value

値は次のとおりです。

0: 基本的なロギングの場合に使用します。これは、DBMS_MGWADM.BASIC_LOGGINGと同じです。

1: 低レベルのトレースの場合に使用します。これは、DBMS_MGWADM.TRACE_LITE_LOGGINGと同じです。

2: 高レベルのトレースの場合に使用します。これは、DBMS_MGWADM.TRACE_HIGH_LOGGINGと同じです。

3: デバッグ・トレースの場合に使用します。これは、DBMS_MGWADM.TRACE_DEBUG_LOGGINGと同じです。

4: 高レベルのデバッグ・トレースの場合に使用します。これは、DBMS_MGWADM.TRACE_DEBUG_HIGH_LOGGINGと同じです

例:

log_level = 0

18.6.2 mgw.ora環境変数

ユーザーは、メッセージ・ゲートウェイの処理環境を直接制御できないため、初期化ファイルを使用して特定の環境変数を設定する必要があります。現在、メッセージ・ゲートウェイ・エージェントによって使用されている環境変数は、CLASSPATH、MGW_PRE_PATHおよびORACLE_SIDです。

CLASSPATHおよびMGW_PRE_PATHなどの環境変数は、メッセージ・ゲートウェイ・エージェントが必要な共有オブジェクトやJavaクラスなどを検出できるように設定されます。環境変数は、「set env_var=value<NL>」または「setenv env_var=value<NL>」という書式の行で指定されます。ここで、env_varは設定する環境変数の名前、valueは環境変数の値、<NL>は改行を表します。

CLASSPATH

用途:

Oracle Database Advanced QueuingとOracle以外のメッセージ・システム間の伝播のために、メッセージ・ゲートウェイ・エージェントに必要なJavaクラスを検索するJava Virtual Machineによって使用されます。

形式:

set CLASSPATH=value

例:

set CLASSPATH=ORACLE_HOME/jdbc/lib/ojdbc6.jar:JRE_HOME/lib/rt.jar:
ORACLE_HOME/sqlj/lib/runtime12.jar:ORACLE_HOME/jlib/orai18n.jar:ORACLE_HOME/rdbms/
jlib/jmscommon.jar:ORACLE_HOME/rdbms/jlib/aqapi.jar:ORACLE_HOME/jlib/jta.jar:
/opt/mqm/java/lib/com.ibm.mq.jar:/opt/mqm/java/lib/com.ibm.mqjms.jar:/opt/mqm/java
/lib/connector.jar

MGW_PRE_PATH

用途:

メッセージ・ゲートウェイのプロセスによって継承されたパスの先頭に追加されます。Windowsオペレーティング・システムの場合、この変数を設定してライブラリjvm.dllが存在する位置を指定する必要があります。

形式:

set MGW_PRE_PATH=value

例:

set MGW_PRE_PATH=JRE_HOME\bin\client

ORACLE_SID

用途:

メッセージ・ゲートウェイの構成時にサービス名が指定されていない場合に使用できます。

形式:

set ORACLE_SID=value

例:

set ORACLE_SID=my_sid

18.6.3 mgw.ora Javaプロパティ

TIB/Rendezvousサブジェクトを使用する場合、メッセージ・ゲートウェイJVMのJavaシステム・プロパティを指定する必要があります。これには、メッセージ・ゲートウェイ初期化ファイルのsetJavaPropパラメータを使用できます。Javaプロパティは、「setJavaProp prop_name=value<NL>」という書式の行で指定されます。ここで、prop_nameは設定するJavaプロパティの名前、valueはJavaプロパティの値、<NL>は改行記号を表します。

oracle.mgw.batch_size

用途:

このJavaプロパティは、1つのトランザクションで伝播されるメッセージの最大数を表します。メッセージ・ゲートウェイのジョブ・オプションMsgBatchSizeが指定されていない場合のデフォルト値として機能します。デフォルトから変更された場合、予期されるメッセージのサイズとメッセージ・ゲートウェイ・エージェントのメモリーを考慮する必要があります(DBMS_MGWADM.ALTER_AGENTのmax_memoryパラメータを参照)。このJavaプロパティの最小値は1、最大値は100で、デフォルトは30です。

18.6.4 mgw.oraコメント行

コメント行は、行の先頭に#という文字を使用して指定されます。