After applying maintenance to OM Web Viewer 14 getting a U4038 abend
Article ID: 404526
Updated On:
Products
Issue/Introduction
After applying maintenance to Web Viewer 14.0, our web viewer installation has stopped working. No one can log on. It maybe something to do with the new CAHVCENV member, or potentially Java 17.
We're going from Version 14.0.03 Build:14.0.70 #8aa7b438 2023-11 to the latest release
Getting a U4038 abend. It was working prior to applying maintenance.
IEA995I SYMPTOM DUMP OUTPUT 389
389 USER COMPLETION CODE=4039 REASON CODE=00000000
Environment
Output Management Web Viewer™ for z/OS
Cause
You have an early version of the CAHVCENV file which was created when only Java 8 was supported. After Java 8, IBM changed the directory structure of the Java lib directory so we had to update our samples to properly set LIBPATH depending on the Java version.
Resolution
In PTF LU12737 JAVA 17 Support (the PTF that introduced Java 17 support), the LIBPATH environment variable was changed to:
# Configure LIB Path LIBPATH="/lib:/usr/lib:${CATALINA_HOME}/lib"
# Java 8
if Ý "$JVMLDM_VERSION" = "86" ¨; then
LIBPATH="${LIBPATH}:${JAVA_HOME}/lib/s390x" LIBPATH="${LIBPATH}:${JAVA_HOME}/lib/s390x/classic"
# Java 11+
else
LIBPATH="${LIBPATH}:${JAVA_HOME}/lib" LIBPATH="${LIBPATH}:${JAVA_HOME}/lib/server"
fi
export LIBPATH
Where JVMLDM_VERSION is a new variable that was introduced to identify the Java version.
You need to correct the LIBPATH in CAHVCENV. Please also note that the install process was simplified by PTF LU15267 Simplify Product Installation to use the CAHVIAUD process to create user data sets.
Consider migrating to that process to make future maintenance easier. See Migrate from a Java 8/11 Environment in the documentation for more information.
Feedback
