Systemwalker Centric Manager API・スクリプトガイド

6.3.22 sw_TcWriteTrace（トレース情報の出力をする）

機能説明

トレースファイルにトレース情報を出力します。

記述形式

sw_TcWriteTrace 【-level tlevel】 thandle text

オプション

-level tlevel

tlevelにトレースレベル1または2を指定します。省略値は、1です。

thandle

sw_TcOpenTraceで取得したハンドルを指定します。空文字列“”を指定した場合は、トレースの採取はされません。

text

トレースファイルに出力する任意の文字列を900バイト以内で指定します。900バイトを超える文字列は、900バイトで切り捨てられます。

復帰値

TCOK：	正常終了
TCERR_WRITE：	ファイル書き込みエラー
TCERR_CODECONV：	コード変換エラー

参照

sw_TcOpenTrace（トレースファイルをオープンする）

実行環境による差異

OSやエディションによる差異はなし。

使用例

変数hwndにsw_TcOpenTraceの復帰値が格納されている場合、文字列“File open error”をhwndが示すトレースファイルに書きます。

sw_TcWriteTrace $hwnd "File open error"

実行結果/出力形式

トレースファイルの出力形式を以下に示します。

Mon Apr  4 10:37:00 2005    18879 File open error

各項目について、以下に説明します。

第1項目 : 時刻

出力時の時刻が“曜日 月 日 時:分:秒 年”の形式で出力されます。

第2項目 : プロセスID

SystemwalkerスクリプトのプロセスIDが出力されます。

第3項目 : 文字列

sw_TcWriteTrace で指定した文字列が出力されます。