Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference

jim_log.bat (Windows only)

Function

This is a tool for collecting data in the event of a failure in JP1/IM - Manager or JP1/IM - View. The data collected by this tool includes maintenance information for JP1/IM - Manager, JP1/IM - View, and JP1/Base, system information from the OS, and integrated trace logs.

This tool is a batch file, which cannot be customized by the user.

When you execute this tool, the target folders or files used for data collection are classified into primary and secondary data categories and the collected data is stored directly under the specified data storage folder.

The primary data is collected for such purposes as identifying a failure and investigating the causes of minor failures. It consists of the minimum amount of logs and settings files. The secondary data provides the detailed information needed for an in-depth investigation of a failure. It consists of such data as the Windows event log, a crash dump, and the JP1/Base event database.

If you execute jim_log.bat while a thread dump of JP1/IM - Manager (JP1/IM - Central Console) or JP1/IM - View is available, the tool displays the KAVB8946-I message asking whether the thread dump is to be deleted. If you enter y, the tool deletes the thread dump.

If necessary, use a program such as a compression tool to compress the collected data.

For details about the data that can be collected by this tool, see 9.3 Data that needs to be collected when a problem occurs in the Job Management Partner 1/Integrated Management - Manager Administration Guide.

The following tables show the organization of folders directly under the data storage folder and the data that is stored.

Table 1-18 Organization of the internal folders for the primary data of the physical host

Folder name	Stored data
data-storage-folder\jp1_default\imm_1st\imm	Data storage folder for JP1/IM - Manager JP1/IM - Manager patch information
data-storage-folder\jp1_default\imm_1st\imm\conf	JP1/IM - Manager settings and definition files
data-storage-folder\jp1_default\imm_1st\imm\log	Log files for JP1/IM - Manager
data-storage-folder\jp1_default\imm_1st\cons	Data storage folder for JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\jp1_default\imm_1st\cons\conf	JP1/IM - Manager (JP1/IM - Central Console) settings and definition files
data-storage-folder\jp1_default\imm_1st\cons\default	Common definition information for JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\jp1_default\imm_1st\cons\log	Log files for JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\jp1_default\imm_1st\scope	Data storage folder for JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\jp1_default\imm_1st\scope\conf	JP1/IM - Manager (JP1/IM - Central Scope) settings and definition files
data-storage-folder\jp1_default\imm_1st\scope\default	Common definition information for JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\jp1_default\imm_1st\scope\log	Log files for JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\jp1_default\imm_1st\coview	Data storage folder for JP1/IM - View JP1/IM - View patch information
data-storage-folder\jp1_default\imm_1st\coview\conf	JP1/IM - View settings and definition files
data-storage-folder\jp1_default\imm_1st\coview\default	Common definition information for JP1/IM - View
data-storage-folder\jp1_default\imm_1st\coview\log	Log files for JP1/IM - View
data-storage-folder\jp1_default\imm_1st\imm\Patchlog_jp1imm.txt	JP1/IM - Manager patch information
data-storage-folder\jp1_default\imm_1st\imm\conf\tools	JP1/IM - Manager settings and definition files
data-storage-folder\jp1_default\imm_1st\imcf\conf\imcf	IM Configuration Management settings and definition files
data-storage-folder\jp1_default\imm_1st\imdb\conf\imdb	IM database settings and definition files
data-storage-folder\jp1_default\imm_1st\imcf\system\default\new\imcf	Common definition information for IM Configuration Management
data-storage-folder\jp1_default\imm_1st\imdb\database\imdb	Detailed log information for the IM database
data-storage-folder\jp1_default\imm_1st\imcf\log\imcf	Log files for IM Configuration Management
data-storage-folder\jp1_default\imm_1st\imdb\log\imdb	Log files for the IM database
data-storage-folder\jp1_default\imm_1st\base	Data storage folder for JP1/Base JP1/Base patch information
data-storage-folder\jp1_default\imm_1st\base\conf	JP1/Base settings and definition files
data-storage-folder\jp1_default\imm_1st\base\default	Common definition information for JP1/Base
data-storage-folder\jp1_default\imm_1st\base\log	Log files for JP1/Base
data-storage-folder\jp1_default\imm_1st\base\plugin\conf	Settings file for JP1/Base plug-in services
data-storage-folder\jp1_default\imm_1st\base\sys\tmp	Logs and temporary files for JP1/Base
data-storage-folder\jp1_default\imm_1st\oslog	OS log information
data-storage-folder\jp1_default\imm_1st\spool	Integrated trace logs

Table 1-19 Organization of the internal folders for the secondary data of the physical host

Folder name	Stored data
data-storage-folder\jp1_default\imm_2nd\cons	Data storage folder for JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\jp1_default\imm_2nd\cons\operation\evgen	Correlation event generation history files for JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\jp1_default\imm_2nd\scope	Data storage folder for JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\jp1_default\imm_2nd\scope\database	Database information for JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\jp1_default\imm_2nd\base	Data storage folder for JP1/Base
data-storage-folder\jp1_default\imm_2nd\base\log\COMMAND	Command execution log files for JP1/Base
data-storage-folder\jp1_default\imm_2nd\base\sys\event\servers\default	Event database for JP1/Base
data-storage-folder\jp1_default\imm_2nd\oslog	Windows event log Crash dump
data-storage-folder\jp1_default\imm_2nd\imcf\data\imcf	Data files for IM Configuration Management
data-storage-folder\jp1_default\imm_2nd\imdb\database\imdb\imdbbackup.dat	Backup files of the IM database

Table 1-20 Organization of the internal folders for the primary data of the logical host

Folder name	Stored data
data-storage-folder\logical-host-name\imm_1st\cons	Data storage folder for the logical host of JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\logical-host-name\imm_1st\cons\conf	Logical host settings and definition files for JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\logical-host-name\imm_1st\cons\log	Log files for the logical host of JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\logical-host-name\imm_1st\scope	Data storage folder for the logical host of JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\logical-host-name\imm_1st\scope\conf	Logical host settings and definition files for JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\logical-host-name\imm_1st\scope\log	Log files for the logical host of JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\logical-host-name\imm_1st\base	Data storage folder for the logical host of JP1/Base
data-storage-folder\logical-host-name\imm_1st\base\conf	Logical host name settings and definition files for JP1/Base
data-storage-folder\logical-host-name\imm_1st\base\event	Event server settings for the logical host of JP1/Base
data-storage-folder\logical-host-name\imm_1st\base\log	Log files for the logical host of JP1/Base
data-storage-folder\logical-host-name\imm_1st\oslog	OS log information
data-storage-folder\logical-host-name\imm_1st\imm\Patchlog_jp1imm.txt	JP1/IM - Manager patch information
data-storage-folder\logical-host-name\imm_1st\imcf\conf\imcf	IM Configuration Management settings and definition files
data-storage-folder\logical-host-name\imm_1st\imdb\database\imdb	Detailed log information for the IM database
data-storage-folder\logical-host-name\imm_1st\imcf\log\imcf	Log files for IM Configuration Management
data-storage-folder\logical-host-name\imm_1st\imdb\log\imdb	Log files for the IM database

Table 1-21 Organization of the internal folders for the secondary data of the logical host

Folder name	Stored data
data-storage-folder\logical-host-name\imm_2nd\cons	Data storage folder for the logical host of JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\logical-host-name\imm_2nd\cons\operation\evgen	Correlation event generation history file for the logical host of JP1/IM - Manager (JP1/IM - Central Console)
data-storage-folder\logical-host-name\imm_2nd\scope	Data storage folder for the logical host of JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\logical-host-name\imm_2nd\scope\database	Database information for the logical host of JP1/IM - Manager (JP1/IM - Central Scope)
data-storage-folder\logical-host-name\imm_2nd\base	Data storage folder for the logical host of JP1/Base
data-storage-folder\logical-host-name\imm_2nd\base\log\COMMAND	Command execution log files for the logical host of JP1/Base
data-storage-folder\logical-host-name\imm_2nd\base\event	Event database for the logical host of JP1/Base
data-storage-folder\logical-host-name\imm_2nd\imcf\data\imcf	Data files for IM Configuration Management
data-storage-folder\logical-host-name\imm_2nd\imdb\database\imdb\imdbbackup.dat	Backup files of the IM database

Format

jim_log.bat -f data-storage-folder
            [-h logical-host-name]
            [-t]
            [-u]
            [-n]
            [-p]
            [-r]
            [-g]
            [-s]
            [-c]
            [-d]
            [-x]
            [-w]
            [-q]

Execution permission

In Windows Server 2003: None

In Windows Server 2008: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)

In UNIX: None

Storage directory

Manager-path\tools\

Arguments

-f data-storage-folder

Specifies the name of the folder to which the collected data is to be output, expressed as a full path or a path relative to the location where the command is executed. If the path contains a space, enclose the entire path in double-quotation marks ("). This option is mandatory.

If a nonexistent folder is specified, a new folder with the specified name is created. If an existing folder is specified, the contents of that existing folder are deleted and the specified folder is created.

-h logical-host-name

When you are operating in a cluster system, this option specifies a logical host name and that the command is to collect data for that logical host as well as for the physical host. If this option is omitted, the command collects data for the physical host only. If you are not using a cluster system, there is no need to specify this option.

Note that this command will not use the logical host name that is set in the JP1_HOSTNAME environment variable. Therefore, if you use this command in a cluster system, make sure that you specify the logical host name in this option.

-t

Specifies that the hosts and services files are not to be collected.

-u

Specifies that a crash dump is not to be collected. This option is not supported by the Windows Server 2008 version of JP1/IM - View.

-n

Specifies that maintenance data for JP1/Base is not to be collected.

-p

Specifies that the event database for JP1/Base is not to be collected.

-r

Specifies that the command execution log files for JP1/Base are not to be collected.

-g

Specifies that the correlation event generation history file is not to be collected.

-s

Specifies that maintenance data for JP1/IM - Manager (JP1/IM - Central Scope) is not to be collected.

-c

Specifies that maintenance data for IM Configuration Management is not to be collected.

-d

Specifies that maintenance data for the IM database is not to be collected.

-x

Specifies that IM database backup files are to be collected.

The IM database backup files are not included in the maintenance data for the IM database that is collected by default. If the IM database service is not running, the maintenance data is not collected; in such a case, start the IM database service and then re-execute the data collection command. The backup files can be collected even when JP1/IM - Manager is running.

-w

Specifies that maintenance data for JP1/IM - View is not to be collected.

-q

Specifies that the command is to be executed without requesting confirmation from the user.

Notes

• It is possible that this tool will collect a vast amount of data. Before you execute this tool, you must estimate the amount of disk space required and then check the available capacity in your machine. For details, see 9.4 Collecting data in the Job Management Partner 1/Integrated Management - Manager Administration Guide.
• Do not execute this tool more than once.
• If a file to be collected is not found, the tool might display a message such as The file was not found. However, it is not necessary to take any action.

Return values

0	Normal termination
8	Abnormal termination

Example 1

Collect data for the physical host and for logical host hostA into the D:\temp folder:

jim_log.bat -f D:\temp -h hostA

The output result is as follows:

KAVB8925-I The directory does not exist. ("D:\temp\jp1_default\imm_1st")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("D:\temp\jp1_default\imm_2nd")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("D:\temp\hostA\imm_1st")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("D:\temp\hostA\imm_2nd")
           The directory will be created.
Press any key to continue...
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - Manager will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Manager has been acquired.
KAVB8921-I The information for JP1/IM - Central Console will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/IM - Central Console has been acquired.
KAVB8921-I The information for JP1/IM - Central Scope will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/IM - Central Scope has been acquired.
KAVB8921-I The information for JP1/Base will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8921-I The logical host (hostA) information will be acquired.
KAVB8922-I The logical host (hostA) information has been acquired.
KAVB8922-I The information for JP1/Base has been acquired.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetMsInfo.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log file has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.

Example 2

Collect data for the physical host into the nonexistent folder D:\temp, but do not specify the existing logical host (hostA):

jim_log.bat -f D:\temp

The output result is as follows:

KAVB8925-I The directory does not exist. ("D:\temp")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("D:\temp\jp1_default\imm_1st")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("D:\temp\jp1_default\imm_2nd")
           The directory will be created.
Press any key to continue...
KAVB8926-I Data acquisition processing will start.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetConfInfo.exe" command will start.
KAVB8921-I The information for JP1/IM - Manager will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Manager has been acquired.
KAVB8921-I The information for JP1/IM - Central Console will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Central Console has been acquired.
KAVB8921-I The information for JP1/IM - Central Scope will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/IM - Central Scope has been acquired.
KAVB8921-I The information for JP1/Base will be acquired.
KAVB8921-I The physical host information will be acquired.
KAVB8922-I The physical host information has been acquired.
KAVB8922-I The information for JP1/Base has been acquired.
KAVB8921-I The information for JP1/IM - View will be acquired.
KAVB8922-I The information for JP1/IM - View has been acquired.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetConfInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8929-I The system information will be acquired. Please wait.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetMsInfo.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetMsInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I The system information has been acquired.
KAVB8929-I "Watson log and crash dump" will be acquired. Please wait.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetWtsnInfo.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetWtsnInfo.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I "Watson log and crash dump" has been acquired.
KAVB8921-I Windows Eventlog(Application) will be acquired.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(Application) has been acquired.
KAVB8921-I Windows Eventlog(System) will be acquired.
KAVB8927-I Execution of the "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" command will start.
KAVB8928-I "D:\Program Files\Hitachi\JP1IMM\bin\jimGetEvLog.exe" execution is ended. (ERRORLEVEL=0)
KAVB8922-I Windows Eventlog(System) has been acquired.
KAVB8921-I The setup.ini of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ini of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - Manager will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - Manager has been acquired.
KAVB8921-I The setup.ini of JP1/IM - View will be acquired.
KAVB8922-I The setup.ini of JP1/IM - View has been acquired.
KAVB8921-I The setup.ilg of JP1/IM - View will be acquired.
KAVB8922-I The setup.ilg of JP1/IM - View has been acquired.
KAVB8921-I The setup.ini of JP1/Base will be acquired.
KAVB8922-I The setup.ini of JP1/Base has been acquired.
KAVB8921-I The setup.ilg of JP1/Base will be acquired.
KAVB8922-I The setup.ilg of JP1/Base has been acquired.
KAVB8921-I The integrated trace log will be acquired.
KAVB8922-I The integrated trace log has been acquired.
KAVB8921-I The integrated installer log will be acquired.
KAVB8922-I The integrated installer log has been acquired.
KAVB8921-I The installer log file will be acquired.
KAVB8922-I The installer log file has been acquired.
KAVB8921-I The hosts will be acquired.
KAVB8922-I The hosts has been acquired.
KAVB8921-I The services will be acquired.
KAVB8922-I The services has been acquired.
KAVB8921-I The registry information will be acquired.
KAVB8922-I The registry information has been acquired.
KAVB8921-I The netstat information will be acquired.
KAVB8922-I The netstat information has been acquired.
KAVB8921-I The ipconfig information will be acquired.
KAVB8922-I The ipconfig information has been acquired.
KAVB8921-I The net start information will be acquired.
KAVB8922-I The net start information has been acquired.
KAVB8921-I The set information will be acquired.
KAVB8922-I The set information has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8934-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.bat -f output-directory-name -h logical-hostname".
Press any key to continue...

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.