Zowe startup causes "BPXI039I SYSTEM LIMIT SHRLIBRGNSIZE HAS REACHED 100%"

Products

• Zowe

Issue/Introduction

After installing Zowe version 3.0, seeing the below messages after starting the Zowe started task (ZWESLSTC).

ZWESLSTC 00000010 *BPXI039I SYSTEM LIMIT SHRLIBRGNSIZE HAS REACHED 95% OF ITS CURRENT
                   CAPACITY OF 125829120   
ZWE1CS 00000010 *BPXI039I SYSTEM LIMIT SHRLIBRGNSIZE HAS REACHED 100% OF ITS CURRENT
                   CAPACITY OF 125829120                                         

ZWE1AZ   00000010 *BPXI039I SYSTEM LIMIT SHRLIBRGNSIZE HAS REACHED 100% OF ITS CURRENT
                   CAPACITY OF 125829120    
ZWESLSTC 00000010 *BPXI039I SYSTEM LIMIT SHRLIBRGNSIZE HAS REACHED 100% OF ITS CURRENT
                   CAPACITY OF 125829120         

System usage before starting Zowe:

System usage after starting Zowe:




What size should be allocated for SHRLIBRGNSIZE to enable Zowe to start without causing the limit to be reached and the BPXI039I messages being reported?

Resolution

There is no specific recommendation for setting up a SHRLIBRGNSIZE value for Zowe.
Zowe does use a lot of shared libraries.

Please see this IBM Support document: Hitting your SHRLIBRGNSIZE Limit

Below is listed some of the most relevant information from that document:

*****
Environment
Reaching your SHRLIBRGNSIZE limit is not a critical issue;  z/OS UNIX outputs the BPXI039I messages to keep the system programmer notified of what is happening with the shared library storage. Once you reach 100% SHRLIBRGNSIZE, your applications will still function. . What happens is that libraries will start be loaded in the user's private storage instead of the shared library region. The BPXPRMxx SHRLIBRGNSIZE parameter is described more fully in  this link and ...
We do not recommend any specific limit setting, as it is system-needs dependent. Only you can know whats best for your system.

Diagnosing The Problem
There is a tool (WJSIGSHL) that is available on GitHub that can show what modules are loaded in the shared library region. More information about this tool can be found here.

Resolving The Problem
If you're looking to increase the limit, it is best to increase SHRLIBRGNSIZE in smaller increments instead of making a large jump in size to avoid any storage issues. It is recommended to set a SHRLIBRGNSIZE limit that will be about 80% - 85% used. Once it reaches 85%, z/OS UNIX will start to load libraries into user storage to help conserve space in the shared library region. Keeping the usage to 85% or below will maximize the shared library benefit. You can issue the command D OMVS,L to display the library statistics and monitor usage.
*****

Therefore please use the above information to increase SHRLIBRGNSIZE using this link to avoid seeing the BPXI039I  messages after Zowe is started.