解析トレースファイルは，コマンドの解析結果を出力するファイルです。対象となるスクリプトが複数起動を許可されているかどうかによって，出力形式が異なります。

(a)　複数起動が許可されていないスクリプトの場合

• ファイル名
  ファイル名（拡張子.SPA）は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。
  
• 出力形式
  解析トレースファイルの出力形式を図A-1に示します。
  

  図A-1　解析トレースファイルの出力形式（複数起動が許可されていないスクリプトの場合）

  

  a．トレース出力を開始した日時，実行したコンピュータ名，実行したユーザ名，およびスクリプトエンジンのバージョンを出力します。

  b．解析時エラーとなった時間を出力します。

  c．解析時エラーとなった行の位置，列の位置を出力します。

  d．解析エラーとなったコマンドを出力します。

  e．解析エラーの内容を出力します。

  f．解析エラーの合計値を出力します。

  g．トレース出力を終了した日時を出力します。

• 行数および列数の範囲
  解析トレースファイルに出力するトレース情報は，行数100〜9,999，列数128〜1,024の範囲で出力できます。
  行数，および列数の出力範囲は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
  なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。
  

(b)　複数起動が許可されているスクリプトの場合

• ファイル名
  ファイル名（拡張子.SPA）は，マネージャの［ツール］−［オプション］の「複数起動」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。
  
• 出力形式
  解析トレースファイルの出力形式を図A-2に示します。
  

  図A-2　解析トレースファイルの出力形式（複数起動が許可されているスクリプトの場合）

  

  a．実行したプロセスのトレース出力を開始した日時，プロセス識別子，開始を意味する「S」，スクリプトエンジンのバージョン，および実行したコンピュータ名と実行したユーザ名を出力します。

  b．解析時エラーとなった時間を出力します。

  c．解析時エラーとなったプロセスのプロセス識別子を出力します。

  d．解析時エラーとなった行の位置，列の位置を出力します。

  e．解析エラーとなったコマンドを出力します。

  f．解析エラーの内容を出力します。

  g．実行したプロセスのトレース出力を終了した日時，プロセス識別子，および終了を意味する「E」を出力します。

  h．解析エラーの合計値を出力します。

• 行数および列数の範囲
  解析トレースファイルに出力するトレース情報は，行数100〜9,999，列数128〜1,024の範囲で出力できます。
  行数，および列数の出力範囲は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
  なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。
  

実行トレースファイルは，スクリプト実行プログラムが，コマンドの実行結果を出力するファイルです。対象となるスクリプトが複数起動を許可されているかどうかによって，出力形式が異なります。

(a)　複数起動が許可されていないスクリプトの場合

• ファイル名
  ファイル名（拡張子.SPX）は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。
  
• 出力形式
  実行トレースファイルの出力形式を図A-3に示します。
  

  図A-3　実行トレースファイルの出力形式（複数起動が許可されていないスクリプトの場合）

  

  a．トレースの出力を開始した日時，および実行したコンピュータ名，実行したユーザ名，およびスクリプトエンジンのバージョンを出力します。

  b．実行時エラーとなった時間を出力します。

  c．エラーとなったときに出力します。

  d．実行時エラーとなったコマンドの行位置を出力します。

  e．実行エラーのコマンド名を出力します。

  f．エラーの内容を出力します。

  g．実行エラーの合計値を出力します。

  h．トレース出力を終了した日時を出力します。

• 行数および列数の範囲
  実行トレースファイルに出力するトレース情報は，行数100〜9,999，列数128〜1,024の範囲で出力できます。
  行数，および列数の出力範囲は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
  なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。
  

(b)　複数起動が許可されているスクリプトの場合

• ファイル名
  ファイル名（拡張子.SPX）は，マネージャの［ツール］−［オプション］の「複数起動」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。
  
• 出力形式
  実行トレースファイルの出力形式を図A-4に示します。
  

  図A-4　実行トレースファイルの出力形式（複数起動が許可されているスクリプトの場合）

  

  a．実行したプロセスのトレースの出力を開始した日時，プロセス識別子，開始を意味する「S」，およびスクリプトエンジンのバージョン，および実行したコンピュータ名と実行したユーザ名を出力します。

  b．実行時エラーとなった時間を出力します。

  c．実行時エラーとなったプロセスのプロセス識別子を出力します。

  d．エラーとなったときに出力します。

  e．実行時エラーとなったコマンドの行位置を出力します。

  f．実行エラーのコマンド名を出力します。

  g．エラーの内容を出力します。

  h．実行したプロセスのトレース出力を終了した日時，プロセス識別子，および終了を意味する「E」を出力します。

  i．実行エラーの合計値を出力します。

• 行数および列数の範囲
  実行トレースファイルに出力するトレース情報は，行数100〜9,999，列数128〜1,024の範囲で出力できます。
  行数，および列数の出力範囲は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
  なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。
  

ユーザトレースファイルは，Messageコマンドの第一引数にTarget_Fileを指定して出力したファイルです。

(a)　ファイル名

ファイル名（.TXT）は，ユーザが任意で付けられます。

(b)　出力形式

ユーザトレースファイルの出力形式を図A-5に示します。

図A-5　ユーザトレースファイルの出力形式

a．トレース出力した日付と時間を出力します。

b．出力したメッセージです。

(c)　行数および列数の範囲

ユーザトレースファイルに出力するトレース情報は，行数100〜9,999，列数128〜1,024の範囲で出力できます。

行数，および列数の出力範囲は，マネージャの［ファイル］−［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。

なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。

サーバトレースファイルは，クライアントからSetGV，GetGV，DeleteGV，およびNetExecコマンドで呼び出されたサーバがコマンドを実行した結果を出力するファイルです。

(a)　ファイル名

ファイル名は，SPTSVTRC.SPYで固定です。インストール先フォルダの"DATA"フォルダ^※下に作成されます。

注※

Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ\ProgramData\Hitachi\Script\Data）

(b)　出力形式

サーバトレースファイルの出力形式を図A-6に示します。

図A-6　サーバトレースファイルの出力形式

a．サーバでコマンドを実行した日付を出力します。

b．サーバでコマンドの実行を開始した時間を出力します。

c．サーバでコマンドの実行を終了した時間を出力します。

d．サーバで実行したコマンド名を出力します。

e．サーバで実行したコマンドがプロセスを呼び出す場合，2行のトレースを出力します。この1行目と2行目を識別する記号を出力します。

S：1行目のトレース

E：2行目のトレース

f．サーバで実行したコマンドがプロセスを呼び出す場合，プロセス識別子を出力します。

g．サーバで実行したコマンドの実行結果を出力します。

OK：正常

ER：実行エラー（括弧内の数値は，エラー詳細コード）

h．クライアントのコンピュータ名を出力します（""で囲まれます）。

i．クライアントのユーザ名を出力します（""で囲まれます）。

j．クライアントで実行したスクリプトファイル名をフルパスで出力します（""で囲まれます）。括弧内の数値は，サーバで実行したコマンドのスクリプトファイル中の行番号です。

k．サーバで実行したコマンドがプロセスを呼び出す場合，プロセスを開始した時間を出力します。

l．サーバで実行したコマンドがプロセスを呼び出す場合，プロセスを終了した時間を出力します。

m．サーバで実行したコマンドがプロセスを呼び出す場合，プロセスの終了コードを出力します（サーバで実行したコマンドの実行結果がOKのときだけ出力されます）。

(c)　行数および列数の範囲

サーバトレースファイルに出力する実行結果は，行数1〜1,000，列数200で，行数，および列数の値は変更できません。なお，出力される実行結果が行数の最大値を超えた場合は，先頭の行に戻って，先頭の行から実行結果が出力されます（すでに出力されている実行結果が上書きされます）。また，列数の最大値を超えた場合は，改行されます。

(d)　出力指定

ユーザは，マネージャの［オプションダイアログ］の［サーバ情報］ページで，サーバトレースファイルの出力の有無を指定できます。

NetExecエラーログファイルは，NetExecコマンド実行時に発生したエラー内容を出力します。障害が発生した際，トレースファイル，ログファイル，およびイベントログを参照しても障害の原因を特定できない場合は，NetExecエラーログファイルを採取してサポートセンターに問い合わせてください。

(a)　ファイル名

• クライアント側
  フォルダ名^※1：インストール先の「LOG」フォルダ^※2に「STXNetExec_Client」というフォルダを作成し，そのフォルダ下。
  ファイル名：「STXNetExec_C_xx.LOG」
  xxは01〜30までの数値。NetExecコマンド実行制御を行うSPTXNetx.exeの1回のプロセス実行に対して，一つのトレースファイルを出力します。
  
• サーバ側
  フォルダ名^※3：インストール先の「LOG」フォルダ^※2に「STXNetExec_Server」というフォルダを作成し，そのフォルダ下。
  ファイル名：「STXNetExec_S_xx.LOG」
  xxは01〜30までの数値。NetExecコマンド実行制御を行うSPTXNetx.exeの1回のプロセス実行に対して，一つのトレースファイルを出力します。
  注※1　JP1/Script 07-00より前のバージョンではインストール先の"Data"フォルダ下に「LOG\STXNetExec_Client」というフォルダを作成し，そのフォルダ下。
  注※2　Windows Vista以降のOSではスクリプトのログファイルフォルダ（システムドライブ\ProgramData\Hitachi\Script\Log）。
  注※3　JP1/Script 07-00より前のバージョンではインストール先の"Data"フォルダ下に「LOG\STXNetExec_Server」というフォルダを作成し，そのフォルダ下。
  

(b)　出力形式

クライアント側エラーログの出力形式を図A-7に，サーバ側エラーログの出力形式を図A-8に示します。

図A-7　クライアント側エラーログの出力形式

図A-8　サーバ側エラーログの出力形式

(c)　ファイル容量

エラーログのファイル容量は，クライアント側，サーバ側のそれぞれで，次のとおりです。

1ファイルのファイル容量上限値：（100バイト／1行）＊100行=約10KB（キロバイト）

ファイル数の上限値： 30ファイル

合計の上限値：約10KB（キロバイト）＊30ファイル=約300KB（キロバイト）

(d)　出力指定

インストーラは次のレジストリを設定し，デフォルトでエラーログを出力します。

〔レジストリキー〕

HKEY_LOCAL_MACHINE\SOFTWARE\Hitachi\JP1/Script\SPTX\Option

〔値名1〕

Net_Trace

〔値のデータタイプ1〕

REG_DWORD

〔値1〕

トレースの出力の有無，および出力レベル

0：トレース出力しない

1：エラートレースだけ出力し，正常終了時はファイルを削除し残さない（初期値）

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

　

〔値名2〕

Net_Trace_Directory

〔値のデータタイプ2〕

REG_SZ

〔値2〕

トレース出力先フォルダ名（初期値：スクリプトのログフォルダ）

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時