Systemwalker Operation Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

16.3.1.1 sw_TcOpenTrace (トレースファイルオープンコマンド)

◆機能説明

トレースファイルをオープンし、トレース採取のための初期処理を行います。スクリプトの実行トレース採取を開始する場合は、本コマンドが最初に呼び出されなければなりません。

◆記述形式

sw_TcOpenTrace 【-size fsize】【-level tlevel】
【-mode group|other】 filename

◆オプション

-size fsize

fsizeにトレースファイル1ファイルあたりの最大サイズを1〜100000[KB]で指定します。省略時のデフォルト値は、50KBです。

トレース採取は、2つのファイルが作成されサイクリックに採取されるため、ファイルサイズの最大値の見積もりはここで指定するサイズの2倍になります。

-level tlevel

tlevelにトレースレベルを0〜2で指定します。省略時のデフォルト値は、1です。以下にレベルごとの採取内容と推奨例を示します。

0：	それ以降のsw_TcWriteTraceコマンドは無効となりトレースは採取されません。
1：	それ以降のsw_TcWriteTraceでトレースレベル1のものだけが採取されます。 例：実運用時にも採取する情報の出力に使用 　　・起動時や処理結果など動作ログとして残す情報の出力 　　・異常を検知した場合の詳細情報など、エラーログとして残す情報の出力
2：	それ以降のsw_TcWriteTraceでトレースレベル1と2のものが採取されます。 例：動作確認テスト時やデバッグ時に採取する情報の出力に使用 　　・処理分岐点や外部プログラム起動の前後など、スクリプトのルートチェックとして残す情報の出力 　　・読み込みファイルの内容やループ処理内での変数値など、スクリプト内情報として残す情報の出力

-mode group|other

作成するトレースファイルの書き込みモードを指定します。省略時は、所有者のみに書き込み許可属性を設定します。本オプションは、Windows上では無視されます。

group

所有者およびグループに書き込み許可属性を設定します。

other

所有者、グループおよびその他に書き込み許可属性を設定します。

filename

トレースファイル名を指定します。パス指定なしでファイル名のみ指定した場合はデフォルトのトレース格納ディレクトリへ採取され、パス指定をした場合はそのパスに従って採取されます。

Windows上のファイル名の場合は、ディレクトリの区切りを“\”(円記号)の他に“/”(スラッシュ)で記述することが可能です。円記号を使用する場合は、エスケープ文字に扱われないようファイル名全体を“{}”(中括弧)で囲む必要があります。

トレースは、デフォルトで以下のディレクトリに格納されます。

【Windows版】

Systemwalker Operation Managerインストールディレクトリ
\MpWalker.JM\mpfwtco\trc

【UNIX版】

/var/opt/FJSVfwtco/trc

トレースファイルが作成されるディレクトリは、Systemwalkerスクリプトを実行するユーザが更新権を持つディレクトリにしてください。

トレースは、2つのファイルが作成されそれらに対してサイクリックに採取していきます。そのため、実際のファイル名は、ここで指定するファイル名の後ろに“#1.txt”または“#2.txt”が付加された名前となります。

例えば、{c:\tmp\trc}と指定した場合、c:\tmp配下にtrc#1.txtとtrc#2.txtが作成されます。【Windows版】

“/tmp/trc”と指定した場合、/tmp配下にtrc#1.txtとtrc#2.txtが作成されます。【UNIX版】

◆復帰値

正の値：	正常終了。トレースコマンドで使用するハンドル
-9：	メモリ不足
-15：	コード変換エラー
-17：	ファイルオープンエラー

◆参照

sw_TcCloseTrace

◆実行環境による差異

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

◆使用例

【Windows版】

ファイルc:\var\tmp\usrtrcをトレースファイルに指定してトレースをオープンし、ハンドルを変数hwndに格納します。

set hwnd [sw_TcOpenTrace {c:\var\tmp\usrtrc}]

【UNIX版】

ファイル/var/tmp/usrtrcをトレースファイルに指定してトレースをオープンし、ハンドルを変数hwndに格納します。

set hwnd [sw_TcOpenTrace /var/tmp/usrtrc]

◆実行結果／出力形式

なし