PM96410: XML EXCEPTIONS IN THE WEB UI AND ERROR IN CAE SERVER LOG: JAVA.LANG.INTERNALERROR: CAN'T CONNECT TO X11 WINDOW SERVER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The CAE Server can have a variety of problems if the server log
  contains the following error message:
  *
  java.lang.InternalError: Can't connect to X11 window server
  using ':0' as the value of the DISPLAY variable.
  *
  This error is caused by the existence of a non-empty value for
  the DISPLAY environment variable in the environment under which
  the CAE Server is running. Usually this variable should not be
  set, but sometimes, for example, the userid of the CAE Server
  may have this variable set in its initialization profile (e.g.
  in the .profile file in its USS  home directory ).
  

Local fix

• This APAR has 2 possible Workarounds.
  .
  1. Change the DISPLAY value in CAE Server user's .profile to
     'DISPLAY=' or remove the DISPLAY parm.
  .
  2. Modify the CAE Server Script 'start_cae_server' to
     basically ignore the DISPLAY:
  
  ...add this line: -Djava.awt.headless=true \
  in the CAE Server Script: /cqmv3r1/bin/start_cae_server
  EXAMPLE:
  ${CQM_HOME}/bin/runjava -m +a +j \
     $CQM_HEAP_ARG \
     $CQM_CAE_CACHE_LOCALHOST_ARG \
    -Djava.class.path="$CLASSPATH" \
    -Djava.awt.headless=true \
     $CQM_LOGGING_ARG \
     $TZ_ARG \
     $LOCAL_PORTAL_PORT_ARG \
     $RMI_PORT_RANGE_ARG \
     $CAE_AGENT_LISTENER_PORT_ARG \
     $CAE_SECURITY_ARGS \
     $CAE_TRUSTSTORE_ARG \
     $CAE_KEYSTORE_ARG \
    -Djava.security.policy=${CQM_HOME}/bin/java.policy \
     com.rocketsoft.nm.licensing.Boot
     com.rocketsoft.nm.discovery.TopologyServer \
    -serverPolicyClass
     com.rocketsoft.nm.qm.topology.QMServerPolicy \
    -modules $CQM_VAR_HOME \
     $WEBSERVER_PORT_ARG \
     $JDBC_PORT_ARG \
    -httpRoot $CQM_VAR_HOME $* &
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of DB2 Query Monitor.                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CAE Server can have a variety of    *
  *                      problems if the server log contains     *
  *                      the following error message:            *
  *                      *                                       *
  *                      java.lang.InternalError: Can't connect  *
  *                      to X11 window server using ':0' as the  *
  *                      value of the DISPLAY variable.          *
  *                      *                                       *
  *                                                              *
  *                      This error is caused by the existence   *
  *                      of a non-empty value for the DISPLAY    *
  *                      environment variable in the             *
  *                      environment under which the CAE Server  *
  *                      is running. Usually this variable       *
  *                      should not be set, but sometimes, for   *
  *                      example, the userid of the CAE Server   *
  *                      may have this variable set in its       *
  *                      initialization profile (e.g. in the     *
  *                      .profile file in its USS  home          *
  *                      directory ).                            *
  ****************************************************************
  * RECOMMENDATION: APPLY the PTF.                               *
  ****************************************************************
  Code has been changed to correct this condition.
  

Problem conclusion

• APPLY the PTF.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI15735

Modules/Macros

• CQMCAEPT CQMSSV
  

Fix information

• Fixed component name

  DB2 QUERY MONIT

• Fixed component ID

  5655E6701

Applicable component levels

• R320 PSY UI15735

     UP14/03/14 P F403

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.