This describes how to create a new message definition from an XML
DTD using the New Message Definition File wizard in the workbench.
Before you start:
To complete this task, you must
have completed the following tasks:
Before you begin this task, you should be aware of the points listed
below:
- To create a new message definition file from an XML DTD, the DTD file
must already be present in the workbench,
for example in your message set project. This allows you to select the DTD
file in the New Message Definition File wizard.
- 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 lower case.
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 Broker Application Development
perspective.
- Open the New Message Definition File wizard
by clicking File > New > Message Definition File from
the workbench menu.
- In the displayed list of options, click XML DTD file to
select it then click Next.
- Step through the remainder of the wizard filling
in 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 workbench 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 workbench task list to see whether you need to
make any corrections to resolve errors or warnings relating to the new file.