IBM Support

ICM: "Message file cmbmsg816.dll load error" solution for C++ applications

Flashes (Alerts)


Abstract

If your custom C++ application for IBM DB2 Content Manager Express Edition Version 8.2 or DB2 Content Manager Enterprise Edition Version 8.2 is unable to locate the text for the error messages, this document outlines one solution. The applications cannot locate error message text because they cannot locate the cmbmsg816.dll, cmbmsg817.dll, or other libraries that contain the messages.

Content

Custom C++ applications for IBM DB2® Content Manager Express Edition Version 8 or IBM DB2® Content Manager Enterprise Edition Version 8 must be able to locate the necessary libraries for the messages. The applications cannot locate the error messages' text because they cannot locate the cmbmsg816.dll, cmbmsg817.dll, or other libraries that contain the messages.

For example, you will receive the following message in place of the intended message:


    Message file cmbmsg816.dll load error. [MessageNumber = 394, Windows system error RC = 126] DKDatastoreICM.connect [SERVER = ICMNLSDB, USERID = user2]; Message file cmbmsgls816.dll load error. [MessageNumber = 7127, Windows system error RC = 126] (STATE) : [LS RC = 7127]

Solution

Refer to the Messages and Codes book for the error message number and error codes provided. Error DGL0300A in the Messages and Codes book provides more information on how to extract the correct text.

In order to correctly setup the environment, use the environment setup script, cmbenv81.bat (or cmbenv81.sh for AIX systems), provided by DB2® Content Manager. The cmbenv81 script file is available in the direction indicated by the CMBROOT environment variable. For example, on Windows systems, the default location is C:\CMBROOT\cmbenv81.bat.

If that does not work, validate and add the following setting to your environment so that the C++ application can locate the necessary DLLs. Validate that the cmbmsg81x.dll file that is used by your application exists in the location indicated below, where 'x' indicates the compiler version in use. Modify your PATH environment variable to include the path to the required message libraries.


    Windows

    set PATH = %PATH%;%CMBROOT%\Lang\enu\dll

    Where "enu" is the three-letter language designation. In the example above, "enu" designates English.


Do not modify the cmbenv81.bat script file directly. You can make a copy and then modify and use your copy of the file. Since you would then be using your own copy of the file, check for differences in the original file after fix packs and service releases are applied so that you can update your copy.

[{"Product":{"code":"SSRS7Z","label":"IBM Content Manager Enterprise Edition"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"DB2 Information Integrator for Content","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.2;8.3","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSRS7Z","label":"IBM Content Manager Enterprise Edition"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Usage","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"","label":"UNIX"},{"code":"","label":"Windows 2000"},{"code":"","label":"Windows NT"},{"code":"","label":"Windows XP"},{"code":"","label":"Windows 2003"}],"Version":"8.2;8.3","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
25 September 2022

UID

swg21144041