スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス(UNIX(R)用)

[目次][索引][前へ][次へ]

15.2.2 オプション

<この項の構成>
(1) -r {RDエリア名〔,RDエリア名〕…|ALL}
(2) -k {logi|phys|clus|pred}
(3) -d
(4) -z
(5) -f
(6) -a
(7) -h
(8) -u 認可識別子
(9) -p パスワード
(10) -t 〔認可識別子.〕表識別子
(11) -s
(12) -i 〔認可識別子.〕インデクス識別子
(13) -q 世代番号
(14) -b
(15) -e 予測レベル
(16) -w 休止時間,セグメント数
(17) -n 解析分割数
(18) -I
(19) -m
(20) -R 監視期間〔,メンテナンス延長期間〕
(21) -c 基準値定義ファイル名
(22) -X サーバ間通信の応答監視時間
(23) -v 制御文ファイル名

(1) -r {RDエリア名〔,RDエリア名〕…|ALL}

   〜<識別子>((1〜30))

解析するRDエリアの名称を指定します。

指定できるRDエリアを次に示します。

RDエリアの指定方法については,「1.5.2 運用コマンド,ユティリティでのRDエリアの指定」を参照してください。

<規則>
  1. -qオプションと同時に指定する場合は,オリジナルRDエリア名を指定してください。
  2. 状態解析結果蓄積機能,及び再編成時期予測機能では,1RDエリアに格納されているすべての表を,1回のトランザクションで解析します。そのため,システム定義のpd_max_access_tablesオペランドの指定値は,解析対象RDエリア内で最も表を多く格納しているRDエリアの,表数以上必要となります。

(2) -k {logi|phys|clus|pred}

DB状態解析機能,状態解析結果蓄積機能,又は再編成時期予測機能のどれを実行するのかを指定します。

logi
RDエリアの状態解析(論理的解析),又は状態解析結果蓄積機能を実行する場合に指定します。

phys
RDエリアの状態解析(物理的解析)を実行する場合に指定します。

clus:
クラスタキー及びクラスタリングデータページの格納状態解析を実行する場合に指定します。

pred:
再編成時期予測機能を実行する場合に指定します。

<-kオプションとほかのオプションとの組み合わせ>
-kオプションの指定値よって,-r,-t,及び-iオプションの指定可否が変わります。
-kオプションの指定 オプションの指定可否 備考
-r -t -i
logi × × RDエリア単位の状態解析(論理的解析)
phys × × RDエリア単位の状態解析(物理的解析)
clus × × クラスタキー及びクラスタリングデータページの格納状態解析
省略 × × 表単位の状態解析
× × インデクス単位の状態解析
× × RDエリア単位の状態解析(論理的解析)
pred × × 再編成時期予測機能
(凡例)
○:必ず指定してください。
△:指定は任意です。
×:指定できません。

(3) -d

ページの詳細情報を表示する場合に指定します。このオプションは,論理的解析(-k logi),表単位の状態解析,及びインデクス単位の状態解析の場合に指定できます。ページの詳細情報は,pdrorg,及びpdreclaimの実行要否の基になる情報です。

(4) -z

ページに格納されているインデクスエントリの詳細情報(インデクスエントリが管理する行数や,残存エントリが管理する削除行数)を表示する場合に指定します。このオプションは,論理的解析(-k logi),及びインデクス単位の状態解析の場合に指定できます。インデクスエントリの詳細情報は,インデクスを解析するために使用します。

<規則>
このオプションを指定する場合,同時に-dオプションを指定する必要があります。

(5) -f

HiRDBファイル情報を表示する場合に指定します。このオプションは,物理的解析(-k phys)の場合に指定できます。

(6) -a

解析結果をDAT形式で表示する場合に指定します。

なお,RDエリアの状態解析(物理的解析)でこのオプションを指定した場合,-fオプションの指定有無に関係なく,-fオプション指定が仮定されます。

(7) -h

-aオプション指定時に,ヘッダを付ける場合に指定します。

(8) -u 認可識別子

pddbstを実行するユーザの,認可識別子を指定します。

<規則>
  1. このオプションを省略した場合,クライアント環境定義のPDUSERで定義した認可識別子とパスワードが仮定されます。PDUSERが設定されていない場合,ユティリティを実行するユーザのOS上のユーザIDに対応するユーザ名が仮定されます。
  2. 認可識別子を引用符('')で囲んだ場合は,英大文字と英小文字が区別されます。引用符('')で囲まない場合は,すべて英大文字として扱われます。なお,sh(Bourneシェル),csh(Cシェル),及びksh(Kシェル)の場合は,更にアポストロフィ(’)で囲む必要があります。

(9) -p パスワード

-uオプションで指定した認可識別子に対応するパスワードを指定します。

<規則>
  1. このオプションの指定を省略し,クライアント環境定義のPDUSERにも値が設定されていない場合,ユティリティの実行画面に入力された値が仮定されます。
  2. パスワードを引用符('')で囲んだ場合は,英大文字と英小文字が区別されます。引用符('')で囲まない場合は,すべて英大文字として扱われます。なお,sh(Bourneシェル),csh(Cシェル),及びksh(Kシェル)の場合は,更にアポストロフィ(’)で囲む必要があります。

(10) -t 〔認可識別子.表識別子

解析する表の名称を指定します。

<規則>
  1. ビュー表及び外部表は指定できません。
  2. 認可識別子を省略した場合は,-uオプションで指定した認可識別子が仮定されます。
  3. 認可識別子又は表識別子を引用符('')で囲んだ場合は,英大文字と英小文字が区別されます。引用符('')で囲まない場合は,すべて英大文字として扱われます。
  4. 表識別子に空白が含まれる場合は,引用符('')で囲んでください。なお,sh(Bourneシェル),csh(Cシェル),及びksh(Kシェル)の場合は,更にアポストロフィ(’)で囲む必要があります。

(11) -s

表単位の状態解析で,格納行数を表示する場合に指定します。表の総格納行数及びRDエリアごとの格納行数を表示します。

(12) -i 〔認可識別子.インデクス識別子

解析するインデクスの名称を指定します。

<規則>
  1. 外部インデクスは指定できません。
  2. 認可識別子を省略した場合は,-uオプションで指定した認可識別子が仮定されます。
  3. 認可識別子又はインデクス識別子を引用符('')で囲んだ場合は,英大文字と英小文字が区別されます。引用符('')で囲まない場合は,すべて英大文字として扱われます。
  4. インデクス識別子に空白が含まれる場合は,引用符('')で囲んでください。なお,sh(Bourneシェル),csh(Cシェル),及びksh(Kシェル)の場合は,更にアポストロフィ(’)で囲む必要があります。

(13) -q 世代番号

   〜<符号なし整数>((0〜10))

インナレプリカ機能に関する情報を表示する場合に指定します。

<規則>
  1. HiRDB Staticizer Optionが組み込まれていない場合にこのオプションを指定すると,エラーとなります。
  2. このオプションを指定した場合,指定した世代のレプリカ定義が存在するRDエリアを解析対象とします。指定した世代に解析対象となるRDエリアが存在しない場合はエラー(KFPK10102-Wメッセージ)となります。
  3. このオプションを省略した場合,解析対象となるRDエリアは次のようになります。
    ・RDエリア単位の状態解析で-rオプションにALLを指定した場合は,定義されているRDエリアのうち,「15.2.2(1) -r {RDエリア名〔,RDエリア名〕…|ALL}」に示した指定できるRDエリア
    ・RDエリア単位の状態解析で,-rオプションに一括指定又は直接指定を指定した場合は,-rオプションで指定したRDエリア
    ・表又はインデクス単位の状態解析と,クラスタキー及びクラスタリングデータページの格納状態解析の場合は,カレントRDエリア
  4. 状態解析結果蓄積機能,及び再編成時期予測機能を実行する場合,このオプションは指定できません。インナレプリカ機能を使用している場合は,-q 0を仮定して実行します。

(14) -b

pddbst実行によるアプリケーションへのオンライン性能劣化を防ぐ場合に指定します。

-sオプションと同時に指定すると,解析時間が長くなることがあります。また,ディクショナリ表からデータベースの状態解析対象となる表,インデクスの情報を検索する処理や,再編成時期予測機能での運用管理表の検索処理では,-bオプションの指定は無効となります。

<適用基準>
pddbstを実行すると,解析対象の資源のページをグローバルバッファに読み込んでから処理をします。このとき,グローバルバッファ不足が発生すると,先にアプリケーションなどで読み込んでいたページがグローバルバッファから追い出されるため,オンライン性能が劣化する可能性があります。この性能劣化を回避する場合,-bオプションを指定します。
-bオプションを指定した場合,pddbstだけが読み込んだページは常に最古のページとして扱い,グローバルバッファ不足時には最初に追い出されるページとなります。-bオプションを指定しない場合はLRU管理方式となります。

<利点>
グローバルバッファが不足した場合でも,アプリケーションのオンライン性能への影響がありません。ただし,pddbst実行時に,行数を取得するためのディレクトリページの再読み込みが発生します。

(15) -e 予測レベル

状態解析結果蓄積機能,又は再編成時期予測機能を実行する場合の予測レベルを指定します。

1:
状態解析結果蓄積機能,又は再編成時期予測機能を予測レベル1で実行する場合に指定します。

2:
状態解析結果蓄積機能,又は再編成時期予測機能を予測レベル2で実行する場合に指定します。

<規則>
  1. 状態解析結果蓄積機能と再編成時期予測機能の予測レベルは同じにしてください。
  2. -eオプションを指定した場合,-bオプション指定が仮定されます。

(16) -w 休止時間,セグメント数

予測レベル2の状態解析結果蓄積機能を,インターバル解析で実行する場合に指定します。インターバル解析については,「15.6.1 インターバル解析」を参照してください。指定したセグメント数分の解析をした後,休止時間に指定した時間だけ処理を休止します。

休止時間   〜<符号なし整数>((10〜60000))
休止時間を10ミリ秒単位に指定します。10ミリ秒単位の指定でない場合,1けた目を切り上げます(例:15→20)。

セグメント数   〜<符号なし整数>((1〜2147483647))
解析をするセグメント数を指定します。

<規則>
  1. -wオプションは,予測レベル2(-e 2)の場合に有効となります。そのほかの場合に指定すると,制御文エラーになります。
  2. HiRDB/パラレルサーバの場合,指定値はサーバごとに有効となります。
  3. グローバルバッファに解析対象のページがない場合,休止時間が来るまで(指定したセグメント数×セグメントサイズ)回の入出力が発生します。

(17) -n 解析分割数

   〜<符号なし整数>((2〜10))

予測レベル2の状態解析結果蓄積機能を,マージ解析で実行する場合に指定します。マージ解析については,「15.6.2 マージ解析」を参照してください。

1回の状態解析結果蓄積機能の実行を,指定した解析分割数に分けて行います。ここで指定した解析分割数(n)を分母にして,1/nのデータが1回の解析対象となります。最終的には,n回実行すると,対象となる全データが解析されます。

<規則>
  1. -nオプションは,予測レベル2(-e 2)の場合に有効となります。そのほかの場合に指定すると,制御文エラーになります。
  2. -nオプションを指定する場合,指定した回数分pddbstを実行する必要があります。途中で-nオプションの指定値を変更した場合は,前回までに蓄積した解析情報は無効となり,再度最初から解析を始めます。
  3. 全体の解析が終わる前の状態(例えば,全体の2/3が完了している状態)で,表やインデクスをメンテナンスした場合は,再度最初から解析を始めます(1/3から開始します)。

(18) -I

状態解析結果蓄積情報をリセットする場合に指定します。状態解析結果蓄積情報をリセットについては,「15.1.3(4)障害発生時にデータベースを最新の状態に回復しない場合の再編成時期予測」を参照してください。

<規則>
  1. -Iオプションを指定する場合,-r オプションにALLは指定できません。
  2. -Iオプションは,データベースを回復した後の1回目の状態解析結果蓄積機能実行時にだけ指定してください。それ以外のタイミングで-Iオプションを指定すると,状態解析結果蓄積情報がリセットされます。

(19) -m

再編成時期予測機能で,DBメンテナンス予定日の情報,及びメンテナンス方法の情報を出力する場合に指定します。省略した場合は,DBメンテナンス予定日の情報だけ出力されます。

(20) -R 監視期間〔,メンテナンス延長期間〕

再編成時期予測機能を実行する場合,対象とする期間とメンテナンスの延長期間を指定します。

監視期間 〜<符号なし整数>((1〜400))《14》
監視対象期間を日数で指定します。
例えば,この先2週間以内に,DBメンテナンス予定日となるRDエリアを監視したい場合,14と指定します。

メンテナンス延長期間 〜<符号なし整数>((0〜400))《監視期間÷2》
DBメンテナンス予定日にメンテナンスをした場合,次のDBメンテナンス予定日を迎えるまでの余裕期間を,日数で指定します。
例えば,DBメンテナンスを実行した後,次のDBメンテナンスまで1週間の余裕を持たせたい場合は,7と指定します。

(21) -c 基準値定義ファイル名

   〜<パス名>((1023バイト以内))

再編成時期予測機能を実行する場合,あらかじめ決められた各項目の基準値を基に予測をしています。この各項目の基準値を変更する場合に,基準値定義ファイルを絶対パス名又は相対パス名で指定します。

基準値定義ファイルには,変更後の各項目の基準値を記述します。基準値定義ファイルについては,「15.5 基準値定義ファイル(再編成時期予測機能)」を参照してください。

(22) -X サーバ間通信の応答監視時間

   〜<符号なし整数> ((1〜65535)) 《300》

コマンドを実行したサーバで通信障害などの障害が発生した場合,コマンドは無応答となり,業務が停止するおそれがあります。pddbstでは障害を検知するために,コマンドで実施されるディクショナリ操作についての通信の応答時間を監視できます。

-Xオプションには,ディクショナリ操作での応答監視時間を秒数で設定します。ディクショナリ操作時の実行時間が,-Xオプションに設定した時間を超えた場合は,pddbstはディクショナリアクセスで障害が発生したと判断し,リターンコード8で処理を打ち切ります。

<適用基準>
  • 通信障害やユニットダウンによってサーバから応答が返らない状態となった場合に,300秒より早く障害を検知したいとき,-Xオプションに300より小さい値を指定してください。
  • 系切り替え機能を使用している場合,系切り替えが完了しているにもかかわらず,コマンドが応答を待ち続けることがあります。その場合は,監視時間を短く設定することで,コマンドを即時終了できます。
  • 同時実行するアプリケーションやユティリティの多重度が高い場合など,ディクショナリからの応答が遅延し,-Xオプションのデフォルトである300秒以内にユティリティの前処理が完了しないときは,監視時間でタイムアウトするおそれがあります。このような環境では,-Xオプションには300より大きい値を指定してください。

(23) -v 制御文ファイル名

   〜<パス名>((1023バイト以内))

pddbstの制御文を指定したファイルを,絶対パス名又は相対パス名で指定します。

このファイルは,pddbstを実行するホストになければなりません。指定できる制御文を次に示します。