IT29667: Installation of IBM MQ client for Windows fails with AMQ4739

APAR status

• Closed as program error.

Error description

• Attempts to migrate a existing client to a newer version fails
  with AMQ4739.
  The install log reports an error running the amqidsec.bat file.
  
  MQCA iwiLaunchAmqidsec info: Launching process 'cmd' ' /c
  "C:\Program Files (x86)\IBM\WebSphere MQ\bin\amqidsec.bat"
  Installation1
  >C:\Users\nnnnn\AppData\Local\Temp\amqidsec-Installation1.txt
  2>&1'; dir 'C:\Users\nnnnn\AppData\Local\Temp'.
  MQCA iwiLaunchAmqidsec info: Process 'cmd' ended; exit code
  0x00000002
  MQCA iwiLaunchAmqidsec(icsLaunchAmqidsec) info: amqidsec.bat
  retVal=0
  MQCA iwiLaunchAmqidsec(icsLaunchAmqidsec) info: amqidsec.bat
  dwExitCode=2
  MQCA iwiLaunchAmqidsec(icsLaunchAmqidsec) info: ***ERROR:
  amqidsec.bat returned bad dwExitCode=2
  MQCA iwiLaunchAmqidsec(icsLaunchAmqidsec) info: ***ERROR: bad
  return code (2) from security script invocation
  MQCA iwiLaunchAmqidsec(iwiLaunchAmqidsec) info: ***ERROR:
  invocation of amqidsec.bat returned retVal=2
  MQCA iwiLaunchAmqidsec info: Property 'AMQLANGDLLCREATED' value
  '1'; from CustomActionData
  MQCA iwiLaunchAmqidsec(iwiKillSplashBitmap) info: Splash bitmap
  not running
  MQCA iwiLaunchAmqidsec(iiiDisplayMsgBox) info: MQCA
  iwiLaunchAmqidsec MB *** error: One or more problems occurred.
  Review the trace and/or log file for details. (AMQ4739)
  1: One or more problems occurred. Review the trace and/or log
  file for details. (AMQ4739)
  The amqidsec-Installation1.txt file reports:
  00:00:00.00 - start processing "C:\Program Files
  (x86)\IBM\WebSphere MQ\mqxr" directory
  PERMISSIONS BEFORE "C:\Program Files (x86)\IBM\WebSphere
  MQ\mqxr\bin CHANGES"...
  ---running: icacls "C:\Program Files (x86)\IBM\WebSphere
  MQ"\mqxr\bin
  C:\Program Files (x86)\IBM\WebSphere MQ\mqxr\bin: The system
  cannot find the file specified.
  Successfully processed 0 files; Failed processing 1 files
  ***ERROR: icacls returned ERRORLEVEL 2
  ***ERROR: Error setting permissions on the "C:\Program Files
  (x86)\IBM\WebSphere MQ\mqxr" directory
  

Local fix

• As the MQXR directory is not supposed to be present in a client
  only installation, either try removing the MQXR directory or
  install the client to a different location.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users installing or upgrading to one of the following MQ Client
  versions:
  
   8.0.0.12, 8.0.0.13
   9.0.0.6, 9.0.0.7, 9.0.0.8
   9.1.0.2, 9.1.0.3, 9.1.0.4
  
  This issue does not affect installation of the client libraries
  using the full product (server) installer.
  
  
  Platforms affected:
  Windows
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The issue is seen only when installation in performed against a
  location which has MQXR folder already present in the target
  path. The presence of this unexpected directory caused the
  installation logic to report the AMQ4739MQ when attempting to
  set permissions on the installed directories.
  

Problem conclusion

• The MQ Client install code has been modified to rectify the
  problem.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.14
  v9.0 LTS   9.0.0.9
  v9.1 CD    9.1.3
  v9.1 LTS   9.1.0.5
  
  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

  IBM MQ BASE MP

• Fixed component ID

  5724H7251

Applicable component levels