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 signal (UNIX), or exception (Windows) 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 signal (UNIX), or exception (Windows) 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.
Warning: (UNIX platforms only) When this value is set, operating system security may prevent a core dump file from being created; refer to Preparing for a Core Dump for instructions on how to ensure that a core dump file is created.
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.
Warning: (UNIX platforms only) When this value is set, operating system security may prevent a core dump file from being created; refer to Preparing for a Core Dump for instructions on how to ensure that a core dump file is created.
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:

Parameters 129, 130, and 131 are only applicable to Windows platforms.

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 on UNIX platforms has the following restrictions on some operating systems:
  • On HP-UX, it is only supported on version 11.31 or later, where the gcore utility is supported.
  • On Linux, it is only supported if gdb (GNU debugger) is installed and the creation of valid 32-bit core dumps is supported.
  • On AIX, it is only supported when the "fullcore" kernel tunable is set. To enable "fullcore" support, run the following command as root: chdev -l sys0 -a fullcore='true'.