ESMPROC failing after IPL with RC=0100. java.lang.ClassNotFoundException

Products

• COMMON SERVICES FOR Z/OS
• COMMON PRODUCT SERVICES COMPONENT
• Common Services

Issue/Introduction

Attempting to start the ESM Microservice (ie. ESMPROC) but it is failing with a RC=0100.

Looking through the output generated, the following concerns are witnessed:

 JVMJZBL2010E Exception occurred invoking org.springframework.boot.loader.JarLauncher.main()
 JVMJZBL2999T -> JniUtil.writeStackTrace()
 JVMJZBL2007E Stack trace follows:
 java.lang.reflect.InvocationTargetException
  at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
  at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:90)
  at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)
  at java.lang.reflect.Method.invoke(Method.java:508)
  at org.springframework.boot.loader.MainMethodRunner.run(MainMethodRunner.java:48)
  at org.springframework.boot.loader.Launcher.launch(Launcher.java:87)
  at org.springframework.boot.loader.Launcher.launch(Launcher.java:50)
  at org.springframework.boot.loader.JarLauncher.main(JarLauncher.java:51)
 Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'esmApplicationEventsServ
 ice': Unsatisfied dependency expressed through field 'healthCheckService'; nested exception is org.springframework.beans.factory.Bea
 nCreationException: Error creating bean with name 'esmZosHealthCheckService' defined in URL [jar:file:/B/Sw_ST/CA/CCS/V150/Base/misc
 /esmMService/esm.jar!/BOOT-INF/classes!/com/ca/esm/services/EsmZosHealthCheckService.class]: Instantiation of bean failed; nested ex
 ception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [com.ca.esm.services.EsmZosHealthCheckService
 ]: Constructor threw exception; nested exception is java.lang.NoClassDefFoundError: com.ca.opsmvs.opsgenapi.OpsGenAPI

Environment

CA Common Services 14.1 w/PTF SO05223

CA Common Services 15.0 w/PTF SO07047

Cause

One of the following PTFs was installed which introduced new environment variables in hlq.CAW0OPTV(ESMENV)

• CCS 14.1 - SO05223
• CCS 15.0 - SO07047

The above mentioned PTFs upgrade the ESM Microservice from v1 to v2.

This new version contains new features that require Java classes from "ccsopjex.jar", which provide heartbeat information to OPSMVS utilities.

An updated ESMENV member includes variables for this .jar file.

 

Related variable:

ccsopjex_LOCATION=<USS directory where ccsopjex.jar is located>
 

Resolution

Ensure the updated version on ESMENV is being used and that the following variables are accurately specified.

IRRRacf_LOCATION=<USS directory where IRRRacf.jar is located>  
ccsopjex_LOCATION=<USS directory where ccsopjex.jar is located>

export CLASSPATH="${IRRRacf_LOCATION}/IRRRacf.jar:${ccsopjex_LOCATION}/ccsopjex..jar"

Additional Information

See article #256576 "ESMPROC RC=0100 after PTF LU07250" for another potential concern.