2.89.1　pdorendの形式と規則

(a)　-s サーバ名〔，サーバ名〕…　〜＜識別子＞((1〜8))

レプリカRDエリアに対する更新処理をオリジナルRDエリアに反映する，レプリカグループのあるサーバの名称を指定します。

＜規則＞

1. -sオプションを省略した場合，オンライン再編成閉塞のRDエリアがあるすべてのサーバに対して追い付き反映処理をします。

2. HiRDBシングルサーバの場合は，-sオプションを省略してください。

3. サーバ名を重複して指定した場合，重複排除されます。

4. 指定できるサーバの数は最大128個です。129個以上指定した場合，129個目以降のサーバ名は無視されます。

5. pdorbeginコマンドでサーバ間横分割表を指定した場合，サーバ間で一括して処理をします。したがって，追い付き反映処理をするサーバを限定するときだけ，-sオプションを指定してください。

6. 処理対象RDエリアに共用RDエリアがある場合に-sオプションを指定するときは，同時に-uオプションも指定してください。-uオプションを指定していない場合に-sオプションを指定するとエラーになります。

7. 次の条件を二つとも満たす場合，-sオプションを指定してpdorendコマンドを実行してください。-sオプションを省略して実行すると，エラーとなります。

   • -tオプション指定のpdorbeginコマンドを実行している（共用表を指定している場合を除く）。

   • HiRDBの一部のユニット若しくはサーバが停止している，又は停止処理中である。

(b)　-n 最大リトライ回数　〜＜符号なし整数＞((0〜10))《3》

オリジナルRDエリアとレプリカRDエリアの同期を取るため，オンライン再編成閉塞のRDエリアがあるレプリカグループ構成に排他を掛けます。排他を掛けるとき，又は排他を掛けた後の，追い付き反映処理時にタイムアウトが発生した場合に，リトライするサーバごとの最大リトライ回数を指定します。

指定した最大リトライ回数を超えた場合，該当するサーバの処理はエラー終了します。リトライが発生する条件については，規則を参照してください。

(c)　-w 追い付き反映処理の最大待ち時間　〜＜符号なし整数＞((60〜3600))《600》

レプリカRDエリアに対する更新処理をオリジナルRDエリアに反映するまでの，最大待ち時間を秒単位で指定します。

指定した追い付き反映処理の最大待ち時間を超えた場合，処理が終了していないサーバはエラー終了となります。エラーとなった場合は，-wオプションの指定値を大きくするか，又はpdorend実行中のオンライン業務のトランザクション量を抑えるかしてください。

(d)　-t トランザクション処理の最大待ち時間　〜＜符号なし整数＞((1〜3600))

オリジナルRDエリアとレプリカRDエリアの同期を取るための，オンライン再編成閉塞のRDエリアがあるレプリカグループ構成の排他を掛けるとき，又は排他を掛けた後の追い付き反映処理の完了までの，サーバごとの最大待ち時間を秒単位で指定します。

-tオプションを省略した場合，システム定義のpd_lck_wait_timeoutオペランドの指定値が仮定されます。トランザクション処理の最大待ち時間については，規則を参照してください。

(e)　-m pdorend反映プロセスの多重度　〜＜符号なし整数＞((1〜8))《2》

レプリカRDエリアに対する更新処理をオリジナルRDエリアに反映する，pdorend反映プロセスのバックエンドサーバごとの多重度を指定します。

＜規則＞

pdorendコマンドを実行すると，次の計算式の数のpdorend反映プロセスが起動されます。

pdorend反映プロセス起動数＝M×S（単位：プロセス数）
 
M：-mオプションの指定値
S：-sオプションの指定値（-sオプションを省略した場合，オンライン再編成閉塞のRDエリアがあるすべてのバックエンドサーバ数）

なお，HiRDB全体で保証されるpdorend反映プロセス数は，あらかじめシステム定義のpd_max_reflect_process_countオペランドで指定しておく必要があります。

＜指定値の目安＞

指定値は次の計算式から求めてください。なお，ログ読み込みなどのボトルネックでの最大有効多重度は8程度を仮定します。

pdorend反映プロセスの多重度＝
MIN（8，↑（NLine×PLine/100）×Ntrn×（m＋n）/n×TSql↑）
 
NLine：SDS又はBESにあるRDエリアの更新での，1トランザクション当たりの平均更新行数
PLine：SDS又はBESにあるRDエリアの更新のうち，対象となるRDエリアの更新が占める割合（単位：％）
Ntrn：SDS又はBESにあるRDエリアの更新での，1秒当たりのトランザクション量（単位：件数）
m：表の再編成の実行時間（単位はnと同じにしてください）
n：追い付き反映処理時間（単位はmと同じにしてください）
TSql：対象となるRDエリアの1行当たりの平均SQL実行時間（単位：秒）

例えば，NLine=10，PLine=20，Ntrn=50，TSql=0.003，及び追い付き反映処理時間が表の再編成の実行時間の1/5程度の場合，pdorend反映プロセスの多重度は2となります。

なお，次の場合は，反映処理の間で処理の競合が発生するため，多重度は1にすることをお勧めします。

• 追い付き反映処理の対象表の，ngramインデクスを頻繁に更新する場合

• 追い付き反映処理の対象表の，UNIQUE指定のインデクスを頻繁に更新する場合

(f)　-z

障害発生時に，システムログ反映開始ポイントから再度追い付き反映処理を実行する場合に指定します。

-zオプションは，サーバで障害が発生したとき以外は指定しないでください。サーバでエラーが発生した後，再度pdorendコマンドを実行するときには指定しないでください。

＜適用基準＞

pdorendコマンド実行中に，オリジナルRDエリアがある正系ボリュームで障害が発生した場合，正系ボリュームを回復した後に，再度pdorbeginコマンドで設定したシステムログ反映開始ポイントから追い付き反映処理をするときに指定します。

(g)　-f 追い付き反映制御ファイル名　〜＜パス名＞((255文字以内))

追い付き反映処理の制御文を記述したファイル（追い付き反映制御ファイル）を，絶対パス名で指定します。-fオプションを省略した場合，追い付き反映制御ファイルに記述できる制御文の省略時仮定値が仮定されます。なお，追い付き反映制御ファイル中にコメントは記述できません。

追い付き反映制御ファイルに記述できる制御文を次に示します。

制御文	内容	指定できる個数
reflection	追い付き反映処理の動作内容を指定します。	1
report	追い付き反映処理の実行結果を出力するファイルを指定します。	1

reflection文とreport文は必ず両方とも指定してください。また，reflection文のsql_traceオペランドとreport文のsqltrc_dirオペランドは必ず両方とも指定してください。

reflection文

形式：

　reflection 〔sql_error=｛stop｜skip｝〕
 
　　　　　 〔mvcelmwarn=｛stop｜ignore｝〕
 
　　　　　 〔sql_trace=｛none｜err｜all｝〕

説明：

sql_error=｛stop｜skip｝

追い付き反映処理中にSQLエラーが発生した場合の動作を指定します。

stop：

SQLエラーが発生した場合，エラー終了します。このとき，処理はロールバックされ，前回のコミット時点の状態で終了します。

skip：

SQLエラーが発生した場合，特定のSQLエラー^※1は無視して追い付き反映処理を続行します。

skipを指定すると，更新可能なオンライン再編成後のオリジナルとレプリカのDBの整合性が保証できなくなります。このため，skipは，十分に運用を検討した上で指定してください。

スキップしたSQLの情報は，report文のskip_infoオペランドに指定したファイルに出力されます。このとき，スキップしたSQLを特定するため，スキップ情報中にマッピングキー^※2情報を出力します。SQLをスキップした後に同じ行に対してマッピングキー更新をすると，マッピングキー情報からはスキップした行が特定できなくなります。

注※1

無視する特定のSQLエラーを次に示します。

• キー重複エラー（SQLCODE=-803，SQLWARN6=空白）

• 対象行なしエラー（SQLCODE=100，SQLWARN6=空白）

• UPDATE文のADD句で追加した列の要素数が最大要素数を超えているエラー（SQLCODE=-806，SQLWARN6=空白）

注※2

レプリカRDエリアの更新行に対応するオリジナルRDエリアの反映対象行の特定には，表に定義されているユニークキー（CREATE UNIQUE INDEXで指定された列，CREATE TABLE PRIMARY KEYで指定された列，CREATE TABLE PRIMARY CLUSTER KEY，又はCREATE TABLE UNIQUE CLUSTER KEYで指定された列）のうち，その構成列すべてが非ナル値制約であるものを使用します。このキーをマッピングキーといいます。該当するユニークキーが複数ある場合は，クラスタキー，プライマリキー，インデクスIDの小さいインデクスの順番でどれか一つをマッピングキーとして使用します。

mvcelmwarn=｛stop｜ignore｝

追い付き反映処理中に，SET句又はDELETE句で繰返し列にない要素番号を指定したUPDATE文を実行した場合，警告エラーとなります。この警告エラーとなったときの動作内容を指定します。

stop：

追い付き反映処理をエラー終了します。このとき，処理はロールバックされ，前回のコミット時点の状態で終了します。

ignore：

繰返し列にない要素に対する更新を無視し，繰返し列にある要素及び列に対する更新だけをして，追い付き反映処理を続行します。

ignoreを指定すると，更新可能なオンライン再編成後のオリジナルとレプリカのDBの整合性が保証できなくなります。このため，ignoreは，十分に運用を検討した上で指定してください。

更新が無視されたSQLの情報は，report文のskip_infoオペランドに指定したファイルに出力されます。このとき，更新の一部が無視されたSQLを特定するため，スキップ情報出力ファイル中にマッピングキー情報を出力します。該当するSQLを実行した後に，同じ行に対してマッピングキー更新をすると，マッピングキー情報から該当する行が特定できなくなります。

sql_trace=｛none｜err｜all｝

追い付き反映処理中にマスタのDBに対して発行したSQLのトレース情報を出力するかどうかを指定します。

none：

追い付き反映処理中にマスタのDBに対して発行したSQLのトレース情報を出力しません。

err：

追い付き反映処理中にマスタのDBに対して発行したSQLがエラーの場合，SQLのトレース情報及びスキップ情報をファイルに出力します。

all：

追い付き反映処理中にマスタのDBに対して発行したSQLのトレース情報及びスキップ情報をファイルに出力します。allを指定した場合，実行したSQLの終了状態（正常終了又は異常終了）に関係なく出力します。

＜規則＞

1. このオペランドを指定する場合，report文のsqltrc_dirオペランドの指定は必須です。

report文

形式：

　report 〔skip_info=スキップ情報出力ファイル名〕
 
　　　　〔sqltrc_dir=SQLトレース情報ファイル出力ディレクトリ名
　　　　　　　　　　，SQLトレース情報ファイルサイズ〕

説明：

skip_info=スキップ情報出力ファイル名　〜＜パス名＞((235文字以内))

reflection文にsql_error=skip，又はmvcelmwarn=ignoreを指定した場合，スキップしたSQL，又は繰返し列にない要素の更新を無視したSQLの情報を出力するファイルを，絶対パス名で指定します。なお，実際に作成されるファイル名は，"指定したファイル名_サーバ名_プロセスID"^※となります。

注※

サーバ名：最大8文字で，スキップ対象のSQLエラーが発生したサーバ名

プロセスID：最大10文字で，スキップ対象のSQLエラーが発生したプロセスID

＜規則＞

1. スキップ情報出力ファイルを出力するディレクトリは，すべてのサーバマシンで同じにしておく必要があります。出力するディレクトリがない場合は，制御文エラーとなります。

2. このオペランドを省略した場合，次の名称でファイルが作成されます。

   skip_infoオペランドの指定	システム定義のpd_tmp_directoryオペランドの指定
   	あり	なし
   		環境変数TMPDIR※の指定
   		あり	なし
   あり	skip_infoオペランドに指定したディレクトリ/指定したファイル名_サーバ名_プロセスID
   なし	pd_tmp_directoryに指定したディレクトリ/pdskipsql_サーバ名_プロセスID	TMPDIRに指定したディレクトリ/pdskipsql_サーバ名_プロセスID	/tmp/pdskipsql_サーバ名_プロセスID

   注※　init（OSのプロセス）から起動されたプロセスサーバプロセス（pdprcd）に設定される環境変数

3. 指定したスキップ情報出力ファイルがない場合は，スキップ情報出力ファイルを作成した後，スキップ情報を出力します。指定したスキップ情報出力ファイルがある場合は，そのファイルにスキップ情報を追加出力します。

4. スキップ情報出力中にエラーが発生した場合，処理を中断して，ロールバックした後エラー終了します。

スキップ情報出力ファイルの見積もり式：

スキップ情報出力ファイルの見積もり式を次に示します（単位：バイト）。

n
Σ( 270 ＋ (563 × (A ＋ B)) ＋ C )
1

n：スキップしたSQL数

見積もり式で使用する変数について説明します。

変数	説明
A	更新後マッピングキー構成列数です。 SQL種別が，INSERT又はUPDATEのときだけ加算してください。加算する内容は，pdorbeginコマンドに-eオプションを指定（更新された列だけを反映）するかどうかによって異なります。 pdorbeginコマンドに-eオプションを指定しない場合 マッピングキー構成列数を加算 pdorbeginコマンドに-eオプションを指定する場合 更新したマッピングキー列数を加算
B	更新前マッピングキー構成列数です。SQL種別が，UPDATE又はDELETEのときだけ加算してください。
C	mvcelmwarnオプションにignoreを指定し，かつ，繰返し列が存在するときだけ加算してください。 m 50 ＋ ( Σ(51 ＋ ↑(D ÷ 9)↑ × 81)) 1 m：1SQL文での繰り返し列数
D	更新要素数です。SQL種別によって，次のとおり加算してください。 UPDATE SET（要素指定）：更新対象の要素数 UPDATE ADD：1 UPDATE DELETE：削除対象の要素数

スキップ情報出力ファイルの出力PDATE DELETE：削除対象の情報：

スキップ情報出力ファイルに出力される情報を次に示します。

YYYY/MM/DD HH:MM:SS  SVR(サーバ名) PID(プロセスID) [1]
**** SKIP SQL INFORMATION **** [2]
  TABLE NAME : "認可識別子"."表識別子" [3]
  SQL KIND : SQL種別 [4]
  SQLCODE : SQLコード [5]
  SQLWARN : 警告情報 [6]
  **** AFTER KEY INFORMATION **** [7]
    COLUMN NAME : "列名" [8]
      DATA LENGTH : 実データ長 [9]
      DATA : データ値 [10]
  **** BEFORE KEY INFORMATION **** [11]
    COLUMN NAME : "列名" [12]
      DATA LENGTH : 実データ長 [13]
      DATA : データ値 [14]
  **** UPDATE MULTI-VALUE COLUMN INFORMATION **** [15]
    COLUMN NAME : "列名" [16]
      UPDATE ELEMENT NO : 要素番号[,要素番号]... [17]

［説明］

スキップしたSQL数分，1〜14が出力されます。

SQL種別がINSERT，及びUPDATEの場合，7〜10が出力されます。また，マッピングキー列数分，8〜10が出力されます。

SQL種別がUPDATE，及びDELETEの場合，11〜14が出力されます。また，マッピングキー列数分，12〜14が出力されます。

mvcelmwarnオプションにignoreを指定し，かつSQL種別がUPDATE SET（要素指定），UPDATE ADD，又はUPDATE DELETEの場合，15〜17が出力されます。また，更新対象の繰返し列数分，16及び17が出力されます。

1. SQLエラー発生の日時，サーバ名，及びプロセスIDです。

2. スキップ情報のヘッダ

3. 認可識別子，及び表識別子

4. スキップしたSQL種別

   INSERT：挿入

   UPDATE SET，UPDATE ADD，及びUPDATE DELETE：更新

   DELETE：削除

5. スキップしたSQLのSQLCODE

6. 警告情報

   発生した警告情報が出力されます。警告情報が複数ある場合は，各項目の間に空白が入ります。警告情報がない場合は，「SQLWARN:」だけ出力されます。

7. 更新後のキー情報のヘッダ

8. 列名

9. 実データ長（10進数）

10. データの内容（ダンプ形式（16進数＋文字列表示））^※１

11. 更新前のキー情報のヘッダ

12. 列名

13. 実データ長（10進数）

14. データの内容（ダンプ形式（16進数＋文字列表示））^※１

15. 繰返し列の更新情報のヘッダ

16. 繰返し列の列名

17. 更新対象の要素番号

    SQL種別が次のどれかの場合，更新対象の要素番号が出力されます。

    UPDATE SET（要素指定）：更新対象の要素番号^※２

    UPDATE ADD：追加する要素の先頭の要素番号^※３

    UPDATE DELETE：削除対象の要素番号^※２

    更新対象の要素が複数ある場合，コンマで区切られます。要素番号が10個以上ある場合は，9個の要素ごとに改行されます。

    注※1

    該当する列に文字集合が定義されている場合，定義された文字コードで出力されます。

    注※2

    *指定のSQLを実行した場合は，実際に更新した要素番号が出力されます。

    注※3

    *指定のSQLを実行した場合は，更新対象の要素番号に*が出力されます。

sqltrc_dir=SQLトレース情報ファイル出力ディレクトリ名，SQLトレース情報ファイルサイズ

reflection文のsql_traceオペランドにerr，又はallを指定して出力するSQLトレース情報の出力ディレクトリ，及びSQLトレース情報ファイルサイズを指定します。

SQLトレース情報ファイル出力ディレクトリ名　〜＜パス名＞((223文字以内))

SQLトレース情報を出力するディレクトリ名を絶対パス名で指定します。ここで指定したディレクトリに，次の二つのファイルを作成します。

• pdorsqltrc1_サーバ名称_プロセスID

• pdorsqltrc2_サーバ名称_プロセスID

  サーバ名称（最大8文字）：SQLトレース情報の出力元の追い付き反映対象サーバ名

  プロセスID（最大10文字）：SQLトレース情報の出力元の追い付き反映SQL実行プロセスのプロセスID

＜規則＞

1. このオペランドを指定する場合，reflection文のsql_traceオペランドの指定は必須です。

2. pdorendを実行する前に，追い付き反映対象サーバが存在するすべてのサーバマシンで，このオペランドに指定したディレクトリを作成しておく必要があります。ディレクトリが作成されていない場合，pdorendはエラーになります。

3. SQLトレース情報ファイルの初回作成時に，作成対象ファイルと同名のファイルが存在した場合，そのファイルを上書きします。必要に応じて，別ディレクトリ又は別ファイル名にコピーしておく必要があります。

4. SQLトレース情報を出力するファイルのスワップが発生した場合，切り替え先のファイルは上書きされるため，必要に応じて，切り替わる前に別ディレクトリ又は別ファイル名にコピーしておく必要があります。なお，ファイルのスワップが発生すると，syslogfile及びメッセージログファイルにKFPT01020-Iメッセージが出力されます。

5. SQLトレース情報ファイルのアクセス処理でエラーが発生した場合，pdorendは処理を中断し，ロールバックしてからエラー終了します。

6. 更新情報のダンプ出力時は1行出力するたびに入出力が発生します。更新情報の出力数は，SQLトレース情報ファイルサイズの＜指定値の目安＞の変数D（更新データ長）の説明を参照してください。

SQLトレース情報ファイルサイズ　〜((0，4096〜2144337920))

SQLトレース情報ファイルのサイズをバイト単位で指定します。sqltrc_dirオペランドを指定する場合，SQLトレース情報ファイルサイズは必ず指定してください。

0を指定すると，HiRDBファイルシステムの最大サイズが仮定されます。この場合，出力するSQLトレース情報サイズがHiRDBファイルシステムの最大サイズを超えるとpdorendはエラーになります。

4,096〜2,144,337,920を指定した場合，SQLトレース情報ファイルが指定したファイルサイズを超えると，もう一つのファイルにスワップしてSQLトレース情報の出力を切り替えます。出力先を切り替えた時点で，切り替え元のファイルサイズは，ここで指定したファイルサイズよりも最大で3メガバイト程度大きくなる可能性があります。

＜指定値の目安＞

SQLトレース情報の出力量に対して過小なサイズを指定すると，SQLトレース情報ファイルのスワップが多発して性能が劣化します。次の見積もり式で求めた値を目安としてください。なお，予備列がある表の場合，見積もり式で求めた値は，予備列の情報を含めた値です。

 n
 Σ表単位のSQLトレースサイズ
 i=1

n：更新可能なオンライン再編成中にレプリカのデータベースに対して更新した表の数

表単位のSQLトレースサイズ（単位：バイト）：

（E＋A）×B＋200×B÷100

見積もり式で使用する変数について説明します。

変数	説明
A	SQLトレース情報サイズです。 行更新※4の場合 400＋100×（1＋マッピングキー列数）＋C＋D 列更新の場合 400＋100×（更新表の構成列数※１＋マッピングキー列数）＋C＋D
B	更新SQL数です。 更新SQL数は，reflection文の指定内容によって，次の値になります。 sql_trace=errの場合 sql_error=stop又はsql_errorオペランド省略，mvcelmwarn=stop又はmvcelmwarnオペランド省略のとき 1 sql_error及びmvcelmwarnの指定が上記以外※２のとき 更新可能なオンライン再編成中にレプリカのデータベースの該当表の更新SQLのうち，SQLエラーになると思われる更新SQL数 sql_trace=allの場合 sql_error=stop又はsql_errorオペランド省略，mvcelmwarn=stop又はmvcelmwarnオペランド省略のとき 更新可能なオンライン再編成中にレプリカのデータベースの該当表の更新SQL数＋100 sql_error及びmvcelmwarnの指定が上記以外※２のとき 更新可能なオンライン再編成中にレプリカのデータベースの該当表の更新SQL数×（更新SQLのうち，SQLエラーになると思われる割合÷100＋1）+100
C	更新データ長です。 行更新※4の場合 （表の行長÷16）×100 列更新の場合 更新列だけ反映する ｛（更新列の固定長データ型の列定義長の合計※１＋更新列の可変長データ型の列定義長の合計※１＋更新列の圧縮列の定義長の合計※5）÷16｝×100 更新列以外の列も反映する ｛（更新表の構成列中で固定長データ型の列定義長の合計※１＋更新表の構成列で可変長データ型の列定義長の合計※１，※３＋更新列の圧縮列の定義長の合計※5）÷16｝×100
D	SQLCSNA情報サイズです。SQLCSNA情報サイズは文字集合が定義された表の場合だけ加算してください。 4400＋（↑（更新表の構成列数※１＋マッピングキー列数）÷ 8↑×100）
E	スキップ情報出力ファイルサイズです。 skip_infoオペランドの説明を参照してください。

注※1

繰返し列の場合，定義長×更新する要素数を加算してください。

注※2

次に示す組み合わせのときです。

・sql_error=skip，mvcelmwarn=ignore

・sql_error=skip，mvcelmwarn=stop又はmvcelmwarnオペランド省略

・sql_error=stop又はsql_errorオペランド省略，mvcelmwarn=ignore

注※3

BLOB又はBINARY型の場合，更新するときだけ更新データ長を加算してください。

注※4

既定義型以外の文字集合の列がないFIX表で，次のSQLを実行した場合，行更新をします。

・INSERT文

・UPDATE文（更新列以外の列も反映するとき）

注※5

次の条件をすべて満たす場合に加算されます。

・圧縮列のデータ型がBINARY型である。

・BINARY型の圧縮列がある表を追い付き反映処理する場合に，データが伸張される圧縮列がある。

追い付き反映処理時に伸張される圧縮列については，マニュアル「HiRDB Staticizer Option Version 9」の「圧縮表の追い付き反映処理をする場合」を参照してください。

SQLトレース情報ファイルの出力情報：

SQLトレース情報ファイルに出力される情報を次に示します。

YYYY/MM/DD HH:MM:SS  SVR(サーバ名) PID(プロセスID) [1]
**** SQL TRACE INFORMATION **** [2]
  ** EXECUTION SQL ** [3]
    UPDATE "repjobp"."ANA_0001" SET "C01"=?,"C02"=? WHERE "C01"=? [4]
  ** SQL EXECUTION RESULT ** [5]
    SQLCODE : SQLコード [6]
    SQLWARN : 警告情報 [7]
  ** SQLDA ** [8]
    Address  Loc      +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f 0123456789abcdef [9]
    400b3010 00000000 53514c44 41202020 00000000 00030003 SQLDA   ........
  ** SQLVAR ** [10]
    Address  Loc      +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f 0123456789abcdef
    400b3020 00000000 00f40001 00020000 400c07b8 400c07b0 ........@...@...
    400b3030 00000010 00f40001 00020000 400c07c8 400c07c0 ........@...@...
    400b3040 00000020 00f40001 00020000 400c07a8 400c07a0 ........@...@...
                                    :
  ** SQLCSNA ** [11]
    Address  Loc      +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f 0123456789abcdef
    400b4040 00000000 53514c43 534e4120 00000000 00000000 SQLCSNA ........
    400b4050 00000010 00050005 000a0001 00000000 00000000 ................
                                    :
  ** UPDATE INFORMATION **
    Address  Loc      +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f 0123456789abcdef [12]
    400c0700 00000000 2a2a5442 4c552a2a 0002007a 03000000 **TBLU**...z....
    400c0710 00000010 00000000 00000000 00000001 00000044 ...............D
    400c0720 00000020 00000002 00000058 4540236c 45402383 .......XE@#lE@#.
    400c0730 00000030 00000001 0000013f 00000000 0000026e .......?.......n
    400c0740 00000040 00000000 4d430001 00000000 000000a0 ....MC..........
    400c0750 00000050 000000a8 00000002 55430001 00000100 ........UC......
    400c0760 00000060 00000000 00000000 00000000 00000000 ................
    400c0770 00000070 000000b0 000000b8 00000002 55430002 ............UC..
    400c0780 00000080 00000000 00000000 00000000 00000000 ................
    400c0790 00000090 00000000 000000c0 000000c8 00000002 ................
    400c07a0 000000a0 00000000 00000000 00010000 00000000 ................
    400c07b0 000000b0 00000000 00000000 00030000 00000000 ................
    400c07c0 000000c0 00000000 00000000 0001              ..........
YYYY/MM/DD HH:MM:SS  SVR(サーバ名) PID(プロセスID) [13]
**** SKIP SQL INFORMATION ****
  TABLE NAME : "認可識別子"."表識別子"
             ：
             ：
YYYY/MM/DD HH:MM:SS  SVR(サーバ名) PID(プロセスID) [4]
**** SQL TRACE INFORMATION ****
  ** EXECUTION SQL **
    COMMIT     

［説明］

1. SQLを実行した日時，サーバ名，及びプロセスIDです。

2. SQLトレース情報のヘッダ

3. 実行したSQLの情報を示すヘッダ

4. SQL文

   実行したSQL文及びCOMMIT文です。

   SQL文の場合は[1]〜[12]の情報を出力します。COMMIT文の場合は[1]〜[4]の情報を出力します。

   ただし，レプリカのデータベースを更新したSQLとは異なるSQL文が出力される場合があります。例を示します。

   ・追い付き反映時，更新列だけ反映する指定をしなかった場合

   ・更新列数＋マッピングキー列数が30000（？パラメタの最大数）を超える場合

   ・ロールバックのSQLの場合

   ・行更新の場合（行更新については，SQLトレース情報ファイルサイズの＜指定値の目安＞の注を参照してください）

5. 実行したSQLの結果を示すヘッダ

6. 実行したSQLのSQLCODE

7. 実行したSQLの警告情報（SQLWARNn　n：0〜F）

   発生した警告情報が出力されます。警告情報が複数ある場合は，各項目の間に空白が入ります。警告情報がない場合は，「SQLWARN:」だけ出力されます。

8. SQL記述領域情報（SQLDA）

   SQL記述領域については，マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。

9. ダンプ出力ヘッダ

   ヘッダと出力される内容を次に示します。

   ヘッダ	出力内容
   Address	アドレス（16進数）※１
   Loc	先頭からのオフセット（16進数）※１
   +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f	メモリの内容（16進表示）※２
   0123456789abcdef	メモリの内容（キャラクタ表示）※２

   注※1

   32ビットモードのHiRDBの場合は4バイト（8けた），64ビットモードのHiRDBの場合は8バイト（16けた）で出力されます。

   注※2

   該当する列に文字集合が定義されている場合，定義された文字コードで出力されます。

10. SQL記述領域情報（SQLVAR）

    SQL記述領域については，マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。

11. 文字集合名記述領域（SQLCSNA）

    表に文字集合が定義されている列が存在する場合だけ出力されます。

    文字集合名記述領域については，マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。

12. 更新情報

    SQL実行時の更新情報。データ型ごとの更新データのフォーマットについては，マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。

    ただし，次のデータ型の列に圧縮指定（COMPRESSED）がある場合，更新情報には圧縮されたデータ又は伸張されたデータが出力されます。圧縮後のデータ長が定義長よりも大きい列があるかどうかで出力されるデータが異なります。

    圧縮指定があるデータ型	圧縮後のデータ長が定義長よりも大きい列
    	ない	ある
    BINARY型	圧縮データ	伸張データ
    XML型	圧縮データ	圧縮データ

13. スキップ情報

    SQLトレース情報とともに出力されます。出力される情報については，「スキップ情報出力ファイルの出力情報」を参照してください。

(h)　-p

追い付き反映処理終了後に，オンライン再編成対象のRDエリアにある被参照表に対して制約定義をしている参照表，オンライン再編成対象のRDエリアにある参照表，及びオンライン再編成対象のRDエリアにある検査制約表を検査保留状態にしない場合に指定します。このオプションは，システム定義のpd_check_pendingオペランドの値がUSEの場合にだけ有効です。

＜規則＞

1. このオプションは，オンライン再編成後にデータ不整合が発生しない場合に指定してください。参照制約及び検査制約で不整合が発生する条件については，マニュアル「HiRDB Version 9 システム導入・設計ガイド」を参照してください。

2. このオプションを指定しない場合，次に示す表のオリジナルRDエリアの世代を検査保留状態にします。

   • オンライン再編成の対象RDエリアにある被参照表に対して，制約定義をしている参照表

   • オンライン再編成の対象RDエリアにある参照表

   • オンライン再編成の対象RDエリアにある検査制約表

3. 表を検査保留状態にした後，pdorendコマンドがエラーとなった場合，検査保留状態のまま処理を終了します。

4. 検査保留状態の設定ができなかった場合は，KFPT01018-Wメッセージを出力し，該当する表の検査保留状態の設定処理を無視して処理を続行します。KFPT01018メッセージが出力された場合は，該当メッセージの管理者の処置に従って，該当する表の整合性をチェックしてください。

5. 追い付き反映処理が終了した後に検査保留状態の表がある場合，pdconstckで整合性を確認してください。検査保留状態が解除されるまで，該当表に対してはアクセスできません。整合性の確認手順については，マニュアル「HiRDB Version 9 システム導入・設計ガイド」を参照してください。

6. システム定義のpd_check_pendingオペランドの値がNOUSEの場合は，このオプションの指定に関係なく，表の検査保留状態を変更しません。また，pd_check_pendingオペランドの値がNOUSEの場合，pdorendコマンドの実行でデータ不整合が発生することがあります。

＜検査保留状態の遷移＞

検査保留状態の遷移について次に説明します。

被参照表の場合

被参照表がオンライン再編成の対象RDエリアにある場合の，被参照表に関連のある参照表の検査保留状態の遷移を次の表に示します。なお，被参照表に対して，複数の関連のある参照表がある場合でも，参照表の検査保留状態は次の表に従って遷移します。

表2‒17　被参照表がある場合の検査保留状態の遷移

pd_check_pendingオペランドの指定値	-pオプションの指定	参照表の種別	被参照表に関連のある参照表の表格納RDエリアの状態	参照表の検査保留状態
USE	なし	非分割表	オンライン再編成の対象になっている。	○
			オンライン再編成の対象になっていない。	○
		分割表	すべての表格納用RDエリアがオンライン再編成の対象になっている。	○
			一部の表格納用RDエリアがオンライン再編成の対象になっている。	○
			すべての表格納用RDエリアがオンライン再編成の対象になっていない。	○
	あり	該当しない	該当しない。	−
NOUSE	該当しない	該当しない	該当しない。	−

(凡例)

○：参照表を構成するすべてのRDエリアの表情報を検査保留状態にします。

−：状態を変更しません。

＜例＞

pd_check_pendingオペランドにUSEを指定し，pdorendコマンドに-pオプションを指定しないで，かつ被参照表T0と参照表T1〜T5が次の図で示す構成で1対1の参照関係にある場合，オンライン再編成の対象RDエリアがRD1及びRD2のとき，検査保留状態にする対象を表「被参照表の検査保留状態の遷移例（被参照表と参照表が1対1の場合）」に示します。

図2‒9　被参照表と参照表の構成例

表2‒18　被参照表の検査保留状態の遷移例（被参照表と参照表が1対1の場合）

参照表の表名	RDエリア名	検査保留状態の設定
T1	RD1	○
T2	RD1	○
	RD2	○
T3	RD1	○
	RD2	○
	RD3	○
T4	RD3	○
T5	RD3	○
	RD4	○

(凡例)

○：検査保留状態にします。

参照表の場合

参照表がオンライン再編成の対象RDエリアにある場合の検査保留状態の遷移を次の表に示します。なお，参照表と関連のある被参照表が，オンライン再編成対象のRDエリアにない場合でも，参照表の検査保留状態は次の表に従って遷移します。

表2‒19　参照表の検査保留状態の遷移

pd_check_pendingオペランドの指定値	-pオプションの指定	参照表の種別	参照表の表格納用RDエリアの状態	参照表の検査保留状態
USE	なし	非分割表	オンライン再編成の対象になっている。	○
			オンライン再編成の対象になっていない。	−
		分割表	すべての表格納用RDエリアがオンライン再編成の対象になっている。	○
			一部の表格納用RDエリアがオンライン再編成の対象になっている。	△
			すべての表格納用RDエリアがオンライン再編成の対象になっていない。	−
	あり	該当しない	該当しない。	−
NOUSE	該当しない	該当しない	該当しない。	−

(凡例)

○：参照表を構成するすべてのRDエリアの表情報を検査保留状態にします。

△：オンライン再編成対象のRDエリアにある，参照表を構成するRDエリアの表情報だけを検査保留状態にします。

−：状態を変更しません。

＜例＞

pd_check_pendingオペランドにUSEを指定し，pdorendコマンドに-pオプションを指定しないで，かつ参照表T1〜T5が次の図に示す構成の場合，オンライン再編成の対象となるRDエリアがRD1及びRD2のとき，検査保留状態にする対象を表「参照表の検査保留状態の遷移例」に示します。

図2‒10　参照表の構成例

表2‒20　参照表の検査保留状態の遷移例

参照表の表名	RDエリア名	検査保留状態の設定
T1	RD1	○
T2	RD1	○
	RD2	○
T3	RD1	○
	RD2	○
	RD3	−
T4	RD3	−
T5	RD3	−
	RD4	−

(凡例)

○：検査保留状態にします。

−：検査保留状態にしません。

検査制約表の場合

検査制約表がオンライン再編成の対象RDエリアにある場合の検査保留状態の遷移を次の表に示します。

表2‒21　検査制約表の検査保留状態の遷移

pd_check_pendingオペランドの指定値	-pオプションの指定	検査制約表の種別	検査制約表の表格納用RDエリアの状態	参照表の検査保留状態
USE	なし	非分割表	オンライン再編成の対象になっている。	○
			オンライン再編成の対象になっていない。	−
		分割表	すべての表格納用RDエリアがオンライン再編成の対象になっている。	○
			一部の表格納用RDエリアがオンライン再編成の対象になっている。	△
			すべての表格納用RDエリアがオンライン再編成の対象になっていない。	−
	あり	該当しない	該当しない。	−
NOUSE	該当しない	該当しない	該当しない。	−

(凡例)

○：検査制約表を構成するすべてのRDエリアの表情報を検査保留状態にします。

△：オンライン再編成の対象RDエリアにある，検査制約表を構成するRDエリアの表情報だけを検査保留状態にします。

−：状態を変更しません。

＜例＞

pd_check_pendingオペランドにUSEを指定し，pdorendコマンドに-pオプションを指定しないで，かつ検査制約表T1〜T5が次の図で示す構成の場合，オンライン再編成の対象RDエリアがRD1及びRD2のとき，検査保留状態にする対象を表「検査制約表の検査保留状態の遷移例」に示します。

図2‒11　検査制約表の構成例

表2‒22　検査制約表の検査保留状態の遷移例

参照表の表名	RDエリア名	検査保留状態の設定
T1	RD1	○
T2	RD1	○
	RD2	○
T3	RD1	○
	RD2	○
	RD3	−
T4	RD3	−
T5	RD3	−
	RD4	−

(凡例)

○：検査保留状態にします。

−：検査保留状態にしません。

(i)　-u

オンライン再編成の追い付き反映処理を中止する場合に指定します。

＜規則＞

1. -uオプションを指定すると，障害時の運用となるため，注意が必要です。

2. pdorend実行時の排他が掛けられない場合，システム定義のpd_lck_wait_timeoutオペランドの指定値まで待ちます。

3. 処理対象RDエリアに共用RDエリアがある場合，全バックエンドサーバで一括して処理をします。そのため，処理対象のすべてのRDエリアのオンライン再編成閉塞を解除できない場合はエラーとなります。なお，特定のバックエンドサーバが停止中などの理由で，サーバ単位にオンライン再編成閉塞を解除する場合は，-sオプション指定でオンライン再編成閉塞を解除できます。

＜適用基準＞

-uオプションは，該当するサーバに障害が発生した場合に指定してください。それ以外の場合に指定すると，追い付き反映処理ができなくなり，オリジナルRDエリアにトランザクションのアクセスを切り替えられなくなります。この場合，副系ボリュームのレプリカRDエリアでオンライン業務を続行します。オンライン業務をオリジナルRDエリアにアクセスさせたい場合は，HiRDBをいったん終了する必要があります。

(j)　-I｛put｜noput｝

排他待ちによってタイムアウトした際に，タイムアウト情報を出力するかどうかを指定します。タイムアウト情報はタイムアウト要因の特定に使用できます。タイムアウト情報については，マニュアル「HiRDB Version 9 システム運用ガイド」を参照してください。

タイムアウト情報を出力する指定（-I put）は，このコマンドと同時間帯に動いている処理（UAP・コマンドなど）を把握していない場合に使用してください。

put：

$PDDIR/spool/pdlckinfにタイムアウト情報が出力されます。

タイムアウト情報を出力する場合は，ディスク容量の確保が必要です。タイムアウト情報を含む単調増加ファイルのファイルサイズについては，マニュアル「HiRDB Version 9 システム導入・設計ガイド」を参照してください。

noput：

タイムアウト情報は出力されません。

タイムアウト情報を出力する指定（-Iput）時に，タイムアウトによってリトライが発生した場合は，タイムアウトが発生した回数分のタイムアウト情報が出力されます。リトライの詳細については，pdorendコマンドの-nオプションを参照してください。