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

• IFILE

• HS_FDS_DATE_MAPPING

• HS_FDS_ARRAY_EXEC

• HS_FDS_CONNECT_INFO

• HS_FDS_RECOVERY_ACCOUNT

• HS_FDS_RECOVERY_PWD

• HS_FDS_FETCH_ROWS

• 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_QUOTE_IDENTIFIER

• HS_FDS_CAPABILITY

• HS_FDS_ISOLATION_LEVEL

• HS_FDS_PACKAGE_COLLID

• 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

• HS_FDS_REPORT_REAL_AS_DOUBLE

C.8 HS_TIME_ZONE

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

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

HS_TIME_ZONE = [+ | -] hh:mm

C.9 HS_FDS_PROC_IS_FUNC

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

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

ノート:

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

C.10 HS_FDS_RESULTSET_SUPPORT

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

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

ノート:

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

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

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

C.11 HS_FDS_SHAREABLE_NAME

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

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

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

HS_FDS_SHAREABLE_NAME=odbc_installation_path/lib/libodbc.sl

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

C.12 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.13 HS_CALL_NAME

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

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

owner_name.function_name
 

たとえば:

owner1.A1;owner2.A2;owner3.A3 

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

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

C.14 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.15 HS_DB_INTERNAL_NAME

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

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

C.16 HS_DB_NAME

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

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

C.17 HS_DESCRIBE_CACHE_HWM

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

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

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

C.18 HS_LANGUAGE

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

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

language[_territory.character_set]

ノート:

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

C.18.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.18.2 言語

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

• 日付の月日の名前

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

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

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

C.18.3 地域

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

ノート:

このパラメータは、Oracle Database Gateway for DRDAの対応するDB2ターゲット・セットを示す際にも使用されます。

C.19 HS_LONG_PIECE_TRANSFER_SIZE

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

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

C.20 HS_OPEN_CURSORS

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

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

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

C.21 HS_RPC_FETCH_REBLOCKING

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

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

次の値を指定できます。

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

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

C.22 HS_RPC_FETCH_SIZE

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

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

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

C.23 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.24 IFILE

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

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

関連項目:

Oracle Databaseリファレンス

C.25 HS_FDS_CONNECT_INFO

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

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

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

たとえば、

HS_FDS_CONNECT_INFO=[2001:0db8:20c:f1ff:fec6:38af]:1300/sybase_db

ゲートウェイの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[[:port_number]|/[instance_name]][/database_name]

host_nameは、SQL Serverデータベースをホストしているマシンのホスト名またはIPアドレスです。port_numberは、SQL Serverデータベース・サーバーのポート番号です。instance_nameは、マシンで実行中のSQL Serverのインスタンスです。database_nameは、SQL Serverデータベースの名前です。変数port_numberまたはinstance_nameのいずれかを使用できますが、両方を同時に使用することはできません。オプションで、両方を省略することも可能です。値database_nameは常にオプションです。特定の値が省略されている場合はスラッシュ(/)が必要です。たとえば、次のエントリはいずれも有効です。

HS_FDS_CONNECT_INFO=host_name/instance_name/database_name
HS_FDS_CONNECT_INFO=host_name//database_name
HS_FDS_CONNECT_INFO=host_name:port_name//database_name
HS_FDS_CONNECT_INFO=host_name/instance_name
HS_FDS_CONNECT_INFO=host_name 

Oracle Database Gateway for ODBCの場合:

HS_FDS_CONNECT_INFO=dsn_value

ここで、dsn_valueは、odbc.iniファイルに構成されているデータソース名です。

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またはWindows)

たとえば、

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

C.26 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.27 HS_FDS_RECOVERY_PWD

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

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

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

関連項目:

詳細は、『Oracle Database Gateway for DRDAユーザーズ・ガイド』を参照してください。

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

C.28 HS_FDS_TRACE_LEVEL

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

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

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

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

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

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

C.29 HS_FDS_TRANSACTION_LOG

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

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

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ユーザーズ・ガイド』のアプリケーションの開発に関する項を参照してください。
構文	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

プロパティ	説明
デフォルト値	DB2 UDB for iSeriesの場合はCHG、DB2 UDB for z/OS、DB2 UDB for Linux、UnixおよびWindowsの場合はCS
値の範囲	{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および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 for UDB 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

TCPプロトコルで実行中のOracleゲートウェイに対するHS RPC呼出しの読取りタイム・アウト値を指定します。

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

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に設定されている場合、ゲートウェイは、挿入文、更新文および削除文に配列操作を使用しなくなります。かわりに、値ごとに単一の文が発行されます。

C.40 HS_FDS_QUOTE_IDENTIFIER

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

デフォルトでは、ゲートウェイは識別子を引用します(FDSでサポートされている場合)。ただし、この動作はユーザーが上書きできます

C.41 HS_NLS_LENGTH_SEMANTICS

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

このリリースのゲートウェイには、Oracleデータベースのキャラクタ・セマンティクス(NLS_LENGTH_SEMANTICS)と同等のキャラクタ・セマンティクス機能が備わっています。HS_NLS_LENGTH_SEMANTICSがCHARに設定されている場合、DB2の(var)char列と(var)graphic列は、CHARのセマンティクスを持つものとして解釈されます。たとえば、DB2 CHAR(10)は、ゲートウェイの文字セットからOracleの文字セットへの比率拡大がないと仮定すると、Oracleに対してCHAR(10 CHAR)であると表現されます。Oracleとゲートウェイの両方が同じマルチバイト文字セットである場合にのみ、ゲートウェイはHS_NLS_LENGTH_SEMANTICS=CHAR 設定を無視します。

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データベースをインスタンス化するときに拡大が抑制されます。これは、Oracle以外のデータベースからOracleデータベースへのリモートの列サイズに対してのみ作用します。ゲートウェイがWindowsで実行されていて、HS_LANGUAGE=AL32UTF8の場合は、このパラメータを指定しないでください(その他の比率に関連するパラメータ操作に影響します)。INSERT、UPDATEまたはDELETEの操作時にゲートウェイを通じてOracleデータベースからOracle以外のデータベースに移動するデータに対する比率の計算には影響しません。

C.43 HS_FDS_RESULTSET_SUPPORT

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

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

ノート:

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

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

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

C.44 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.45 HS_FDS_SUPPORT_STATISTICS

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

デフォルトで、Oracle以外のデータベースから統計が収集されます。リモート・データベースの統計の収集は、HS_FDS_SUPPORT_STATISTICSパラメータをFALSEに設定することで無効化できます。

C.46 HS_FDS_RSET_RETURN_ROWCOUNT

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

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

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

C.47 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.48 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.49 HS_FDS_ENCRYPT_SESSION

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

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

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

• SSL: データ・セッションの暗号化にSSLが使用されます(DB2 for iSeriesでのみサポートされます)。

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

C.50 HS_FDS_TRUSTSTORE_FILE

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

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

C.51 HS_FDS_TRUSTSTORE_PASSWORD

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

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