Before you start:
To complete this task, you must
have completed the following tasks:
You must create a message definition file before you can create the
message model objects. The message definition file contains the logical and
physical model definitions of the objects in XML schema form.
To create
an empty message definition file to contain your message model objects:
- Switch to the Broker Application Development
perspective.
- Right-click in the Resource Navigator then click New
> Message Definition File on the pop-up menu. This
opens the New Message Definition File wizard.
Tip: If you select the message set to which you are adding a message
definition file before you open the New Message Definition
File wizard, the message set is preselected when the wizard opens.
The
wizard displays the following options, which allow you to select whether you
want to create an empty message definition file, or import message definitions
from a source file:
- Create a new message definition file
- This option allows you to create an empty message definition file, as
described in the remaining steps of this task. You can then create the content
yourself using the Message Definition editor.
- XML Schema file
- This option allows you to create a message definition file and associated
message definitions from an XML schema file. For further information on this
task see Importing from XML schema.
- XML DTD file
- This option allows you to create a message definition file and associated
message definitions from an XML DTD file. For further information on this
task see Importing from XML DTD.
- C header file
- This option allows you to create a message definition file and associated
message definitions from a C header file. For further information on this
task see Importing from C.
- COBOL file
- This option allows you to create a message definition file and associated
message definitions from a COBOL file. For further information on this task
see Importing from COBOL copybooks.
- To create an empty message definition file,
click Create a new message definition file. This displays the Message Definition File page.
- In the top pane, select the message set to which
you are adding a new message definition file.
- Type the File Name that
you want to use for your new message definition file.
- Optional: If you do not want to add any further
configuration information for the message definition file at this point, click Finish to
close the wizard.
- If you want to continue with adding configuration
information for your message definition file, click Next.
This displays the "Message definition namespace" page,
which allows you to specify the namespace for the new message definition contents.
- In the Schema for Schema settings pane, either
keep the default selections shown in the Prefix and Namespace fields
or change the information in the fields according to your requirements.
- If you want to use a target namespace for this
message definition file, select the Use target namespace check
box. (This enables the Target namespace pane.) You can only choose a target
namespace if namespaces are enabled for the message set as described in Creating a message set.
- Either keep the default selections shown in
the Prefix and Namespace fields
or change the information in the fields according to your requirements.
- Click Finish.
The new empty message definition file with the name that you have
specified and a file extension of *.mxsd opens
in the Message Definition Editor so that you can use the editor to create
your own message definitions. If you have selected to use a target namespace,
a directory structure based on the URI that you have supplied is created.
The new message definition file is placed within this directory structure,
which appears in the Resource Navigator, Outline view and Overview editor.