C 初期化パラメータ

init.oraファイルのOracle Database初期化パラメータは、ゲートウェイ初期化パラメータと異なります。エージェント固有のメカニズムを使用して初期化パラメータ・ファイルにゲートウェイ・パラメータを設定するか、DBMS_HSパッケージを使用してOracleデータ・ディクショナリにゲートウェイ・パラメータを設定します。ゲートウェイ初期化パラメータ・ファイルは、ゲートウェイの起動時に使用可能である必要があります。初期化パラメータに加えた変更は、次のゲートウェイ・セッションまで反映されません。

次のトピックには、ゲートウェイごとに設定可能なゲートウェイ初期化パラメータのリストとその説明が含まれます。また、初期化パラメータ・ファイルの構文についても説明します。

• 初期化パラメータ・ファイルの構文

• Oracle Database Gateway for Sybaseの初期化パラメータ

• Oracle Database Gateway for Informixの初期化パラメータ

• Oracle Database Gateway for Teradataの初期化パラメータ

• Oracle Database Gateway for SQL Serverの初期化パラメータ

• Oracle Database Gateway for ODBCの初期化パラメータ

• Oracle Database Gateway for DRDAの初期化パラメータ

C.1 初期化パラメータ・ファイルの構文

初期化パラメータ・ファイルの構文は次のとおりです。

1. ファイルは一連のコマンドで構成されています。

2. 各コマンドは、個別の行で始まる必要があります。

3. 行の終わりは、コマンド終端文字で認識されます(円記号でエスケープされない場合)。

4. 初期化パラメータ・ファイルに構文エラーがあると、設定はすべて無効です。

5. パラメータ値は次のように設定します。

   [SET][PRIVATE] parameter=value
   

   説明:

   parameterは初期化パラメータの名前です。この名前は、任意の文字から始まる文字列であり、文字、数字およびアンダースコアで構成されます。初期化パラメータ名は大/小文字が区別されます。

   valueは初期化パラメータの値です。大/小文字が区別されます。初期化パラメータの値は、次のいずれかになります。

   1. 円記号、空白、二重引用符(")が含まれない文字列。

   2. 二重引用符で始まり、二重引用符で終わる引用符付き文字列。引用符付き文字列内では、次の文字列が使用できます。

      • 円記号(\)はエスケープ文字です。

      • \nは新しい行を挿入します。

      • \tはタブを挿入します。

      • \は二重引用符を挿入します。

      • \\はバックスラッシュを挿入します。

      行末の円記号は、文字列が次の行に続くことを示します。その他の文字の前に円記号を付けると、その円記号は無視されます。

   たとえば、エージェントのトレースを有効化するには、HS_FDS_TRACE_LEVEL初期化パラメータを次のように設定します。

   HS_FDS_TRACE_LEVEL=ON
   

   SETおよびPRIVATEは、オプションのキーワードです。どちらも初期化パラメータ名としては使用できません。ほとんどのパラメータは初期化パラメータとしてのみ必要とされるため、通常は、SETまたはPRIVATEキーワードを使用する必要はありません。SETまたはPRIVATEのいずれも指定しない場合、パラメータはエージェントの初期化パラメータとしてのみ使用されます。

   SETを指定すると、そのパラメータ値は初期化パラメータとして使用されるだけでなく、エージェント・プロセスの環境変数として設定されます。SETは、ドライバやOracle以外のシステムで環境変数として必要とされるパラメータ値に使用します。

   PRIVATEを指定すると、その初期化パラメータはエージェントに対してプライベートとなり、Oracle Databaseにアップロードされません。ほとんどのパラメータは、プライベートに設定しません。ただし、初期化パラメータ・ファイルにパスワードなどの機密情報を格納している場合、初期化パラメータとその値はアップロード時に暗号化されないため、機密情報のサーバーへのアップロードを避けたいことがあります。初期化パラメータをプライベートに設定すると、アップロードは実行されず、動的パフォーマンス・ビューにも表示されなくなります。PRIVATEは、パラメータ値にユーザー名やパスワードなどの機密情報が含まれる場合にのみ、初期化パラメータに使用します。

   SET PRIVATEを指定すると、そのパラメータ値はエージェント・プロセスの環境変数として設定され、かつプライベートになります(Oracle Databaseに転送されず、動的パフォーマンス・ビューやグラフィカル・ユーザー・インタフェースにも表示されません)。

C.2 Oracle Database Gateway for Sybaseの初期化パラメータ

この項では、Oracle Database Gateway for Sybaseで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。

• HS_CALL_NAME

• HS_DB_DOMAIN

• HS_DB_INTERNAL_NAME

• HS_DB_NAME

• HS_DESCRIBE_CACHE_HWM

• HS_LANGUAGE

• HS_LONG_PIECE_TRANSFER_SIZE

• HS_OPEN_CURSORS

• HS_RPC_FETCH_REBLOCKING

• HS_RPC_FETCH_SIZE

• HS_TIME_ZONE

• HS_TRANSACTION_MODEL

• IFILE

• HS_FDS_TIMESTAMP_MAPPING

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_FDS_CONNECT_INFO

• HS_FDS_PROC_IS_FUNC

• HS_FDS_RECOVERY_ACCOUNT

• HS_FDS_RECOVERY_PWD

• HS_FDS_RESULTSET_SUPPORT

• HS_FDS_TRACE_LEVEL

• HS_FDS_TRANSACTION_LOG

• HS_FDS_FETCH_ROWS

• HS_FDS_QUOTE_IDENTIFIER

• HS_IDLE_TIMEOUT

• HS_NLS_LENGTH_SEMANTICS

• HS_KEEP_REMOTE_COLUMN_SIZE

• HS_FDS_REMOTE_DB_CHARSET

• HS_FDS_SUPPORT_STATISTICS

• HS_FDS_RSET_RETURN_ROWCOUNT

• HS_FDS_SQLLEN_INTERPRETATION

• HS_FDS_REPORT_REAL_AS_DOUBLE

C.3 Oracle Database Gateway for Informixの初期化パラメータ

この項では、Oracle Database Gateway for Informixで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。

• HS_DB_DOMAIN

• HS_DB_INTERNAL_NAME

• HS_DB_NAME

• HS_DESCRIBE_CACHE_HWM

• HS_LANGUAGE

• HS_LONG_PIECE_TRANSFER_SIZE

• HS_OPEN_CURSORS

• HS_RPC_FETCH_REBLOCKING

• HS_RPC_FETCH_SIZE

• HS_TIME_ZONE

• HS_TRANSACTION_MODEL

• IFILE

• HS_FDS_TIMESTAMP_MAPPING

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_FDS_CONNECT_INFO

• HS_FDS_RECOVERY_ACCOUNT

• HS_FDS_RECOVERY_PWD

• HS_FDS_TRACE_LEVEL

• HS_FDS_TRANSACTION_LOG

• HS_FDS_FETCH_ROWS

• HS_IDLE_TIMEOUT

• HS_NLS_LENGTH_SEMANTICS

• HS_KEEP_REMOTE_COLUMN_SIZE

• HS_FDS_REMOTE_DB_CHARSET

• HS_FDS_SUPPORT_STATISTICS

• HS_FDS_SQLLEN_INTERPRETATION

C.4 Oracle Database Gateway for Teradataの初期化パラメータ

この項では、Oracle Database Gateway for Teradataで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。

• HS_DB_DOMAIN

• HS_DB_INTERNAL_NAME

• HS_DB_NAME

• HS_DESCRIBE_CACHE_HWM

• HS_LANGUAGE

• HS_LONG_PIECE_TRANSFER_SIZE

• HS_OPEN_CURSORS

• HS_RPC_FETCH_REBLOCKING

• HS_RPC_FETCH_SIZE

• HS_TIME_ZONE

• HS_TRANSACTION_MODEL

• IFILE

• HS_FDS_TIMESTAMP_MAPPING

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_FDS_CONNECT_INFO

• HS_FDS_RECOVERY_ACCOUNT

• HS_FDS_RECOVERY_PWD

• HS_FDS_TRACE_LEVEL

• HS_FDS_TRANSACTION_LOG

• HS_FDS_FETCH_ROWS

• HS_IDLE_TIMEOUT

• HS_NLS_LENGTH_SEMANTICS

• HS_KEEP_REMOTE_COLUMN_SIZE

• HS_FDS_REMOTE_DB_CHARSET

• HS_FDS_SUPPORT_STATISTICS

C.5 Oracle Database Gateway for SQL Serverの初期化パラメータ

この項では、Oracle Database Gateway for SQL Serverで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。

• HS_CALL_NAME

• HS_DB_DOMAIN

• HS_DB_INTERNAL_NAME

• HS_DB_NAME

• HS_DESCRIBE_CACHE_HWM

• HS_LANGUAGE

• HS_LONG_PIECE_TRANSFER_SIZE

• HS_OPEN_CURSORS

• HS_RPC_FETCH_REBLOCKING

• HS_RPC_FETCH_SIZE

• HS_TIME_ZONE

• HS_TRANSACTION_MODEL

• IFILE

• HS_FDS_CONNECT_INFO

• HS_FDS_PROC_IS_FUNC

• HS_FDS_RECOVERY_ACCOUNT

• HS_FDS_RECOVERY_PWD

• HS_FDS_REPORT_REAL_AS_DOUBLE

• HS_FDS_RESULTSET_SUPPORT

• HS_FDS_TRACE_LEVEL

• HS_FDS_TRANSACTION_LOG

• HS_FDS_FETCH_ROWS

• HS_FDS_TIMESTAMP_MAPPING

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_IDLE_TIMEOUT

• HS_NLS_LENGTH_SEMANTICS

• HS_KEEP_REMOTE_COLUMN_SIZE

• HS_FDS_REMOTE_DB_CHARSET

• HS_FDS_SUPPORT_STATISTICS

• HS_FDS_RSET_RETURN_ROWCOUNT

• HS_FDS_SQLLEN_INTERPRETATION

C.6 Oracle Database Gateway for ODBCの初期化パラメータ

この項では、Oracle Database Gateway for ODBCで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。

• HS_DB_DOMAIN

• HS_DB_INTERNAL_NAME

• HS_DB_NAME

• HS_DESCRIBE_CACHE_HWM

• HS_LANGUAGE

• HS_LONG_PIECE_TRANSFER_SIZE

• HS_OPEN_CURSORS

• HS_RPC_FETCH_REBLOCKING

• HS_RPC_FETCH_SIZE

• HS_FDS_SHAREABLE_NAME

• HS_TIME_ZONE

• IFILE

• HS_FDS_TIMESTAMP_MAPPING

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_FDS_CONNECT_INFO

• HS_FDS_TRACE_LEVEL

• HS_TRANSACTION_MODEL

• HS_FDS_FETCH_ROWS

• HS_FDS_REMOTE_DB_CHARSET

• HS_FDS_SQLLEN_INTERPRETATION

• HS_FDS_REPORT_REAL_AS_DOUBLE

C.7 Oracle Database Gateway for DRDAの初期化パラメータ

この項では、Oracle Database Gateway for DRDAで設定できるすべての初期化ファイル・パラメータをリストします。パラメータは次のとおりです。

• HS_CALL_NAME

• HS_DB_DOMAIN

• HS_DB_INTERNAL_NAME

• HS_DB_NAME

• HS_DESCRIBE_CACHE_HWM

• HS_LANGUAGE

• HS_LONG_PIECE_TRANSFER_SIZE

• HS_OPEN_CURSORS

• HS_RPC_FETCH_REBLOCKING

• HS_RPC_FETCH_SIZE

• HS_TRANSACTION_MODEL

• HS_FDS_FETCH_ROWS

• IFILE

• HS_FDS_CONNECT_INFO

• HS_FDS_TRACE_LEVEL

• HS_FDS_TRANSACTION_LOG

• HS_IDLE_TIMEOUT

• HS_FDS_MBCS_TO_GRAPHIC

• HS_FDS_GRAPHIC_TO_MBCS

• HS_FDS_TIMESTAMP_MAPPING

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_FDS_QUOTE_IDENTIFIER

• HS_FDS_ISOLATION_LEVEL

• HS_FDS_PACKAGE_COLLID

• HS_FDS_RECOVERY_ACCOUNT

• HS_FDS_RECOVERY_PWD

• HS_NLS_LENGTH_SEMANTICS

• HS_KEEP_REMOTE_COLUMN_SIZE

• HS_FDS_RESULTSET_SUPPORT

• HS_FDS_REMOTE_DB_CHARSET

• HS_FDS_SUPPORT_STATISTICS

• HS_FDS_RSET_RETURN_ROWCOUNT

• HS_FDS_AUTHENTICATE_METHOD

• HS_FDS_ENCRYPT_SESSION

• HS_FDS_TRUSTSTORE_FILE

• HS_FDS_TRUSTSTORE_PASSWORD

• HS_FDS_SQLLEN_INTERPRETATION

C.8 HS_CALL_NAME

プロパティ	説明
デフォルト値	なし
値の範囲	該当なし

SQL文で参照できるリモート・ファンクションを指定します。値は、リモート・ファンクションとその所有者をセミコロンで区切った次の形式のリストです。

owner_name.function_name
 

次に例を示します。

owner1.A1;owner2.A2;owner3.A3 

リモート・ファンクションに所有者名が指定されていない場合、デフォルトの所有者名がリモート・データベースへの接続に使用されるユーザー名になります(この名前は、異機種間サービス・データベース・リンクの作成時に指定されたものですが、DBリンクで指定されていない場合はユーザー・セッションから取得されます)。

所有者名およびファンクション名のエントリでは、大/小文字が区別されます。

C.9 HS_DB_DOMAIN

プロパティ	説明
デフォルト値	WORLD
値の範囲	1から199文字

Oracle以外のシステムにおける一意のネットワーク・サブアドレスを指定します。HS_DB_DOMAIN初期化パラメータは、Oracle Databaseリファレンスで説明されているDB_DOMAIN初期化パラメータと同様です。HS_DB_DOMAIN初期化パラメータは、Oracle Names Serverを使用する場合は必須です。HS_DB_NAMEおよびHS_DB_DOMAIN初期化パラメータでは、Oracle以外のシステムのグローバル名を定義します。

注意:

コオペラティブ・サーバー環境では、HS_DB_NAMEおよびHS_DB_DOMAIN初期化パラメータを組み合せて一意のアドレスを構成する必要があります。

C.10 HS_DB_INTERNAL_NAME

プロパティ	説明
デフォルト値	01010101
値の範囲	1から16の16進文字

異機種間サービス・エージェントの接続先となるインスタンスを識別する一意の16進数を指定します。このパラメータの値は、グローバル・ネーム・サービスがアクティブ化されたときにトランザクションIDの一部として使用されます。一意でない数値を指定すると、トランザクションで2フェーズ・コミットのリカバリ・アクションが必要な場合に問題が発生する可能性があります。

C.11 HS_DB_NAME

プロパティ	説明
デフォルト値	HO
値の範囲	1から8文字

Oracle以外のシステムに割り当てるデータ・ストアの一意の英数字名を指定します。この名前により、コオペラティブ・サーバー環境内でOracle以外のシステムが識別されます。HS_DB_NAMEおよびHS_DB_DOMAIN初期化パラメータでは、Oracle以外のシステムのグローバル名を定義します。

C.12 HS_DESCRIBE_CACHE_HWM

プロパティ	説明
デフォルト値	100
値の範囲	1から4000

異機種間サービスで使用される記述キャッシュのエントリの最大数を指定します。この制限は、記述キャッシュの最高水位標として知られています。キャッシュには、異機種間サービスがOracle以外のデータ・ストアに再アクセスせずに済むように、異機種間サービスで再利用するマップされた表の記述が含まれます。

多くのマップされた表にアクセスする場合、最高水位標を増加させてパフォーマンスを向上してください。最高水位標を増加させるとパフォーマンスは向上しますが、メモリー使用量も増大します。

C.13 HS_LANGUAGE

プロパティ	説明
デフォルト値	システム固有
値の範囲	任意の有効な言語名(最大255文字)

異機種間サービスに、Oracle以外のデータソースのキャラクタ・セット、言語および地域情報を提供します。値には次の書式を使用する必要があります。

language[_territory.character_set]

注意:

グローバリゼーション・サポートの初期化パラメータは、エラー・メッセージ、SQLサービスのデータ、および分散外部プロシージャのパラメータに影響します。

C.13.1 キャラクタ・セット

Oracle Databaseのキャラクタ・セットとOracle以外のデータソースのキャラクタ・セットは、同じであることが理想的です。ほとんどの場合、HS_LANGUAGEはキャラクタ・セット・マッピングとパフォーマンスを最適化するためのOracleデータベース・キャラクタ・セットと完全に同じに設定する必要があります。同じでない場合、異機種間サービスは、Oracle以外のデータソースのキャラクタ・セットをOracle Databaseのキャラクタ・セットに変換し、それを再び元に戻そうとします。この変換により、パフォーマンスが低下する可能性があります。状況によっては、異機種間サービスは、あるキャラクタ・セットから別のキャラクタ・セットに文字を変換できません。

注意:

指定するキャラクタ・セットは、エージェントがインストールされているプラットフォームにおけるオペレーティング・システムのキャラクタ・セットのスーパーセットである必要があります。

データベース・キャラクタ・セットとしてUnicodeを使用するOracleデータベースとOracle以外のデータベースが増えているため、ゲートウェイもUnicodeキャラクタ・セットで実行することをお薦めします。そのためには、HS_LANGUAGE=AL32UTF8を設定する必要があります。ただし、ゲートウェイがWindowsで実行される場合、Microsoft ODBCドライバ・マネージャ・インタフェースはダブルバイト・キャラクタ・セットUCS2でのみデータを交換できます。これにより、説明されているバッファおよび列サイズの比率が拡大します。適切なサイズに調整する方法の説明は、「HS_FDS_REMOTE_DB_CHARSET」を参照してください。

C.13.2 言語

HS_LANGUAGE初期化パラメータの言語構成要素により、次の項目が決定されます。

• 日付の月日の名前

• 日時に対するAD、BC、PMおよびAMの記号

• デフォルトのソート・メカニズム

Oracleでは、異機種間サービスの汎用メッセージに対応するエラー・メッセージ(ORA-25000からORA-28000)の言語は決定されません。これらは、Oracle Databaseのセッション設定により制御されます。

C.13.3 地域

地域の句により、日と週の順序規則、デフォルトの日付書式、小数点文字とグループ・セパレータ、およびISOと各国の通貨記号が指定されます。Oracle DatabaseとOracle以外のデータソース間におけるグローバリゼーション・サポートのレベルは、ゲートウェイがどのように実装されているかに応じて変化します。

C.14 HS_LONG_PIECE_TRANSFER_SIZE

プロパティ	説明
デフォルト値	64 KB
値の範囲	2GB以下の任意の値

転送されるLONGデータのピース・サイズを設定します。ピース・サイズを小さくすると、メモリー要件は減少しますが、すべてのデータをフェッチするためのラウンドトリップ回数は増加します。ピース・サイズを大きくすると、ラウンドトリップ回数は減少しますが、内部的に中間ピースを格納するためのメモリー要件は増大します。つまり、この初期化パラメータは、ラウンドトリップ回数とメモリー要件(およびネットワーク待機時間またはレスポンス時間)の最適なトレードオフ関係に基づいて、最高のパフォーマンスを発揮するようにシステムをチューニングする場合に使用します。

C.15 HS_OPEN_CURSORS

プロパティ	説明
デフォルト値	50
値の範囲	1からOracle DatabaseのOPEN_CURSORS初期化パラメータの値まで

Oracle以外のシステムのインスタンスに対する1つの接続でオープンできるカーソルの最大数を定義します。

この値は、Oracle Databaseのオープン・カーソルの数を超えることはできません。そのため、Oracle DatabaseのOPEN_CURSORS初期化パラメータと同じ値を設定することをお薦めします。

C.16 HS_RPC_FETCH_REBLOCKING

プロパティ	説明
デフォルト値	ON
値の範囲	OFFまたはON

Oracle DatabaseとOracle以外のデータ・ストアに接続された異機種間サービス・エージェントとの間におけるデータ転送のパフォーマンスを異機種間サービスにより最適化するかどうかを制御します。

次の値を指定できます。

• OFFを指定すると、エージェントからサーバーにデータを即座に送信するように、フェッチされたデータの再ブロッキングが無効化されます。

• ONでは再ブロック化が可能です。これは、Oracle以外のシステムからフェッチされたデータがエージェントにバッファされ、フェッチされたデータの量がHS_RPC_FETCH_SIZE初期化パラメータの値以上になるまでOracleデータベースに送信されないことを意味します。ただし、フェッチでそれ以上データが存在しないことが示された場合、またはOracle以外のシステムがエラーをレポートした場合は、バッファされたデータが即時に返されます。

C.17 HS_RPC_FETCH_SIZE

プロパティ	説明
デフォルト値	50000
値の範囲	1から10000000

内部データ・バッファリングを調整して、サーバーとエージェント・プロセス間のデータ転送レートを最適化します。

値を増やすと、指定されたデータ量を転送するために必要なネットワークのラウンドトリップの回数が減りますが、データ帯域幅が増え、問合せの発行から問合せのすべてのフェッチの完了までとして測定されるレイテンシが短縮される傾向があります。一方、最初のフェッチ結果は追加データが使用可能になるまで送信されないため、フェッチ・サイズを増やすと問合せの初期フェッチの結果のレイテンシが増大します。

C.18 HS_FDS_SHAREABLE_NAME

プロパティ	説明
デフォルト値	なし
値の範囲	適用なし

ODBCドライバ・マネージャのフルパス名を指定します。

このパラメータは、必須パラメータです。形式は次のとおりです。

HS_FDS_SHAREABLE_NAME=odbc_installation_path/lib/libodbc.sl

説明:

odbc_installation_pathは、ODBCドライバのインストール先のパスです。

C.19 HS_TIME_ZONE

プロパティ	説明
[+|-]hh:mmのデフォルト値	NLS_TERRITORY初期化パラメータから導出
[+|-]hh:mmの値の範囲	有効な日時書式マスク

現在のSQLセッションに対応するデフォルトのローカル・タイムゾーンの置換を指定します。書式マスク[+|-]hh:mmは、UTC(協定世界時、旧称グリニッジ標準時)の前後の時間および分を示すために指定します。次に例を示します。

HS_TIME_ZONE = [+ | -] hh:mm

C.20 HS_TRANSACTION_MODEL

プロパティ	説明
デフォルト値	COMMIT_CONFIRM
値の範囲	COMMIT_CONFIRM, READ_ONLY, READ_ONLY_AUTOCOMMIT, SINGLE_SITE, SINGLE_SITE_AUTOCOMMIT

Oracle以外のデータベースがトランザクションによって更新されるときに使用されるトランザクション・モデルのタイプを指定します。

次の値を指定できます。

• COMMIT_CONFIRMは、Oracle以外のデータベースに対する読取りおよび書込みアクセス権を付与し、ゲートウェイを分散更新に加えることができます。コミット確認モデルを使用するには、次のものをOracle以外のデータベースに作成する必要があります。

  • トランザクション・ログ表。デフォルトの表名はHS_TRANSACTION_LOGです。HS_FDS_TRANSACTION_LOGパラメータを使用して別の名前を設定できます。トランザクション・ログ表には、パブリックに設定されたSELECT、DELETEおよびINSERT権限を付与する必要があります。

  • リカバリ・アカウント。アカウント名は、HS_FDS_RECOVERY_ACCOUNTパラメータで割り当てます。

  • リカバリ・アカウントのパスワード。パスワードは、HS_FDS_RECOVERY_PWDパラメータで割り当てます。

    COMMIT_CONFIRMは、Oracle Database Gateway for ODBCには適用されません。Oracle Database Gateway for ODBCのデフォルト値は、SINGLE_SITEです。

• READ_ONLYは、Oracle以外のデータベースに対する読取りアクセスを提供します。

• READ_ONLY_AUTOCOMMITは、ロギングされていないOracle以外のデータベースへの読取りアクセスを提供します。READ_ONLY_AUTOCOMMITは、Oracle Database Gateway for ODBCには適用されません。

• SINGLE_SITEは、Oracle以外のデータベースに対する読取り/書込みアクセスを提供します。ただし、ゲートウェイを分散更新に加えることはできません。

• SINGLE_SITE_AUTOCOMMITは、ロギングされていないOracle以外のデータベースに対する読取り/書込みアクセスを提供します。更新は即時にコミットされ、ゲートウェイを分散更新に加えることはできません。SINGLE_SITE_AUTOCOMMITは、Oracle Database Gateway for ODBCには適用されません。

C.21 IFILE

プロパティ	説明
デフォルト値	なし
値の範囲	有効なパラメータ・ファイル名

IFILE初期化パラメータを使用して、現在の初期化ファイル内に別の初期化ファイルを埋め込みます。値は絶対パスである必要があり、環境変数を含めることはできません。3レベルのネスト制限は適用されません。

関連項目:

Oracle Databaseリファレンス

C.22 HS_FDS_CONNECT_INFO

プロパティ	説明
デフォルト値	なし
値の範囲	適用なし

HS_FDS_CONNECT_INFOでは、Oracle以外のシステムに対する接続を記述します。

デフォルトの初期化パラメータ・ファイルには、このパラメータのエントリがすでに含まれています。このリリースのゲートウェイでは、IPv6をサポートできます。IPv6アドレス形式を指定する場合は、ポート番号との分離を示すために、IPv6仕様を角カッコで囲む必要があります。ゲートウェイのHS_FDS_CONNECT_INFOの構文は、次のとおりです。

Oracle Database Gateway for Sybaseの場合:

HS_FDS_CONNECT_INFO=host_name:port_number/database_name

ここで、host_nameはSybaseデータベースをホストするマシンのホスト名またはIPアドレス、port_numberはSybaseデータベース・サーバーのポート番号、database_nameはSybaseデータベースの名前です。

Oracle Database Gateway for Informixの場合:

HS_FDS_CONNECT_INFO=host_name:port_number/server_name/database_name

ここで、host_nameはInformixデータベースをホストするマシンのホスト名またはIPアドレス、port_numberはInformixデータベース・サーバーのポート番号、server_nameはInformixデータ用のサーバー・マシンの名前、database_nameはInformixデータベースの名前です。

Oracle Database Gateway for Teradataの場合:

HS_FDS_CONNECT_INFO=host_alias:port_number[/database_name]

ここで、host_aliasはTeradataデータベースをホストするマシンのホスト・エイリアス名またはIPアドレス、port_numberはTeradataデータベース・サーバーのポート番号、database_nameはTeradataデータベースの名前です。database_name変数はオプションです。

Oracle Database Gateway for SQL Serverの場合:

HS_FDS_CONNECT_INFO= host_name/[instance_name][/database_name]

ここで、host_nameはSQL Serverデータベースをホストするマシンのホスト名またはIPアドレス、instance_nameはマシンで稼働するSQL Serverのインスタンス、database_nameはSQL Serverデータベースの名前です。instance_nameとdatabase_nameは両方ともオプションです。instance_nameを省略してdatabase_nameを指定する場合、スラッシュ(/)が必要です。つまり、次のようになります。

HS_FDS_CONNECT_INFO= host_name//database_name

Oracle Database Gateway for ODBCの場合:

HS_FDS_CONNECT_INFO=dsn_value

ここで、dsn_valueは、Microsoft WindowsのODBCデータソース アドミニストレータで定義したシステムDSNの名前です。

Oracle Database Gateway for DRDAの場合:

HS_FDS_CONNECT_INFO=IP_address:Port_number/Database_name,Type

IP_addressは、DB2 DRDAサーバーのホスト名またはIPアドレスです。

Port_numberは、DB2 DRDAサーバーのポート番号です。

Database_nameは、DB2サーバーのデータベース名です。

Type(大/小文字を区別しない)は次のいずれかです。

• ZOS (DB2 UDB for z/OS)、

• IOS (DB2 UDB for iSeries)、または

• LUW (DB2 UDB for Linux, UNIX, and Windows)

次に例を示します。

HS_FDS_CONNECT_INFO=[2001:0db8:20C:F1FF:FEC6:38AF]:1300/DB2M,ZOS

C.23 HS_FDS_PROC_IS_FUNC

プロパティ	説明
デフォルト値	FALSE
値の範囲	TRUE、FALSE

関数からの戻り値を使用できるようにします。デフォルトでは、すべてのストアド・プロシージャおよび関数は、ユーザーに戻り値を返しません。

注意:

この初期化パラメータを設定する場合、すべての既存のストアド・プロシージャについて、戻り値を処理するようにプロシージャ実行文の構文を変更する必要があります。

C.24 HS_FDS_RECOVERY_ACCOUNT

プロパティ	説明
デフォルト値	RECOVER。
値の範囲	任意の有効なユーザーID

コミット確認トランザクション・モデルに使用するリカバリ・アカウントの名前を指定します。ユーザー名とパスワードを備えたアカウントをOracle以外のシステムで設定する必要があります。コミット確認モデルの詳細は、HS_TRANSACTION_MODELパラメータを参照してください。

DRDAの場合、HS_FDS_RECOVERY_ACCOUNTは、分散トランザクションがインダウト状態になった場合にゲートウェイで使用されるユーザーIDを指定します。このユーザーIDは、パッケージに対する実行権限を持っている必要があり、IBMデータベースに定義されている必要があります。

分散トランザクションがインダウト状態になると、Oracle Databaseは、HS_FDS_RECOVERY_ACCOUNTを使用してIBMデータベースに接続し、トランザクションのステータスを確認します。このパラメータが存在しない場合、ゲートウェイはRECOVERのユーザーIDへの接続を試みます。

リカバリ・アカウントの名前では、大/小文字が区別されます。

C.25 HS_FDS_RECOVERY_PWD

プロパティ	説明
デフォルト値	なし
値の範囲	任意の有効なパスワード

Oracle以外のシステムで設定されたコミット確認トランザクション・モデルで使用されるリカバリ・アカウントのパスワードを指定します。コミット確認モデルの詳細は、HS_TRANSACTION_MODELパラメータを参照してください。

HS_FDS_RECOVERY_PWDは、HS_FDS_RECOVERY_ACCOUNTとともに使用されます。リカバリ・ユーザーは、分散トランザクションがインダウト状態になった場合にOracle以外のデータベースに接続します。

リカバリ・アカウントのパスワード名では、大/小文字が区別されます。

C.26 HS_FDS_RESULTSET_SUPPORT

プロパティ	説明
デフォルト値	FALSE
値の範囲	TRUE、FALSE

ストアド・プロシージャから返される結果セットを使用できるようにします。デフォルトでは、すべてのストアド・プロシージャは、ユーザーに結果セットを返しません。

注意:

この初期化パラメータを設定する場合、次の作業をする必要があります。

• すべての既存のストアド・プロシージャについて、結果セットを処理するようにプロシージャ実行文の構文を変更します。

• 異機種間サービスのシーケンシャル・モードで作業します。

C.27 HS_FDS_TRACE_LEVEL

プロパティ	説明
デフォルト値	OFF
値の範囲	OFF、ON、DEBUG

ゲートウェイ接続に対するエラー・トレースをオンにするかオフにするかを指定します。

有効な値は次のとおりです。

• OFFにすると、エラー・メッセージのトレースは使用できません。

• ONにすると、問題が発生したときに、発生したエラー・メッセージをトレースできます。デフォルトでは、結果はゲートウェイのインストール先のLOGディレクトリにあるゲートウェイ・ログ・ファイルに書き込まれます。

• DEBUGを指定すると、デバッグに使用できる詳細なエラー・メッセージのトレースが有効化されます。

C.28 HS_FDS_TRANSACTION_LOG

プロパティ	説明
デフォルト値	HS_TRANSACTION_LOG
値の範囲	有効な表名

Oracle以外のシステムでトランザクション・ロギング用に作成される表の名前を指定します。トランザクション・モデルの詳細は、HS_TRANSACTION_MODELパラメータを参照してください。

C.29 HS_FDS_REPORT_REAL_AS_DOUBLE

プロパティ	説明
デフォルト値	FALSE
値の範囲	TRUE、FALSE

Oracle Database Gateway for SQL Server、Oracle Database Gateway for ODBCおよびOracle Database Gateway for SybaseでSINGLE FLOAT PRECISIONフィールドをDOUBLE FLOAT PRECISIONフィールドとして処理できるようにします。

C.30 HS_FDS_FETCH_ROWS

プロパティ	説明
デフォルト値	100
値の範囲	1から1000の任意の整数
構文	HS_FDS_FETCH_ROWS=num

HS_FDS_FETCH_ROWSでは、フェッチ配列サイズを指定します。これは、Oracle以外のデータベースからフェッチされ、Oracle Databaseに一度に戻される行数です。このパラメータは、HS_RPC_FETCH_SIZEおよびHS_RPC_FETCH_REBLOCKINGパラメータの影響を受けます。

C.31 HS_FDS_CAPABILITY

プロパティ	説明
デフォルト値	なし
値の範囲	Oracle Database Gateway for DRDAユーザーズ・ガイドの第4章「アプリケーションの開発」を参照
構文	HS_FDS_CAPABILITY= {FUNCTION/{ON|OFF|SKIP}},...

HS_FDS_CAPABILITYがONに設定されている場合、指定された関数は、処理のためにDB2に送信されます。つまり、この関数については事後処理は不要になります。

HS_FDS_CAPABILITYがOFFに設定されている場合、指定された関数は、処理のためにDB2に送信されません。つまり、事後処理が行われます。

HS_FDS_CAPABILITYがSKIPに設定されている場合、指定された関数は、DB2に送信されるSQL文から削除されます。つまり、この関数は無視されます。

C.32 HS_FDS_ISOLATION_LEVEL

プロパティ	説明
デフォルト値	CHG (DB2 UDB for iSeries)、CS (DB2 UDB for z/OS)、DB2/UDB
値の範囲	{CHG|CS|RR|ALL|NC}
構文	HS_FDS_ISOLATION_LEVEL={CHG|CS|RR|ALL|NC}

HS_FDS_ISOLATION_LEVELでは、作成時にパッケージに対して定義される分離レベルを指定します。リモートDRDAデータベースに送信されるすべてのSQL文は、この分離レベルで実行されます。分離レベルは、アプリケーションのパフォーマンスに大きく影響します。デフォルト以外の分離レベルを指定する場合は、慎重に行ってください。分離レベルの詳細は、IBM社のデータベース・マニュアルを参照してください。

次の表に、分離レベルとその説明を示します。このレベルは、制御の少ない順に並んでいます(CHGはカーソル固定の信頼性が最も低く、RRは最も高くなっています)。固定度が高くなるほど、サーバー上のリソースをより多く使用し、長期間にわたりそれらのリソースをロックする可能性があることに注意してください。

レベル	説明
CHG	変更(DB2 UDB for iSeriesのデフォルト)
CS	カーソル固定(DB2 UDB for Linux, UNIX, and WindowsおよびDB2 UDB for z/OSのデフォルト)
RR	反復可能読取り
ALL	すべて
NC	コミットなし

C.33 HS_FDS_PACKAGE_COLLID

プロパティ	説明
デフォルト値	ORACLEGTW
値の範囲	長さが1から18文字の英数字文字列
構文	HS_FDS_PACKAGE_COLLID=collection_id

HS_FDS_PACKAGE_COLLIDでは、パッケージのコレクションIDを指定します。DB2 UDB for iSeriesの場合、コレクションIDは、実際にはAS/400ライブラリの名前です。

注意:

このパラメータを変更すると、ゲートウェイによって新しいパッケージが暗黙的にバインドされます。DB2 UDB for iSeriesの場合、接続を試みる前に、iSeries SQLコマンドCREATE SCHEMAまたはCREATE COLLECTIONを使用して、HS_FDS_PACKAGE_COLLIDに指定された名前でiSeriesライブラリを作成する必要があります。このCOLLECTIONまたはSCHEMAは、Oracle SQLコマンドCREATE DATABASE LINKのCONNECT TO句で指定されたIDで作成する必要があります。

C.34 HS_IDLE_TIMEOUT

プロパティ	説明
デフォルト値	0 (タイムアウトなし)
値の範囲	0-9999 (分)
構文	HS_IDLE_TIMEOUT=num

この機能は、Oracle Net TCPプロトコルでのみ使用できます。

ここで指定された期間、接続されたゲートウェイ・セッションのアクティビティがない場合、ゲートウェイ・セッションは保留中の更新(存在する場合)をロールバックして自動的に終了します。

C.35 HS_FDS_MBCS_TO_GRAPHIC

プロパティ	説明
デフォルト値	FALSE
値の範囲	FALSE|TRUE
構文	HS_FDS_MBCS_TO_GRAPHIC={FALSE|TRUE}

TRUEに設定されている場合、DB2 (var)graphic列に挿入されるようになっている任意のシングルバイト・キャラクタは、挿入操作前に同等のダブルバイト値に変換されます。

C.36 HS_FDS_GRAPHIC_TO_MBCS

プロパティ	説明
デフォルト値	FALSE
値の範囲	FALSE|TRUE
構文	HS_FDS_GRAPHIC_TO_MBCS={FALSE|TRUE}

TRUEに設定されている場合、同等のシングルバイト文字を持つことができるDB2 (var)graphic列にダブルバイト文字を使用すると、ユーザーに送信される前に同等のシングルバイトに変換されます。

C.37 HS_FDS_TIMESTAMP_MAPPING

プロパティ	説明
デフォルト値	DATE (デフォルトとしてCHARを使用するDB2を除く)
値の範囲	CHAR|DATE|TIMESTAMP
構文	HS_FDS_TIMESTAMP_MAPPING={CHAR|DATE|TIMESTAMP}

CHARに設定されている場合、Oracle以外のターゲット・タイムスタンプはCHAR(26)にマップされます。DATE (デフォルト)に設定されている場合、Oracle以外のターゲット・タイムスタンプはOracle DATEにマップされます。TIMESTAMPに設定されている場合、Oracle以外のターゲット・タイムスタンプはOracle TIMESTAMPにマップされます。

C.38 HS_FDS_DATE_MAPPING

プロパティ	説明
デフォルト値	DATE (デフォルトとしてCHARを使用するTeradataを除く)
値の範囲	DATE|CHAR
構文	HS_FDS_DATE_MAPPING={DATE|CHAR}

CHARに設定されている場合、Oracle以外のターゲット日付はCHAR(10)にマップされます。DATEに設定されている場合、Oracle以外のターゲット日付はOracle Dateにマップされます。

C.39 HS_FDS_ARRAY_EXEC

プロパティ	説明
デフォルト値	TRUE (デフォルトとしてFALSEを使用するOracle Database Gateway for DRDAを除く)
値の範囲	{TRUE|FALSE}
構文	HS_FDS_ARRAY_EXEC= {TRUE|FALSE}

TRUEに設定されている場合、ゲートウェイは配列操作を使用して、リモート・データ・ソースに対するバインドを含む文を挿入、更新、削除します。配列のサイズは、HS_FDS_FETCH_ROWS初期化パラメータの値によって決まります。

FALSEに設定されている場合、ゲートウェイは文の挿入、更新および削除に配列操作を使用しません。かわりに、値ごとに1つの文が発行されます。

C.40 HS_FDS_QUOTE_IDENTIFIER

プロパティ	説明
デフォルト値	TRUE (Sybaseの場合)
値の範囲	TRUE|FALSE
構文	HS_FDS_QUOTE_IDENTIFIER={FALSE|TRUE}

デフォルトでは、FDSでサポートされている場合、ゲートウェイは、識別子を引用符で囲みます。ただし、ユーザーはこの動作を上書きできます。HS_FDS_QUOTE_IDENTIFIERは、指定された値に応じて、引用符付きの識別子をサポートできるよう、ターゲットの機能をオーバーライドします。

C.41 HS_NLS_LENGTH_SEMANTICS

プロパティ	説明
デフォルト値	BYTE
値の範囲	BYTE | CHAR
構文	HS_NLS_LENGTH_SEMANTICS = { BYTE | CHAR }

このリリースのゲートウェイでは、Oracleデータベース・キャラクタ・セマンティクスと同等のキャラクタ・セマンティクス機能、つまり、NLS_LENGTH_SEMANTICS.が含まれています。HS_NLS_LENGTH_SEMANTICSがCHARに設定されている場合、Oracle以外のデータベースの(VAR)CHAR列はCHARセマンティクスを持つものとして解釈されます。ゲートウェイでHS_NLS_LENGTH_SEMANTICS=CHAR設定が使用されない唯一の状況は、Oracleとゲートウェイの両方で同じマルチバイト・キャラクタ・セットが使用されている場合です。

C.42 HS_KEEP_REMOTE_COLUMN_SIZE

プロパティ	説明
デフォルト値	OFF
値の範囲	OFF | LOCAL | REMOTE | ALL
構文	HS_KEEP_REMOTE_COLUMN_SIZE = OFF | LOCAL | REMOTE | ALL
パラメータ・タイプ	文字列

HS_KEEP_REMOTE_COLUMN_SIZEは、Oracle以外のデータベースからOracleデータベースへのデータ変換中に(VAR)CHARデータ型の長さを計算する際に比率の拡大を抑制するかどうかを指定します。REMOTEに設定されている場合は、Oracle以外のデータベースとゲートウェイの間で拡大が抑制されます。LOCALに設定されている場合は、ゲートウェイとOracleデータベースの間で拡大が抑制されます。ALLに設定されている場合は、Oracle以外のデータベースからOracleデータベースの場合に拡大が抑制されます。

パラメータを設定した場合、リモート列サイズの報告、暗黙的な結果のバッファ・サイズの計算、およびローカルOracleデータベースでの初期化の際に拡大が抑制されます。ゲートウェイがWindowsとHS_LANGUAGE=AL32UTF8で実行されている場合は、他の比率に関連するパラメータの操作に影響があるため、このパラメータを指定する必要はありません。これは、Oracle以外のデータベースからOracleデータベースの場合のリモート列サイズにのみ影響します。これは、INSERT、UPDATEまたはDELETEの操作時にゲートウェイを介してOracleデータベースからOracle以外のデータベースに移動するデータの比率の計算には影響しません。

C.43 HS_FDS_REMOTE_DB_CHARSET

プロパティ	説明
デフォルト値	なし
値の範囲	該当なし
構文	HS_FDS_REMOTE_DB_CHARSET

このパラメータは、HS_LANGUAGEがAL32UTF8に設定され、ゲートウェイがWindowsで実行されている場合にのみ有効です。データベース・キャラクタ・セットとしてUnicodeを使用するOracleデータベースとOracle以外のデータベースが増えているため、ゲートウェイもUnicodeキャラクタ・セットで実行することをお薦めします。そのためには、HS_LANGUAGE=AL32UTF8を設定する必要があります。ただし、ゲートウェイがWindowsで実行される場合、Microsoft ODBCドライバ・マネージャ・インタフェースはダブルバイト・キャラクタ・セットUCS2でのみデータを交換できます。これにより、説明されているバッファおよび列サイズの比率が拡大します。補正するために、ゲートウェイは、HS_FDS_REMOTE_DB_CHARSETが対応するOracle以外のデータベース・キャラクタ・セットに設定されている場合に、列サイズを再調整できます。たとえば、HS_FDS_REMOTE_DB_CHARSET=KO16KSC5601などです。

C.44 HS_FDS_SUPPORT_STATISTICS

プロパティ	説明
デフォルト値	TRUE
値の範囲	{TRUE|FALSE}
構文	HS_FDS_SUPPORT_STATISTICS= {TRUE|FALSE}

デフォルトでは、Oracle以外のデータベースの統計を収集します。HS_FDS_SUPPORT_STATISTICSパラメータをFALSEに設定することで、リモート・データベース統計の収集を無効にするよう選択できます。

C.45 HS_FDS_RSET_RETURN_ROWCOUNT

プロパティ	説明
デフォルト値	FALSE
値の範囲	{TRUE|FALSE}
構文	HS_FDS_RSET_RETURN_ROWCOUNT= {TRUE|FALSE}

TRUEに設定されている場合、ゲートウェイは、ストアド・プロシージャ内で実行されたDML文の行数を返します。行数は、符号付き整数型の単一行、単一列の結果セットとして返されます。

FALSEに設定されている場合、ゲートウェイは、ストアド・プロシージャ内で実行されたDML文の行数をスキップします。これはデフォルト動作であり、11.1以前のゲートウェイの動作です。

C.46 HS_FDS_SQLLEN_INTERPRETATION

プロパティ	説明
デフォルト値	64
値の範囲	{64|32}
構文	HS_FDS_SQLLEN_INTERPRETATION= {64|32}

このパラメータは、64ビット・プラットフォームでのみ有効です。ODBC標準は、64ビット・プラットフォームで(内部ODBCコンストラクトの) SQLLENを64ビットとして指定しますが、一部のODBCドライバ・マネージャおよびドライバはこの規則に違反し、32ビットとして実装します。ゲートウェイが動作を補正できるように、これらのタイプのドライバ・マネージャおよびドライバを使用する場合はHS_FDS_SQLLEN_INTERPRETATION=32を指定する必要があります。

C.47 HS_FDS_AUTHENTICATE_METHOD

プロパティ	説明
デフォルト値	CLEARTEXT
値の範囲	{CLEARTEXT|ENCRYPT|ENCRYPT_BOTH|CLIENT|KERBEROS}
構文	HS_FDS_AUTHENTICATE_METHOD= {CLEARTEXT|ENCRYPT|ENCRYPT_BOTH|CLIENT|KERBEROS}

ユーザーIDとパスワードをリモートDB2サーバーに送信して認証を行う方法を指定します。有効な値は次のとおりです。

• CLEARTEXT : ユーザーIDとパスワードがクリアテキストでサーバーに送信されます(デフォルト)。

• ENCRYPT : パスワードが暗号化されてサーバーに送信されます。

• ENCRYPT_BOTH : ユーザーIDとパスワードが暗号化されてサーバーに送信されます。

• CLIENT : サーバーではなくクライアント側でユーザーIDが検証されます。

• KERBEROS : ユーザーIDの認証にKerberosを使用します。

C.48 HS_FDS_ENCRYPT_SESSION

プロパティ	説明
デフォルト値	NONE
値の範囲	NONE|SSL|DB2}
構文	HS_FDS_ENCRYPT_SESSION = {NONE|SSL|DB2}

DB2へのセッションを暗号化する方法を指定します。有効な値は次のとおりです。

• NONE : データ・セッションは暗号化されません(デフォルト)。

• SSL : SSLを使用してデータ・セッションを暗号化します(DB2for iSeriesでのみサポートされています)。

• DB2 : データ・セッションにDB2暗号化プロトコルを使用します(DB2 for LUWおよびDB2 for z/OSの場合にのみサポートされ、認証がCLEARTEXT、ENCRYPTまたはENCRYPT_BOTHである場合にのみ使用できます)。

C.49 HS_FDS_TRUSTSTORE_FILE

プロパティ	説明
デフォルト値	なし
値の範囲	path to truststore file
構文	HS_FDS_TRUSTSTORE_FILE = path to truststore file

トラストストア・ファイルの場所を示すパスを指定します。トラストストア・ファイルには、SSLサーバー認証のクライアント・マシンで信頼されている有効な認証局(CA)のリストが含まれます。

C.50 HS_FDS_TRUSTSTORE_PASSWORD

プロパティ	説明
デフォルト値	なし
値の範囲	password
構文	HS_FDS_TRUSTSTORE_PASSWORD= password

トラストストアへのアクセスに必要なパスワードを指定します。