Previous Topic Next topic Print topic


core_on_error

Specifies in what circumstances a core file is produced.
Restriction: The following applies to native code only.

Syntax:

>>-----set core_on_error=---.-0-.-----------><
                            +-1-+
                            +-2-+
                            +-3-+
                            +-129-+
                            +-130-+
                            +-131-+

Parameters:

0 The run-time system never produces a core file on any signalexception or run-time system error. This is the default behavior of the run-time system.
1 The run-time system produces a core file when any system signalexception is received that would normally produce a core file on the host system; for example, SIGBUS and SIGSEGV (which would usually produce a run-time system error 114). After writing out the core file the process terminates immediately.; for example, a run-time system error COBRT114, and so on.
2 The run-time system produces a core file when any run-time system error occurs. After writing out the core file the process terminates immediately.
3 The run-time system produces a snap shot core file when any run-time system error occurs. After writing out the core file the process continues as normal; for example, to display an RTS error message.
129 Same as core_on_error=1, except no message box is displayed after the core file is created.
130 Same as core_on_error=2, except no message box is displayed after the core file is created.
131 Same as core_on_error=3, except no message box is displayed after the core file is created.

Properties:

Default: 0
IDE equivalent: You can override the setting of this tunable using the Error handling when running programs outside of the IDE control on the Debug Options dialog box.

Comments:

You can debug core files to determine the cause of the problem if you have the appropriate dictionary (.idy) files. When a core file is produced, using core_on_error=1 or core_on_error=2, the run-time system itself cannot clean up COBOL file buffers or free system resources. This could lead to data file corruption that might not have occurred if no core file was produced.

Restriction:
The core_on_error=3 functionality has the following restrictions on some operating systems:
  • On HP-UX, it's only supported on version 11.31 or later, where the gcore utility is supported.
  • On Linux, it's only supported if gdb (GNU debugger) is installed and the creation of valid 32-bit core dumps is supported.
  • On AIX, it's only supported when the "full core" kernel tunable is set. To enable "full core" support, run the following command as root: chdev -l sys0 -a fullcore='true'.
Previous Topic Next topic Print topic