JVMJZBL1042E with return code 102 when starting NetMaster API Service

Products

• NetMaster Network Management for TCP/IP

Issue/Introduction

NetMaster API Service STC/job can be successfully started by the user who installed it. However, when started with the user associated with the NetMaster region, it fails to start because of the following error messages:

JVMJZBL1005I Output from DD:STDENV config shell script:                        
JVMJZBL2999T waiting for child shell process to complete                       
JVMJZBL2999T -> waitChild()                                                    
JVMJZBL1038E Child shell process exited with exit code: 127                    
JVMJZBL2999T <- waitChild()                                                    
JVMJZBL2999T <- adoptEnvironment()                                             
JVMJZBL2999T <- run()                                                          
JVMJZBL2999T -> cleanup()                                                      
JVMJZBL2999I JZOS batch launcher elapsed time=-1 seconds, cpu time=0.010000 sec
JVMJZBL1042E JZOS batch launcher failed, return code=102                       

Environment

NetMaster 12.2

Cause

The user doesn't have all the required external security authorizations

Resolution

Check the STC/job JESMSGLG for any ESM error message and provide all the required access authorizations.

Check also if Java is on the PATH; if not, set the path by adding the statement:

export PATH=$JAVA_HOME/bin:$PATH

to the NMAPIENV file, and then restart the API Service

Additional Information

The following JCL can be used to check if all the correct authorizations are in place:

//NMDETEST JOB .....
//NMDETEST PROC
//*
//BATCHSH EXEC PGM=BPXBATCH,REGION=0M
//STDENV   DD  *
JAVA_HOME=/usr/lpp/java/J8.0_64
export JAVA_HOME
IJO="-Xms512m -Xmx512m"
IJO="$IJO -Duser.language=en -Duser.country=US"
export IBM_JAVA_OPTIONS="${IJO}"
/*
//STDPARM  DD  *
SH echo "pwd";
pwd;
echo "echo PATH";
echo $PATH;
echo "whoami";
whoami;
echo "java -version";
java -version;
echo "java -cp JAVA_HOME HelloWorld";
java -cp $JAVA_HOME HelloWorld;
echo "JAVA_HOME/bin/java -version";
$JAVA_HOME/bin/java -version;
echo "JAVA_HOME/bin/java -cp JAVA_HOME HelloWorld";
$JAVA_HOME/bin/java -cp $JAVA_HOME HelloWorld
/*
//STDOUT   DD   SYSOUT=*
//STDERR   DD   SYSOUT=*
//*
//         PEND
//*
//         EXEC NMDETEST