2.106.1 pdrelsの形式と規則
(1) 機能
指定したRDエリアの閉塞状態を解除します。
(2) 実行者
HiRDB管理者が実行できます。
(3) 形式
pdrels -r {RDエリア名〔,RDエリア名〕…|ALL} 〔-q 世代番号〕 〔-o〕〔-W 実行監視時間〕
(4) オプション
(a) -r {RDエリア名〔,RDエリア名〕…|ALL}
- RDエリア名 〜<識別子>((1〜30))
-
閉塞状態を解除するRDエリア名を指定します。
- ALL
-
マスタディレクトリ用RDエリアを除くすべてのRDエリアの閉塞解除をします。ただし,-qオプション指定時は,同じ世代のRDエリアを対象とします。
<規則>
-
バックアップ閉塞中でないマスタディレクトリ用RDエリアは指定できません。
-
ユーザ用RDエリア又はユーザLOB用RDエリアを指定する場合は,データディクショナリ用RDエリアが次のどちらかの状態でなければなりません。
-
オープン状態,かつ閉塞解除状態
-
オープン状態,かつpdholdコマンドによる閉塞状態
-
-
インナレプリカ機能を使用している場合,オリジナルRDエリア名及びレプリカRDエリア名も指定できます。ただし,この場合,指定できるのはユーザ用RDエリア及びユーザLOB用RDエリアだけです。
(b) -q 世代番号 〜<符号なし整数>((0〜10))
レプリカRDエリアの世代番号を指定します。
このオプションを指定した場合,-rオプションにはオリジナルRDエリア名を指定してください。この場合,レプリカがすべて削除されたオリジナルRDエリア,又は通常のRDエリア(レプリカRDエリアがないRDエリア)を指定したときはエラーとなります。
(c) -o
閉塞状態を解除した後,RDエリアをオープンします。省略した場合,RDエリアの閉塞解除だけをします。
(d) -W実行監視時間 〜<符号なし整数>((0〜3600))
pdrelsコマンドの実行時間を監視する場合に,その監視時間を分単位で指定します。このオプションに指定する値の目安や動作については,マニュアル「HiRDB システム定義」のシステム共通定義pd_cmd_exec_timeオペランドの説明を参照してください。
なお,このオプションに0を指定した場合は,監視を行いません。
また,このオプションを省略した場合は,システム共通定義のpd_cmd_exec_timeオペランドの指定値に従います。
(5) 規則
-
pdrelsコマンドは,HiRDBが稼働中のときだけ実行できます。
-
pdrelsコマンドは,シングルサーバ又はシステムマネジャがあるサーバマシンで実行してください。
-
pdrelsコマンドは,RDエリアに対してモードPRで排他制御をします(更新可能バックアップ閉塞の解除時を除く)。そのため,指定したRDエリアにほかの更新系トランザクションがアクセスしている場合は,そのトランザクションの終了までpdrelsコマンドは待ち状態となります。
-
同期化閉塞したRDエリアのデータは,更新バッファが破棄されるため,RDエリアの内容は不整合となり,RDエリアには不整合情報が書き込まれます。同期化閉塞後は,整合性のあるほかのレプリカRDエリアのデータを,同期化閉塞したRDエリアへ複写する必要があります。不整合情報が書き込まれているRDエリアは,閉塞解除できません。
-
共用RDエリアに対してpdrelsコマンドを実行した場合,全バックエンドサーバに排他を掛けます。このため,該当するRDエリアへのアクセスを複数同時に実行している場合,グローバルデッドロックが発生し,タイムアウトする可能性があります。グローバルデッドロックが発生した場合,再度pdrelsコマンドを実行してください。
(6) 注意事項
-
pdrelsコマンドの結果は,pddblsコマンドで確認できます。
-
更新可能バックアップ閉塞(WAITモード)中に,更新バッファの内容がRDエリアに反映された場合,閉塞解除するときに警告メッセージ(KFPH00157-W)が出力されます。
-
pdrelsコマンドのリターンコードと基本的な対処方法を次に示します。
0,1以外の場合,一部のRDエリアが閉塞解除していないことがあります。その状態では業務を継続できないおそれがあるため,再度pdrelsコマンドで閉塞解除してください。
0:正常終了
- 1:警告終了
-
更新可能バックアップ閉塞(WAITモード)時に,更新バッファの内容がRDエリアに反映されました。閉塞解除処理は正常終了しています。
- 4:警告終了
-
一部のRDエリアの処理がエラー終了しました。
- 8:異常終了
-
一部のRDエリアの処理がエラー終了していることがあります。
- 12:異常終了
-
エラーメッセージを表示できない事象が発生しました。
一部のRDエリアの処理がエラー終了していることがあります。シングルサーバ又はディクショナリサーバがあるホストのsyslogfile中のエラーメッセージを参照して,エラーの要因を取り除いた後,再度コマンドを実行してください。syslogfile中にエラーメッセージが出力されていない場合は保守員に連絡してください。
-
障害閉塞したRDエリアを回復していない場合,又は同期化閉塞したRDエリアのデータが置き換えられていない場合,閉塞解除はできません。ただし,書き込み時の入出力エラー,ログレスモードのUAP,及びログレスモードのユティリティによる障害閉塞は解除できます。
-
データ未完状態の改竄防止表が格納されているRDエリアがコマンド閉塞している場合,そのRDエリアの閉塞解除はできません。この場合,データ未完状態の改竄防止表に対してpdrorgの表へのリロードを実行すると,データ未完状態は解除されます。解除された後に,閉塞解除をしてください。
-
pdrelsコマンドでは,RDエリアのオンライン再編成閉塞の解除はできません。
-
リアルタイムSANレプリケーションの処理方式にハイブリッドを選択している場合,pdrelsコマンドを実行して障害閉塞しているRDエリアの閉塞解除を行うと,リモートサイトへのデータベース同期待ち合わせをします。このため,-rオプションで指定したRDエリア一つにつき,2秒以上のオーバヘッドが掛かることがあります。リモートサイトへのデータベース同期待ち合わせに失敗した場合,リモートサイトのデータベースを回復する必要があります。リアルタイムSANレプリケーションを使用した場合の障害発生時の運用については,マニュアル「HiRDB ディザスタリカバリシステム 構築・運用ガイド」を参照してください。