Job Management Partner 1/Automatic Job Management System 3 for Enterprise Applications Description, User's Guide and Reference

8.2.2 Data to be collected about the InfoPackage control function or the process chain control function

If a problem occurs while you are using the InfoPackage control function or the process chain control function, collect the data described below.

Organization of this subsection

(1) When Windows is used

(2) When UNIX is used

(1) When Windows is used

Collect the following data as maintenance information.

(a) OS log information

Table 8-7 OS log information (for Windows)

Type of information to be collected Procedure

Windows event log Obtain the application log and the system log collected by Windows for the period of time during which the problem occurred (contents of System Log and Application Log in the Event Viewer window of Windows).

System information Collect the system information managed by Windows (choose Accessories and then System Tools, and collect the contents of System Information).

Dump information (Watson log file) If an application error occurs during execution of a custom job for the SAP BW system or a command provided by JP1/AJS3 for EAP:
Collect the following log file (*.log) and dump file (*.dump):

For Windows Server 2003

User specified folder^#\drwtsn32.log

User specified folder^#\user.dump

For Windows Server 2008

Dr. Watson has been changed to Problem report and solutions.

Collect the following problem report and user dump.

(1) Problem report

If the JP1/AJS3 for EAP process stops due to an application error, use the following procedure to collect the problem report.

1. In the Specify a file name and execute text box, enter wercon and click the OK button.

The Problem report and solutions dialog box opens.

2. On the left side area, click View Problem History.

The problem history is displayed in list form.

3. Double-click the relevant problem.

Details of the problem report appear.

4. Select Copy to clipboard.

5. Copy and save the copied content to a text file.

6. The saved problem report is collected as data for problem investigation.

(2) User dump

If the JP1/AJS3 for EAP process stops due to an application error and an error dialog box appears, use the following procedure to collect the problem report.

Note

Collect the problem report while the error dialog box is displayed.

1. Start Task Manager.

2. From the Task Manager dialog box, click Process.

3. Right-click the JP1/AJS3 for EAP process name that stopped due to an application error, and then select Create dump file.

4. When a dialog box appears asking you to specify the path to the user dump output destination, collect data from there.

#

By default, system-drive\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson.

(b) Information to be collected from JP1/AJS3 for EAP (InfoPackage control or process chain control)

Table 8-8 Information to be collected from JP1/AJS3 for EAP (InfoPackage control or process chain control) (for Windows)

Type of information to be collected Procedure

Trace information Collect the following files:

When a file name is specified for the TargetFile key in the trace section in the conf file:

File specified by the TargetFile key

If no file name is specified for the TargetFile key in the trace section in the conf file:

Files in installation-folder\bwsta\log

In addition to the above files, collect all the files in the following folders regardless of the conf file setting:
Files in installation-folder\log
Files in Windows-folder\Temp\jp1common\jp1amr3

Standard error output information If a command provided by JP1/AJS3 for EAP ends abnormally:
Obtain the error message text that is output to the standard error output.

Standard error output

When a command is executed from the command line:

File specified in the window where the command is executed or file specified by the -se option

When a command is executed by JP1/AJS:

File defined as the standard error output by JP1/AJS, file defined as the standard error output by a JP1/AJS custom job, or file specified in the -se option of the command

Model, version, and patch information Collect the following version and patchlog.txt files:
installation-folder\system\version
installation-folder\system\patchlog.txt

Environment setup file Collect the following conf file:
installation-folder\bwsta\conf\conf

RFC trace file If an error occurs during the execution of a custom job for the SAP BW system or a command of JP1/AJS3 for EAP:
Collect the file named dev_rfc.trc containing the trace information about the communication with the SAP BW system. This file is created in the work directory of JP1/AJS3 for EAP.

RFC library status management file Collect the following jr3chrfc file:
installation-folder\system\jr3chrfc

Product information file Collect the following files:

For an x86 OS:

system-drive\Program Files\Hitachi\jp1common\jp1amr3\jp1amr3.dat

For an x64 OS:

system-drive\Program Files (x86)\Hitachi\jp1common\jp1amr3\jp1amr3.dat

(c) Information to be collected from the SAP BW system

Table 8-9 Information to be collected from the SAP BW system (for Windows)

Type of information to be collected Procedure

System log Run transaction SM21 via the SAP front-end software to collect the data matching the following criteria:

User: Not specified

Transaction code: Not specified

SAP process: Not specified

Error class: All messages

Starting and ending dates and times: Period during which the target error occurred

For details about the system log, see the SAP BW documentation and the online help.

Release and patch information

Start the SAP front-end software and choose System and then Status from the menu. Obtain a hard copy of the displayed window.

Obtain hard copies of the following windows that can opened from the above window:
System: Status window
System: Component Information window
System: Kernel Information window

Execution result of InfoPackage (for InfoPackage control) If an error occurs during the execution of a custom job for the SAP BW system or InfoPackage using the jbwipsta command:
Run transaction RSA1 via the SAP front-end software and display the monitor window. Obtain the execution result of the InfoPackage with the problem (header, status, contents of the Details page) from the window.

Execution result of a process chain (for process chain control) If an error occurs during the execution of a custom job for the SAP BW system or a process chain using the jbwipsta command:
Run transaction RSPC via the SAP front-end software and display the log view. Obtain the execution result of the process chain and the execution logs of the process with the problem (process log (contents of the Process page) and the job log of the process (contents of the Backg page)).

Developer trace If an error occurs during the execution of a custom job for the SAP BW system or a command provided by JP1/AJS3 for EAP:
Obtain the developer trace in the SAP BW system (dev_w*, dec_rfc*, and dev_rd files that are collected by running transaction ST11 via the SAP front-end software).

(d) Operational details

Check the following information about the operation that was being performed when the problem occurred:

Detailed contents of the operation

Time when the problem occurred

Job in which the problem occurred (jobnet name and job name in JP1/AJS, InfoPackage ID, process chain ID)

Machine configuration (version of each OS, host name, and the configuration of JP1/AJS and the SAP BW system)

Whether the problem is reproducible, how often the problem occurs

Type of information to be collected	Procedure
Windows event log	Obtain the application log and the system log collected by Windows for the period of time during which the problem occurred (contents of System Log and Application Log in the Event Viewer window of Windows).
System information	Collect the system information managed by Windows (choose Accessories and then System Tools, and collect the contents of System Information).
Dump information (Watson log file)	If an application error occurs during execution of a custom job for the SAP BW system or a command provided by JP1/AJS3 for EAP: Collect the following log file (.log) and dump file (.dump): For Windows Server 2003 User specified folder^#\drwtsn32.log User specified folder^#\user.dump For Windows Server 2008 Dr. Watson has been changed to Problem report and solutions. Collect the following problem report and user dump. (1) Problem report If the JP1/AJS3 for EAP process stops due to an application error, use the following procedure to collect the problem report. 1. In the Specify a file name and execute text box, enter wercon and click the OK button. The Problem report and solutions dialog box opens. 2. On the left side area, click View Problem History. The problem history is displayed in list form. 3. Double-click the relevant problem. Details of the problem report appear. 4. Select Copy to clipboard. 5. Copy and save the copied content to a text file. 6. The saved problem report is collected as data for problem investigation. (2) User dump If the JP1/AJS3 for EAP process stops due to an application error and an error dialog box appears, use the following procedure to collect the problem report. Note Collect the problem report while the error dialog box is displayed. 1. Start Task Manager. 2. From the Task Manager dialog box, click Process. 3. Right-click the JP1/AJS3 for EAP process name that stopped due to an application error, and then select Create dump file. 4. When a dialog box appears asking you to specify the path to the user dump output destination, collect data from there.

Type of information to be collected	Procedure
Trace information	Collect the following files: When a file name is specified for the TargetFile key in the trace section in the conf file: File specified by the TargetFile key If no file name is specified for the TargetFile key in the trace section in the conf file: Files in installation-folder\bwsta\log In addition to the above files, collect all the files in the following folders regardless of the conf file setting: Files in installation-folder\log Files in Windows-folder\Temp\jp1common\jp1amr3
Standard error output information	If a command provided by JP1/AJS3 for EAP ends abnormally: Obtain the error message text that is output to the standard error output. Standard error output When a command is executed from the command line: File specified in the window where the command is executed or file specified by the -se option When a command is executed by JP1/AJS: File defined as the standard error output by JP1/AJS, file defined as the standard error output by a JP1/AJS custom job, or file specified in the -se option of the command
Model, version, and patch information	Collect the following version and patchlog.txt files: installation-folder\system\version installation-folder\system\patchlog.txt
Environment setup file	Collect the following conf file: installation-folder\bwsta\conf\conf
RFC trace file	If an error occurs during the execution of a custom job for the SAP BW system or a command of JP1/AJS3 for EAP: Collect the file named dev_rfc.trc containing the trace information about the communication with the SAP BW system. This file is created in the work directory of JP1/AJS3 for EAP.
RFC library status management file	Collect the following jr3chrfc file: installation-folder\system\jr3chrfc
Product information file	Collect the following files: For an x86 OS: system-drive\Program Files\Hitachi\jp1common\jp1amr3\jp1amr3.dat For an x64 OS: system-drive\Program Files (x86)\Hitachi\jp1common\jp1amr3\jp1amr3.dat

Type of information to be collected	Procedure
System log	Run transaction SM21 via the SAP front-end software to collect the data matching the following criteria: User: Not specified Transaction code: Not specified SAP process: Not specified Error class: All messages Starting and ending dates and times: Period during which the target error occurred For details about the system log, see the SAP BW documentation and the online help.
Release and patch information	Start the SAP front-end software and choose System and then Status from the menu. Obtain a hard copy of the displayed window. Obtain hard copies of the following windows that can opened from the above window: System: Status window System: Component Information window System: Kernel Information window
Execution result of InfoPackage (for InfoPackage control)	If an error occurs during the execution of a custom job for the SAP BW system or InfoPackage using the jbwipsta command: Run transaction RSA1 via the SAP front-end software and display the monitor window. Obtain the execution result of the InfoPackage with the problem (header, status, contents of the Details page) from the window.
Execution result of a process chain (for process chain control)	If an error occurs during the execution of a custom job for the SAP BW system or a process chain using the jbwipsta command: Run transaction RSPC via the SAP front-end software and display the log view. Obtain the execution result of the process chain and the execution logs of the process with the problem (process log (contents of the Process page) and the job log of the process (contents of the Backg page)).
Developer trace	If an error occurs during the execution of a custom job for the SAP BW system or a command provided by JP1/AJS3 for EAP: Obtain the developer trace in the SAP BW system (dev_w, dec_rfc, and dev_rd files that are collected by running transaction ST11 via the SAP front-end software).

(2) When UNIX is used

Collect the following data as maintenance information.

(a) OS log information

Table 8-10 OS log information (for UNIX-based OSs)

Type of information to be collected Procedure

syslog file Obtain the syslog files whose facility includes user in the /etc/syslog.conf file. You only need the part of the system log that covers the period of time during which the problem occurred.

Version information Obtain the execution result of the uname -a command.

Information about the installed Hitachi products Collect the /etc/.hitachi/pplistd/pplistd file.

(b) Information to be collected from JP1/AJS3 for EAP (InfoPackage control or process chain control)

Table 8-11 Information to be collected from JP1/AJS3 for EAP (InfoPackage control or process chain control) (for UNIX-based OSs)

Type of information to be collected Procedure

Trace information Collect the following files:

When a file name is specified for the TargetFile key in the trace section in the conf file:

File specified by the TargetFile key

When no file name is specified for the TargetFile key in the trace section in the conf file:

Files in /var/opt/jp1_am_r3/bwsta/log

In addition to the above files, collect the following file:
/var/opt/jp1_am_r3/log/jr3chrfc.log

Standard error output information If a command provided by JP1/AJS3 for EAP ends abnormally:
Obtain the error message text that is output to the standard error output.

Model, version, and patch information Collect the following .version and .patch_hist files:
/etc/opt/jp1_am_r3/.version
/etc/opt/jp1_am_r3/.patch_hist

Environment setup file Collect the following conf file:
/etc/opt/jp1_am_r3/bwsta/conf/conf

RFC trace file If an error occurs during the execution of a custom job for the SAP BW system or a command of JP1/AJS3 for EAP:
Collect the file named dev_rfc containing the trace information about the communication with the SAP BW system. This file is created in the work directory of JP1/AJS3 for EAP.

RFC library status management file Collect the following .jr3chrfc file:
/etc/opt/jp1_am_r3/.jr3chrfc

(c) Information to be collected from the SAP BW system

Table 8-12 Information to be collected from the SAP BW system (for UNIX-based OSs)

Type of information to be collected Procedure

System log Run transaction SM21 via the SAP front-end software to collect the data matching the following criteria:

User: Not specified

Transaction code: Not specified

SAP process: Not specified

Error class: All messages

Starting and ending dates and times: Period during which the target error occurred

For details about the system log, see the SAP BW documentation and the online help.

Release and patch information

Start the SAP front-end software and choose System and then Status from the menu. Obtain a hard copy of the displayed window.

Obtain hard copies of the following windows that can be opened from the above window:
System: Status window
System: Component Information window
System: Kernel Information window

Execution result of InfoPackage (for InfoPackage control) If an error occurs during the execution of a custom job for the SAP BW system or InfoPackage using the jbwipsta command:
Run transaction RSA1 via the SAP front-end software and display the monitor window. Obtain the execution result of the InfoPackage with the problem (header, status, contents of the Details page) from the window.

Execution result of a process chain (for process chain control) If an error occurs during the execution of a custom job for the SAP BW system or a process chain using the jbwipsta command:
Run transaction RSPC via the SAP front-end software and display the log view. Obtain the execution result of the process chain and the execution logs of the process with the problem (process log (contents of the Process page) and the job log of the process (contents of the Backg page)).

Developer trace If an error occurs during the execution of a custom job for the SAP BW system or a command provided by JP1/AJS3 for EAP:
Obtain the developer trace in the SAP BW system (dev_w*, dec_rfc*, and dev_rd files that are collected by running transaction ST11 via the SAP front-end software).

(d) Operational details

Check the following information about the operation that was being performed when the problem occurred:

Detailed description of the operation

Time when the problem occurred

Job in which the problem occurred (jobnet name and job name in JP1/AJS, InfoPackage ID, process chain ID)

Machine configuration (version of each OS, host name, and the configuration of JP1/AJS and the SAP BW system)

Whether the problem is reproducible, how often the problem occurs

Type of information to be collected	Procedure
syslog file	Obtain the syslog files whose facility includes user in the /etc/syslog.conf file. You only need the part of the system log that covers the period of time during which the problem occurred.
Version information	Obtain the execution result of the uname -a command.
Information about the installed Hitachi products	Collect the /etc/.hitachi/pplistd/pplistd file.

Type of information to be collected	Procedure
Trace information	Collect the following files: When a file name is specified for the TargetFile key in the trace section in the conf file: File specified by the TargetFile key When no file name is specified for the TargetFile key in the trace section in the conf file: Files in /var/opt/jp1_am_r3/bwsta/log In addition to the above files, collect the following file: /var/opt/jp1_am_r3/log/jr3chrfc.log
Standard error output information	If a command provided by JP1/AJS3 for EAP ends abnormally: Obtain the error message text that is output to the standard error output.
Model, version, and patch information	Collect the following .version and .patch_hist files: /etc/opt/jp1_am_r3/.version /etc/opt/jp1_am_r3/.patch_hist
Environment setup file	Collect the following conf file: /etc/opt/jp1_am_r3/bwsta/conf/conf
RFC trace file	If an error occurs during the execution of a custom job for the SAP BW system or a command of JP1/AJS3 for EAP: Collect the file named dev_rfc containing the trace information about the communication with the SAP BW system. This file is created in the work directory of JP1/AJS3 for EAP.
RFC library status management file	Collect the following .jr3chrfc file: /etc/opt/jp1_am_r3/.jr3chrfc

Type of information to be collected	Procedure
System log	Run transaction SM21 via the SAP front-end software to collect the data matching the following criteria: User: Not specified Transaction code: Not specified SAP process: Not specified Error class: All messages Starting and ending dates and times: Period during which the target error occurred For details about the system log, see the SAP BW documentation and the online help.
Release and patch information	Start the SAP front-end software and choose System and then Status from the menu. Obtain a hard copy of the displayed window. Obtain hard copies of the following windows that can be opened from the above window: System: Status window System: Component Information window System: Kernel Information window
Execution result of InfoPackage (for InfoPackage control)	If an error occurs during the execution of a custom job for the SAP BW system or InfoPackage using the jbwipsta command: Run transaction RSA1 via the SAP front-end software and display the monitor window. Obtain the execution result of the InfoPackage with the problem (header, status, contents of the Details page) from the window.
Execution result of a process chain (for process chain control)	If an error occurs during the execution of a custom job for the SAP BW system or a process chain using the jbwipsta command: Run transaction RSPC via the SAP front-end software and display the log view. Obtain the execution result of the process chain and the execution logs of the process with the problem (process log (contents of the Process page) and the job log of the process (contents of the Backg page)).
Developer trace	If an error occurs during the execution of a custom job for the SAP BW system or a command provided by JP1/AJS3 for EAP: Obtain the developer trace in the SAP BW system (dev_w, dec_rfc, and dev_rd files that are collected by running transaction ST11 via the SAP front-end software).

[Contents][Back][Next]

[Trademarks]