jnlstts

名称

稼働統計情報の出力

ページの先頭へ

形式

jnlstts 〔-e 編集項目〕〔-u 編集単位〕〔-l 行〕〔-c〕
        〔-i 時間間隔〕〔-t〔開始〕〔,終了〕〕
        〔-s ｛サーバ名｜サービス名｝ 〕
        〔ファイル名〕

ページの先頭へ

機能

指定したアンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルから統計情報を収集し，編集後，標準出力へ出力します。

出力する情報を次に示します。

• システム統計情報（システム統計レコード内の各コンポーネント情報）

• トランザクション統計情報（システム統計レコード内の各トランザクションの情報）

• レスポンス統計情報（システム統計レコード内の各レスポンスタイムの情報）

• 通信遅延時間統計情報（システム統計レコード内の通信遅延に関する情報）

ページの先頭へ

オプション

ページの先頭へ

コマンド引数

ページの先頭へ

出力形式

●システム統計情報の場合

出力形式を次に示します。

-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けたを四捨五入して出力します。

• イベント数，平均値がオーバフローして'*'が設定された場合でも，最大値と最小値は保証されます。

• 取得編集時間帯にデータがない場合は，その時間帯に'該当データなし'を出力します。

• ファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

• レスポンス統計情報の場合で，レスポンスタイム取得失敗の統計情報だけが取得されていた場合，データにはすべて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秒までのシステム統計情報を出力します。

ページの先頭へ