C Oracle Database Gateway for WebSphere MQ初期化パラメータ
Oracle Database Gateway for WebSphere MQには独自の初期化パラメータがあります。これについては以下のトピックで説明し、Oracle Databaseゲートウェイの初期化パラメータをサポートしています。
ゲートウェイ・パラメータ
これらのトピックでは、ゲートウェイ・パラメータ、デフォルト値、値の範囲、および使用法の構文について説明します。
LOG_DESTINATION
次の表では、LOG_DESTINATION
パラメータについて説明します。
LOG_DESTINATION | 使用 |
---|---|
構文 |
|
デフォルト値 |
|
値の範囲 |
なし |
LOG_DESTINATION
は、ゲートウェイ・ログ・ファイルのフルパス名を指定します。
AUTHORIZATION_MODEL
次の表では、AUTHORIZATION_MODEL
パラメータの使用方法について説明します。
AUTHORIZATION_MODEL | 使用 |
---|---|
構文 |
|
デフォルト値 |
|
値の範囲 |
|
AUTHORIZATION_MODEL
は、ゲートウェイ・ユーザーの認可モデルを定義します。 Relaxedモデルは、ゲートウェイの有効なユーザーIDに対してキュー・マネージャから付与される認可を、Oracleアプリケーションが持つただ1つの関連付けとして指定します。
Strictモデルは、OracleユーザーIDおよびパスワード(データベース・リンクの作成時に指定される)、または現行のユーザーIDおよびパスワード(OracleユーザーIDおよびパスワードが指定されていない場合)で、ローカルまたはネットワーク・パスワード・ファイルをチェックするかを指定します。
実効ユーザーIDの詳細については、「"セキュリティ・モデル"」を参照してください。
QUEUE_MANAGER
次の表では、QUEUE_MANAGER
パラメータについて説明します。
QUEUE_MANAGER | 使用 |
---|---|
構文 |
|
デフォルト値 |
なし |
値の範囲 |
なし |
必須パラメータQUEUE_MANAGER
は、ゲートウェイがログイン時に接続するキュー・マネージャの名前を指定します。 ゲートウェイの有効なユーザーIDは、正しいユーザー権限が付与されるか、このキュー・マネージャへの接続が認可される必要があります。 次のルールを使用してmanager_name
を指定します:
-
長さ1から48文字の英数字
-
先行または埋込み空白文字の不可
-
後続空白文字の許可
実効ユーザーIDの詳細については、「"セキュリティ・モデル"」を参照してください。
TRACE_LEVEL
次の表では、TRACE_LEVEL
パラメータについて説明します。
TRACE_LEVEL | 使用 |
---|---|
構文 |
|
デフォルト値 |
|
値の範囲 |
|
TRACE_LEVEL
は、ゲートウェイ実行時に、トレース情報を収集するかどうかを制御します。 情報を収集するように設定されると、トレース・データが、LOG_DESTINATION
パラメータで指定されるログ・ファイルに書き込まれます。 level
を、0
から3
までの整数として指定します。これは、必要なトレース値の合計です。 次の表では、これらの値の意味について説明します。
トレース・レベル | 説明 |
---|---|
0 |
トレースの実行を指定しません。 |
1 |
一般的なトレースの実行を指定します。 これには、WebSphere MQキュー・マネージャへのログインに使用されるユーザーID、キュー・マネージャの名前、ゲートウェイ・トランザクション・モード、セキュリティ・モードなどが含まれます。 |
2 |
ゲートウェイにより発行されるMQIコールに対するトレースの実行を指定します。 |
3 |
ゲートウェイにより発行されるMQIコールに渡される、またはMQIコールから受け取るすべてのパラメータに対するトレースの実行を指定します。 |
MQI呼び出しの詳細については、。
関連項目:
MQIコールの詳細は、IBMのドキュメントを参照してください。
TRANSACTION_LOG_QUEUE
次の表では、TRANSACTION_LOG_QUEUE
パラメータの使用方法について説明します。
TRANSACTION_LOG_QUEUE | 説明 |
---|---|
構文 |
|
デフォルト値 |
なし |
値の範囲 |
なし |
TRANSACTION_LOG_QUEUE
は、ロギング・トランザクションIDのキュー名を指定します。 次のルールを使用してtx_queue_name
を指定します:
-
長さ1から48文字の英数字
-
先行または埋込み空白文字の不可
-
後続空白文字の許可
詳細については、「"トランザクション・ログ・キューの作成"」を参照してください。
TRANSACTION_MODEL
次の表では、TRANSACTION_MODEL
の使用方法について説明します。
TRANSACTION_MODEL | 説明 |
---|---|
構文 |
|
デフォルト値 |
|
値の範囲 |
|
TRANSACTION_MODEL
は、ゲートウェイのトランザクション・モードを定義します。 次の表の説明に従い、TRANSACTION_MODEL
の値を指定してください。
項目 | 説明 |
---|---|
|
同一のWebSphereキュー・マネージャに所属するキューが更新された場合に、ゲートウェイがトランザクションに参加するように指定します。 同時に、Oracleデータベースはいくつでも更新されます。 ゲートウェイがトランザクションの中心として操作するため、コミット確認モデルの1つのゲートウェイのみが分散トランザクションに参加できます。 この値が指定される場合、 |
|
同一のWebSphereキュー・マネージャに所属するキューが更新された場合にのみ、ゲートウェイがトランザクションに参加するように指定します。 Oracleアプリケーションは、WebSphere MQにアクセスする同一トランザクション内のOracleデータベース上のデータを選択できますが、更新できません。 |
TRANSACTION_RECOVERY_PASSWORD
次の表では、TRANSACTION_RECOVERY_PASSWORD
パラメータについて説明します。
TRANSACTION_RECOVERY_PASSWORD | 説明 |
---|---|
デフォルト値 |
|
値の範囲 |
パラメータを暗号化する必要があることを示すアスタリスク(*)、またはいずれかの有効なパスワード |
構文 |
または
|
TRANSACTION_RECOVERY_PASSWORD
は、トランザクションのリカバリを開始する際にゲートウェイが使用するユーザーのパスワードを指定します。 デフォルト値は、アスタリスク(*)に設定され、このアスタリスクは、パラメータ値が個別のパスワード・ファイルに暗号化されて格納されていることを示します。 暗号化されたゲートウェイ・パスワードを指定または変更するには、dg4pwd
ゲートウェイ・ユーティリティを使用して作業します。 詳細は、「"dg4pwdユーティリティの使用"」を参照してください。
TRANSACTION_MODEL
がCOMMIT_CONFIRM
に設定されている場合にのみ、TRANSACTION_RECOVERY_PASSWORD
パラメータが必要です。 詳細については、「"トランザクション・ログ・キューの作成"」を参照してください。
ゲートウェイ初期化ファイルのパスワード
ゲートウェイは、ユーザーIDおよびパスワードを使用して、WebSphere MQサーバー上のリモート・データベースにある情報にアクセスします。 ユーザーIDおよびパスワードは、リソース・リカバリなどの機能を処理するために、ゲートウェイ初期化ファイルで定義される場合があります。 セキュリティを意識した環境では、プレーン・テキスト・パスワードが初期化ファイルでアクセス可能な場合、これらのパスは安全ではないとみなされます。 新しい暗号化機能がゲートウェイに追加されたため、そのようなパスワードがより保護されています。 dg4pwd
ユーティリティを使用して、通常、ゲートウェイ初期化ファイルに格納されるパスワードを暗号化できます。 この機能の使用はオプションですが、使用することを強くお薦めします。 この機能を使用すると、パスワードは初期化ファイルに格納されず、パスワード・ファイルに暗号化された形式で格納されます。 これにより、パスワード情報がより保護されます。
dg4pwdユーティリティの使用
dg4pwd
ユーティリティは、通常、ゲートウェイ初期化ファイルに格納されるパスワードを暗号化するために使用されます。 ユーティリティは、初期化ファイルを読み取って作用し、特別な値を持つパラメータを検索します。 値は、アスタリスク(*
)です。 アスタリスクは、このパラメータの値が別のファイルに暗号化された形式で格納されていることを示します。 次のサンプルは、この値と初期化ファイルのセクションです。
TRANSACTION_RECOVERY_PASSWORD = *
初期化ファイルは、まず、パラメータの値をアスタリスク(*
)に設定するように編集されます。 次に、dg4pwd
ユーティリティが実行され、ゲートウェイSIDをコマンドライン上に指定します。 ユーティリティは初期化ファイルを読み取り、ユーザーに暗号化される値を入力するように求めます。
このコマンドの構文は次のとおりです。
dg4pwd gateway_sid
このコマンドでは、gateway_sid
はゲートウェイのSIDです。
次の例では、ゲートウェイIDが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]キーを押します。 暗号化が必要なパラメータがまだある場合、その値を求められます。 暗号化されたデータは、Microsoftではdg4mq\admin
ディレクトリおよびUNIXベース・システムではdg4mq/admin
ディレクトリに格納されます。
注意:
ORACLE_HOME
環境変数が正しいゲートウェイ・ホームを指定することで、正しいゲートウェイ初期化ファイルが読み取られます。
TRANSACTION_RECOVERY_USER
次の表では、TRANSACTION_RECOVERY_USER
パラメータの使用方法について説明します。
項目 | 説明 |
---|---|
構文 |
|
デフォルト値 |
なし。 |
値の範囲 |
WebSphere MQ Manager(MQM)により認可された、いずれかの有効なオペレーティング・システム・ユーザーID |
TRANSACTION_RECOVERY_USER
は、トランザクションのリカバリを開始する際にゲートウェイが使用するユーザー名を指定します。 これは、AUTHORIZATION_MODEL
がSTRICT
に設定され、TRANSACTION_MODEL
がCOMMIT_CONFIRM
に設定されている場合にのみ必要です。 詳細については、「"トランザクション・ログ・キューの作成"」を参照してください。