jss_log.bat (collects data)
- Organization of this page
Description
This command collects data if a failure occurs in JP1/IM - Service Support. The data to be collected includes the maintenance data of JP1/IM - Service Support and the system information of the OS.
When you execute this command, the target folders and files (from which data is collected) are divided into two categories, primary data and secondary data. Two folders, jp1_default\imss_1st folder and jp1_default\imss_2nd folder, are automatically created under the data storage folder you specify. Then the target folders and files are stored in these two folders.
Use a compression tool to compress the collected data if necessary.
For details about the data you can collect by using this command, see 14.3 Data that must be collected when a problem occurs.
Table 11-4 and Table 11-5 describe the folders under the data storage folder, and the data to be stored.
Folder name |
Data to be stored |
---|---|
data-storage-folder\jp1_default\imss_1st\conf\ |
Environment settings file of JP1/IM - Service Support |
data-storage-folder\jp1_default\imss_1st\tools\ |
Command environment settings file of JP1/IM - Service Support |
data-storage-folder\jp1_default\imss_1st\log\ |
Log file of JP1/IM - Service Support |
data-storage-folder\jp1_default\imss_1st\dbms\ |
Settings and log data of the Item management database and Item storage database#1 |
data-storage-folder\jp1_default\imss_1st\uCPSB\ |
Settings and log data of the Web server and the WWW container server |
data-storage-folder\jp1_default\imss_1st\oslog\ |
System information of the OS |
data-storage-folder\jp1_default\imss_1st\hntr\ |
Integrated trace log data |
data-storage-folder\jp1_default\imss_1st\work\ |
Setup information file of uCosminexus |
data-storage-folder\logical_host\imss_1st\ |
Settings and log data of the cluster environment #2 |
- #1
-
Settings and log data of the Item storage database are collected only when JP1/IM - Service Support Advanced Edition is used.
- #2
-
This data is collected only when a cluster environment is used.
Folder name |
Data to be stored |
---|---|
data-storage-folder\jp1_default\imss_2nd\dbms\ |
Detailed log data of the Item management database and Item storage database# |
data-storage-folder\jp1_default\imss_2nd\oslog\ |
Dr. Watson log data |
data-storage-folder\jp1_default\imss_2nd\uCPSB\ |
Log data of uCosminexus |
- #
-
Settings and log data of the Item storage database are collected only when JP1/IM - Service Support Advanced Edition is used.
Format
jss_log.bat -f data-storage-folder-name [-t] [-u] [-q]
Required execution permission
Administrator permissions
Storage folder
IM-SS-path\tools\
Arguments
-f data-storage-folder-name
Specifies the name of the folder that stores the collected data using the absolute path or a relative path from the location where this command is executed. If the path contains a blank, enclose it between double quotation marks (").
If you specify a non-existent folder, a new folder is created with the specified name.
If you specify an existing folder, the folder is deleted and then re-created. Do not specify the name of a folder that contains files you do not want to delete.
-t
Specify this argument if you do not want to collect the following:
-
Host names assigned to the machines (data-storage-folder\jp1_default\imss_1st\oslog\hosts)
-
Settings of the service ports (data-storage-folder\jp1_default\imss_1st\oslog\services)
-u
Specify this argument if you do not want to collect crash dumps.
-q
Specify this argument if you want to continue collecting data without displaying a confirmation message. If you do not specify the -q option, the system displays a message to ask whether to continue collecting data.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end |
Remarks
-
If you use Ctrl+C to cancel the jss_log.bat command while the command is being executed, some data might fail to be collected. For this reason, do not cancel the command during execution by using Ctrl+C. If you happen to do so, wait for a while and then re-execute the command.
-
If the OS is Windows Server 2012 or Windows Server 2008, Dr. Watson does not exist. For this reason, a KNAB22102-W message appears when you execute the jss_log.bat command. If this occurs, manually collect user dumps in place of the Dr. Watson log.
-
If the OS is Windows Server 2012 or Windows Server 2008, while the jss_log.bat command is executed, a dialog box appears asking whether to update system information. Do not click the Cancel button. If you do, some information about the OS might fail to be collected. When a dialog box appears indicating that system information is being updated, do not worry. Actually, information about the OS is being collected, not updated.
-
If you specify drive-letter: in the -f option, the following problems might occur. Do not specify drive-letter: in the -f option to avoid these problems.
-
Data is stored in an illegal location.
-
Some data fails to be collected.
-
Example
The following example shows how to output collected data to the c:\log folder except for the host names assigned to the machines and the settings of the service ports.
jss_log.bat -f c:\log -t