Creating a Message Definition

If you plan to use custom wire formats in a message service, create a message definition.

For assistance in performing this task, open the Creating a Message Definition cheat sheet.

To create a message definition:

  1. In the Service Development perspective, select File|New|Other from the main menu bar.

    The New wizard opens.

  2. Expand Sybase and select Message Definition.

  3. Click Next.

    The New Message Definition page opens.

  4. In the Enter or select the parent folder field, select the project to contain the message definition.

  5. Enter the message definition name in the File name field.

    Consider the following before naming a message definition:

    • The name must not exceed 64 characters and must conform to the naming conventions for XML elements, available at http://www.w3c.com, and the naming conventions for Java classes, available at http://java.sun.com. For more information, see Troubleshooting Message Definition Objects.

    • Use a naming convention appropriate for your implementation. Sybase recommends keeping message names unique and avoiding message names that differ only in case.

  6. Do one of the following:

    • To accept the default settings for all message definition properties, click Finish.

      The message definition automatically inherits default property settings specified in message default preferences.

      Note

      You can also change design-related default settings for custom messages after the message definition is created. Select Change design defaults from the context menu accessed from the Message Details page of the Message Definition editor.

    • To specify default properties for the message definition:

      1. Click Next.

        You can specify default values for message, container, field, date and time, numeric, and length properties. Each set of properties is defined on a separate wizard page.

      2. Select defaults for each property, clicking Next to move from page to page.

        Note

        It is possible to select any combination of default properties even though it is impractical or impossible to use all settings in the same message definition.

      3. Click Finish when the default properties are set.

        The message definition appears in the WorkSpace Navigator, and the message definition opens in the Message Definition Editor.

Editing a Message Definition

Setting Message Definition Preferences

Custom Wire Formats

Naming Conventions

Supported Character Sets

Supported Datatypes

Supported Datatypes for HL7 Messages

Supported Date and Time Format Codes

Send your feedback on this help topic to Sybase Tech Pubs: pubs@sybase.com