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.
-
If a daemon process stopped by an application error, collect a problem report.
-
If a command process stopped by an application error, collect a user dump.
How to collect a problem repot:
-
In the Run text box, enter wercon and click OK.
-
On the left pane, click Show Problem History.
-
Double-click the applicable problem.
Details of the problem report are displayed.
-
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.
-
Start Task Manager.
-
Click the Processes tab from the task manager dialog box.
-
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
-
Execute this command when the APM process is running. However, do not restart the abnormally terminated APM process when executing this command.
-
Execute this command immediately after an error has occurred, when possible.
-
When the disk becomes full while files are being saved, data cannot be stored correctly. Make sure that the disk has sufficient free space before executing this command.