Interstage Shunsaku Data Manager アプリケーション開発ガイド - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX共通 -

8.1.6 C APIの関数情報

アプリケーションから呼び出された関数の情報は、アプリケーションからの呼出し時、復帰時、および関数の実行でエラーが発生したときに出力されます。

■出力形式

APIスナップは、CSV形式で出力します。

以下に、出力レベルごとの出力形式を説明します。

◆レベル1

関数呼出し時

アプリケーション名,コネクションハンドルID,スレッドID,日付,時間,Call,関数名

関数復帰時

アプリケーション名,コネクションハンドルID,スレッドID,日付,時間,Return,関数名,関数実行時間,復帰値,,性能情報

エラー復帰時

アプリケーション名,コネクションハンドルID,スレッドID,日付,時間,Error,関数名,関数実行時間,復帰値,エラー詳細文字列,性能情報

◆レベル2

関数呼出し時

アプリケーション名,コネクションハンドルID,スレッドID,日付,時間,Call,関数名,,,入力パラメタ情報

関数復帰時

アプリケーション名,コネクションハンドルID,スレッドID,日付,時間,Return,関数名,関数実行時間,復帰値,出力パラメタ情報,性能情報

エラー復帰時

アプリケーション名,コネクションハンドルID,スレッドID,日付,時間,Error,関数名,関数実行時間,復帰値,エラー詳細文字列,性能情報

■出力内容

以下に出力される項目と内容を説明します。

[表: C APIの関数情報の出力内容の一致]

出力項目	内容	出力レベル
		レベル1	レベル2
アプリケーション名	呼出し元アプリケーションの名前を表示します。	○	○
コネクションハンドルID	コネクションハンドルのIDを出力します。 コネクションハンドルの割当て時にShunAllocHandle関数が返す値です。	○	○
スレッドID	スレッドIDを出力します。	○	○
日付	関数呼出しの開始/終了の日付を“年/月/日”の形式で出力します。	○	○
時間	関数呼出しの開始/終了の時間を“時:分:秒.ミリ秒”の形式で出力します。	○	○
Call Return Error	“Call”：関数呼出し時の情報であることを示します。 “Return”：関数復帰時の情報であることを示します。 “Error”：関数の実行時にエラーが発生したことを示します。	○	○
関数名	呼び出されたC APIの関数名を出力します。	○	○
関数実行時間	関数呼出しから復帰までにかかった時間を出力します。単位は秒です。	○	○
復帰値	復帰値を出力します。 “SHUN_SUCCESS”：関数が正常に終了したことを示します。 “SHUN_ERROR”：関数の実行時に問題が検出されたことを示します。	○	○
エラー詳細文字列	関数呼出しでエラーが発生した場合の詳細文字列を出力します。 詳細文字列が含まれていない場合は、本項目は出力しません。	○	○
入力パラメタ情報	関数呼出し時の入力パラメタ情報（パラメタの型、値）を以下の形式で出力します。 (パラメタの型)値 入力パラメタがない場合は、本項目は出力されません。	×	○
出力パラメタ情報	関数復帰時の出力パラメタ情報（パラメタの型、値）を以下の形式で出力します。 (パラメタの型)値 出力パラメタがない場合は、本項目は出力されません。	×	○
性能情報	性能ログに出力されている依頼番号（conductorで採番する8バイトの番号）を出力します。(注)	○	○

○：出力される項目
×：出力されない項目

注) 性能ログの出力内容については、“導入・運用ガイド”の“性能ログの出力情報”を参照してください。

■出力例

スナップに出力する情報は、C APIが動作するプラットフォームの文字コードで出力します。

以下に、出力例を出力レベルごとに示します。

◆レベル1

正常終了時

"sample_hit_count",9449912,2820,"2006/10/22","11:58:10.380","Call","ShunConnect"
"sample_hit_count",9449912,2820,"2006/10/22","11:58:10.380","Return","ShunConnect",0.015,"SHUN_SUCCESS",,"42d234c100000100"

異常終了時

"sample_hit_count",9449912,3540,"2006/10/22","14:34:37.270","Call","ShunConnect"
"sample_hit_count",9449912,3540,"2006/10/22","14:34:38.286","Error","ShunConnect",1.016,
"SHUN_ERROR","shn30654u:Either the director or the conductor has not been started, or the port number is incorrect. <ShunConnect>",

◆レベル2

正常終了時

"sample_hit_count",9449912,3116,"2006/10/22","11:58:19.661","Call","ShunConnect",,,"(SHUNHCON)3554328[00363C18] (char*)DirSvr1 (int)33101 (char*)shunsakuFile1"
"sample_hit_count",9449912,3116,"2006/10/22","11:58:19.661","Return","ShunConnect",0.015,"SHUN_SUCCESS","","42d234c100000100"

異常終了時

"sample_hit_count",9449912,3540,"2006/10/22","14:34:37.270","Call","ShunConnect",,,
"(SHUNHCON)3427440[00344C70] (char*) localhost (int)10007 (char*)file1"
"sample_hit_count",9449912,3540,"2006/10/22","14:34:38.286","Error","ShunConnect",1.016,
"SHUN_ERROR","shn30654u:Either the director or the conductor has not been started, or the port number is incorrect. <ShunConnect>",

• 文字列項目は二重引用符(")で囲みます。
• 数値項目は二重引用符(")で囲みません。

採取したログファイルは、コネクションハンドルIDでフィルタを掛けることにより、コネクションごとの操作を時系列でトレースすることが可能です。