Message Sets: Importing from C

Create a message definition file from a C header file for use in the MRM and IDOC domains.

Tip: In IBM® App Connect Enterprise, message model schema files contained in applications, integration services, and libraries are the preferred way to model messages for most data formats. Message sets are required if you use the MRM or IDOC domains. For more information about message modeling, see Message modeling concepts. For information about how to import a C header file for use by DFDL domain, see Creating a DFDL schema file by using the New Message Model wizard.

Before you begin

Complete the following tasks:

Be aware of the following points:

  • The wizard can import C header files with .h, .c and .css extensions. If your source file has a different extension you must rename it before attempting to import it.
  • If the message set to which you are adding the new message definition file does not have an Custom Wire Format (CWF) layer only the logical information appears in the model. You can add the physical layer to the message set before or after importing a C header file, but you should add the physical layer before importing it to ensure that it is populated with settings from the C header file.
  • You can import a C header file from the command line using mqsicreatemsgdefs.

About this task

The following steps cover both creating a completely new message definition file and overwriting the contents of an existing file.

To create a message definition file from a C header file:

Procedure

  1. Switch to the Integration Development perspective.
  2. Open the New Message Definition File wizard by clicking FileNew Other from the IBM App Connect Enterprise Toolkit menu.
    A window opens in which you can select a wizard.
  3. Expand Message Broker - Message Set Development, select Message Definition, and click Next.
    The New Message Definition File wizard opens.
  4. In the displayed list of options, click C header file then click Next.
  5. Step through the remainder of the wizard completing the details as required.

Results

When you have completed importing the C header file using the wizard:

  • Carefully check for any errors in the report that is created when the file is imported. You can find this report in the log directory within the project containing the message definition that you have attempted to create. The report has a .c.report.txt file extension, prefixed with the name that you specified for the new message definition file.
  • Review the messages shown in the IBM App Connect Enterprise Toolkit task list to check whether any new warnings or errors have appeared.