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

jcoview_log.bat (Windows only)

Function

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

This tool constitutes 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 a specified data storage folder.

The primary data, which consists of a minimum amount of logs and settings files, is collected for purposes such as identifying failures and investigating minor errors. The secondary data consists of the Windows event log and crash dump, and provides the detailed information needed to investigate failures in depth.

If you execute jcoview_log.bat during a thread dump of JP1/IM - View, 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, compress the collected data by using a program such as a compression tool.

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 the folders directly under the data storage folder and the details of the data that is stored.

Table 1-16 Organization of the internal folders for the primary data

Folder name Stored data

data-storage-folder\jp1_default\imm_1st\coview 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\oslog OS log information^#

data-storage-folder\jp1_default\imm_1st\spool Integrated trace logs

#

If JP1/IM - Manager and JP1/Base are installed on the same machine, data for JP1/IM - Manager and JP1/Base is also collected.

Table 1-17 Organization of the internal folders for the secondary data

Folder name Stored data

data-storage-folder\jp1_default\imm_2nd\oslog

Windows event log

Crash dump^#

#

Crash dumps are not collected in the case of the Windows Vista and Windows Server 2008 versions of JP1/IM - View.

Folder name	Stored data
data-storage-folder\jp1_default\imm_1st\coview	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\oslog	OS log information^#
data-storage-folder\jp1_default\imm_1st\spool	Integrated trace logs

Folder name	Stored data
data-storage-folder\jp1_default\imm_2nd\oslog	Windows event log Crash dump^#

Format

jcoview_log.bat -f data-storage-folder
               [-t]
               [-u]
               [-q]

Execution permission

None

Storage directory

View-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 that name is created. If an existing folder is specified, the contents of that folder are deleted and then the specified folder is created.

-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 Vista and Windows Server 2008 versions of JP1/IM - View.

-q

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

Notes

If you wish to collect JP1/IM - View data at the same host as for JP1/IM - Manager, use the jim_log.bat command.

Do not execute this tool more than once. If it is executed multiple times, collected data may be overwritten or data collection may fail.

If a file to be collected cannot be found, the tool may display a message such as The file was not found; however, no action is necessary.

Return values

0 Normal termination

8 Abnormal termination

Example

Collect data in the F:\tmp\bat folder:

jcoview_log.bat -f F:\tmp\bat

The output results are as follows:

KAVB8925-I The directory does not exist. ("F:\tmp\bat")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("F:\tmp\bat\jp1_default\imm_1st")
           The directory will be created.
Press any key to continue...
KAVB8925-I The directory does not exist. ("F:\tmp\bat\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 - 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/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 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 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 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.

[Contents][Back][Next]

[Trademarks]