IT00879: MQ .NET CLIENT APPLICATION USING A CCDT TO CONNECT TO A QUEUE MANAGER FAILS WITH AMQ9518

Fix Pack 7.1.0.6 for WebSphere MQ V7.1

APAR status

• Closed as program error.

Error description

• After setting the environment variables MQCHLLIB and MQCHLTAB
  to make use of the CCDT, the .NET client application fails to
  connect to the queue manager reporting AMQ9518 . The following
  error is written to the error log:
  
  Process(1234.1) User(IBMuser) Program(test.exe)
  
  Host(IBMSupportbox)Installation(Installation`)
   VRMF(7.5.0.2) AMQ9518: File
  '#:\###\AMQCLCHL.TAB' not found.
  
  EXPLANATION:
  The program requires that the file '#:\###\AMQCLCHL.TAB' is
  present and available. ACTION:
  This may be caused by invalid values for the optional
  environment
  variables MQCHLLIB, MQCHLTAB or MQDATA. If these variables are
  valid or not set then record the name of the file tell the
  systems administrator who must ensure that file
  '#:\###\AMQCLCHL.TAB' is available to the program.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All MQ client application that connects to the queue manager
  using CCDT.
  
  
  Platforms affected:
  Windows
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  If first connection of a client application does not use the
  client channel definition table (CCDT) file and if the second
  connection made by the same application tries to use CCDT to
  establish connection with the queue manager then the client code
  looks for the CCDT file only in the default path. It does not
  attempt to pick the value set in the environment variable
  MQCHLLIB and hence the connection fails if the CCDT file is not
  in the default path.
  

Problem conclusion

• MQ code has been modified to retrieve the CCDT information from
  the environment variable.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.1.13
  v7.1       7.1.0.6
  v7.5       7.5.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

  WMQ BASE MULTIP

• Fixed component ID

  5724H7241

Applicable component levels

• R750 PSY

     UP