IBM Support

PH21809: LIBERTY ON Z/OS MESSAGE ROUTING TO MSGLOG DD STOPS UNEXPECTEDLY.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • At 19.0.0.9 and beyond, message routing to MSGLOG might
    unexpectedly stop early on server processing, whilst
    continuing
    as normal to the messages.log file.
    Underlying enablement of
    multithreaded startup in the OSGi code breached a documented
    C/C++ restriction.
    

Local fix

  • update (or create) the bootstrap.properties file for the server
    with line:
    equinox.start.level.thread.count=1
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of IBM WebSphere Application      *
    *                  Server Liberty                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: MSGLOG DD was closed when the thread    *
    *                      that did the open terminated            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The MSGLOG DD is opened with the native service fopen().   There
    is native code that will close the file if the thread that
    opened the file terminates.   This is not a problem when running
    with the property equinox.start.level.thread.count=1.  This was
    the default until 19.0.0.7.  The
    equinox.start.level.thread.count property defines the number of
    initial threads to start the server.   When it is set to allow
    more than one thread there is a chance that the open will be
    done on a thread that will later terminate and thus cause the
    closing of the MSGLOG DD file.
    
    Even with the early closing of the MSGLOG DD messages were still
    written to messages.log.
    

Problem conclusion

  • Code was modified to perform the MSGLOG DD open on a thread that
    will not be terminated until the Liberty MSGLOG log handler is
    terminated.  This is will occur normally during server stop.
    
    The fix for this APAR is currently targeted for inclusion in fix
    pack 20.0.0.3.  Please refer to the Recommended Updates page for
    delivery information:
    http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
    

Temporary fix

  • Set the property equinox.start.level.thread.count=1 in the
    bootstrap.properties to avoid an early close of the MSGLOG DD
    which will stop messages from being written to the MSGLOG DD.
    

Comments

APAR Information

  • APAR number

    PH21809

  • Reported component name

    LIBERTY PROF -

  • Reported component ID

    5655W6514

  • Reported release

    CD0

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-02-05

  • Closed date

    2020-02-14

  • Last modified date

    2020-02-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

    LIBERTY PROF -

  • Fixed component ID

    5655W6514

Applicable component levels

  • RCD0 PSY

       UP

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"CD0"}]

Document Information

Modified date:
13 September 2021