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.
Log output function |
Log file name |
---|---|
Script execution control |
SPTXE_process-ID.log |
NetExec command execution control |
SPTXNETX_process-ID.log |
Script service |
SPTHSV_process-ID.log |
Script Launcher |
SPTHLNCH_process-ID.log |
Script Launcher service |
SPTHLSV_process-ID.log |
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\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
-
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.