jnlstts
形式
jnlstts 〔-e 編集項目〕〔-u 編集単位〕〔-l 行〕〔-c〕 〔-i 時間間隔〕〔-t〔開始〕〔,終了〕〕 〔-s {サーバ名|サービス名} 〕 〔ファイル名〕
機能
指定したアンロードジャーナルファイル,またはグローバルアーカイブアンロードジャーナルファイルから統計情報を収集し,編集後,標準出力へ出力します。
出力する情報を次に示します。
-
システム統計情報(システム統計レコード内の各コンポーネント情報)
-
トランザクション統計情報(システム統計レコード内の各トランザクションの情報)
-
レスポンス統計情報(システム統計レコード内の各レスポンスタイムの情報)
-
通信遅延時間統計情報(システム統計レコード内の通信遅延に関する情報)
オプション
●-e 編集項目 〜《all》
編集項目を指定します。
sys:システム統計情報を出力します。
trn:トランザクション統計情報を出力します。
rsp:レスポンス統計情報を出力します。
dly:通信遅延時間統計情報を出力します。
all:上記すべての情報を編集します。
●-u 編集単位 〜《srv》
編集単位を指定します。
- srv:サーバ名単位で編集します。
-
srvを指定すると,-sオプションにはサーバ名を指定したと見なされます。
- svc:サービス名単位で編集します。
-
svcを指定すると-sオプションにはサービス名を指定したと見なされます。
-uオプションの指定は,-eオプションでtrn,またはallを指定した場合に有効です。
●-l 行 〜〈符号なし整数〉((12〜256))《24》
1ページの出力行数を指定します。
●-c
稼働統計情報の編集結果を,CSV形式で出力します。
●-i 時間間隔
稼働統計情報を編集し,出力する時間の間隔を,時間間隔,または分間隔で指定します。
- h〔HH〕:時間間隔(01≦HH≦24)で出力します。
-
HHの指定を省略すると,1時間間隔で出力します。
- m〔MM〕:1分間隔(01≦MM≦09),または10分間隔(10≦MM≦30)で出力します。
-
MMの指定を省略すると,10分間隔で出力します。
時間間隔と分間隔の両方を指定すると,エラーとなります。
-iオプションの指定を省略すると,1時間間隔で出力します。
●-t 〔開始〕〔,終了〕
稼働統計情報の出力範囲をジャーナルレコード出力時刻で指定します。
開始には,出力を開始する時刻を指定します。終了には,出力を終了する時刻を指定します。
開始は,1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。
開始,または終了のどちらか一方を必ず指定してください。開始の指定を省略すると,アンロードジャーナルファイルの先頭から指定した終了時刻までが出力範囲になります。終了の指定を省略すると,指定した開始時刻からアンロードジャーナルファイルの最後までが出力範囲になります。
開始,および終了は,「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オプションの指定を省略すると,指定したファイル内のすべての情報を編集出力します。
●-s サーバ名 〜〈1〜8文字の英数字〉
統計情報を編集出力したいサーバの名称を指定します。
-eオプションでsysを指定し,サーバ名の指定を省略した場合は,すべてのサーバの統計情報が出力されます。
-uオプションでsrvを指定した場合,-sオプションにはサーバ名を指定したと見なされます。
-eオプションでsysを指定し,サーバ名にSYSTEMと指定すると,システム全体の統計情報が出力されます。
●-s サービス名 〜〈1〜31文字の英数字〉
統計情報を編集出力したいサービスの名称を指定します。
-eオプションでtrnを指定し,-uオプションでsvcを指定し,サービス名の指定を省略した場合は,すべてのサービスの統計情報を出力します。
-uオプションでsvcを指定した場合,-sオプションにはサービス名を指定したと見なされます。
-e,および-uオプションと-sオプションとの組み合わせを次に示します。
-eオプション |
-uオプション |
-sオプション |
出力対象 |
備考 |
---|---|---|---|---|
sys |
− |
サーバ名 |
指定したサーバのシステム統計情報 |
− |
SYSTEM |
システム全体の統計情報 |
− |
||
trn |
srv |
サーバ名 |
指定したサーバのトランザクション統計情報 |
− |
svc |
サービス名 |
指定したサービスのトランザクション統計情報 |
− |
|
省略 |
サーバ名 |
指定したサーバのトランザクション統計情報 |
− |
|
rsp |
− |
サービス名 |
指定したサービスのレスポンス統計情報 |
− |
dly |
− |
− |
すべての通信遅延時間統計情報 |
− |
all |
srv |
サーバ名 |
指定したサーバに関するすべての統計情報 |
レスポンス統計情報,通信遅延時間統計情報は全データ出力 |
svc |
サービス名 |
指定したサービスに関するすべての統計情報 |
システム統計情報,通信遅延時間統計情報は全データ出力 |
|
省略 |
サーバ名 |
指定したサーバに関するすべての統計情報 |
レスポンス統計情報,通信遅延時間統計情報は全データ出力 |
- (凡例)
-
−:指定できません。または,該当しません。
jnlsttsコマンドで指定できるオプションの組み合わせを次に示します。
- (凡例)
-
○:指定できます。
×:指定できません。
−:無効です。
- 注※1
-
-uオプションでsrvを指定した場合,または-uオプションの指定を省略した場合は,-sオプションにはサーバ名を指定したと見なされます。
- 注※2
-
-uオプションでsvcを指定した場合,-sオプションにはサービス名を指定したと見なされます。
コマンド引数
●ファイル名 〜〈パス名〉
アンロードジャーナルファイル,またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。
マルチノード機能を使用している場合は,jnlsortコマンドでソート,およびマージ(ノードの抽出,ジャーナルサーバランIDの特定)した結果のファイル名を指定してください。
このコマンド引数の指定を省略すると,標準入力と見なされます。
出力形式
●システム統計情報の場合
出力形式を次に示します。
-cオプションを指定したときの出力形式を次に示します(CSV形式)。
-
1:指定されたサーバ名ごとに,取得コンポーネントの統計情報を編集して表示します。
-
2〜8:1行で表示します。
-
aa...aa:ファイルの名称(59文字以内)
-
bb...bb:ファイルの作成日時
-
cc...cc:-tオプション指定開始時刻(-tオプション省略時は'*'を設定)
-
dd...dd:-tオプション指定終了時刻(-tオプション省略時は'*'を設定)
-
ee...ee:ノード識別子
-
ffffffff:サーバの名称
'SYSTEM'と表示された場合は,システム全体の統計情報であることを示します。
-
gg...gg:システム統計情報の編集開始時間
-
hh...hh:システム統計情報の編集終了時間
-
xx...xx:統計情報(10けた以内の10進数。イベント数,平均値がオーバフローした場合は'*'を,最大値,最小値,平均値の編集データがない場合は'-'を設定)
-
vv-rr:バージョン番号−リビジョン番号
-
yyyy:ページ
●トランザクション統計情報の場合
-uオプションでsrvを指定した場合,または-uオプションの指定を省略した場合は,サーバ名単位で編集します。-uオプションでsvcを指定した場合は,サービス名単位で編集します。
出力形式を次に示します。
- 注※1
-
-uオプションでsvcを指定した場合は,「サービス名」を出力します。
- 注※2
-
-uオプションでsvcを指定した場合は,「ユーザサーバ名」を出力します。
-cオプションを指定したときの出力形式を次に示します(CSV形式)。
-
1:サービス名単位に繰り返し表示します。
-uオプションでsvcを指定した場合は,サーバ名単位に繰り返し表示します。
-
2〜17:1行で表示します。
-
aa...aa:ファイルの名称(59文字以内)
-
bb...bb:ファイルの作成日時
-
cc...cc:-tオプション指定開始時刻(-tオプション省略時は'*'を設定)
-
dd...dd:-tオプション指定終了時刻(-tオプション省略時は'*'を設定)
-
ee...ee:ノード識別子
-
ffffffff:ユーザサーバの名称
-uオプションでsvcを指定した場合は,サービスの名称を出力します。
-
gg...gg:トランザクション統計情報の編集開始時間
-
hh...hh:トランザクション統計情報の編集終了時間
-
iiiiiiii:サービスの名称(サービス名がない場合は'*'を設定)
-uオプションでsvcを指定した場合は,ユーザサーバの名称を出力します。
-
xx...xx:統計情報(10けた以内の10進数。平均値は小数点以下1けたを四捨五入して表示。また,最大値,最小値,平均値がオーバフローした場合は'*'を,編集データがない場合は'-'を設定)
-
vv-rr:バージョン番号−リビジョン番号
-
yyyy:ページ
●レスポンス統計情報の場合
出力形式を次に示します。
-cオプションを指定したときの出力形式を次に示します(CSV形式)。
- 注
-
MHPのサービス実行時間,およびサービス待ち時間は取得されません。
-
1:サービス名単位に繰り返し表示します。
-
2〜6:1行で表示します。
-
aa...aa:ファイルの名称(59文字以内)
-
bb...bb:ファイルの作成日時
-
cc...cc:-tオプション指定開始時刻(-tオプション省略時は'*'を設定)
-
dd...dd:-tオプション指定終了時刻(-tオプション省略時は'*'を設定)
-
ee...ee:ノード識別子
-
ff...ff:サービスグループの名称
-
gg...gg:レスポンス統計情報の編集開始時間
-
hh...hh:レスポンス統計情報の編集終了時間
-
ii...ii:サービスの名称
-
xx...xx:統計情報(10けた以内の10進数。平均値は小数点以下1けたを四捨五入して表示。また,最大値,最小値,平均値がオーバフローした場合は'*'を,編集データがない場合は'-'を設定)
-
vv-rr:バージョン番号−リビジョン番号
-
yyyy:ページ
●通信遅延時間統計情報の場合
出力形式を次に示します。
-cオプションを指定したときの出力形式を次に示します(CSV形式)。
-
1:送信先ノード識別子単位に繰り返し表示します。
-
2〜4:1行で表示します。
-
aa...aa:ファイルの名称(59文字以内)
-
bb...bb:ファイルの作成日時
-
cc...cc:-tオプション指定開始時刻(-tオプション省略時は'*'を設定)
-
dd...dd:-tオプション指定終了時刻(-tオプション省略時は'*'を設定)
-
ee...ee:ノード識別子
-
ff...ff:送信先ノード識別子
-
gg...gg:通信遅延時間統計情報の編集開始時間
-
hh...hh:通信遅延時間統計情報の編集終了時間
-
xx...xx:統計情報(10けた以内の10進数。平均値は小数点以下1けたを四捨五入して表示。また,最大値,最小値,平均値がオーバフローした場合は'*'を設定)
-
vv-rr:バージョン番号−リビジョン番号
-
yyyy:ページ
出力メッセージ
メッセージID |
内容 |
出力先 |
---|---|---|
KFCA02600-E |
アンロードジャーナルファイルのアクセスでエラーが発生しました |
標準エラー出力 |
KFCA02601-E |
アンロードジャーナルファイルが不正です |
標準エラー出力 |
KFCA02602-E |
ジャーナルブロックが不正です |
標準エラー出力 |
KFCA02603-E |
ジャーナルレコードが不正です |
標準エラー出力 |
KFCA02604-E |
メモリが確保できません |
標準エラー出力 |
KFCA02660-I |
ヘルプメッセージ |
標準出力,標準エラー出力 |
KFCA02661-E |
jnlsttsコマンドのパラメタ不正,または制限値オーバです |
標準エラー出力 |
KFCA02662-E |
jnlsttsコマンドのオプションの組み合わせが不当です |
標準エラー出力 |
KFCA02663-E |
jnlsttsコマンドのオプションの指定に誤りがあります |
標準エラー出力 |
KFCA02664-E |
jnlsttsコマンドのファイル名の指定に誤りがあります |
標準エラー出力 |
KFCA02665-E |
jnlsttsコマンドの-lオプションの指定値が小さ過ぎるため統計情報を出力できません |
標準エラー出力 |
注意事項
-
稼働統計情報の出力範囲を指定する場合の開始時刻,または終了時刻と一致するジャーナルレコードがないときは,開始時刻と終了時刻の間にあるジャーナルレコードが出力対象になります。
-
開始時刻が終了時刻より遅くなるように稼働統計情報の出力範囲を指定するときは,必ず「月」「日」,または「月」「日」「年(西暦)」を指定して,終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると,jnlsttsコマンドを入力した年月日と見なすため,出力範囲が該当する年月日以外の日付の場合は,必ず「月」「日」,または「月」「日」「年(西暦)」を指定してください。
-
稼働統計情報の編集出力開始時刻は,-tオプションで開始時刻を指定するか,指定しないかによって異なります。指定した場合,-tオプションの開始時刻が含まれる時間帯から出力します。指定しなかった場合,該当するファイルの先頭のSJレコード時刻が含まれる時間帯から出力します。ここでいう時間帯とは,それぞれの開始時刻の時間(hh:00)を基に,-iオプションで指定した時間間隔で区切った間隔のことです。
jnlsttsコマンドの-t,-iオプションの指定と,稼働統計情報(SJ)のアンロードジャーナルファイルへの出力時刻との関係を次に示します。
-tオプションで指定した開始時刻
SJのアンロードジャーナルファイルへの出力時刻
-iオプションで指定した時間間隔
出力開始時刻
備考
例1
9時0分0秒
9時10分0秒
10分
9:00〜9:10
9:00〜9:10に該当する範囲は,9時0分0秒から9時9分59秒までで,この時間帯にSJは含まれていません。したがって,SJは次の時間帯に出力されます。
例2
9時0分0秒
8時50分0秒
7分
9:00〜9:07
SJは,-tオプションの指定開始時刻より前に出力されています。したがって,SJは出力対象外となり,jnlsttsコマンドを実行しても出力できません。
例3
指定なし
9時5分34秒
4分
9:04〜9:08
9時4分0秒から9時7分59秒までのSJが出力されます。
例4
指定なし
9時37分0秒
30分
9:30〜10:00
9時30分0秒から9時59分59秒までのSJが出力されます。
例5
9時29分59秒
9時30分0秒
30分
9:00〜9:30
9:00〜9:30に該当する範囲は,9時0分0秒から9時29分59秒までで,この時間帯にSJは含まれていません。したがって,SJは次の時間帯に出力されます。
-
稼働統計情報の出力終了時刻を指定すると,指定終了時刻を含む時間帯まで出力されます。例えば,-tオプションで終了時刻を9時0分0秒と指定し,-iオプションで時間間隔を30分と指定すると,最終時間帯は9:00〜9:30ですが,実際は9時0分0秒の稼働統計情報が出力されます。
-
システム統計情報の場合,編集した平均値は小数点以下1けたを切り捨てて出力します。
-
トランザクション統計情報の場合,編集した平均値は小数点以下1けたを四捨五入して出力します。
-
イベント数,平均値がオーバフローして'*'が設定された場合でも,最大値と最小値は保証されます。
-
編集対象データが連続して存在していない場合は,まとめて'該当データなし'を1行出力します。
(例)稼働統計情報の取得データが次の状況だった場合を例に説明します。
統計データの取得時間帯
統計データの有無
9:00〜9:30
あり
9:30〜10:00
なし
10:00〜10:30
なし
10:30〜11:00
あり
jnlsttsコマンドで,稼働統計情報の出力範囲に9:00〜11:00を指定し,編集出力する時間の間隔に30分を指定した場合の出力結果
<出力例>
--------------------------------------------------------------------------- ***** 編集対象時間 22- 4- 1 09:00 〜 22- 4- 1 09:30 ***** : <データ編集結果を出力> : --------------------------------------------------------------------------- ***** 編集対象時間 22- 4- 1 09:30 〜 22- 4- 1 10:30 ***** ***** 該当データなし ***** --------------------------------------------------------------------------- ***** 編集対象時間 22- 4- 1 10:30 〜 22- 4- 1 11:00 ***** : <データ編集結果を出力> : ---------------------------------------------------------------------------
-
ファイル名の指定を省略すると,標準入力からの入力となります。そのため,入力ファイルをパイプ,リダイレクションなどで指定してください。
-
レスポンス統計情報の場合で,レスポンスタイム取得失敗の統計情報だけが取得されていた場合,データにはすべて0が出力されます。
-
-tオプションの終了時刻の「年」に2038年を超える値を指定すると,CPU消費量およびメモリ所要量が増大してコマンドを終了するまでに時間が掛かる場合があります。
-
OSの時刻補正機能などによる時刻戻しが発生して取得編集時間帯のデータがマイナス値になった場合,その時間帯の最大値,最小値,および平均値に'*'を出力します。
-
jnlsttsコマンドでは,編集する稼働統計情報の項目,出力範囲,または時間間隔などのオプションの指定値によっては,メモリ所要量が非常に大きくなる可能性があります。また,ジャーナルに含まれるサーバ名やサービス名などの数,構成によってもメモリ所要量は異なります。次に示す見積もり式に従ってメモリ所要量を算出し,必要に応じて実行環境のメモリの割り当てを増やしてください(単位:バイト)。
実行環境のメモリ割り当てを増やしただけでは対処できない場合は,次の方法でメモリ所要量を減らす対策を行ってください。
-
編集項目(-eオプション)で”all”を指定している場合,個別に編集項目を指定する
-
出力範囲(-tオプション)で,ジャーナル出力時刻の範囲を狭める
-
時間間隔(-iオプション)を大きくして,解析出力する時間帯(区間)の数を減らす
これらの実施に際しては「編集項目ごと,または出力範囲ごとに分けてコマンドを実行する」という運用が目的に応じて必要になる場合があります。
- (凡例)
-
↑↑:小数点以下を切り上げます。
A:サーバ数。-uオプションにsvcを指定した場合はサービス数になります。
B:サービスグループ数。
- 注※1
-
システムジャーナルサービス定義のjnl_max_datasizeオペランドの指定値になります。
- 注※2
-
-tオプションで指定した編集開始から終了までの時間を,-iオプションで指定した時間間隔の値で割った値です。データがない時間帯はカウントしません。
- 注※3
-
-uオプションにsvcを指定した場合はサービス数になります。
- 注※4
-
-uオプションにsvcを指定した場合は各サービスのサーバ数になります。
-
使用例
アンロードジャーナルファイルの先頭から1993年5月29日17時30分0.999999秒までのシステム統計情報を,30分間隔で編集出力する場合
アンロードジャーナルファイル:sysjnl001
jnlstts -e sys -i m30 -t ,17300005291993 /tp1/jnl/sysjnl001
上記の例の場合,最終時間帯は17:30〜18:00ですが,1993年5月29日17時30分0.0秒から1993年5月29日17時30分0.999999秒までのシステム統計情報を出力します。