ゲートウェイは、この付録で説明する独自の初期化パラメータを持ち、Oracle Database Gatewayの初期化パラメータをサポートします。
この付録の内容は次のとおりです。
ゲートウェイ初期化ファイルは、init
sid
.ora
と呼ばれます。デフォルト初期化ファイルは、Oracle Database Gateway for WebSphere MQのインストール中、Microsoft WindowsではORACLE_HOME
\dg4mq\admin
ディレクトリおよびUNIXベース・システムではORACLE_HOME
/dg4mq/admin
ディレクトリに作成されます。
この項では、ゲートウェイ・パラメータ、デフォルト値のリスト、値の範囲および使用方法の構文を説明します。この項で説明するパラメータは、次のとおりです。
次の表では、LOG_DESTINATION
パラメータについて説明します。
LOG_DESTINATION | 使用方法 |
---|---|
構文 | LOG_DESTINATION = log_file |
デフォルト値 | SID_agt_PID.trc (PIDは、ゲートウェイのプロセスID) |
値の範囲 | なし |
LOG_DESTINATION
は、ゲートウェイ・ログ・ファイルのフルパス名を指定します。
次の表では、AUTHORIZATION_MODEL
パラメータの使用方法について説明します。
AUTHORIZATION_MODEL | 使用方法 |
---|---|
構文 | AUTHORIZATION_MODEL = {RELAXED|STRICT} |
デフォルト値 | RELAXED |
値の範囲 | RELAXED またはSTRICT |
AUTHORIZATION_MODEL
は、ゲートウェイ・ユーザーの認可モデルを定義します。Relaxedモデルは、ゲートウェイの有効なユーザーIDに対してキュー・マネージャから付与される認可を、Oracleアプリケーションが持つただ1つの関連付けとして指定します。
Strictモデルは、OracleユーザーIDおよびパスワード(データベース・リンクの作成時に指定される)、または現行のユーザーIDおよびパスワード(OracleユーザーIDおよびパスワードが指定されていない場合)で、ローカルまたはネットワーク・パスワード・ファイルをチェックするかを指定します。
有効なユーザーIDの詳細は、「セキュリティ・モデル」を参照してください。
次の表では、QUEUE_MANAGER
パラメータについて説明します。
QUEUE_MANAGER | 使用方法 |
---|---|
構文 | QUEUE_MANAGER = manager_name |
デフォルト値 | なし |
値の範囲 | なし |
必須パラメータQUEUE_MANAGER
は、ゲートウェイがログイン時に接続するキュー・マネージャの名前を指定します。ゲートウェイの有効なユーザーIDは、正しいユーザー権限が付与されるか、このキュー・マネージャへの接続が認可される必要があります。次のルールに従い、manager_name
を指定してください。
長さ1〜48文字の英数字
先行または埋込み空白文字の不可
後続空白文字の許可
有効なユーザーIDの詳細は、「セキュリティ・モデル」を参照してください。
次の表では、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コールの詳細は、IBMのドキュメントを参照してください。 |
次の表では、TRANSACTION_LOG_QUEUE
パラメータの使用方法について説明します。
TRANSACTION_LOG_QUEUE | 説明 |
---|---|
構文 | TRANSACTION_LOG_QUEUE = tx_queue_name |
デフォルト値 | なし |
値の範囲 | なし |
TRANSACTION_LOG_QUEUE
は、ロギング・トランザクションIDのキュー名を指定します。次のルールに従い、tx_queue_name
を指定してください。
長さ1〜48文字の英数字
先行または埋込み空白文字の不可
後続空白文字の許可
詳細は、「トランザクション・ログ・キューの作成」を参照してください。
次の表では、TRANSACTION_MODEL
の使用方法について説明します。
TRANSACTION_MODEL | 説明 |
---|---|
構文 | TRANSACTION_MODEL = {COMMIT_CONFIRM |SINGLE_SITE } |
デフォルト値 | SINGLE_SITE |
値の範囲 | COMMIT_CONFIRM またはSINGLE_SITE |
TRANZACTION_MODEL
は、ゲートウェイのトランザクション・モードを定義します。次の表の説明に従い、TRANSACTION_MODEL
の値を指定してください。
項目 | 説明 |
---|---|
COMMIT_CONFIRM |
同一のWebSphere MQキュー・マネージャに所属するキューが更新された場合に、ゲートウェイがトランザクションに参加するように指定します。同時に、Oracleデータベースはいくつでも更新されます。ゲートウェイがトランザクションの中心として操作するため、コミット確認モデルの1つのゲートウェイのみが分散トランザクションに参加できます。
この値が指定される場合、 |
SINGLE_SITE |
同一のWebSphere MQキュー・マネージャに所属するキューが更新された場合にのみ、ゲートウェイがトランザクションに参加するように指定します。Oracleアプリケーションは、WebSphere MQにアクセスする同一トランザクション内のOracleデータベース上のデータを選択できますが、更新できません。 |
次の表では、TRANSACTION_RECOVERY_PASSWORD
パラメータについて説明します。
TRANSACTION_RECOVERY_PASSWORD | 説明 |
---|---|
デフォルト値 | * |
値の範囲 | パラメータを暗号化する必要があることを示すアスタリスク(*)、またはいずれかの有効なパスワード |
構文 | TRANSACTION_RECOVERY_PASSWORD = rec_password
または
|
TRANSACTION_RECOVERY_PASSWORD
は、トランザクションのリカバリを開始する際にゲートウェイが使用するユーザーのパスワードを指定します。デフォルト値は、アスタリスク(*)に設定され、このアスタリスクは、パラメータ値が個別のパスワード・ファイルに暗号化されて格納されていることを示します。暗号化されたゲートウェイ・パスワードを指定または変更するには、dg4pwd
ゲートウェイ・ユーティリティを使用して作業します。詳細は、「dg4pwdユーティリティの使用方法」を参照してください。
TRANSACTION_MODEL
がCOMMIT_CONFIRM
に設定されている場合にのみ、TRANSACTION_RECOVERY_PASSWORD
パラメータが必要です。詳細は、「トランザクション・ログ・キューの作成」を参照してください。
ゲートウェイは、ユーザーIDおよびパスワードを使用して、WebSphere MQサーバー上のリモート・データベースにある情報にアクセスします。ユーザーIDおよびパスワードは、リソース・リカバリなどの機能を処理するために、ゲートウェイ初期化ファイルで定義される場合があります。セキュリティを意識した環境では、プレーン・テキスト・パスワードが初期化ファイルでアクセス可能な場合、これらのパスは安全ではないとみなされます。新しい暗号化機能がゲートウェイに追加されたため、そのようなパスワードがより保護されています。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 = rec_user |
デフォルト値 | なし |
値の範囲 | WebSphere MQ Manager(MQM)により認可された、いずれかの有効なオペレーティング・システム・ユーザーID |
TRANSACTION_RECOVERY_USER
は、トランザクションのリカバリを開始する際にゲートウェイが使用するユーザー名を指定します。これは、AUTHORIZATION_MODEL
がSTRICT
に設定され、TRANSACTION_MODEL
がCOMMIT_CONFIRM
に設定されている場合にのみ必要です。詳細は、「トランザクション・ログ・キューの作成」を参照してください。