sqcPDBcout(CSV出力コマンド)について説明します。
■実行に必要な権限
【Windows版】
Administratorsグループに所属するユーザー権限が必要です。
【UNIX版】
システム管理者(スーパーユーザー)権限が必要です。
■実行環境
Manager/Enterprise Manager、もしくは運用管理クライアントで実行可能です。
■記述形式
【Windows版】
<インストールディレクトリ>\bin\sqcPDBcout.exe | -R record-id [-sys system] [-rid resource-id] [-tmbin time] [-tmfin time] [-intval interval] [-lcltm on|off] [-h on|off] |
<インストールディレクトリ>\bin\sqcPDBcout.exe | -f sql-file [-h on|off] |
【UNIX版】
/opt/FJSVssqc/bin/sqcPDBcout.sh | -R record-id [-sys system] [-rid resource-id] [-tmbin time] [-tmfin time] [-intval interval] [-lcltm on|off] [-h on|off] |
/opt/FJSVssqc/bin/sqcPDBcout.sh | -f sql-file [-h on|off] |
<インストールディレクトリ>\bin\sqcPDBcout.exe | -R record-id -name manager [-sys system] [-rid resource-id] [-tmbin time] [-tmfin time] [-intval interval] [-lcltm on|off] [-h on|off] |
<インストールディレクトリ>\bin\sqcPDBcout.exe | -f sql-file -name manager [-h on|off] |
■機能説明
PDBに格納されているデータ(サマリ情報または詳細/レポート情報)をCSV形式で出力するコマンドです。抽出条件をパラメタで指定して実行します。
■オプション
抽出条件をオプションで指定するモードです。record-idには、レコードIDを指定します。レコードIDの詳細については、「第4章 データフォーマット」を参照してください。
抽出条件をsqlで指定するモードです。sql-fileには、sqlが記述されたファイルパスを指定します。
sql文の記述方法については、下記使用例2を参照してください。なお、from句に指定するテーブル名は、「第4章 データフォーマット」を参照してください。select/where句に指定するフィールド名は、下記出力結果を参照してください。
Managerを指定するモードです。managerには、出力するPDBデータを持つManagerのホスト名を指定します。
抽出条件となる、システム名を指定します。省略した場合は、全てのシステムのデータが抽出対象になります。
抽出条件となる、リソースIDを指定します。省略した場合は、全てのリソースのデータが抽出対象になります。
抽出開始時間をGMT(グリニッジ標準時)で指定します。省略した場合は、PDBに格納されている最古のデータ以降が抽出対象になります。
なお、時間の形式は、以下のとおりです。
"YYYY-MM-DD hh:mm:ss" (YYYY:西暦、MM:月、DD:日、hh:時間、mm:分、ss:秒)
抽出終了時間をGMT(グリニッジ標準時)で指定します。省略した場合は、PDBに格納されている最新のデータ以前が抽出対象になります。
なお、時間の形式は、以下のとおりです。
"YYYY-MM-DD hh:mm:ss" (YYYY:西暦、MM:月、DD:日、hh:時間、mm:分、ss:秒)
抽出条件となる、データのインターバルデータ種別を指定します。省略した場合は、全てのインターバルデータが抽出対象になります。
なお、インターバルデータ種別は、600、3600、86400の3つの種類があります。
-tmbin および -tmfin オプションに指定する抽出開始時間および抽出終了時間と、出力するCSV形式のデータ内の時間に、ローカルタイムを使用するか、しないかを指定します。省略した場合はGMT(グリニッジ標準時)が使用されます。
ローカルタイムには、sqcPDBcoutコマンドを実行するマシンで設定されている時間帯が使用されます。
なお、-intval オプションに「86400」（一日データ）を指定している時に、本オプションにonを指定すると、GMT(グリニッジ標準時)の "YYYY-MM-DD 00:00:00" のデータが、現地時間に変換されて表示されます。(日本時間の場合、"YYYY-MM-DD 09:00:00")
出力結果の先頭にヘッダー情報を表示するか、しないかを指定します。省略した場合は、ヘッダー情報は表示しません。
■出力結果
出力結果の先頭にヘッダー情報をつける場合は、以下のような情報が表示されます。
サマリ情報の場合
system_name,record_id,resource_id,start_date_time,end_date_time,end_time,data_num1, data_num2,data_num3,data_num4,data_num5,data_num6,data_num7,data_text1 |
詳細/レポート情報の場合
system_name,record_id,resource_id,start_date_time,end_date_time,consol_flag,consol_interval, coverage,data_num1,data_num2,data_num3,data_num4,data_num5,data_num6,data_num7,data_text1, data_text2,data_text3,data_text4,data_text5 |
これらのヘッダー情報に沿って、各項目について説明します。
システム名です。
レコードIDです。詳細については、「第4章 データフォーマット」を参照ください。
リソースIDです。
収集開始時刻をGMT(グリニッジ標準時)で示します。
収集終了時刻をGMT(グリニッジ標準時)で示します。
収集終了時刻の時間部分を示します。
内部制御情報です。
内部制御情報です。
内部制御情報です。
内部制御情報です。
インターバルの種類を示します。
インターバル時間を示します。
データのカバー率を示します。例えば、カバー率1は、ロストデータが無いことを示します。カバー率0.9は、10%のデータがロストしたことを示します。
各フィールド(数値)を示します。詳細については、「第4章 データフォーマット」を参照してください。
各フィールド(テキスト)を示します。詳細については、「第4章 データフォーマット」を参照してください。
■復帰値
0 : 正常終了
>0 : 異常終了 (以下に詳細)
PDBロックエラー
AgentやProxyManagerで収集した情報のPDBへの書き込み処理と競合した場合や、毎日午前2:00に実行されるPDBメンテナンス処理と競合した場合などに発生します。
本エラーが発生した場合は、正常終了するまでsqcPDBcoutコマドを再実行してください。但し、PDBメンテナンス処理を実行している時間帯で、PDBロックが長時間解消されないような場合には、sqcPDBcoutコマンドを実行するタイミングを、PDBメンテナンス処理が行われていない時間帯にずらしてください。
Manager通信エラー
Managerとの通信に失敗した場合に発生します。当エラーが発生した場合は、Managerが正常に起動されているか確認を行ない、Managerが停止している場合はManagerを起動してから実行してください。
その他のエラー
コマンドへのオプション指定ミスや、環境などの問題により発生します。コマンドへのオプション指定内容や、実行環境の見直しなどを行ってください。
■使用例1
抽出条件オプション指定(-R)の実行例。
【Windows版】
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcPDBcout -R WIN_DISKSPACE -sys LABRET -rid C:\ -tmbin "2004-07-01 10:00:00" -intval 3600 -h off LABRET,WIN_DISKSPACE,C:\,2004-07-01 11:00:00,2004-07-01 12:00:00,2,3600,1,74857984,2113864192,,,,,,,,,, LABRET,WIN_DISKSPACE,C:\,2004-07-01 12:00:00,2004-07-01 13:00:00,2,3600,1,105043456,2113864192,,,,,,,,,, |
【UNIX版】
# cd /opt/FJSVssqc/bin/ # ./sqcPDBcout.sh -R WIN_DISKSPACE -sys LABRET -rid C:\ -tmbin "2004-07-01 10:00:00" -intval 3600 -h off LABRET,WIN_DISKSPACE,C:\,2004-07-01 11:00:00,2004-07-01 12:00:00,2,3600,1,74857984,2113864192,,,,,,,,,, LABRET,WIN_DISKSPACE,C:\,2004-07-01 12:00:00,2004-07-01 13:00:00,2,3600,1,105043456,2113864192,,,,,,,,,, |
■使用例2
抽出条件sqlファイル指定(-f)の実行例。
【Windows版】
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcPDBcout -f C:\sql.txt LABRET,WIN_DISKSPACE,C:\,2004-07-01 11:00:00,2004-07-01 12:00:00,2,3600,1,74857984,2113864192,,,,,,,,,, LABRET,WIN_DISKSPACE,C:\,2004-07-01 12:00:00,2004-07-01 13:00:00,2,3600,1,105043456,2113864192,,,,,,,,,, |
【UNIX版】
# cd /opt/FJSVssqc/bin/ # ./sqcPDBcout.sh -f /tmp/sql.txt LABRET,WIN_DISKSPACE,C:\,2004-07-01 11:00:00,2004-07-01 12:00:00,2,3600,1,74857984,2113864192,,,,,,,,,, LABRET,WIN_DISKSPACE,C:\,2004-07-01 12:00:00,2004-07-01 13:00:00,2,3600,1,105043456,2113864192,,,,,,,,,, |
この時のsql.txtの内容は以下のとおり。
select * from resource_data where record_id='WIN_DISKSPACE' AND system_name='LABRET' AND consol_interval=3600; |
