search cancel

ZMSHUB gets CC=102

book

Article ID: 188605

calendar_today

Updated On:

Products

COMMON SERVICES FOR Z/OS DATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OS Common Services CHORUS SOFTWARE MANAGER Mainframe Operational Intelligence

Issue/Introduction

Starting ZMSHUB (Message Service HUB) for first time and new system and task ends with RC=102.

Note: Same problem applies to ZMSSTART (Message Service)

JVMJZBL2007E Stack trace follows:
 java.lang.UnsatisfiedLinkError: com/ibm/jzos/ZFile.fopen(Ljava/lang/String;Ljava/lang/String;)J
  at com.ibm.jzos.ZFile.doZFileOpen(ZFile.java:613)
  at com.ibm.jzos.ZFile.<init>(ZFile.java:476)
  at com.ibm.jzos.ZUtil$1.run(ZUtil.java:702)
  at java.security.AccessController.doPrivileged(AccessController.java:734)
  at com.ibm.jzos.ZUtil.redirectStandardStreams(ZUtil.java:691)

 < omitted lines >

JVMJZBL2999T com.ibm.jzos.MvsConsole.startMvsCommandListener
JVMJZBL2008E Could not find or load class: com.ibm.jzos.MvsConsole
JVMJZBL2999T -> JniUtil.writeStackTrace()
JVMJZBL2007E Stack trace follows:
 java.lang.UnsatisfiedLinkError: com/ibm/jzos/MvsConsole.retrieveStartParameters()Ljava/lang/String;
  at com.ibm.jzos.MvsConsole.<clinit>(MvsConsole.java:35)
JVMJZBL2999T <- JniUtil.writeStackTrace()
JVMJZBL2999T <- StaticMethod.invoke()
JVMJZBL1046E Unable to establish MVS console listener
 
< omitted lines >

JVMJZBL2999T java.lang.System.exit
JVMJZBL2999T JvmExitHook entered with exitCode=102, javaMainReturnedOrThrewException=0
JVMJZBL1042E JZOS batch launcher failed, return code=102

Cause

Some possible causes.

1. The userid that the ZMSHUB STC is runnning under does not have a valid OMVS segment defined
2. Locate "PWD=" in the job out. This value should be resolved. If not, review possible problems with OMVS HOME directory.
3. There is a problem identifying the ibmjzos environment.

Environment

Release : 14.1 or 15.0
CCSMS1 : CCS MESSAGE SERVICE

Resolution

1. Verify ZMSHUB STC is running with the desired userid
2. Have security team verify OMVS segment defined for userid. Must have valid OMVS HOME Directory, OMVS UID, and OMVS Default PGM '/bin/sh'
3. Install CA Common Services, Message Service PTF SO12983 (r14.1) or  SO12986 (r15.0)

One of the changes the PTF makes is to correct incorrect linkage to JZos library.  The ibmjzos library is part of IBM Java runtime so it should be inherently available anytime a Java application is run on z/OS.