Intertest CCS Tomcat server startup fails with JVMJZBL1038E exit code 204

Products

• InterTest - CICS
• InterTest - Batch
• SymDump for CICS
• SymDump Batch
• Common Components and Services for z/OS

Issue/Introduction

Working on setting up Intertest CCS Apache Tomcat server for the REST API and Testing Tools Server implementation.
However the started task (STC) fails with these errors:

ERROR IEF142I INTOMSTC INTOMSTC - STEP WAS EXECUTED - COND CODE 0102
...
EXAM  IEF373I STEP/SERVER  /START 2025225.1313
      IEF032I STEP/SERVER  /STOP  2025225.1313
              CPU:     0 HR  00 MIN  00.04 SEC    SRB:     0 HR  00 MIN  00.00 SEC
              VIRT:    16K  SYS:   208K  EXT:    10308K  SYS:    10068K
              ATB- REAL:                   460K  SLOTS:                     0K
                   VIRT- ALLOC:      19M SHRD:       0M
      IEF375I  JOB/INTOMSTC/START 2025225.1313
      IEF033I  JOB/INTOMSTC/STOP  2025225.1313
              CPU:     0 HR  00 MIN  00.04 SEC    SRB:     0 HR  00 MIN  00.00 SEC
--------
-------- INTOMSTC JOB29774 T 131350 INTOMSTC.JOB29774.INTOMSTC..SYSOUT           2025225 1313
--------
       JVMJZBL1001N JZOS batch Launcher Version: 2.4.11 2022-05-20
       JVMJZBL1002N (C) Copyright IBM Corp. 2005, 2021
       JVMJZBL1038E Child shell process exited with exit code: 204
       JVMJZBL1042E JZOS batch launcher failed, return code=102

Environment

CCS Apache Tomcat

Resolution

Support requested re-run with trace level logging i.e.
Change:
LOGLVL='  ',
To:
LOGLVL='+T',

The trace job log shows:
*****
       JVMJZBL2999T if !(test $CATALINA_HOME) then
       JVMJZBL2999T   CATALINA_HOME=/D02/products/cai/CADeploy/tomcat/tomcat/
       JVMJZBL2999T fi

...

       JVMJZBL2999T if !(test $CATALINA_HOME) then
       JVMJZBL2999T   CATALINA_HOME=/cai/CADeploy/CCS/tpv/tomcat
       JVMJZBL2999T fi
       JVMJZBL2999T export CATALINA_HOME
...
       JVMJZBL2999T if !(test -f "${CATALINA_HOME}/bin/bootstrap.jar") then
       JVMJZBL2999T   echo '***** CATALINA_HOME does not point to Tomcat directory'
       JVMJZBL2999T   exit 204
       JVMJZBL2999T fi
       JVMJZBL2999T if !(test -d "${CATALINA_BASE}/bin/CA") then
       JVMJZBL2999T   echo '***** CATALINA_BASE does not point to TestingTools server'
       JVMJZBL2999T   exit 205
       JVMJZBL2999T fi
       JVMJZBL2999T #
       JVMJZBL2999T # Change working directory to CATALINA_HOME
       JVMJZBL2999T #
       JVMJZBL2999T cd "$CATALINA_HOME"
       JVMJZBL1005I Output from DD:STDENV config shell script:
       JVMJZBL2999T ***** CATALINA_HOME does not point to Tomcat directory
       JVMJZBL2999T waiting for child shell process to complete
       JVMJZBL2999T -> waitChild()
       JVMJZBL1038E Child shell process exited with exit code: 204
*****
 
So exit code 204 means the CATALINA_HOME environment variable is not set correctly. 
For the test for the existence of file "${CATALINA_HOME}/bin/bootstrap.jar" to be successful the Tomcat CATALINA_HOME environment variable should be set such that it contains the bin directory with the bootstrap.jar file in it.

In the earlier first test for the existence of environment variable CATALINA_HOME, if it does not exist it is setting a directory where the tomcat sub-directory is used twice i.e.
       JVMJZBL2999T if !(test $CATALINA_HOME) then
       JVMJZBL2999T   CATALINA_HOME=/D02/products/cai/CADeploy/tomcat/tomcat/
       JVMJZBL2999T fi

After changing the directory to the following the started task started successfully:
       JVMJZBL2999T if !(test $CATALINA_HOME) then
       JVMJZBL2999T   CATALINA_HOME=/D02/products/cai/CADeploy/ccs/tomcat/
       JVMJZBL2999T fi

Additional Information

InterTest™ and SymDump® 11.0 > Installing > Complete Configuration Tasks > Configure the REST API and Testing Tools Server