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ログファイル1	RTSログファイル2	RTSログファイル3	-iオプションの指定値	有効になる編集時間間隔（秒）
例1	600	300	200	1000	1000
例2	600	300	200	100	100
例3	100	200	300	指定を省略	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オプションを指定した場合（標準出力）

[図データ]

1：RTSログファイルごとに繰り返し表示します。
aa...aa：読み込んだRTSログファイルの名称
bbbb：ノード識別子
cccc/cc/cc cc:cc:cc：RTSログファイルの更新時間
dd...dd：出力時間間隔

各RTSログファイルの出力時間間隔を秒単位で出力します。
ee...ee：読み込んだRTSログファイルのバージョン番号

バージョンが07-00のTP1/Server Baseで取得したRTSログファイルの場合は"1"が，バージョンが07-01以降のTP1/Server Baseで取得したRTSログファイルの場合は"2"が出力されます。

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

[図データ]

1，および2：1行で表示します。
2：リアルタイム統計情報を取得しているサーバまたはサービスごとに，統計情報分繰り返し表示します。
aa...aa：読み込んだRTSログファイル名
bbbb/bb/bb bb:bb:bb：出力ファイルの作成時刻
cccc/cc/cc cc:cc:cc：-tオプションで指定した開始時刻

-tオプションの指定を省略した場合は，'-'を表示します。
dddd/dd/dd dd:dd:dd：-tオプションで指定した終了時刻

-tオプションの指定を省略した場合は，'-'を表示します。
ee...ee：編集時間間隔

RTSログファイルへの出力時間間隔と，-iオプションの指定値に基づいた，有効になるCSVファイルへの編集時間間隔
ffff：ノード識別子
gggg/gg/gg gg:gg:gg：リアルタイム統計情報の編集開始時刻
hhhh/hh/hh hh:hh:hh：リアルタイム統計情報の編集終了時刻
ii...ii：編集するサーバの名称

サーバ名に「_SYSTEM」が表示されて，かつサービス名に「△△△△」が表示された場合は，システム全体の統計情報を示します。「----」が表示された場合は，取得対象名1を指定しないで取得したリアルタイム統計情報を示します。
jj...jj：編集するサービスのサービス名

「****」が表示された場合は，サービス以外の処理単位で取得したリアルタイム統計情報を示します。「△△△△」が表示された場合は，サーバ単位で取得したリアルタイム統計情報を示します。「----」が表示された場合は，取得対象名2を指定しないで取得したリアルタイム統計情報を示します。
kk...kk：リアルタイム統計情報種別
ll...ll：項目名
mm...mm：項目ID
nn...nn：項目数

編集対象となるリアルタイム統計情報がない場合^※は'-'を表示します。オーバフローが発生した場合は'****'を表示します。
oo...oo：最大値

編集対象となるデータ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。
pp...pp：最小値

編集対象となるデータ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。
qq...qq：平均値

編集対象となるデータ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。
rr...rr：リアルタイム統計情報の単位
vv-rr：バージョン番号−リビジョン番号

注※

次に示す理由で編集対象となるリアルタイム統計情報がない場合に，-eオプションおよび-qオプションを指定したときは，項目数，最大値，最小値および平均値に'-'を表示します。

-iオプションの指定値（編集時間間隔）が，RTSログファイルの出力時間間隔よりも小さい
-iオプションの指定値（編集時間間隔）とRTSログファイルの出力時間間隔は等しいが，リアルタイム統計情報の取得時に遅延が発生したため，編集時間間隔の区間中に編集対象となるデータが存在しなかった
リアルタイム統計情報の出力の一時的な停止や，取得項目の削除によって，リアルタイム統計情報を取得していない区間が存在する
コマンド引数に，取得時間が連続していない複数のRTSログファイルを指定した

ページの先頭へ

出力メッセージ

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

ページの先頭へ

注意事項

バージョンが07-00のTP1/Server Baseで取得したRTSログファイルを指定して編集した場合，ジャーナル情報のwrite（項目ID：1104）およびread（項目ID：1107）の最大値，最小値，および平均値を'-'ではなく0で出力します。
バージョンが07-00のTP1/Server Baseで取得したRTSログファイルとバージョンが07-01以降のTP1/Server Baseで取得したRTSログファイルを混在させ，RTSログファイルの出力時間間隔よりも長い間隔に編集する場合，ジャーナル情報のwrite（項目ID：1104）およびread（項目ID：1107）の最小値は0が出力されます。また，平均値は実際の値よりも小さくなることがあります。
コマンド引数に運用中のRTSログファイルを指定した場合，正しい情報が出力されないことがあります。
KFCA32729-Eメッセージが出力された場合は，-lオプションの指定値を大きくするか，またはコマンド引数に指定したRTSログファイルの個数を減らしたあとで，rtseditコマンドを再実行してください。
異なるOpenTP1システム上で取得したRTSログファイルを複数指定する場合，ノードIDが同一のRTSログファイルは指定しないでください。ノードIDが同一のRTSログファイルを指定すると，ノードIDが同一の統計情報として編集するか，またはKFCA32759-Eメッセージを出力してコマンドの処理を終了します。

次に示す条件での，RTSログファイル，-tオプションおよび-iオプションの指定の関係を次の図に示します。

RTSログファイルの出力時間間隔：30分

-tオプションの指定値：084500,105500

図13‒3　RTSログファイルとオプションの指定の関係

ページの先頭へ

rtsedit

名称

形式

機能

オプション

●-m

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

●-q

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

●-u 編集単位 〜〈all〉

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

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

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

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

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

コマンド引数

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

出力形式

出力メッセージ

注意事項

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

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

●-u　編集単位　　〜〈all〉

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

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

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

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

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

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