ZMSSTART terminates with RC=0000

Products

• COMMON SERVICES FOR Z/OS
• DATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OS
• Common Services
• LDAP SERVER FOR Z/OS
• CHORUS SOFTWARE MANAGER
• WEB ADMINISTRATOR FOR TOP SECRET
• Output Management Web Viewer
• OPS/MVS Event Management & Automation

Issue/Introduction

New install of ZMSSTART ended immediately with a RC=0000

There are no obvious messages in the ZMSSTART job output that explains why the task terminated.

Review of the server.log file revealed the following symptoms:

ERROR [2020-05-28 23:46:42.686] [Message Service Server] - [com.ca.messagingservice.engine.MessagingServiceLifeCycleListener:lifeCycleFailure:72] [main] - Life cycle failed. 
com.ca.messagingservice.adapter.AdapterLifecycleException: initialize(adapter.java:538)initialization failed:
{}

Caused by: java.lang.NoClassDefFoundError: com.ca.opsmvs.opsgenapi.OpsGenAPI
 at com.ca.automation.opsmvs.opsMessageService.adapter.initialize(adapter.java:391) ~[na:na]
 ... 13 common frames omitted
Caused by: java.lang.ClassNotFoundException: com.ca.opsmvs.opsgenapi.OpsGenAPI

ERROR [2020-05-28 23:46:42.687] [Message Service Server] - [com.ca.messagingservice.engine.ContainerCommand:run:52] [main] - Failed to start managed components 
com.ca.messagingservice.adapter.AdapterLifecycleException: initialize(adapter.java:538)initialization failed:

Environment

Release : 14.1
Release : 15.0
Component : CCS390 - CA COMMON SERVICES FOR Z/OS

Cause

The CCSOPJEXJAR_PATH environment variable defined for the Message Service is incorrect. This causes the ccsopjex.jar file to be not found.

Refer to: yourHLQ.CAW0OPTV(ZMSENVT)

Resolution

Set the value of 'CCSOPJEXJAR_PATH' to the path of the USS directory containing 'ccsopjex.jar'.

CCSOPJEXJAR_PATH=<uss_deployment_path>/CCS/misc/ccsOPSjex