D. Maintenance Log Files

A maintenance log file is output if an error occurs when a Windows function is called in a JP1/Script.

If an error occurs and you cannot determine the cause of the error by referring to the trace file, log file, or event log, acquire the maintenance log file and then contact the support center.

The following table lists the functions that output maintenance log files, and the log file names.

If maintenance log files are repeatedly output by a single process, the output log file size might exceed the maximum allowable size. If the log file size exceeds the maximum, the name of the oldest log file will change to XXXX_process-ID.n.log (where n is a serial number) the next time a maintenance log file is output. Then, a new XXXX_process-ID.log file is created.

The following describes how to specify output of maintenance log files.

Registry key

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Hitachi\JP1/Script\Option\Maintenance

When the setting takes effect

• For Script execution control, the next time the script file is executed

• For NetExec command execution control, the next time the script file is executed

• For the JP1/Script service, the next time the JP1/Script service is started

• For Script Launcher, the next time Script Launcher is started

• For the Script Launcher service, the next time the Script Launcher service is started

  Table D‒2: Values that can be set for registry keys

  Function name	Value name	Value datatype	Value
  Script execution control	SptExec_Log_Dir	REG_SZ	Output folder path#1 Initial value: Default maintenance log file output folder#2
  	SptExec_Log_Size	REG_DWORD	Maximum file size (bytes) 1,024 to 2,147,483,647 Initial value: 32,768
  	SptExec_Log_Num	REG_DWORD	Maximum number of files 0 to 1,024 Initial value: 20
  NetExec command execution control	SptNetExec_Log_Dir	REG_SZ	Output folder path#1 Initial value: Default Maintenance log file output folder#2
  	SptNetExec_Log_Size	REG_DWORD	Maximum file size (bytes) 1,024 to 2,147,483,647 Initial value: 32,768
  	SptNetExec_Log_Num	REG_DWORD	Maximum number of files 0 to 1,024 Initial value: 10
  Script service	Service_Log_Dir	REG_SZ	Output folder path#3 Initial value: Default Maintenance log file output folder#2
  	Service_Log_Size	REG_DWORD	Maximum file size (bytes) 1,024 to 2,147,483,647 Initial value: 524,288
  	Service_Log_Num	REG_DWORD	Maximum number of files 0 to 1,024 Initial value: 2
  Script Launcher	Launcher_Log_Dir	REG_SZ	Output folder path#4 Initial value: Default Maintenance log file output folder#2
  	Launcher_Log_Size	REG_DWORD	Maximum file size (bytes) 1,024 to 2,147,483,647 Initial value: 524,288
  	Launcher_Log_Num	REG_DWORD	Maximum number of files 0 to 1,024 Initial value: 2
  Script Launcher service	LauncSv_Log_Dir	REG_SZ	Output folder path#3 Initial value: Default Maintenance log file output folder#2
  	LauncSv_Log_Size	REG_DWORD	Maximum file size (bytes) 1,024 to 2,147,483,647 Initial value: 524,288
  	LauncSv_Log_Num	REG_DWORD	Maximum number of files 0 to 1,024 Initial value: 2

  #1: Select a folder in which files can be created, deleted, and updated by using the account used for executing files.

  #2: Maintenance log files are output to the following folder by default:

  system-drive\ProgramData\Hitachi\Script\Log\Maintenance

  #3: Select a folder in which files can be created, deleted, and updated by using a local system account.

  #4: Select a folder in which files can be created, deleted, and updated by using the account used for starting files.

Generally, use the initial values of the maximum size of a maintenance log file and maximum number of maintenance log files. Maintenance log files might be output even for minor errors. Therefore, depending on the contents of a script, a maintenance log file might be created or updated even if the system is running normally. In such a case, change the number of maintenance log files for script execution control or for the NetExec command. When changing the values, use the number of scripts that can be executed concurrently as a guideline.

If a version of JP1/Script earlier than 10-00 is used with a script that ignores errors and executes the next process, upgrading JP1/Script to 10-00 might degrade execution performance due to output of maintenance log files. If such performance degradation occurs, specify 0 for the maximum number of maintenance log files for script execution control. This will suppress output of maintenance log files.

To Page Top