2.94.1　pdstbeginの形式と規則

(1)　機能

ホスト名で指定したサーバマシンにあるユニットの統計情報を，統計ログファイルに出力します。統計情報の出力を停止したい場合は，pdstendコマンドを実行します。

統計情報は，各ホストのpdstj1，又はpdstj2という名称の統計ログファイルに出力されます。

出力した統計情報は，統計解析ユティリティの入力となります。統計解析ユティリティについては，「統計解析ユティリティ（pdstedit）」を参照してください。

ページの先頭へ

(2)　実行者

HiRDB管理者が実行できます。

ページの先頭へ

(3)　形式

　pdstbegin 〔-k 統計情報種別〔，統計情報種別〕…〕 〔-m システム稼働統計情報出力時間間隔〕
 
　　　　　　〔-I データベースの入出力統計情報出力時間間隔〕
 
　　　　　　〔-D 〔データベースの入出力統計情報オプション
 
　　　　　　　〔，データベースの入出力統計情報オプション〕〕〕
 
　　　　　　〔｛-a｜-s サーバ名〔，サーバ名〕…｝〕
 
　　　　　　〔-w〕

　pdstbegin 〔-k 統計情報種別〔，統計情報種別〕…〕 〔-m システム稼働統計情報出力時間間隔〕
 
　　　　　　〔-I データベースの入出力統計情報出力時間間隔〕
 
　　　　　　〔-D 〔データベースの入出力統計情報オプション
 
　　　　　　　〔，データベースの入出力統計情報オプション〕〕〕
 
　　　　　　〔｛-x ホスト名｜-u ユニット識別子｝〕
 
　　　　　　〔｛-a｜-s サーバ名〔，サーバ名〕…｝〕
 
　　　　　　〔-w〕

ページの先頭へ

(4)　オプション

ページの先頭へ

(5)　規則

1. pdstbeginコマンドは，HiRDBが稼働中のときだけ実行できます。

2. pdstbeginコマンドは，シングルサーバ又はシステムマネジャがあるサーバマシンで実行してください。

3. 統計情報を出力している場合は，pdstendコマンドを実行しないと，HiRDBが停止するまで統計情報を出力し続けます。

4. 出力される統計情報と-sオプションとの組み合わせによって，出力される統計情報が異なります。出力される統計情報と-sオプションとの関係（HiRDB/シングルサーバの場合）を表「出力される統計情報と-sオプションとの関係（HiRDB/シングルサーバの場合）」，（HiRDB/パラレルサーバの場合）を表「出力される統計情報と-sオプションとの関係（HiRDB/パラレルサーバの場合）」に示します。

   表2‒24　出力される統計情報と-sオプションとの関係（HiRDB/シングルサーバの場合）

   統計情報種別	-sオプションで指定したサーバ（シングルサーバ）
   sys	○
   uap	○
   sql	○
   sqh	○
   buf	○
   fil	○
   dfw	○
   idx	○
   sop	○
   dop	○
   pcd	○
   obj	×
   dio	○

   （凡例）

   　○：統計情報を出力します。

   　×：統計情報を出力しません。

   表2‒25　出力される統計情報と-sオプションとの関係（HiRDB/パラレルサーバの場合）

   統計情報種別	-sオプションで指定したサーバ
   	フロントエンドサーバ	ディクショナリサーバ	バックエンドサーバ
   sys	○	○	○
   uap	○	×	×
   sql	○	×	×
   sqh	○	×	×
   buf	×	○	○
   fil	×	○	○
   dfw	×	○	○
   idx	×	○	○
   sop	○	×	×
   dop	○	×	×
   pcd	○	○	○
   obj	×	○	○
   dio	×	○	○

   （凡例）

   　○：統計情報を出力します。

   　×：統計情報を出力しません。

5. 次の場合，すべてのサーバのスレッド間ロックの待ち時間の統計情報の取得を開始します。

   • -aオプションを指定した場合

   • -sオプション及び-aオプションの指定を省略して，-wオプションを指定した場合

ページの先頭へ

(6)　注意事項

1. pdstbeginコマンドのリターンコードを次に示します。

   0：正常終了

   4：一部のユニットが正常終了

   8：異常終了（オプション指定不正，rsh失敗など）

2. pdstbeginコマンドは，コマンド名pdststartでも実行できます。

3. ユニット内のサーバがすべて停止している場合，ユニットの統計情報は取得されません。

4. HiRDB/パラレルサーバでシステムマネジャだけのユニット（同じユニットにフロントエンドサーバ，バックエンドサーバ，又はディクショナリサーバがない）の場合，このユニットの統計情報は取得されません。

5. 影響分散スタンバイレス型系切り替え機能を適用したユニットで，ユニット内に実行系として稼働しているサーバが存在しない場合，このユニットの統計情報は取得されません。

6. サーバのsys（システムの稼働に関する統計情報）の取得を開始すると，ユニットのsysの取得も開始します。

7. HiRDBを終了し，再度開始した場合，統計情報の出力は引き継がれません。したがって，HiRDB開始後に統計情報を出力したい場合は，再度pdstbeginコマンドを実行してください。

8. サーバを一度終了すると，サーバの正常開始時には統計情報の出力は引き継がれません。一度終了したサーバの統計情報を出力したい場合は，サーバの正常開始後にpdstbeginコマンドを実行してください。

9. 統計情報が出力中かどうかについては，pdls -d stjコマンドを実行してください。

10. UAPに関する統計情報は，pdstbeginコマンドの入力からpdstendコマンドの入力までに実行していたUAPについてだけ出力します。また，OLTP環境下で実行しているUAPでは，pdstbeginコマンドの実行からpdstendコマンドの実行までに実行したトランザクションについてだけ，UAPに関する統計情報を出力します。

11. SQLに関する統計情報は，pdstbeginコマンドの入力からpdstendコマンドの入力までに実行したSQLについてだけ出力されます。

12. UAPに関する統計情報とSQLに関する統計情報は，pdstbegin及びpdstendコマンドを入力するタイミングによっては情報が一致しない場合があります。出力される統計情報と，pdstbegin，pdstendコマンドの入力との関係を次の図に示します。

    図2‒12　出力される統計情報と，pdstbegin，pdstendコマンドの入力との関係

13. 各統計情報の出力契機を次に示します。

    sys：

    -mオプションに指定した時間間隔ごとに情報を出力します。

    uap：

    HiRDBへの接続時及びHiRDBからの切離し時に情報を出力します。

    sql：

    SQLの実行開始時及びSQLの実行終了時に情報を出力します。

    sqh：

    PREPARE時及び埋込み型SQL文の実行時に情報を出力します。

    buf，fil，idx：

    シンクポイント時に情報を出力します。

    dfw：

    シンクポイント時，及びデファードライトトリガ時に情報を出力します。

    sop：

    動的SQLの前処理時，及び静的SQLの前処理時に，SQLオブジェクトがSQLオブジェクト用バッファにヒットしなかった場合に情報を出力します。

    dop：

    FETCH文及びCLOSE文以外のSQL文を実行したときに情報を出力します。

    pcd：

    SQLオブジェクトの実行時に情報を出力します。

    obj：

    ディクショナリサーバ，及びバックエンドサーバでSQLオブジェクトの実行要求時に情報を出力します。

    dio：

    -Iオプションに指定した時間間隔（秒）ごとにデータベースへの入出力が発生した場合に情報を出力します。

14. 次に示す統計情報は，シンクポイント時に取得され，シンクポイント間の情報が編集されます。このため，シンクポイントが2回以上発生しないと統計情報が取得されません。

    • グローバルバッファプールに関する統計情報

    • データベース操作に関するHiRDBファイルの統計情報

    • インデクスに関する統計情報

    これらの統計情報を取得するためには，pdstbeginコマンド実行直後と，pdstendコマンド実行直前に，pdlogswapコマンドを実行してシンクポイントを発生させる必要があります。

15. SQL文の履歴に関する統計情報は，SQLに関する統計情報出力が指定されている場合に出力されます。

16. 影響分散スタンバイレス型系切り替え機能を適用している場合，pdstbeginコマンド実行後で，かつpdstend実行前に再開始が発生すると，再開始後も再開始前と同じ統計情報が出力されます。また，pdstbeginコマンド実行後で，かつpdstend実行前に系切り替えが発生すると，障害が発生したユニットで実行系として稼働していたサーバについては，切り替え先の受け入れユニットでも切り替え前と同じ統計情報が出力されます。統計情報の出力を停止する場合は，pdstendコマンドを実行してください。

17. 影響分散スタンバイレス型系切り替え機能を適用している場合，-x，又は-uオプションを指定するときは，系切り替えの前後でpdstbeginコマンドの実行対象が異なります。pdstbeginコマンドの実行対象は次のようになります。

    サーバの種別	サーバの状態	実行対象
    ホストBES	実行中	○
    	待機中	×
    ゲストBES	実行中	○
    	受け入れ可能状態	×

    （凡例）

    ○：実行できます。

    ×：実行できません。KFPS01882-Eメッセージを表示します。

18. 影響分散スタンバイレス型系切り替え機能を適用している場合，-x，又は-uオプションと，-sオプションを同時に指定したときの注意事項を次に示します。

    • pdstbeginコマンド実行時点で，-x，又は-uオプションに指定したユニットの，-sオプションで指定したバックエンドサーバが稼働中の場合，統計情報の取得を開始します。

    • -sオプションで指定したバックエンドサーバが-x，又は-uオプションで指定したユニットで稼働していない場合，KFPS01882-Eメッセージを表示して，エラー終了します。

      バックエンドサーバが稼働しているユニットをpdls -d svrコマンドで確認した後，pdstbeginコマンドを再実行してください。

19. pdstbegin -wコマンドで，スレッド間ロックの待ち時間の統計情報を取得すると，システム全体の性能に影響を与えるおそれがあります。そのため，通常は指定しないでください。

ページの先頭へ