Job Management Partner 1/Integrated Management - Event Gateway for Network Node Manager i Description, User's Guide and Reference

2.4.4 Settings for handling errors

JP1/IM - EG for NNMi provides various measures for handling errors in JP1/IM - EG for NNMi, such as a tool for collecting data needed for investigation of errors and a function for automatically restarting the process in the event of an abnormal process termination.

This subsection describes the settings for handling JP1/IM - EG for NNMi errors.

Organization of this subsection

(1) Preparations for collecting data in the event of an error (Windows only)

(2) Settings for restarting after an abnormal process termination

(3) Setting JP1 event issuance in the event of an abnormal process termination

(1) Preparations for collecting data in the event of an error (Windows only)

If an error occurs in Windows, you might need a memory dump and a crash dump in order to determine the cause of the error. To be prepared for such errors, we recommend that you set your system to output these dump files.

If your system is set to output crash dumps, you can use the data collection tool (jegn_log.bat command) to obtain a needed crash dump and Dr. Watson log.

For details about the data to be collected in the event of an error, see 10.3 Data to be collected in the event of an error. For details about the data collection tool (jegn_log.bat command), see jegn_log.bat (Windows only) in 7. Commands.

This subsection describes how to set the system to collect memory dumps and crash dumps.

(a) Memory dump output settings

To specify the settings for output of memory dumps:

From Control Panel, double-click System.

On the Advanced page, in Startup and Recovery, click the Settings button.

In Write debugging information, select Kernel memory dump, and then specify an output file.

Note:

The size of a memory dump depends on the size of the real memory. If the installed physical memory is large, a large amount of space will be required for a memory dump. You must allocate sufficient disk space to collect a memory dump. For details, see the Windows Help topic STOP error.

(b) Crash dump output settings

To specify the settings for output of crash dumps:

From the Start menu, choose Run.

In the text box, enter drwtsn32 and then click the OK button.
The Dr. Watson for Windows dialog box appears.

Select the Create Crash Dump File check box and then specify the output file in the Crash Dump text box.

Click the OK button.

Note:

In addition to JP1 information, error information from other application programs is also output to a crash dump. For this reason, output of a crash dump may require considerable disk space. If you specify the settings for output of crash dumps, make sure that sufficient disk space is available.

(2) Settings for restarting after an abnormal process termination

A process is generated when JP1/IM - EG for NNMi starts. JP1/IM - EG for NNMi enables you to make settings so that the process will restart automatically after it has terminated abnormally for some reason.

To specify the settings for process restart after abnormal termination of the process:
Specify process restart.
Edit the extended startup process definition file (jegn_service_0700.conf). This file is stored at the following locations:

In Windows:

Physical host: EG-for-NNMi-path\conf

Logical host: shared-folder\JP1EG4NNMI\conf

In UNIX:

Physical host: /etc/opt/jp1eg4nnmi/conf

Logical host: shared-directory/jp1eg4nnmi/conf

The relevant parameter is the fourth value of the values separated by the vertical bar (|). Set either 0 (do not restart (default)) or 1 (restart). Do not change any other parameter values.
For details about the extended startup process definition file, see F.1 Extended startup process definition file (jegn_service_0700.conf).

Apply the settings.
Either restart JP1/IM - EG for NNMi or execute the jegn_spmd_reload command to apply the settings. For details about the jegn_spmd_reload command, see jegn_spmd_reload in 7. Commands.
Suppress error notification by Dr. Watson (Windows only).
In the case of Windows, you must specify a setting so that the Dr. Watson dialog box will not be displayed. This is because a process cannot be restarted if the Dr. Watson dialog box is displayed in the event of an application error.
From the Start menu, choose Run, and then execute drwtsn32. When the Dr. Watson dialog box appears, clear the Visual Notification check box.
Note that the Dr. Watson settings are common settings, which means that the setting specified here will apply to programs throughout the entire system.
To enable the Dr. Watson settings, execute the following command at the command prompt:
drwtsn32 -i
Dr. Watson is installed as the default application debugger.
Suppress error reporting to Microsoft (Windows only).
In the case of Windows, you must specify settings so that the Microsoft error reporting dialog box, which is displayed in the event of error detection, will not be displayed. This is because a process cannot restart if this dialog box is displayed.
1. From Control Panel, double-click System.
2. On the Advanced page, click the Error Reporting button.
3. Choose Disable error reporting and make sure that the But notify me when critical errors occur check box is cleared.

(3) Setting JP1 event issuance in the event of an abnormal process termination

JP1/IM - EG for NNMi enables you to issue JP1 events in the event of automatic recovery from a process error or abnormal termination. By issuing JP1 events, you can manage the error logs of JP1/IM - EG for NNMi itself.

To specify settings for JP1 event issuance:

Set JP1 event issuance.
Edit the JP1/IM - EG for NNMi parameter definition file (jegn_param_V7.conf). This file is stored at the following locations:

In Windows:

Physical host: EG-for-NNMi-path\conf

Logical host: shared-folder\JP1EG4NNMI\conf

In UNIX:

Physical host: /etc/opt/jp1eg4nnmi/conf

Logical host: shared-directory/jp1eg4nnmi/conf

In this file, SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT and SEND_PROCESS_RESTART_EVENT are the JP1 event issuance setting parameters. To issue JP1 events, change the values of these parameters to dword:1.
For details about the JP1/IM - EG for NNMi parameter definition file, see F.2 JP1/IM - EG for NNMi parameter definition file (jegn_param_V7.conf).

Execute the jbssetcnf command to apply the definition information.
For details about the jbssetcnf command, see the Job Management Partner 1/Base User's Guide.

Restart JP1/Base and the products that require JP1/Base.
The specified settings take effect after the restart.

[Contents][Back][Next]

[Trademarks]