Buttons in the Configuration Tool do not show the text but the variable name behind it

The buttons in the Configuration Tool (on z/OSMF) do not show the text but the underlying variable names.

Symptom

When you use the Configuration Tool on IBM® z/OS® Management Facility (z/OSMF), the buttons do not show the text but the underlying variable names.

Cause

There are several possible reasons:
  • The web browser that is used to visit the Configuration Tool is not supported.
  • JRE level is not up to date.
  • Missing the file en.i18.json.
The following logs can be used to further investigate:
  • IZUSVR1 PROC (default zOSMF PROC) job log
  • IZUGx.log
z/OSMF creates its log files at /var/zosmf/data/logs in z/OS UNIX System Services. This location varies depending on your z/OSMF user directory, which by default is /var/zosmf. Logs are named like IZUGx.log, where x is a number in the range 0 - 9. A smaller number indicates that the log is newer (that is, IZUG0.log is the most recent, and is most likely the log you should investigate).
To make the file readable, run the following command first:
iconv -t IBM1047 -f ISO8859-1 /var/zosmf/data/logs/IZUG0.log > /tmp/izug0.ebcdic

Solution

Depending on the causes, there are different solutions:
  • The web browser used to visit the Configuration Tool is not supported.
    The following web browsers are supported by z/OSMF, and are recommended for best results:
    • Google Chrome V84 or later (Windows 10, macOS 10.15 and later version)
    • Mozilla Firefox ESR 78 or later (Windows 10, macOS 10.15 and later version)
    • Microsoft Edge (Windows 10)
    You can run the environment checker tool (https://www.ibm.com/docs/en/zos/2.4.0?topic=ttt-verifying-your-workstation-environment-checker) to inspect your web browser and workstation operating system for compliance with z/OSMF requirements and recommended settings.
  • JRE level is not up to date.
    Run the z/OS UNIX System Services command to check the JRE level:
    java -fullversion
    Upgrade JRE to latest level. Here is the link to download the JRE: https://developer.ibm.com/javasdk/downloads/.
  • Missing the file en.i18.json.

    Check whether this file is missing in the build directory (where you put your build) and installation directory.

    z/OSMF default directory is: /u/userid/cdpConfig/HBOCDEUI/v5r1m0/LIB.

    Consider that this path brings you to a symbolic and not a physical file but if you navigate to the link with the z/OS UNIX System Services ISHELL, you get the file location the link represents.