mcfstats

名称

MCF稼働統計情報の出力

形式

mcfstats 〔-k 出力種別〕 〔-u 出力対象〕 〔-o 出力ファイル名〕
        〔-f 出力ファイルサイズ〕 〔-s 時間間隔〕 〔-t 出力回数〕 〔-r〕

機能

指定した時間間隔で,MCF稼働統計情報をファイルに出力します。

-rオプションを指定した場合は,MCF稼働統計情報の出力を終了します。

オプション

●-k 出力種別  ~《all》

出力する種別を指定します。

all:すべての統計情報を出力します。

in:受信メッセージに関する統計情報を出力します。

out:送信メッセージに関する統計情報を出力します。

cn:コネクション処理待ちに関する統計情報を出力します。

●-u 出力対象

出力の対象となるサービスグループ名,論理端末名称,またはMCF通信プロセス識別子を指定します。

-kオプションの指定によって,次の項目を指定します。

-kオプションでin,out,cnを指定した場合,このオプションは必ず指定してください。allを指定した場合,このオプションの指定は無効となります。

サービスグループ名,論理端末名称,MCF通信プロセス識別子は複数指定できません。

出力対象は,*を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の項目を混在して指定できません。一括指定の場合,出力対象を引用符(")で囲みます。

〈一括指定の例〉abcで始まるすべてのサービスグループを指定する場合
-u "abc*"

●-o 出力ファイル名  ~〈1~35文字のパス名〉《mcfstc》

出力ファイル名を指定します。ファイル名だけを指定した場合,$DCDIR/spool下にファイルが作成されます。絶対パス名で指定した場合,指定したディレクトリ下にファイルが作成されます。ただし,ディレクトリは作成しません。また,すでに存在するファイル名は指定できません。

このオプション省略時は,$DCDIR/spool/mcfstcに出力します。

●-f 出力ファイルサイズ  ~〈符号なし整数〉((1~1000))《10》(単位:メガバイト)

MCF稼働統計情報を出力するファイルのサイズをメガバイト単位で指定します。ファイルサイズは次に示す算出式で算出します。

サービスグループの場合:↑(64+A)×出力回数/(1024×1024)↑

論理端末の場合:↑(64+B)×出力回数/(1024×1024)↑

MCF通信プロセスの場合:↑(64+C)×出力回数/(1024×1024)↑

すべての場合:(64+(A+B+C))×出力回数/(1024×1024)

(凡例)
↑↑:小数点以下を切り上げます。
A:96×サービスグループ総数
B:64×4×論理端末総数
C:64×MCF通信プロセス総数
この算出式は,-uオプションで"*"指定をした場合の最大値を仮定しています。

指定されたファイルサイズを超えた場合は,統計情報の出力を終了します。

●-s 時間間隔  ~〈符号なし整数〉((1~43200))《60》(単位:秒)

MCF稼働統計情報をファイルに出力する時間間隔を,秒単位で指定します。

指定を省略した場合は,60秒間隔で出力します。

●-t 出力回数  ~〈符号なし整数〉((1~65535))(単位:回)

出力回数を指定します。

指定を省略した場合はmcfstats -rが実行されるまで,MCFが停止するまで,または-fオプションで指定したファイルサイズを超えるまで出力します。指定した回数出力すると終了します。

また,-fオプションで指定したファイルサイズを超えた場合は,指定した出力回数に満たなくてもMCF稼働統計情報の出力を終了します。

●-r

MCF稼働統計情報の出力を終了します。

このオプションを指定すると,ほかのオプションは無効となります。

出力メッセージ

メッセージID内容出力先
KFCA19700-E内部関数処理中に障害が発生しました標準出力,メッセージログファイル
KFCA19701-W共用メモリが不足しているため,MCF稼働統計情報の取得ができません標準エラー出力,メッセージログファイル
KFCA19702-IMCF稼働統計情報のファイル出力を開始しました標準出力,メッセージログファイル
KFCA19703-IMCF稼働統計情報のファイル出力を終了しました標準出力,メッセージログファイル
KFCA19704-WMCF稼働統計情報の取得を開始していません標準エラー出力
KFCA19705-WMCF稼働統計情報の出力を開始していません標準エラー出力
KFCA19706-Iファイルサイズを超えたためMCF稼働統計情報のファイル出力を終了します標準出力,メッセージログファイル
KFCA19707-EMCF稼働統計情報のファイル出力処理中に障害が発生しました標準エラー出力,メッセージログファイル
KFCA19708-WMCF稼働統計情報のファイル出力を開始しているため,コマンドは受け付けられません標準エラー出力
KFCA19709-W指定されたファイルはすでに存在します標準エラー出力
KFCA19710-EMCF稼働統計情報のファイル出力準備に失敗しました標準エラー出力
KFCA19711-Eファイルのオープンに失敗しました標準エラー出力

注意事項