Linkexpress Transactional Replication option説明書

4.3.2 DB動作環境定義の作成

逐次差分反映機能において、コード変換エラーや文字あふれエラーなどが発生することがあります。また、データベースのロックの獲得に失敗することがあります。これらの現象が発生した場合の処理(異常終了する／代替文字に置き換えて処理を継続するなど)やデータベースのロックの獲得における待機時間などを、キーワードによりカスタマイズできます。これらのキーワードおよび指定値を記述したものを"DB動作環境定義"と呼びます。

DB動作環境定義に指定可能なキーワードを"表:DB動作環境定義のキーワード"に示します。

DB動作環境定義を記述したファイルを"DB動作環境定義ファイル"と呼びます。
DB動作環境定義ファイルの指定方法および優先順位は、以下のとおりです。

1. lxrtmdbコマンドの-dオプション(DB動作環境定義ファイル配置ディレクトリ名)
2. DBサービス定義のSTOREGROUP定義文のENVFILEオペランド(DB動作環境定義ファイル名)
3. 環境変数LXRTMENV(DB動作環境定義ファイル名)

なお、DB動作環境定義ファイルはユーザディレクトリ配下に配置してください。製品のインストールディレクトリ配下には配置しないでください。

[表:DB動作環境定義のキーワード]

キーワード	概要
MESSAGE_LEVEL ※	メッセージの出力レベル
EDIT_MESSAGE_LEVEL ※	データ編集時のメッセージ出力レベル
CHARACTER_CONVERT_ERROR ※	コード変換エラー発生時の動作
ALTERNATE_CHARACTER1 ※	コード変換エラー発生時の代替文字(Unicode以外)
UNICODE_ALTERNATE_CHARACTER1 ※	Unicodeのコード変換エラー発生時の代替文字
CHARACTER_OVERFLOW ※	文字属性データの文字あふれ時の動作
ALTERNATE_CHARACTER2 ※	文字属性データの文字あふれ時の代替文字(Unicode以外)
UNICODE_ALTERNATE_CHARACTER2 ※	Unicodeの文字あふれ時の代替文字
NCHAR_SINGLEBYTE_ERROR ※	日本語文字列属性の1文字未満領域に対する動作
BLANK_TRUNCATION ※	可変長文字属性のデータ末尾の空白の格納方法
NUMERIC_CONVERT_ERROR ※	浮動小数点属性データの桁あふれ時の動作
PACK_CONTROL ※	パック10進数属性データ異常時の動作
PACK_CORRECT	パック10進数属性データ異常時の動作
PACK_NOERROR	パック10進数属性データ異常時におけるエラー情報の出力の扱い
ZONE_CORRECT	ゾーン10進数属性データ異常時の動作
ZONE_NOERROR	ゾーン10進数属性データ異常時におけるエラー情報の出力の扱い
SYMFO_LIBMEM ※	Symfoware/RDBの環境開設時の取得メモリ最大値
SYMFO_SYSTEM_NAME ※	Symfoware/RDBのRDBシステム名
ORACLE_LOCK_RETRY_INTERVAL	Oracleデータベースのロックの獲得の待機時間
SQLSERVER_LOCK_RETRY_INTERVAL	SQL Serverデータベースのロックの獲得の待機時間
SQLSERVER_USE_DELIMITED_IDENTIFIERS	SQL Serverデータベースの識別子の扱い
SQLSERVER_CASE_SENSITIVITY	SQL Serverデータベースの大文字／小文字の扱い
LOGMODE	エラーログ情報採取時の動作モード
LOGSIZE	エラーログ管理ファイルの最大サイズ
LOGDIR	エラーログ管理ファイルを格納するディレクトリ名
LOG_OUTPUT_REDUNDANT_DATA_OPERATION	冗長なデータ操作情報を示すエラーログの出力の扱い
TRANSACTIONID_CONV_MODE	トランザクション識別子の変換モード
STOP_JNLCHECKPOINT_NAME	逐次差分反映処理の停止を指示するジャーナルチェックポイント名

※：LinkexpressのDB動作環境定義と共通のキーワードです。キーワードの詳細については、Linkexpressのマニュアルを参照してください。

■PACK_CORRECTキーワード

[内容]

パック10進数属性データ異常時の動作を指定します。
本キーワードが対象とする異常とPACK_CONTROLキーワードが対象とする異常の違いについて"図:PACK_CORRECTキーワードとPACK_CONTROLキーワードの違い"に示します。

[図:PACK_CORRECTキーワードとPACK_CONTROLキーワードの違い]

[形式]

PACK_CORRECT:動作種別

• 動作種別

  OFF : 異常終了します(省略値)。
  ON : 代替値(0)を設定し、処理を継続します。

[記述例]

# correct error pack data and continue
PACK_CORRECT:ON

■PACK_NOERRORキーワード

[内容]

パック10進数属性データ異常時におけるエラー情報の出力の扱いを指定します。
本キーワードは、PACK_CORRECTキーワードに"ON"を指定し、かつ、LOGMODEキーワードを指定した場合のみ有効になります。

[形式]

PACK_NOERROR:動作種別

• 動作種別

  OFF : パック10進数属性データのエラーログ情報を出力します(省略値)。
  ON : パック10進数属性データのエラーログ情報の出力を抑止します。

[記述例]

# not output error log(pack)
PACK_NOERROR:ON

■ZONE_CORRECTキーワード

[内容]

ゾーン10進数属性データ異常時の動作を指定します。

[形式]

ZONE_CORRECT:動作種別

• 動作種別

  OFF : 異常終了します(省略値)。
  ON : 代替値(0)を設定し、処理を継続します。

[記述例]

# correct error zone data and continue
ZONE_CORRECT:ON

■ZONE_NOERRORキーワード

[内容]

ゾーン10進数属性データ異常時におけるエラー情報の出力の扱いを指定します。
本キーワードは、ZONE_CORRECTキーワードに"ON"を指定し、かつ、LOGMODEキーワードを指定した場合のみ有効になります。

[形式]

ZONE_NOERROR:動作種別

• 動作種別

  OFF : ゾーン10進数属性データのエラーログ情報を出力します(省略値)。
  ON : ゾーン10進数属性データのエラーログ情報の出力を抑止します。

[記述例]

# not output error log(zone)
ZONE_NOERROR:ON

■ORACLE_LOCK_RETRY_INTERVALキーワード

[内容]

Oracleデータベースのロックの獲得の待機時間を指定します。
待機時間を超えた場合は、逐次差分反映処理のデータベースのトランザクションをリトライします。
待機時間を0〜32767(秒)の範囲で指定します。
0(秒)を指定した場合は、ロックを獲得するまで待機します。
本キーワード省略時は、10(秒)となります。

[形式]

ORACLE_LOCK_RETRY_INTERVAL:待機時間

• 待機時間

  0〜32767の範囲の値を10進数で指定してください。

[注意]

ロックの待機をしている状態では、lxrtmdbコマンドで逐次差分反映処理を終了できません。
この状態でlxrtmdbコマンドを投入した場合、コマンドは受け付けられますが、ロックの獲得、または待機時間を超えるまで逐次差分反映処理は終了しません。

[記述例]

ORACLE_LOCK_RETRY_INTERVAL:10

■SQLSERVER_LOCK_RETRY_INTERVALキーワード

[内容]

SQL Serverデータベースのロックの待機時間を指定します。
待機時間を超えた場合は、逐次差分反映処理のデータベースのトランザクションをリトライします。
待機時間を-1〜32767(秒)の範囲で指定します。
0(秒)を指定した場合は、ロックの獲得待ちを行わず、すぐにリトライします。
-1(秒)を指定した場合は、ロックを獲得するまで待機します。
本キーワード省略時は、10(秒)となります。

[形式]

SQLSERVER_LOCK_RETRY_INTERVAL:待機時間

• 待機時間

  -1〜32767の範囲の値を10進数で指定してください。

[注意]

ロックの待機をしている状態では、lxrtmdbコマンドで逐次差分反映処理を終了できません。
この状態でlxrtmdbコマンドを投入した場合、コマンドは受け付けられますが、ロックの獲得、または待機時間を超えるまで逐次差分反映処理は終了しません。

[記述例]

SQLSERVER_LOCK_RETRY_INTERVAL:10

■SQLSERVER_USE_DELIMITED_IDENTIFIERSキーワード

[内容]

SQL Serverデータベースにおいて、標準ではない識別子を有効とするかどうかを指定します。
たとえば、"AAA-B"や"１月"は、標準では許されていません。これらの識別子を有効とする場合、"ON"を指定してください。

[形式]

SQLSERVER_USE_DELIMITED_IDENTIFIERS:動作種別

• 動作種別

  OFF : 無効とします(省略値)。
  ON : 有効とします。

[注意]

"ON"を指定した場合、データベース名、スキーマ名、表名、列名の上限は、"第8章 DBサービス定義"で規定されている上限より2バイト短くなります。

[記述例]

SQLSERVER_USE_DELIMITED_IDENTIFIERS:ON

■SQLSERVER_CASE_SENSITIVITYキーワード

[内容]

SQL Serverデータベースにおいて、DBサービス定義のデータベースに関する値(データベース名、スキーマ名、表名、列名)およびlxrtmdbコマンドの-uオプションの指定値に対する、大文字／小文字の扱いを指定します。
"ON"を指定した場合、DBサービス定義のデータベースに関する値およびlxrtmdbコマンドの-uオプションの指定値は、格納先データベースに定義されている内容と大文字／小文字を含めて一致している必要があります。

[形式]

SQLSERVER_CASE_SENSITIVITY:動作種別

• 動作種別

  OFF : 大文字として扱います(省略値)。
  ON : 大文字／小文字を区別します。

[注意]

大文字／小文字を区別するインスタンスを利用する場合、本キーワードに"ON"を指定してください。
それ以外の場合は、本キーワードを省略または"OFF"を指定してください。

[記述例]

SQLSERVER_CASE_SENSITIVITY:ON

■LOGMODEキーワード

[内容]

本キーワードを指定した場合、エラーログ管理ファイル満杯時の動作モードに従ってエラーログ情報を採取します。本キーワード省略時は、エラーログ情報を採取しません。

"エラーログ情報"および"エラーログ管理ファイル"については、"第9章 エラーロギング機能"を参照してください。

[形式]

LOGMODE:エラーログ管理ファイル満杯時の動作モード

• エラーログ管理ファイル満杯時の動作モード

  エラーログ管理ファイルのサイズが最大に達した場合の逐次差分反映処理の動作を指定します。

  EXIT : エラーメッセージを出力し、逐次差分反映処理を終了します。エラーログ情報採取中に何らかのエラーが発生し、エラーログ情報が出力できない場合にも逐次差分反映処理を終了します。

  CONTINUE : 警告メッセージを出力し、逐次差分反映処理を継続します。以降のエラーログ情報はlxrtmlogctlコマンドでエラーログ情報を退避または初期化するまで出力しません。エラーログ情報採取中に何らかのエラーが発生し、エラーログ情報が出力できない場合にも以降のエラーログ情報出力は行わず、逐次差分反映処理を継続します。

[記述例]

# exit when error log is full
LOGMODE:EXIT

■LOGSIZEキーワード

[内容]

エラーログ情報採取時のエラーログ管理ファイルごとの最大サイズを指定します。エラーログ管理ファイルのサイズが本キーワードに指定した値を超えた場合は、LOGMODEキーワードで指定したモードに従います。
最大サイズを1〜100(メガバイト)の範囲で指定します。

"エラーログ情報"および"エラーログ管理ファイル"については、"第9章 エラーロギング機能"を参照してください。

[形式]

LOGSIZE: エラーログ管理ファイルごとの最大サイズ

• エラーログ管理ファイルの最大サイズ

  エラーログ管理ファイルの最大サイズを1〜100(メガバイト)の範囲で指定します。省略値は10メガバイトです。

[注意]

エラーログ管理ファイルには、編集エラーログ管理ファイルと格納エラーログ管理ファイルがあります。本キーワードではファイル1つあたりの最大サイズを指定してください。

1回のエラーで採取されるエラーログ情報のサイズによっては、本キーワードに指定したサイズを超えてエラーログ情報が出力されることがあります。エラーログ管理ファイルを格納するディレクトリには、1メガバイト程度あらかじめ余裕をもってディスクを割り当ててください。

[記述例]

LOGSIZE:10

■LOGDIRキーワード

[内容]

エラーログ管理ファイルを格納するディレクトリ名を指定します。ディレクトリ名は230バイト以内の絶対パスで指定します。
本キーワードを省略した場合は、以下のディレクトリ配下にエラーログ管理ファイルを格納します。

• /var/tmp/FJSVlnktr/log
• インストールフォルダ\TRO\log

エラーログ管理ファイルについては、"第9章 エラーロギング機能"を参照してください。

[形式]

LOGDIR: エラーログ管理ファイルを格納するディレクトリ名

• エラーログ管理ファイルを格納するディレクトリ名

  エラーログ管理ファイルを格納するディレクトリ名を230バイト以内で指定します。存在しないディレクトリを指定した場合、作成します。

[注意]

本ディレクトリ配下に出力されたエラーログ管理ファイルを直接参照／更新しないでください。直接参照／更新した場合、逐次差分反映処理の性能が劣化したり、逐次差分反映処理が停止する可能性があります。参照する場合は、エラーログ情報をlxrtmlogctlコマンドを使用して退避し、退避したファイルを参照してください。

[記述例]

LOGDIR:d:\log

■LOG_OUTPUT_REDUNDANT_DATA_OPERATIONキーワード

[内容]

冗長なデータ操作情報を示すログの出力の扱いを指定します。
本キーワードは、LOGMODEキーワードを指定した場合に有効になります。

[形式]

LOG_OUTPUT_REDUNDANT_DATA_OPERATION:動作種別

• 動作種別

  OFF : 冗長なデータ操作情報を示すログを出力しません(省略値)。
  ON : 冗長なデータ操作情報を示すログを出力します。

[記述例]

LOG_OUTPUT_REDUNDANT_DATA_OPERATION:ON

■TRANSACTIONID_CONV_MODEキーワード

[内容]

システム取得項目のトランザクション識別子(TJNLTRNID)の変換モードを指定します。トランザクション識別子については"TJNL使用手引書"または"A.1.1 ジャーナル利用定義の規定"を参照してください。

[形式]

TRANSACTIONID_CONV_MODE:トランザクション識別子の変換モード

• トランザクション識別子(バイナリ8バイト)の変換モード

  CHARCONV : トランザクション識別子を16バイトの文字列に変換します。なお、バイナリデータのa〜fは英大文字に変換します。
  NOCONV : トランザクション識別子の変換を行いません(省略値)。

[記述例]

TRANSACTIONID_CONV_MODE:CHARCONV

■STOP_JNLCHECKPOINT_NAMEキーワード

[内容]

逐次差分反映処理を終了するジャーナルチェックポイント名を指定します。本キーワードに指定したジャーナルチェックポイントを受信すると、RT70023メッセージを出力し、逐次差分反映処理は終了します。

[形式]

STOP_JNLCHECKPOINT_NAME:終了ジャーナルチェックポイント名

• 終了ジャーナルチェックポイント名

  32文字以内の英大文字、数字、"@"または"_"の組み合わせで指定します。

[記述例]

STOP_JNLCHECKPOINT_NAME:STOPJCHKPT