IT11525: MQ APPLIANCE V8 CANNOT SEE LOG IF QUEUE MANAGER NAME CONTAINS DOT(.) , PERCENT (%), UNDERSCORE(_), OR SLASH (/)

APAR status

• Closed as program error.

Error description

• In MQ console of Queue Manager Widget,
  if customers try to see the log(More -> View Logs) ,
  message("Failed to retrieve directory listing") is output
  when the name of the queue manager cantains dot(.) , percent
  (%), underscore (_) and slash (/) .
  

Local fix

• Use the mqcli command "dspmqerr" to view error logs via the CLI.
  e.g. "dspmqerr -m QUEUE.MANAGER.NAME"
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Those using the Web UI to attempt to view Queue Manager error
  logs of a Queue Manager with a name containing a supported
  special character.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  Due to limitations with the file system on the MQ Appliance, in
  the case where a Queue Manager name contains a special character
  it is necessary to convert the name of the Queue Manager in to a
  name that can be used to store the Queue Manager data.
  
  The Web UI component was using the actual Queue Manager name to
  attempt to find the error logs in the file system. As this name
  does not match that of the actual storage location of the error
  files, the file is not found and an error occurs.
  

Problem conclusion

• The MQ Appliance Web UI component has been updated so that Queue
  Manager name is correctly translated to the on-disk file path,
  allowing the logs to be viewed within the Web UI.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.4
  
  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 APPL M20

• Fixed component ID

  5725S1400

Applicable component levels

• R800 PSY

     UP