Message Sets: Importing from XML DTD

You can create a new message definition from an XML DTD by using the New Message Definition File wizard in the IBM® Integration Toolkit.

Tip: In WebSphere® Message Broker Version 8.0 and later, 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 an XML DTD for use by the XMLNSC domain, see Creating an XML Schema file by using the New Message Model wizard.

Before you begin

You must have completed the following tasks:

Before you begin this task, you should be aware of the following points:

  • If the message set to which you are adding the new message definition file does not have an XML wire format (XML) layer only the logical information appears in the model. You can add the physical layer to the message set before or after importing from a XML DTD, but you should add the physical layer before importing it to ensure that it is populated with settings from the XML DTD.
  • It is also possible to import an XML DTD from the command line using mqsicreatemsgdefs.
  • The file extension must be .dtd in lowercase.

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 from an XML DTD:

Procedure

  1. Switch to the Integration Development perspective.
  2. Open the New Message Definition File wizard by clicking File> New> Message Definition File from the IBM Integration Toolkit menu.
  3. In the displayed list of options, click XML DTD file to select it then click Next.
  4. Step through the remainder of the wizard completing the details as required.

Results

When you have completed importing the XML DTD 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 .dtd.report.txt file extension, prefixed with the name that you specified for the new message definition file.
  • Review the messages shown in the IBM Integration Toolkit task list to check whether any new warnings or errors have appeared.

The message definition file is created from the XML DTD and is opened in the Message Definition editor so that you can check the imported information and make any required changes. While you are checking the newly created message definition file, review any messages that appear in the IBM Integration Toolkit task list to see whether you need to make any corrections to resolve errors or warnings relating to the new file.