機械翻訳について
  1. インストレーションおよびユーザー・ガイド
  2. Oracle Database Gateway for WebSphere MQ初期化パラメータ

C Oracle Database Gateway for WebSphere MQ初期化パラメータ

Oracle Database Gateway for WebSphere MQには、次の各項で説明する独自の初期化パラメータがあり、Oracle Databaseゲートウェイの初期化パラメータをサポートしています。

C.1 ゲートウェイ初期化ファイル

ゲートウェイ初期化ファイルは、init sid.oraと呼ばれます。

デフォルトの初期化ファイルは、Oracle Database Gateway for WebSphere MQのインストール中に、Microsoft WindowsのディレクトリORACLE_HOME \dg4mq\adminおよびUNIXベースのシステムのORACLE_HOME /dg4mq/adminに作成されます。

C.2 ゲートウェイ・パラメータ

これらのトピックでは、ゲートウェイ・パラメータ、デフォルト値のリスト、値の範囲、および使用方法の構文について説明します。

C.2.1 LOG_DESTINATION

次の表に、LOG_DESTINATIONパラメータを示します:

LOG_DESTINATION 使用

構文

LOG_DESTINATION = log_file

デフォルト値

SID_agt_PID.trc (PIDはゲートウェイのプロセスID)

値の範囲

なし

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

C.2.2 AUTHORIZATION_MODEL

次の表に、AUTHORIZATION_MODELパラメータの使用方法を示します:

AUTHORIZATION_MODEL 使用

構文

AUTHORIZATION_MODEL = {RELAXED|STRICT}

デフォルト値

RELAXED

値の範囲

RELAXED またはSTRICT

AUTHORIZATION_MODELは、ゲートウェイ・ユーザーの認可モデルを定義します。 Relaxedモデルは、ゲートウェイの有効なユーザーIDに対してキュー・マネージャから付与される認可を、Oracleアプリケーションが持つただ1つの関連付けとして指定します。

Strictモデルは、OracleユーザーIDおよびパスワード(データベース・リンクの作成時に指定される)、または現行のユーザーIDおよびパスワード(OracleユーザーIDおよびパスワードが指定されていない場合)で、ローカルまたはネットワーク・パスワード・ファイルをチェックするかを指定します。

有効なユーザーIDの詳細は、「セキュリティ・モデル」を参照してください。

C.2.3 QUEUE_MANAGER

次の表に、QUEUE_MANAGERパラメータを示します:

QUEUE_MANAGER 使用

構文

QUEUE_MANAGER = manager_name

デフォルト値

なし

値の範囲

なし

QUEUE_MANAGER(必須パラメータ)は、ゲートウェイがログオン時に接続するキュー・マネージャの名前を指定します。 ゲートウェイの有効なユーザーIDは、正しいユーザー権限が付与されるか、このキュー・マネージャへの接続が認可される必要があります。 次のルールを使用して、manager_nameを指定します:

  • 長さ1から48文字の英数字

  • 先行または埋込み空白文字の不可

  • 後続空白文字の許可

有効なユーザーIDの詳細は、「セキュリティ・モデル」を参照してください。

C.2.4 TRACE_LEVEL

次の表に、TRACE_LEVELパラメータを示します:

TRACE_LEVEL 使用

構文

TRACE_LEVEL = level

デフォルト値

0

値の範囲

0 から7

TRACE_LEVELは、ゲートウェイの実行時にトレース情報を収集するかどうかをで制御します。 情報を収集するように設定すると、トレース・データは、 LOG_DESTINATIONパラメータで指定されたログ・ファイルに書き込まれます。 levelは、0から3までの整数(必要なトレース値の合計)として指定します。 次の表では、これらの値の意味について説明します。

トレース・レベル 説明

0

トレースの実行を指定しません。

1

一般的なトレースの実行を指定します。 これには、WebSphere MQキュー・マネージャへのログインに使用されるユーザーID、キュー・マネージャの名前、ゲートウェイ・トランザクション・モード、セキュリティ・モードなどが含まれます。

2

ゲートウェイにより発行されるMQIコールに対するトレースの実行を指定します。

3

ゲートウェイにより発行されるMQIコールに渡される、またはMQIコールから受け取るすべてのパラメータに対するトレースの実行を指定します。

MQIコールの詳細。

関連項目:

MQIコールの詳細は、IBMのドキュメントを参照してください。

C.2.5 TRANSACTION_LOG_QUEUE

次の表では、TRANSACTION_LOG_QUEUEの使用方法について説明します。

TRANSACTION_LOG_QUEUE 説明

構文

TRANSACTION_LOG_QUEUE = tx_queue_name

デフォルト値

なし

値の範囲

なし

TRANSACTION_LOG_QUEUEは、トランザクションIDをロギングするためのキューの名前を指定します。 次のルールを使用して、tx_queue_nameを指定します:

  • 長さ1から48文字の英数字

  • 先行または埋込み空白文字の不可

  • 後続空白文字の許可

詳細は、「トランザクション・ログ・キューの作成」を参照してください。

C.2.6 TRANSACTION_MODEL

次の表では、TRANSACTION_MODELの使用方法について説明します。

TRANSACTION_MODEL 説明

構文

TRANSACTION_MODEL = {COMMIT_CONFIRM|SINGLE_SITE}

デフォルト値

SINGLE_SITE

値の範囲

COMMIT_CONFIRMまたはSINGLE_SITE

TRANSACTION_MODELは、ゲートウェイのトランザクション・モードを定義します。 次の表の説明に従って、TRANSACTION_MODELの値を指定します:

項目 説明

COMMIT_CONFIRM

同一のWebSphereキュー・マネージャに所属するキューが更新された場合に、ゲートウェイがトランザクションに参加するように指定します。 同時に、Oracleデータベースはいくつでも更新されます。 ゲートウェイがトランザクションの中心として操作するため、コミット確認モデルの1つのゲートウェイのみが分散トランザクションに参加できます。

この値を指定する場合は、RECOVERY_USER、RECOVERY_PASSWORDおよびTRANSACTION_LOG_QUEUEパラメータも設定する必要があります。

SINGLE_SITE

同一のWebSphereキュー・マネージャに所属するキューが更新された場合にのみ、ゲートウェイがトランザクションに参加するように指定します。 Oracleアプリケーションは、WebSphere MQにアクセスする同一トランザクション内のOracleデータベース上のデータを選択できますが、更新できません。

C.2.7 TRANSACTION_RECOVERY_PASSWORD

次の表では、TRANSACTION_RECOVERY_PASSWORDについて説明します。

TRANSACTION_RECOVERY_PASSWORD 説明

デフォルト値

*

値の範囲

パラメータを暗号化する必要があることを示すアスタリスク(*)、またはいずれかの有効なパスワード

構文

TRANSACTION_RECOVERY_PASSWORD = rec_password

または

TRANSACTION_RECOVERY_PASSWORD = *

TRANSACTION_RECOVERY_PASSWORDは、ゲートウェイがトランザクションのリカバリを開始するために使用するユーザーのパスワードを指定します。 デフォルト値は、アスタリスク(*)に設定され、このアスタリスクは、パラメータ値が個別のパスワード・ファイルに暗号化されて格納されていることを示します。 暗号化されたゲートウェイ・パラメータの有効なパスワードを指定または変更するには、dg4pwdゲートウェイ・ユーティリティを使用して作業を行う必要があります。 詳細は、「dg4pwdユーティリティの使用」を参照してください。

TRANSACTION_RECOVERY_PASSWORDパラメータは、TRANSACTION_MODELがCOMMIT_CONFIRMに設定されている場合にのみ必要です。 詳細は、「トランザクション・ログ・キューの作成」を参照してください。

ゲートウェイ初期化ファイルのパスワード

ゲートウェイは、ユーザーIDおよびパスワードを使用して、WebSphere MQサーバー上のリモート・データベースにある情報にアクセスします。 ユーザーIDおよびパスワードは、リソース・リカバリなどの機能を処理するために、ゲートウェイ初期化ファイルで定義される場合があります。 セキュリティを意識した環境では、プレーン・テキスト・パスワードが初期化ファイルでアクセス可能な場合、これらのパスは安全ではないとみなされます。 新しい暗号化機能がゲートウェイに追加されたため、そのようなパスワードがより保護されています。 dg4pwdユーティリティを使用して、ゲートウェイ初期化ファイルに通常格納されるパスワードを暗号化できます。 この機能の使用はオプションですが、使用することを強くお薦めします。 この機能を使用すると、パスワードは初期化ファイルに格納されず、パスワード・ファイルに暗号化された形式で格納されます。 これにより、パスワード情報がより保護されます。

dg4pwdユーティリティの使用

dg4pwdユーティリティは、通常ゲートウェイ初期化ファイルに格納されるパスワードを暗号化するために使用されます。 ユーティリティは、初期化ファイルを読み取って作用し、特別な値を持つパラメータを検索します。 値はアスタリスク(*)です。 アスタリスクは、このパラメータの値が別のファイルに暗号化された形式で格納されていることを示します。 次のサンプルは、この値と初期化ファイルのセクションです。

TRANSACTION_RECOVERY_PASSWORD = *

初期化ファイルが最初に編集され、パラメータの値がアスタリスク(*)に設定されます。 次に、コマンドラインでゲートウェイSIDを指定して、dg4pwdユーティリティを実行します。 ユーティリティは初期化ファイルを読み取り、ユーザーに暗号化される値を入力するように求めます。

このコマンドの構文は次のとおりです。

dg4pwd gateway_sid

このコマンドで、gateway_sidはゲートウェイのSIDです。

次に、ゲートウェイSIDがdg4mqsであると仮定する例を示します: 

% dg4pwd dg4mqs
ORACLE Gateway Password Utility (dg4mqseries) Constructing password file for
Gateway SID dg4mqs
Enter the value for TRANSACTION_RECOVERY_PASSWORD
welcome
%

この例では、TRANSACTION_RECOVERY_PASSWORDパラメータは暗号化が必要であると識別されます。 ユーザーが値(welcomeなど)を入力し、Enterキーを押します。 暗号化が必要なパラメータがまだある場合、その値を求められます。 暗号化されたデータは、UNIXベースのシステムのMicrosoft Windowsおよびdg4mq/adminディレクトリのdg4mq\adminディレクトリに格納されます。

ノート:

正しいゲートウェイ初期化ファイルが読み取られるように、ORACLE_HOME環境変数で正しいゲートウェイ・ホームを指定することが重要です。

C.2.8 TRANSACTION_RECOVERY_USER

次の表に、TRANSACTION_RECOVERY_USERパラメータの使用方法を示します:

項目 説明

構文

TRANSACTION_RECOVERY_USER = rec_user

デフォルト値

なし。

値の範囲

WebSphere MQ Manager(MQM)により認可された、いずれかの有効なオペレーティング・システム・ユーザーID

TRANSACTION_RECOVERY_USERは、ゲートウェイがトランザクションのリカバリを開始するために使用するユーザー名を指定します。 このパラメータは、AUTHORIZATION_MODELがSTRICTに設定され、TRANSACTION_MODELがCOMMIT_CONFIRMに設定されている場合にのみ必要です。 詳細は、「トランザクション・ログ・キューの作成」を参照してください。