rtsedit

名称

RTSログファイルの編集出力

形式

rtsedit {〔-m〕|〔-e 項目ID〔,項目ID〕…〔-q〕〕
       〔-t〔開始時刻〕〔,終了時刻〕〕
       〔-u 編集単位〔-s サーバ名〕〔-v サービス名〕〕
       〔-i 編集時間間隔〕
       〔-o 出力先ファイル名〔-l 行〕〕}
         RTSログファイル名〔〔△RTSログファイル名〕…〕

機能

RTSログファイルからリアルタイム統計情報を収集し,編集後,CSV形式でファイルまたは標準出力へ出力します。

オプション

●-m

コマンド引数で指定されるRTSログファイルの管理情報を標準出力に出力します。

-mオプションを指定した場合,ほかのオプションは指定できません。

●-e 項目ID  ~〈符号なし整数〉((1000~2147483647))

編集する項目IDを指定します。

項目IDの詳細については,「付録E.5 リアルタイム統計情報」を参照してください。

●-q

-eオプションで指定した項目IDのリアルタイム統計情報が存在しない区間の,項目数,最大値,最小値および平均値に'-'を出力します。

このオプションは,-eオプションを指定した場合だけ有効です。

このオプションの指定を省略した場合,リアルタイム統計情報が存在しない区間に'-'を出力しません。

●-t 〔開始時刻〕〔,終了時刻〕

編集範囲を指定します。開始時刻には,編集対象とするリアルタイム統計情報の開始時刻を指定します。終了時刻には編集対象とするリアルタイム統計情報の終了時刻を指定します。

開始時刻は,1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻,または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると,RTSログファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると,指定した開始時刻からRTSログファイルの最後までが出力範囲になります。

開始時刻,および終了時刻は,「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。

hh:時(00≦hh≦23)
指定を省略できません。
mm:分(00≦mm≦59)
指定を省略できません。
ss:秒(00≦ss≦59)
指定を省略できません。
MM:月(01≦MM≦12)
指定を省略できます。
DD:日(01≦DD≦31)
指定を省略できます。
YYYY:年(1970からの西暦を4けたで指定します)
指定を省略できます。
注※
開始時刻,または終了時刻の「年」の指定を省略した場合は,当年の指定月日時刻と見なされます。「年,月,日」の指定を省略した場合,当年当月当日の指定時刻と見なされます。「月,日」,「月」,または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は,「年」,「月」,「日」のすべてを省略してください。

-tオプションの指定を省略すると,指定したファイル内のすべての情報を編集出力します。

●-u 編集単位  ~〈all〉

編集単位を指定します。

 sys:システム全体で取得したリアルタイム統計情報を編集します。

 svc:サーバ単位,またはサービス単位で取得したリアルタイム統計情報を編集します。

 all:すべてのリアルタイム統計情報(システム全体,全サーバ,および全サービス)を編集します。

●-s サーバ名  ~〈1~8文字の文字列〉

リアルタイム統計情報を編集したいサーバ,ポート番号,論理端末,または取得対象名1の名称を指定します。

-sオプションの指定は,-uオプションでsvcを指定した場合に有効です。

●-v サービス名  ~〈1~63文字の文字列〉

リアルタイム統計情報を編集したいサービス,ポート番号,論理端末,または取得対象名2の名称を指定します。

-vオプションの指定は,-uオプションでsvcを指定した場合に有効です。

-uオプション,-sオプション,および-vオプションと編集対象の組み合わせを,以降の表に示します。

表13-11 rtseditコマンドのオプションと編集対象の組み合わせ

-uオプションの指定-sオプションの指定-vオプションの指定編集対象となるリアルタイム統計情報
sysシステム全体の統計情報
svcサーバ名サービス名指定したサーバおよびサービスの統計情報
指定を省略指定したサーバの統計情報
ポート番号IPアドレス指定したサービス情報参照先ノードの統計情報
論理端末名指定を省略指定した論理端末の統計情報
指定を省略サービス名指定したサービスの統計情報
サービスグループ名指定したサービスグループの統計情報
指定を省略システム全体を除いた,すべての統計情報
allすべての統計情報
(凡例)
-:指定できません。
注※
リアルタイム統計情報サービス定義のrtsput定義コマンド,またはrtsstatsコマンドで,-uオプションにobjを指定して登録した取得対象の統計情報を編集対象とする場合の指定方法です。

●-i 編集時間間隔  ~〈符号なし整数〉((10~31536000))

統計情報を編集し,CSVファイルへ出力する間隔を,秒で指定します。

-iオプションの指定を省略した場合,RTSログファイルにリアルタイム統計情報を取得した際の出力時間間隔(リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドの指定値)が-iオプションに仮定されます。

-iオプションの指定を省略して,かつコマンド引数に複数のRTSログファイルを指定した場合は,複数のRTSログファイルへの出力時間間隔のうち,最大値が-iオプションに仮定されます。

-iオプションの指定値による,有効になるCSVファイルへの編集時間間隔の例を,次の表に示します。

表13-12 有効になるCSVファイルへの編集時間間隔の例

RTSログファイルへの出力時間間隔(秒)-iオプションの指定値有効になる編集時間間隔(秒)
RTSログファイル1RTSログファイル2RTSログファイル3
例160030020010001000
例2600300200100100
例3100200300指定を省略300

RTSログファイルへの出力時間間隔は,-mオプションを指定したrtseditコマンドを実行すると確認できます。

●-o 出力先ファイル名  ~〈1~65文字のパス名〉

編集結果を出力するCSV形式のファイル名を指定します。

このオプションを省略した場合は,標準出力に出力します。

●-l 行  ~〈符号なし整数〉((1024~65535))

1ファイル(-oオプションに指定したCSV形式のファイル)に出力する行数を指定します。

CSV形式のファイルの世代番号は1から999999までです。-lオプションで指定した行数を出力したあとは,CSV形式のファイルの世代番号を1ずつ増加させて出力を続けます。世代番号が999999のファイルに出力したあとは,出力処理を終了します。

-lオプションの指定は,-oオプションを指定した場合に有効となります。

-lオプションの指定を省略した場合,CSV形式のファイルの世代番号を変更しないで,すべてのデータを1ファイルに出力します。

コマンド引数

●RTSログファイル名  ~〈1~65文字のパス名〉

RTSログファイルの名称を指定します。

出力形式

●-mオプションを指定した場合(標準出力)

[図データ]

●-mオプションを指定しない場合(CSV形式)

[図データ]

注※
次に示す理由で編集対象となるリアルタイム統計情報がない場合に,-eオプションおよび-qオプションを指定したときは,項目数,最大値,最小値および平均値に'-'を表示します。
  • -iオプションの指定値(編集時間間隔)が,RTSログファイルの出力時間間隔よりも小さい
  • -iオプションの指定値(編集時間間隔)とRTSログファイルの出力時間間隔は等しいが,リアルタイム統計情報の取得時に遅延が発生したため,編集時間間隔の区間中に編集対象となるデータが存在しなかった
  • リアルタイム統計情報の出力の一時的な停止や,取得項目の削除によって,リアルタイム統計情報を取得していない区間が存在する
  • コマンド引数に,取得時間が連続していない複数のRTSログファイルを指定した

出力メッセージ

メッセージID内容出力先
KFCA32714-Eプロセスメモリ不足のため処理を続行できません標準エラー出力
KFCA32719-Eコマンドの使用方法が不正です標準エラー出力
KFCA32720-Eコマンドのオプションに指定された値が不正です標準エラー出力
KFCA32721-Eコマンドのコマンド引数の指定値が不正です標準エラー出力
KFCA32725-Eファイル操作でエラーが発生しました標準エラー出力
KFCA32726-E指定されたファイルはすでに存在します標準エラー出力
KFCA32727-E指定されたファイルはRTSログファイルではありません標準エラー出力
KFCA32728-ERTSログファイルのV/Rが誤っています標準エラー出力
KFCA32729-E出力ファイルの世代数の限度を超えたので終了します標準エラー出力
KFCA32730-ERTSログファイルへアクセス中に不正データを検出しました標準エラー出力
KFCA32731-E指定されたファイルは存在しません標準エラー出力
KFCA32735-Iヘルプメッセージ標準出力
KFCA32744-Eファイルに対するアクセス権がありません標準エラー出力
KFCA32745-E指定されたファイル名に誤りがあります標準エラー出力
KFCA32759-ERTSログファイルの内容が重複しているため編集できません標準エラー出力

注意事項