機能説明
ユーザデータをPDBに格納します。
実行環境
本コマンドは、Manager、Agentで実行できます。
なお、本コマンドの実行には、システム管理者の権限(スーパユーザ権限、Administrator権限)が必要です。
記述形式
【Windows版】
<インストールディレクトリ>\bin\sqcPDBcload.exe | -u udata-file -i conv-file |
【Solaris版】【Linux版】
/opt/FJSVssqc/bin/sqcPDBcload.sh | -u udata-file -i conv-file |
オプション
PDBに格納するユーザデータファイル(CSVファイル)を指定します。
データ変換定義ファイル(iniファイル形式)を指定します。データ変換ファイルとは、ユーザデータをPDBへ格納するレコード形式に変換する際の変換ルールが記述された以下のようなファイルです。
[USERDATA] consol_flag=2 record_id=1 col_resource_id=2,5 col_start_date_time=6 col_data_num1=10 col_data_num2=9 col_data_text1=4 |
データ変換定義ファイル(conv-file)
生成されるレコードの形式については、「第19章 データフォーマット」を参照してください。
データの種別を指定します。データの種別には、以下があります。それぞれ表示機能と保持期間が異なっています。「第2章 製品アーキテクチャ」を参照して、どのデータ種別で格納するかを設計してください。
0 : モニタデータ
1 : リソースデータ(10分)
2 : リソースデータ(1時間)
3 : リソースデータ(24時間)
0 を指定すると、「SUM_UDATA_n」レコードが生成されます。
1～3 を指定すると、「UDATA_n」レコードが生成されます。
生成するレコード「SUM_UDATA_1～5」または「UDATA_1～5」の内、1～5 どれを生成するかを指定します。
リソースIDとするユーザデータファイルのフィールドの番号を指定します。リソースIDとは、そのレコードを一意に識別する識別子です。
例えば、プロセス情報なら、プロセス名がリソースIDになります。
なお、複数のフィールドをつなげてリソースIDにすることもできます。その場合は、col_resource_id=2,5とすることで、フィールド2と5を一つにつなげるという意味になります。
収集開始時刻となるフィールドの番号を指定します。
なお、格納するデータの形式は、以下のとおりです。
‘YYYY-MM-DD [hh[:mm[:ss]]]’
(YYYY:西暦、MM:月、DD:日、hh:時間、mm:分、ss:秒)
フィールド「smudndata1～7」または「udndata1～7」(Record ID が UDATA_4～5 の場合は udndata14 まで)に格納する、ユーザデータファイルのデータ(数値)のフィールド番号を指定します。
フィールド「smudntxt1」または「udntxt1～5」に格納する、ユーザデータファイルのデータ(テキスト)のフィールド番号を指定します。
データ変換定義ファイル指定 | 生成されるレコード | 補足 | |
|---|---|---|---|
Record ID | Field Name | ||
consol_flag=0 record_id=1 col_data_num3=9 | SUM_UDATA_1 | smud1data3 |
|
consol_flag=1 record_id=1 col_data_num3=9 | UDATA_1 | ud1data3 |
|
consol_flag=3 record_id=2 col_data_num3=9 | UDATA_2 | ud2data3 |
|
復帰値
正常終了 0
異常終了 1
注意事項
ユーザデータが、以下の場合、そのデータはPDBに格納されません。
“col_resource_id”で指定したフィールド番号のデータが空白の場合。
“col_start_date_time”で指定したフィールド番号のデータが形式と違う場合。
収集開始時刻のフォーマットが一致しない場合
使用例
【Windows版】
C:\>cd C:\Program Files\DiskSpaceMonitor\bin C:\Program Files\DiskSpaceMonitor\bin>sqcPDBcload -u C:\temp\udata.csv -i C:\temp\conv.ini sqcPDBcload succeeded |
【Solaris版】【Linux版】
# cd /opt/FJSVssqc/bin/ # ./sqcPDBcload.sh -u /tmp/udata.csv -i /tmp/conv.ini sqcPDBcload succeeded. |
この時、udata.csvの内容は以下のとおり。
2004-09-09 10:00:00,kaminaka,2,octets,data,767872,28856,22400 |
また、conv.iniの内容は以下のとおり。
[USERDATA] consol_flag=2 record_id=1 col_resource_id=2,3 col_start_date_time=1 col_data_num1=6 col_data_num2=7 col_data_text1=4 |
