Job Management Partner 1/Performance Management - Agent Option for Platform Description, User's Guide and Reference
- Organization of this subsection
- (1) Collecting dump information (in Windows Server 2008)
- (2) Executing the data collection command
- (3) Obtaining the Windows event log
- (4) Checking the operation details
- (5) Collecting the error information on the window
- (6) Collecting other information
(1) Collecting dump information (in Windows Server 2008)
To collect dump information in a Windows Server 2008 environment:
- Open Task Manager.
- Select the process tab.
- Right-click the process name for which you want to collect dump information, and then select Create Dump File.
Dump files are stored in the following folder:
system-drive\Users\user-name\AppData\Local\Temp- Obtain the dump file from the folder created in step 3.
If you have changed the environment variable settings so that dump files are output to a different folder, obtain the dump file from that folder.
(2) Executing the data collection command
To collect data for investigating the cause of the error, you use the jpcras command. The procedure for executing the data collection command is described below. Note that the operations explained here must be executed by a user who has the Administrators permission as an OS user.
To collect data:
- Log onto the host on which the service whose data is to be collected is installed.
- At the command prompt, execute the following command and enable the command extended function of the command interpreter.
cmd /E:ON- Specify the data to be collected and the folder for storing it, and execute the jpcras command.
In the example shown below, all information that can be collected using the jpcras command is stored in the folder c:\tmp\jpc\agt.
jpcras c:\tmp\jpc\agt all allWhen the jpcras command is executed, the jpctool service list -id * -host * (jpcctrl list * host=*) command is executed internally to obtain a list of PFM services and to confirm whether the services are running. Execution of this internal command might take a long time if a firewall exists between the host that executes the command and a host in another Performance Management system or if the system configuration is large. In either case, you can set the JPC_COLCTRLNOHOST environment variable to 1 to suppress processing of the jpctool service list -id * -host * (jpcctrl list * host=*) command to shorten the command execution time.
For details about the jpcras command, see the chapter explaining commands in the manual Job Management Partner 1/Performance Management Reference.
- Note on executing the command in a Windows Server 2008 environment
- If the user account control functionality (UAC) is enabled in the operating system, the User Account Control dialog box might be displayed during command execution. If it is displayed, click the Continue button to continue data collection, or click the Cancel button to cancel data collection.
(3) Obtaining the Windows event log
In the Event Viewer window, output the Windows event log to a file.
(4) Checking the operation details
Check the operation that was taking place when the error occurred and record it. You need to check the following information:
- Operation details
- Time at which the error occurred
- Machine configuration (including each OS version, host name, and the configurations of PFM - Manager and PFM - Agent)
- Whether the error can be reproduced
- Performance Management user name used for logon if the user logged on from PFM - Web Console
(5) Collecting the error information on the window
Collect hard copies of the following items:
- Hard copy of the window operation if an application error occurred
- Hard copy of the error message dialog box
If detailed information is available, also copy its content.
- Hard copy of the Command Prompt window or Administrator Console window if a problem occurred during command execution
To obtain a hard copy of the Command Prompt window or Administrator Console window in Windows Server 2003 or Windows Server 2008, specify the following in the Command Prompt Properties window:
- Edit Options under the Options tab
Select Quick Edit Mode.
- Layout tab
Set Height under Screen Buffer Size to 500.
(6) Collecting other information
- Information to be collected for all operating systems
- If the error occurred during command execution, the argument specified for the command
- Contents of the dialog box displayed by choosing Accessories, System Tools, and then System Information
- In Windows Server 2003
- Contents of System and Application in the Windows Event Viewer window
- In Windows Server 2008
- Contents of System and Application under Windows Logs in the left pane of the Windows Event Viewer window
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.