Hitachi

JP1 Version 12 JP1/SNMP System Observer Description, Operator's Guide and Reference


jp1apmlog.bat (Windows only)

Organization of this page

Format

jp1apmlog.bat [-d Output-destination-directory-name]

Function

The jp1apmlog.bat command collects data for an error investigation upon occurrence of an error in APM. This command is provided by APM running in a Windows system.

By default, this command outputs data under %TEMP%\jp1log. If previously collected data is present in this location, the data is all deleted when the command outputs new data. The directory to which collected data is to be output can be specified by using an option. For the output destination directory for the files, priority is placed on the output destination specified by using an option instead of the default output destination and the edited output destination.

Option

-d Output-destination-directory-name

Used to specify the output destination for the file created by this command. For the directory name, you cannot use spaces, double quotation marks ("), asterisks (*), vertical bars (|), angle brackets (< >), question marks (?), commas (,), backslashes (\), equal signs (=), or hash marks (#).

Customize

This command is a batch file. You can customize the following items, if necessary:

If you want to change the default output destination

Edit the output file name in the following line:

set OUTDIR=%TEMP%\jp1log

If the installation path for APM is different from the standard installation path

Edit the installation path in the following line:

set INST_DIR_EA=%SystemDrive%\win32app\HITACHI\cm2

If the output destination of the Watson log is any location other than C:\Documents and Settings\Administrator\Local Settings\Application Data\Microsoft\Dr Watson

Edit the output destination in the following line:

set LOG_DIR_DRWTSN=C:\Documents and Settings\Administrator\Local Settings\Application Data\Microsoft\Dr Watson

Collected data list

The following table lists and describes the data for an error investigation to be collected:

Classification

Collection condition

Acquired data

Main Information

Common

An environment configuration chart (OS, IP address, No. of interfaces, and the product configuration and version of each terminal)#1

A memo about how an error occurred (details about the occurrence date/time, OS, host name, IP address, performed operations, and symptoms)#1

Event log file#1

Process list window in Task Manager#1

Registry information

(Under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\)#1

System information#1

OS information

Common

Collected files

%SystemRoot%\system32\driver\etc folder (a hosts file, services file, and so on)

drwtsn32.log (when applicable)

user.dmp (when applicable)

Command execution results

hostname

set

netstat -a

netstat -an

netstat -ano

netstat -r

net start

ipconfig /all

Registry information

Registry information

(Under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\)

(Under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\)

(Under HKEY_LOCAL_MACHINE\SOFTWARE\HITACHI\)

(Under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\Perflib\)

a problem report and a user dump#2

APM information

Common

Collected files

Files under the installation-directory\log folder

Files under the installation-directory\conf folder

Files under the installation-directory\sockets folder

installation-directory\readme\apm\Version.txt

installation-directory\readme\apm\ProductInfo.txt

Log files of the Hitachi Integrated Installer

Command execution results

apmproclist

apmcheck

apmservlist -all

A list of folders and files under the installation directory

dir /s installation-directory

#1:

Collected manually

#2:

In Windows Server 2008 and Windows Server 2012, the data collection tool can't collect drwtsn32.log and user.dmp because Dr. Watson log file doesn't exist. Therefore, collect the following information manually.

  1. If a daemon process stopped by an application error, collect a problem report.

  2. If a command process stopped by an application error, collect a user dump.

How to collect a problem repot:

  1. In the Run text box, enter wercon and click OK.

  2. On the left pane, click Show Problem History.

  3. Double-click the applicable problem.

    Details of the problem report are displayed.

  4. Choose Copy to Clipboard.

    A new window will be displayed. collect the information that is displayed in the window.

How to collect a user dump:

When the error dialog box is displayed, use the following procedure. Do not close the error dialog box.

  1. Start Task Manager.

  2. Click the Processes tab from the task manager dialog box.

  3. Right-click the name of the process that was stopped by an application error, and then choose Create Dump File.

    When a dialog box showing the user dump output destination path opens, collect a dump from there.

Return values

0

Data collection is completed.

1

At least a part of data collection failed.

2

The user who executed the command does not belong to the Administrators group.

3

System error

4

An inappropriate output destination directory path was specified.

Notes