IT20137: dmpmqcfg outputs incomplete object definitions if queue manager CCSID cannot convert to locale CCSID

APAR status

• Closed as program error.

Error description

• If the CCSID corresponding to the locale where dmpmqcfg runs is
  not compatible with queue manager's CCSID, the dmpmqcfg program
  occasionally writes incomplete object definitions.  At the same
  time, the conversion error AMQ6047 is recorded in queue manager
  error log.
  
  Then, using that output to restore a queue manager will fail in
  respect of those definitions that were incomplete.
  
  This problem does not affect dmpmqcfg when running as a client
  (for example, connecting to a remote queue manager over TCP/IP).
  

Local fix

• Use chcp (Windows) or LANG environment variable (Linux, UNIX,
  IBM i platforms) to change the locale character set, to be one
  that is convertible from the queue manager CCSID.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users of the dmpmqcfg where the command is run from a locale
  that corresponds to a CCSID that does not convert to the queue
  manager's CCSID.  This problem only affects dmpmqcfg when it is
  running on the same machine as the queue manager, as a
  server-bound application.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  dmpmqcfg retrieves messages from the queue manager using an
  asynchronous consume mechanism, using MQGMO_CONVERT, leaving
  MQMD.CodedCharSetId as its default of 0.
  
  For the client-bound dmpmqcfg, this behaves as needed - the
  messages are converted to the CCSID of the locale.  If the
  conversion fails, dmpmqcfg learns of this via a bad return code,
  and fails the operation, with an error message.  The user is in
  no doubt that the operation failed.
  
  For the server-bound dmpmqcfg, this does not behave as needed -
  the messages are transferred to the dmpmqcfg program encoded in
  the queue manager's CCSID without error.  The problem comes
  later when the program is preparing its output.  In some cases
  conversion is attempted from the queue manager's CCSID to the
  CCSID of the locale.  If this latter conversion fails, an error
  message is written to the queue manager's error log, but the
  program continues, omitting the character string it was trying
  to convert.
  

Problem conclusion

• The server-bound dmpmqcfg program has been changed to explicitly
  set MQMD.CodedCharSetId equal to the CCSID of the locale.  This
  will ensure that, if conversion to the locale CCSID is not
  possible, then the user will see an error message in the output.
   No incorrect or incomplete data will be output.
  
  If this error is detected, and an error message is seen by the
  user, they must change the locale and re-run the dmpmqcfg
  program.  They should change it to have a character set that is
  convertible from the queue manager's CCSID.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.8
  v9.0 CD    9.0.4
  v9.0 LTS   9.0.0.2
  
  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:

  PI82301

Fix information

• Fixed component name

  WMQ BASE MULTIP

• Fixed component ID

  5724H7251

Applicable component levels

• R800 PSY

     UP