CAUTION: This site hosts draft documentation for the next release. For published content of the latest release, visit www.eclipse.org/openj9/docs

-Xsignal

(z/OS® only)

This option controls the behavior of OpenJ9 VM signal handlers.

Syntax

    -Xsignal:<parameter>=<value>

Parameters

Restriction: You cannot use these parameters together.

posixSignalHandler

    -Xsignal:posixSignalHandler=cooperativeShutdown

When the VM signal handlers for SIGSEGV, SIGILL, SIGBUS, SIGFPE, SIGTRAP, and SIGABRT end a process, they call exit(), by default. In this case, the z/OS™ Language Environment® is not aware that the VM ended abnormally.

With -Xsignal:posixSignalHandler=cooperativeShutdown, the VM no longer uses exit() to end the process from the signal handlers. Instead, the VM behaves in one of the following ways:

  • In response to a z/OS hardware exception, the VM uses return().
  • In response to signals raised or injected by software, the VM ends the enclave with abend 3565.

Language Environment detects that the VM is ending abnormally and initiates Resource Recovery Services.

userConditionHandler

(31-bit z/OS only)
-Xsignal:userConditionHandler=percolate

This option results in similar behavior to the -XCEEHDLR option: the VM registers user condition handlers to handle the z/OS exceptions that would otherwise be handled by the VM POSIX signal handlers for the SIGBUS, SIGFPE, SIGILL, SIGSEGV, and SIGTRAP signals.

As with the -XCEEHDLR option, the VM does not install POSIX signal handlers for these signals.

This option differs from the -XCEEHDLR option in that the VM percolates all Language Environment® conditions that were not triggered and expected by the VM during normal running, including conditions that are severity 2 or greater. The VM generates its own diagnostic information before percolating severity 2 or greater conditions.

The VM is in an undefined state after percolating a severity 2 or greater condition. Applications cannot resume running then call back into, or return to, the VM.

See also