PI79034: For products that embed Liberty, some bootstrap.properties do not take effect at server startup

Fixes are available

APAR status

Closed as program error.

Error description

Certain properties defined in bootstrap.properties do not
take effect at runtime when the server is started with the
com.ibm.wsspi.kernel.embeddable.ServerBuilder SPI that is
used by some products that embed Liberty.
Note that this does not affect Liberty when used as a
standalone product.  The errors that are generated will vary
depending on which bootstrap property did not take effect
during runtime.

Local fix

Specify the property directly as a JVM System Property instead
of using bootstrap.properties.  The process for doing this may
vary based on which embedding product is being used.  For
example, this can be accomplished in z/OS Connect EE by
following the instructions at this dwAnswers link
https://developer.ibm.com/answers/questions/351636/%7B%7D/

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server Liberty for z/OS                     *
****************************************************************
* PROBLEM DESCRIPTION: Certain properties defined in           *
*                      bootstrap.properties do not take effect *
*                      at runtime when the server is started   *
*                      with the                                *
*                      com.ibm.wsspi.kernel.embeddable.ServerB *
*                      uilder SPI that is used by some         *
*                      products that embed Liberty.            *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Liberty provides an SPI for embedders to use,
com.ibm.wsspi.kernel.embeddable.ServerBuilder, that allows a
Liberty server to be started programmatically inside an existing
JVM.  When Liberty is started this way, certain bootstrap
properties such as com.ibm.ws.tcpchannel.useZosAio,
com.ibm.ws.zos.core.angelRequired, and
com.ibm.ws.zos.core.angelName are not properly read by the
runtime and therefore do not take effect when specified.  Note
that this does NOT affect Liberty when used as a standalone
product, nor does it affect every embedder of Liberty, because
not all embedders use this SPI to start the Liberty server.

Problem conclusion

Code was changed so that com.ibm.ws.tcpchannel.useZosAio,
com.ibm.ws.zos.core.angelRequired, and
com.ibm.ws.zos.core.angelName take effect when the Liberty
server is started inside an existing JVM using the ServerBuilder
SPI.

The fix for this APAR is currently targeted for inclusion in fix
pack 17.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

Comments

APAR Information

APAR number
PI79034
Reported component name
WEBSPHERE FOR Z
Reported component ID
5655I3500
Reported release
850
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-03-29
Closed date
2017-08-14
Last modified date
2017-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
LIBERTY PROF -
Fixed component ID
5655W6514

Applicable component levels

R850 PSY
UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"850","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
04 May 2022

Tips

PI79034: For products that embed Liberty, some bootstrap.properties do not take effect at server startup

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

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

Fixed component ID

Applicable component levels

R850 PSY

Document Information

Share your feedback

Need support?