IBM Support

IV25308: THE JAVA SIGNAL HANDLER SHOULD RETURN ON Z/OS

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • PROBLEM SUMMARY:
    On z/OS the Java signal handler calls exit() rather than
    returning when processing termination signals. This means that
    Language Environment (LE) Resource Recovery Services (RRS) are
    not called after the JVM has captured the required Java
    Diagnostic information.
    
    PROBLEM CONCLUSION:
    This defect will be fixed in:
    6.0.0 SR11
    7.0.0 SR3
    6.0.1 SR4
    The JVM has been updated with a new option to cause the Java
    Signal Handler to return rather than exit() for termination
    signals. This ensures the existing behaviour has not changed
    by default.
    This option is:
    -Xsignal:posixSignalHandler=cooperativeShutdown
    
    The changes are entirely controlled by
    -Xsignal:posixSignalHandler=cooperativeShutdown. The JVM signal
    handling behaviour is unchanged if this option is omitted.
    
    
    -Xsignal:posixSignalHandler=cooperativeShutdown cannot be used
    with -XCEEHDLR nor -Xsignal:userConditionHandler=percolate. The
    JVM will fail to start and will print an error message if this
    combination is found
    .
    TEMPORARY FIX:
    
    COMMENTS:
    
    MODULES/MACROS:   NONE
    
    SRLS:      NONE
    
    RTN CODES:
    
    APPLICABLE COMPONENT LEVEL/SU:
    R600 PSY         UP
    R260 PSY         UP
    
    CIRCUMVENTION:
    CMVC Defect Number: sov,191934
    
    MESSAGE TO SUBMITTER:
    
    ERROR DESCRIPTION:
    
    Error Message: N/A .
    Stack Trace: N/A
    .
    

Local fix

Problem summary

  • Currently on z/OS the Java signal handler calls exit() rather
    than returning when processing termination signals. This means
    that application signal handlers are not called after the JVM
    has captured the required Java Diagnostic information.
    

Problem conclusion

  • This defect will be fixed in:
    6.0.0 SR11
    7.0.0 SR3
    6.0.1 SR4
    .
    The JVM has been updated with a new option to cause the Java
    Signal Handler to return rather than exit() for termination
    signals. This ensures existing signal handlers do not change
    functionality/behaviour by default.
    This option is:
    -Xsignal:posixSignalHandler=cooperativeShutdown
    
    The changes are entirely controlled by
    -Xsignal:posixSignalHandler=cooperativeShutdown. The JVM and
    port library signal handling behaviour is unchanged if this
    option is omitted.
    -Xsignal:posixSignalHandler=cooperativeShutdown cannot be used
    with -XCEEHDLR nor -Xsignal:userConditionHandler=percolate. The
    JVM will fail to start and will print an error message if this
    combination is found.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IV25308

  • Reported component name

    J9 COMMON CODE

  • Reported component ID

    620700127

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-07-27

  • Closed date

    2012-07-27

  • Last modified date

    2012-08-14

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    J9 COMMON CODE

  • Fixed component ID

    620700127

Applicable component levels

  • R600 PSY

       UP

  • R260 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCVQ3W","label":"Virtual Machine"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 August 2012