IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IT00879

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7241

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-04-07

  • Closed date

    2014-05-01

  • Last modified date

    2014-05-01

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5"}]

Document Information

Modified date:
24 September 2021