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
nod
que
mtd
-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
○
○
○
○
○
○
○
○
−
- <稼働統計情報ファイル名>[ <稼働統計情報ファイル名>...]
-
編集および出力する対象となる稼働統計情報ファイル名を指定します。半角スペースで区切って,最大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
単位です。
- 注
-
-CTMCsvオプションでは,編集時間内の統計情報データが取得されている時間帯,および編集時間内で稼働統計が取得されていない時間帯は出力されません。
-
メソッド単位のリクエスト情報を出力する形式(-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オプションでは,編集時間内の統計情報データが取得されている時間帯,および編集時間内で稼働統計が取得されていない時間帯は出力されません。バッチアプリケーションを実行するシステムの場合,メソッド単位のリクエスト情報は無効です。