After applying PTF LU17202 OM Web Viewer 14 output to STDERR is not readable
Article ID: 403148
Updated On:
Products
Output Management Web Viewer
Issue/Introduction
After applying PTF LU17202 Web Viewer Java 21 Support, OM Web Viewer output to STDERR is not readable when using Java 21 and CCS Apache Tomcat Server.
The output to STDERR is partially or completely unreadable containing random characters.
Environment
- Output Management Web Viewer™ for z/OS
- Java 21
- CCS Apache Tomcat Server
Cause
When using CCS Apache Tomcat Server with Java 21 the server requires additional java properties to configure correct encoding for STDERR output.
Resolution
Follow the instructions in the HOLDDATA for PTF LU17202 and run CAHVIAUD to have environment variables updated in CAHVCENV with additional properties.
If using custom started task to CCS Apache Tomcat Server with Java 21 make sure it uses following java properties:
java.util.logging.manager=org.apache.juli.ClassLoaderLogManager
java.util.logging.config.file=${CATALINA_BASE}/conf/logging.properties
Additional Information
+----------------------------------------------------------------------+
| Output Management Web Viewer Version 14.0 |
+----------+-----------------------------------------------------------+
|SEQUENCE | Before Apply |
+----------+-----------------------------------------------------------+
|PURPOSE | Review changes to the OM Web Viewer software |
| | requirements. |
| | Backup previously customized members. |
+----------+-----------------------------------------------------------+
|USERS | All users. |
|AFFECTED | |
+----------+-----------------------------------------------------------+
|KNOWLEDGE | Product Administration. |
|REQUIRED | |
+----------+-----------------------------------------------------------+
|ACCESS | Product Libraries. |
|REQUIRED | |
+----------+-----------------------------------------------------------+
**************************
* STEPS TO PERFORM *
**************************
This PTF includes:
- Changes to the OM Web Viewer software requirements.
- Updates to OM Web Viewer sample members.
1. Review changes to the OM Web Viewer software requirements:
Java 21 is supported Java version in addition to already
supported JVM versions.
See the OM Web Viewer documentation topic Migrate from a Java 8/11
Environment for more information.
2. Backup previously customized members:
This PTF will overwrite the following sample members in the
installation &VIEWHLQ.CVDEJCL data set:
- CAHVIAUD
- CAHVH2SV
- CAHVTOMX
This PTF will overwrite the following sample members in the
installation &VIEWHLQ.CVDEOPTN data set:
- CAHVCENV
If you have customized any of these members manually and you plan to
continue using those customizations, make a backup before you apply
this PTF.
+----------------------------------------------------------------------+
| Output Management Web Viewer Version 14.0 |
+----------+-----------------------------------------------------------+
|SEQUENCE | After Apply |
+----------+-----------------------------------------------------------+
|PURPOSE | Update user &USERHLQ.CVDEJCL and user &USERHLQ.CVDEOPTN |
| | data sets. |
+----------+-----------------------------------------------------------+
|USERS | All users. |
|AFFECTED | |
+----------+-----------------------------------------------------------+
|KNOWLEDGE | Product Administration. |
|REQUIRED | |
+----------+-----------------------------------------------------------+
|ACCESS | Product Libraries. |
|REQUIRED | |
+----------+-----------------------------------------------------------+
**************************
* STEPS TO PERFORM *
**************************
This PTF includes:
- Updates to sample JCL members copied to the user &USERHLQ.CVDEJCL
data set during OM Web Viewer installation and configuration.
- Updates to sample members copied to the user &USERHLQ.CVDEOPTN
data set during OM Web Viewer installation and configuration.
1. Update user &USERHLQ.CVDEJCL and user &USERHLQ.CVDEOPTN data sets:
If you have not yet prepared your customized user &USERHLQ.CVDEJCL
and user &USERHLQ.CVDEOPTN data sets, follow the steps documented in
OM Web Viewer documentation topic Prepare Customized Data Sets. The
user &USERHLQ.CVDEJCL and user &USERHLQ.CVDEOPTN data sets created by
sample JCL CAHVIAUD will include the updates from this PTF.
If you've already prepared your customized &USERHLQ.CVDEJCL
and user &USERHLQ.CVDEOPTN data sets, use the following steps to
propagate the updates from this PTF to your existing data sets:
- Reapply any manual customizations to the updated CAHVIAUD sample
JCL member in the installation &VIEWHLQ.CVDEJCL data set. See the
OM Web Viewer documentation topic Create User Customized Data Sets
for more information on sample JCL CAHVIAUD.
- Run your customized CAHVIAUD to update your existing customized
sample members in your user &USERHLQ.CVDEJCL and user
&USERHLQ.CVDEOPTN data sets.
- Review the changes made by CAHVIAUD:
- User &USERHLQ.CVDEJCL sample members CAHVH2SV and CAHVTOMX:
- The JVMLDMVR description in the comments section has been
updated to include "Use '21' for Java 21 64-bit JVM.".
- The JVM options variable in user &USERHLQ.CVDEOPTN sample member
CAHVCENV has been updated to include options
"-Djava.util.logging.manager" and
"-Djava.util.logging.config.file". Feedback
Yes
No
Powered by
