IC67960: AFTER INSTALLING MS0T, WMQ EXPLORER FAILS TO START. ECLIPSE DIALOG SHOWN WITH "JAVA TERMINATED. EXIT CODE=1" MESSAGE

WebSphere MQ V7.0.1 for i5/OS Fix Pack 7.0.1.3
WebSphere MQ V7.0 Fix Pack 7.0.1.3

APAR status

• Closed as program error.

Error description

• Installation of MS0T, WebSphere MQ (WMQ) Explorer SupportPac, is
  successful.
  
  An Eclipse dialog containing "JVM terminated. Exit code=1" error
  is displayed after attempting to start WMQ Explorer.
  
  The "-DMQCHLLIB" entry in the dialog ends with a double
  quotation mark e.g. -DMQCHLLIB=C:\some\path"
  
  If enabled, the WMQ Explorer trace does not create any
  files.
  

Local fix

• Check value of MQCHLLIB to make sure it ends with \
  If it does not, edit and save variable.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the MQCHLLIB environment variable
  and MS0T SupportPac on Windows Platform.
  
  Platforms affected:
  Windows
  
  ****************************************************************
  PROBLEM SUMMARY:
  The problem is caused by invalid parsing of the MQCHLLIB
  environment variable. The MQCHLLIB specifies a path to
  the file containing the client channel definition table. This
  value is parsed during the startup of WMQ Explorer and if the
  value ends with a "\" the WMQ Explorer startup script attempts
  to remove it. Due to an error in the script, the "\" is not
  removed and the JVM is terminated with an error.
  

Problem conclusion

• The fix ensures that the startup script removes the trailing "\"
  from the MQCHLLIB environment variable. The fix is provided in
  the strmqcfg.cmd file in the WMQ Explorer installation.
  As a workaround to the problem, users can take the
  following steps:
  1.  Open strmqcfg.cmd in a text editor and search for the line:
  if "%MQCHLLIB:~-1%"=="\" SET MQCHLLLIB=%MQCHLLIB:0,-1%
  2.  Replace MQCHLLLIB (Observe 3 'L's) with MQCHLLIB.
  3.  Replace MQCHLLIB:0,-1 with MQCHLLIB:~0,-1
  The line should now read:
  if "%MQCHLLIB:~-1%"=="\" SET MQCHLLIB=%MQCHLLIB:~0,-1%
  4.  Save the modified file
  5.  Run the WMQ Explorer MS0T SupportPac
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
                     v7.0
  Platform           Fix Pack 7.0.1.3
  --------           --------------------
  Windows            U200320
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available, information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

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:

Fix information

• Fixed component name

  WMQ WINDOWS V7

• Fixed component ID

  5724H7220

Applicable component levels

• R701 PSY

     UP