WebSphere Message Broker, Version 8.0.0.7
Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS
See information about the latest product version
See information about the latest product version
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 WebSphere® Message
Broker Version 8.0 and
later, message model schema files contained in applications
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 start:
Complete the following tasks:
- Enabling message set development
- Message Sets: Creating a message set
- Importing files from the file system into the WebSphere Message Broker Toolkit
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.
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:
- Switch to the Broker Application Development perspective.
- Open the New Message Definition File wizard by clicking FileNew Other from the WebSphere Message Broker Toolkit menu. A window opens in which you can select a wizard.
- Expand Message Broker - Message Set Development, select Message Definition, and click Next. The New Message Definition File wizard opens.
- In the displayed list of options, click C header file then click Next.
- Step through the remainder of the wizard completing the details as required.
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 WebSphere Message Broker Toolkit task list to check whether any new warnings or errors have appeared.