ctmstsed（稼働統計情報の編集と出力）

〈このページの構成〉

形式
機能
引数
戻り値
出力形式

形式

ctmstsed  [-h] [-CTMEdit <編集出力形式>[,<編集出力形式>...]]
          [-CTMInterval <時間間隔>] [-CTMTime [<開始時刻>][,<終了時刻>]]
          [-CTMQueueName <キュー名>[,<キュー名>...]]
          [-CTMMethod <メソッド名>[,<メソッド名>...]]
          [-CTMCsv] [-CTMStdout]
          [<稼働統計情報ファイル名>[ <稼働統計情報ファイル名>...]]

ページの先頭へ

機能

稼働統計情報ファイルに，取得した稼働統計情報を編集して出力します。デフォルトはテキスト形式です。

出力できる情報は次の3種類です。

CTMノード全体でまとめた情報
キュー単位のスケジュールキュー情報
メソッド単位のリクエスト情報

ページの先頭へ

引数

-h

コマンドの使用方法が表示されます。

-CTMEdit <編集出力形式>[,<編集出力形式>...]

編集および出力する稼働統計情報の種類を指定します。

nod：CTMノード全体でまとめた情報を編集および出力します。
que：キュー単位のスケジュールキュー情報を編集および出力します。
mtd：メソッド単位のリクエスト情報を編集および出力します。

省略した場合は，nod，que，mtdのすべてが設定されます。

-CTMInterval <時間間隔>

稼働統計情報を編集および出力する時間の間隔（単位：分）を1〜1440の整数で指定します。ctmstsstartコマンドの-CTMIntervalオプションに指定した時間間隔の整数倍を指定してください。整数倍を指定しない場合は，編集結果が正しく出力されません。

省略した場合は，"10"が設定されます。

-CTMTime [<開始時刻>][,<終了時刻>]

稼働統計情報を編集および出力する範囲を，データの取得時刻で指定します。

時分月日年をhhmm[MMDD[YYYY]]の形式で指定します。月（MM），日（DD），および年（YYYY）を省略すると，現在の年月日が設定されます。

指定できる値の範囲を次の表に示します。

記号	意味	値の範囲	省略の可否
hh	時	00≦hh≦23	省略できません。
mm	分	00≦mm≦59	省略できません。
MM	月	01≦MM≦12	省略できます。
DD	日	01≦DD≦31	省略できます。
YYYY	年	1970≦YYYY	省略できます。

開始時刻を省略した場合は，ファイルの先頭から終了時刻までが出力範囲になります。終了時刻を省略した場合は，開始時刻からファイルの最後までが出力範囲になります。また，開始時刻と終了時刻の両方を省略した場合は，稼働統計情報ファイルのすべての情報が編集，出力されます。

-CTMQueueName <キュー名>[,<キュー名>...]

稼働統計情報を編集および出力するキュー名を1〜63文字の英数字，またはアンダースコア（_）で指定します。

このオプションは，-CTMEditオプションに"que"を指定する場合，または-CTMEditオプションを省略する場合に指定できます。

バッチアプリケーションを実行するシステムでは，キュー名としてスケジュールグループ名を指定してください。

-CTMMethod <メソッド名>[,<メソッド名>...]

稼働統計情報を編集および出力するメソッド名を指定します。

このオプションは，-CTMEditオプションに"mtd"を指定する場合，または-CTMEditオプションを省略する場合に指定できます。

-CTMCsv

編集および出力の結果をCSV形式（コンマで区切ったテキスト形式）で出力します。

-CTMStdout

編集および出力の結果を標準出力に出力します。

表6‒4　引数（コマンドオプション）の組み合わせ一覧（ctmstsedコマンド）
コマンドオプション		-h	-CTMEdit			-CTMInterval	-CTMTime	-CTMQueueName	-CTMMethod	-CTMCsv	-CTMStdout
コマンドオプション		-h	nod	que	mtd	-CTMInterval	-CTMTime	-CTMQueueName	-CTMMethod	-CTMCsv	-CTMStdout
-h		−	△-h	△-h	△-h	△-h	△-h	△-h	△-h	△-h	△-h
-CTMEdit	nod	△-h	−	○	○	○	○	×	×	○	○
	que	△-h	○	−	○	○	○	○	×	○	○
	mtd	△-h	○	○	−	○	○	×	○	○	○
-CTMInterval		△-h	○	○	○	−	○	○	○	○	○
-CTMTime		△-h	○	○	○	○	−	○	○	○	○
-CTMQueueName		△-h	×	○	×	○	○	−	○	○	○
-CTMMethod		△-h	×	×	○	○	○	○	−	○	○
-CTMCsv		△-h	○	○	○	○	○	○	○	−	○
-CTMStdout		△-h	○	○	○	○	○	○	○	○	−

（凡例）

○：同時に指定できます。

△：△のあとに続くオプションが有効になります。

×：同時に指定できません。

−：該当しません。

注

-hオプションとほかのオプションを指定する場合，-hが優先されます。

<稼働統計情報ファイル名>[ <稼働統計情報ファイル名>...]

編集および出力する対象となる稼働統計情報ファイル名を指定します。半角スペースで区切って，最大256個のファイル名を指定できます。省略した場合は，標準入力から入力します。

ページの先頭へ

戻り値

0：: 正常終了しました。
0以外：: コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ページの先頭へ

出力形式

CTMノード全体でまとめた情報を出力する形式（-CTMEditオプションに"nod"を指定）

*** Statistics Information by CTMNode ***
CTMDomain :aa..aa
CTMID     :bb..bb
--------------------------------------------------------------------------------
** Edit time cc..cc − dd..dd **
statistical data : ee..ee − ee..ee
no data       : ff..ff − ff..ff
--------------------------------------------------------------------------------
Event                        Count    Maximum      Minimum     Average (unit)
Request Response Time(Reg)  gg..gg      gg..gg      gg..gg      gg..gg (usec)
Request Time Out(Reg)       hh..hh           -           -           - (count)
Request Error(Reg)          ii..ii           -           -           - (count)
Request Response Time(OTM)  jj..jj      jj..jj      jj..jj      jj..jj (usec)
Request Time Out(OTM)       kk..kk           -           -           - (count)
Request Error(OTM)          ll..ll           -           -           - (count)
Schedule Wait Count         mm..mm      mm..mm      mm..mm      mm..mm (count)
Schedule Wait Time          nn..nn      nn..nn      nn..nn      nn..nn (usec) 
Request Overflow            oo..oo           -           -           - (count)
Regulator down              pp..pp           -           -           - (count)
OTMGateway down             qq..qq           -           -           - (count)
Regulator-Client                 -      rr..rr      rr..rr      rr..rr (count)
OTMGateway-Client                -      ss..ss      ss..ss      ss..ss (count)
CTMDaemon-J2EEServer(Ctr)        -      tt..tt      tt..tt      tt..tt (count)
CTMDaemon-J2EEServer(Req)        -      uu..uu      uu..uu      uu..uu (count)
CTMDaemon-Regulator              -      vv..vv      vv..vv      vv..vv (count)
CTMDaemon-OTMGateway             -      ww..ww      ww..ww      ww..ww (count)

(凡例)

記号	説明
aa..aa	CTMドメイン名称（1〜31文字の英数字）です。
bb..bb	CTM識別子（1〜31文字の英数字）です。
cc..cc	編集開始時間です。
dd..dd	編集終了時間です。
ee..ee	編集時間内の稼働統計情報が取得されている時間帯です。
ff..ff	編集時間内で稼働統計情報が取得されていない時間帯です。
gg..gg	CTMレギュレータのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
hh..hh	CTMレギュレータのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ii..ii	CTMレギュレータのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
jj..jj	OTMゲートウェイのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
kk..kk	OTMゲートウェイのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ll..ll	OTMゲートウェイのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
mm..mm	スケジュール待ち件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
nn..nn	スケジュール待ち時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
oo..oo	スケジュールできなかったリクエスト数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
pp..pp	CTMレギュレータ異常終了の件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
qq..qq	OTMゲートウェイ異常終了の件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
rr..rr	CTMレギュレータとクライアント間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ss..ss	OTMゲートウェイとOTMクライアント間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
tt..tt	CTMデーモンとJ2EEサーバ間の制御用のコネクション件数^※（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
uu..uu	CTMデーモンとJ2EEサーバ間のリクエスト用のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます
vv..vv	CTMデーモンとCTMレギュレータ間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ww..ww	CTMデーモンとOTMゲートウェイ間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

注※

CTMデーモンとJ2EEサーバ（バッチアプリケーションを実行するシステムの場合，バッチサーバ）間制御用のコネクション件数は，J2EEサーバ数およびJ2EEサーバごとに生成しているキュー数の合計をカウントして出力します。

CTMノード全体でまとめた情報をCSV形式で出力する形式（-CTMEditオプションに"nod"を指定し，かつ-CTMCsvオプションを指定）

*** Statistics Information by CTMNode ***
CTMDomain，CTMID，start，end，Event，Count，Maximum，Minimum，Average，unit
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj

（凡例）

記号	説明
aa..aa	CTMドメイン名称（1〜31文字の英数字）です。
bb..bb	CTM識別子（1〜31文字の英数字）です。
cc..cc	編集開始時間です。
dd..dd	編集開始時間です。
ee..ee	イベント内容です。
ff..ff	発生件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
gg..gg	最大値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
hh..hh	最小値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ii..ii	平均値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
jj..jj	単位です。

注

-CTMCsvオプションでは，編集時間内の統計情報データが取得されている時間帯，および編集時間内で稼働統計が取得されていない時間帯は出力されません。

キュー単位のスケジュールキュー情報を出力する形式（-CTMEditオプションに"que"を指定）

*** Statistics Information by Queue ***
CTMDomain :aa..aa
CTMID     :bb..bb
--------------------------------------------------------------------------------
QueueName : cc..cc
--------------------------------------------------------------------------------
** Edit time dd..dd - ee..ee **
statistical data : ff..ff − ff..ff
no data       　: gg..gg − gg..gg
--------------------------------------------------------------------------------
Event                        Count     　Maximum   　 Minimum    Average(unit)
Schedule Wait Count           hh..hh    　hh..hh      hh..hh      hh..hh(count)
Schedule Wait Time            ii..ii      ii..ii      ii..ii      ii..ii(usec) 
Request Overflow              jj..jj           -           -           -(count)
CTMDaemon-J2EEServer(Req)  　　    -      kk..kk       kk..kk     kk..kk(count)

（凡例）

記号	説明
aa..aa	CTMドメイン名称（1〜31文字の英数字）です。
bb..bb	CTM識別子（1〜31文字の英数字）です。
cc..cc	J2EEアプリケーションの場合は，キュー名（1〜63文字）です。バッチアプリケーションの場合は，スケジュールグループ名です。
dd..dd	編集開始時間です。
ee..ee	編集終了時間です。
ff..ff	編集時間内の稼働統計情報が取得されている時間帯です。
gg..gg	編集時間内の稼働統計情報が取得されていない時間帯です。
hh..hh	スケジュール待ち件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ii..ii	スケジュール待ち時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
jj..jj	スケジュールできなかったリクエスト数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
kk..kk	CTMデーモンとJ2EEサーバ間（バッチアプリケーションを実行するシステムの場合はバッチサーバ間）のリクエスト用コネクションの件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

注

QueueName : cc..cc以下は，キュー単位に繰り返し出力されます。

キュー単位のスケジュールキュー情報をCSV形式で出力する形式（-CTMEditオプションに"que"を指定し，かつ-CTMCsvオプションを指定）

*** Statistics Information by CTMQueue ***
CTMDomain，CTMID，start，end，Event，Count，Maximum，Minimum，Average，unit
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
：
：

（凡例）

記号	説明
aa..aa	CTMドメイン名称（1〜31文字の英数字）です。
bb..bb	CTM識別子（1〜31文字の英数字）です。
cc..cc	編集開始時間です。
dd..dd	編集開始時間です。
ee..ee	イベント内容です。
ff..ff	発生件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
gg..gg	最大値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
hh..hh	最小値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ii..ii	平均値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
jj..jj	単位です。

注

メソッド単位のリクエスト情報を出力する形式（-CTMEditオプションに"mtd"を指定）

*** Statistics Information by Method ***
CTMDomain :aa..aa
CTMID     :bb..bb
--------------------------------------------------------------------------------
** Edit time cc..cc - dd..dd **
statistical data : ee..ee − ee..ee
no data       : ff..ff − ff..ff
--------------------------------------------------------------------------------
Interface    : gg..gg
Method　     : hh..hh
--------------------------------------------------------------------------------
Event                        Count     Maximum     Minimum     Average (unit)
Request Response Time(Reg)  ii..ii      ii..ii      ii..ii      ii..ii (usec)
Request Time Out(Reg)       jj..jj           -           -           - (count)
Request Error(Reg)          kk..kk           -           -           - (count)
Request Response Time(OTM)  ll..ll      ll..ll      ll..ll      ll..ll (usec)
Request Time Out(OTM)       mm..mm           -           -           - (count)
Request Error(OTM)          nn..nn           -           -           - (count)

（凡例）

記号	説明
aa..aa	CTMドメイン名称（1〜31文字の英数字）です。
bb..bb	CTM識別子（1〜31文字の英数字）です。
cc..cc	編集開始時間です。
dd..dd	編集終了時間です。
ee..ee	編集時間内の稼働統計情報が取得されている時間帯です。
ff..ff	編集時間内の稼働統計情報が取得されている時間帯です。
gg..gg	インタフェース名（1〜31文字の英数字）です。31文字を超える場合は，"先頭から15文字" + "*" + "最後から15文字"の形式で出力されます。
hh..hh	メソッド名（1〜31文字の英数字）です。31文字を超える場合は，"先頭から15文字" + "*" + "最後から15文字"の形式で出力されます。
ii..ii	CTMレギュレータのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
jj..jj	CTMレギュレータのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
kk..kk	CTMレギュレータのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ll..ll	OTMゲートウェイのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
mm..mm	OTMゲートウェイのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
nn..nn	OTMゲートウェイのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

注

Interface以下の情報が，J2EEサーバのメソッド単位に繰り返し出力されます。

メソッド単位のリクエスト情報をCSV形式で出力する形式（-CTMEditオプションに"mtd"を指定し，かつ-CTMCsvオプションを指定）

*** Statistics Information by Method ***
CTMDomain，CTMID，start，end，Event，Count，Maximum，Minimum，Average，unit
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
：

（凡例）

記号	説明
aa..aa	CTMドメイン名称（1〜31文字の英数字）です。
bb..bb	CTM識別子（1〜31文字の英数字）です。
cc..cc	編集開始時間です。
dd..dd	編集開始時間です。
ee..ee	イベント内容です。
ff..ff	発生件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
gg..gg	最大値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
hh..hh	最小値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
ii..ii	平均値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。
jj..jj	単位です。

注

-CTMCsvオプションでは，編集時間内の統計情報データが取得されている時間帯，および編集時間内で稼働統計が取得されていない時間帯は出力されません。バッチアプリケーションを実行するシステムの場合，メソッド単位のリクエスト情報は無効です。

ページの先頭へ