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 start:
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.
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:
- Switch to the Integration Development perspective.
- Open the New Message Definition
File wizard by clicking File> New> Message Definition
File from the IBM Integration Toolkit menu.
- In the displayed list of options, click XML
DTD file to select it then click Next.
- Step through the remainder of the wizard completing the
details as required.
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.