jbs_log.bat (Windows only)
- Organization of this page
Function
The jbs_log.bat command is a tool for collecting data if an error occurs in JP1/Base. The command collects data such as JP1/Base maintenance information, system information output by the OS, and integrated trace logs.
This tool is a batch file. It cannot be customized.
Executing this tool creates a jp1_default folder in the specified data folder. If you specify the -h option, in addition to the jp1_default folder, a folder with the name of the logical host is created. Two further folders, base_1st and base_2nd are created in each of these folders, and the data collected by jbs_log.bat is copied under them. If necessary, you can compress the collected data by using an archiving tool. The following table shows the folder organization and the files stored in each directory.
|
Command folder |
Collected data |
|---|---|
|
data-folder\jp1_default\base_1st\conf\ |
Settings and definition files |
|
data-folder\jp1_default\base_1st\log\ |
Log file |
|
data-folder\jp1_default\base_1st\allusers\jp1_default\JP1Base\log |
Log file |
|
data-folder\jp1_default\base_1st\allusers\logical-host-name\JP1Base\log |
Log file |
|
data-folder\jp1_default\base_1st\sys\ |
OS system information |
|
data-folder\jp1_default\base_1st\sys\tmp\event\ |
Event server settings |
|
data-folder\jp1_default\base_1st\sys\OPI |
Information on the operation of services |
|
data-folder\jp1_default\base_1st\default\ |
Common definition information |
|
data-folder\jp1_default\base_1st\plugin\conf\ |
Plug-in service settings file |
|
data-folder\jp1_default\base_1st\spool\ |
Integrated trace logs (32bit) |
|
data-folder\jp1_default\base_1st\spoolx64\ |
Integrated trace logs (64bit) |
|
data-folder\jp1_default\base_2nd\log\Command\ |
Command execution log files |
|
data-folder\jp1_default\base_2nd\sys\ |
Event database |
|
data-folder\logical-host-name\base_1st\conf\ |
Settings and definition files for the logical host (if applicable) |
|
data-folder\logical-host-name\base_1st\log\ |
Log data for the logical host (if applicable) |
|
data-folder\logical-host-name\base_1st\event\ |
Event server settings for the logical host (if applicable) |
|
data-folder\logical-host-name\base_1st\sys\OPI |
Information on the operation of services for the logical host |
|
data-folder\logical-host-name\base_2nd\sys\ |
Command execution log files for the logical host (if applicable) |
|
data-folder\logical-host-name\base_2nd\event\ |
Event database for the logical host (if applicable) |
For details on the types of data that you can collect with this tool, see 18.3 Data that must be collected when a problem occurs.
Format
jbs_log.bat [-h logical-host-name]
[data-folder]
[-r]
[-t]
[-u]
[-p]
[-q]
Required execution permission
None. (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
Command directory
installation-folder\tools\
Arguments
-h logical-host-name
Specify the logical host if you are using JP1/Base in a cluster system. When this option is specified, the command collects information about the physical hosts and logical host. If you omit this option, the command collects information about the physical hosts only. There is no need to specify this argument unless you are running a cluster system.
You must specify the logical host name in this option if you use JP1/Base on a cluster system. You cannot use the environment variable JP1_HOSTNAME.
data-folder
Specify the folder to which you want to output the collected data, by full path or by relative path from the current directory in which you are executing the command. If the path contains a space, enclose the space in double quotation marks ("). However, you cannot specify a path that contains Japanese characters as the storage directory.
If you specify a non-existing folder, a new folder will be created with that name.
If the specified folder already exists, it will be deleted and recreated. Do not specify the name of a folder containing files you want to keep. Furthermore, do not specify a folder on a network drive.
If you omit this option, the jp1log folder under the folder specified in the environment variable TEMP is assumed. As the TEMP setting differs according to the OS and user, check the setting by clicking System in the Control Panel.
-r
Specify this option if you do not want to collect command execution logs (ISAM).
-t
Specify this option if you do not want to collect data in the hosts and services files.
-u
Specify this option if you do not want to collect crash dumps.
-p
Specify this option if you do not want to collect data in the event database.
-q
Specify this option if you do not want the system to wait for your response about whether a data collection process will continue.
When the -q option is omitted, a confirmation message appears and your response is waited.
Notes
-
When collecting data from the event server, if the names of the directories accessed by the event server are changed to full path in the event server index file, you cannot collect data from the altered event server directories. If an error occurs, in addition to gathering data, use the data collection tool to collect all the directories specified in the event server index file as information for investigating the problem.
-
Do not run multiple data collection tools concurrently.
-
The data collection tool may take 10 minutes or longer to run. Do not forcibly terminate the data collection tool if it does not end promptly.
-
When a data collection tool is executed, the system information may not be collected even though the tool has completed execution. This problem occurs because the process that collects OS information internally had not ended when the data collection tool completed execution.
Open the Task Manager and in the Processes page make sure that msinfo32.exe has ended before you archive the data using a compression tool, or move, delete, or otherwise operate on the data.
-
If the output directory for the integrated trace log is changed, you cannot collect data from the changed output directory for the integrated trace log. If an error occurs, in addition to collecting data, collect all the data from the changed output directory for the integrated trace log in order to investigate the problem.
Return values
|
0 |
Normal end |
|
8 |
Abnormal end
|