Configuring JVMs in WebSphere Liberty

To monitor a Java™ virtual machine (JVM) that runs in WebSphere Liberty, use the JVM_OPTIONS environment variable to add the enablement options.

About this task

The environment variables are defined to the DDNAME STDENV, which can define an MVS data set, an HFS PATH statement, or an in-stream data set.

For JVM applications in WebSphere Liberty, including the ones that are used for z/OS Connect, there are a number of ways that the JVM parameters can be provided.

  • If you customized the PARMGEN configuration profiles by using the KCIJPDLA z/OS Discovery Library Adapter (DLA) autodiscovery job that is introduced starting in PARMGEN 4Q16 IF (PTF UA82508), then the $PARSE*-related job generates a list of auto-discovered CICS regions that are enclosed in the # ************ Discovered z/OS Connect JVMs ************* section.
  • If there are rows that are generated in this section, active on-line JVMs were auto-discovered at the time the KCIJPDLA job was submitted. Within this section, PARMGEN generates the auto-discovered JVMs where the enablement options need to be added. For more information about the KCIJPDLA job, review the job accessible in the Utilities menu. The job is also created by the KCIJPCFG/KCIJPPRF or KCIJPUP1 set-up jobs in the WCONFIG data set.

For information about adding the enablement options, see Configuring Java Applications for Monitoring.

If the Liberty server is to be used with z/OS Connect, the JVM monitoring can be used to provide response time metrics for z/OS Connect services in addition to enabling resource monitoring for z/OS Connect with IBM Z OMEGAMON for JVM.

Enabling the collection of WebSphere Liberty server metrics

PTF UJ07369, APAR OA62512 introduces Web application metrics for JVM servers configured with WebSphere Liberty profile. This includes the performance metrics related to Web applications, Thread Pool, Connection Pool, and Session statistics.

To enable monitoring the Liberty runtime environment, add the monitor-1.0 Liberty feature to the monitored WebSphere Liberty server.xml file. 

<feature>monitor-1.0</feature>