Table of Contents

Search

  1. Preface
  2. Understanding PowerExchange for JMS
  3. Configuring PowerExchange for JMS
  4. Working with JMS Sources and Targets
  5. Creating and Configuring JMS Workflows
  6. Appendix A: JMS Datatype Reference
  7. Appendix B: Glossary of Terms

PowerExchange for JMS User Guide for PowerCenter

PowerExchange for JMS User Guide for PowerCenter

Editing JMS Source and Target Definitions

Editing JMS Source and Target Definitions

You can edit JMS source and target definitions to reflect changes in source or target messages. You can also modify the name and description of the source and target definitions. Edit source and target definitions from the Edit Tables dialog box.
If the source or target is WebSphere MQ JMS, use the following guidelines when editing JMS source and target definitions:
  • Property field names cannot begin with JMS_.
  • Property and body field names cannot begin with a number.
To edit JMS source and target definitions:
  1. For source definitions, double-click the title bar of the source definition in the Source Analyzer. For target definitions, double-click the title bar of the target definition in the Target Designer.
    The Edit Tables window appears.
  2. Click the JMS Message Header Columns tab.
  3. Optionally, edit the datatype and precision of the header columns.
    Only some header columns have editable datatype and precision.
  4. For JMS target definitions, optionally select the Not Null option for any header field.
    When you select Not Null, the field must contain a value when the PowerCenter Integration Service writes messages to the target during the session. Otherwise, the PowerCenter Integration Service generates an error for the field.
    For some header fields, you can configure values for the fields in the session properties.
  5. Click the JMS Message Property Columns tab.
  6. Edit the property fields:
    • To add a new property field, click the Add button. When you add a new field, you can change the name, datatype, and precision of the field.
    • To remove a property field, click the Delete button.
    • To change the order of property fields, use the up and down arrows.
  7. For JMS target definitions, optionally select the Not Null option for any property field.
    When you select Not Null, the field must contain a value when the PowerCenter Integration Service writes messages to the target during the session. Otherwise, the PowerCenter Integration Service generates an error for the field.
    When you leave Not Null blank and the mapping does not contain a link to the field in the target definition, the PowerCenter Integration Service does not include the field in the JMS target messages.
  8. Click the JMS Message Body Columns tab.
  9. Optionally, select one of the following message types from the Message Body Type list:
    JMS Message Type
    Description
    Message
    Designer removes any body fields from the source or target definition.
    TextMessage
    Designer removes any body fields and adds a new body field called BodyText to the source or target definition. Source and target definitions in TextMessage format can only contain one body field.
    BytesMessage
    Designer removes any body fields and adds a new body field called BodyBytes to the source or target definition. Source and target definitions in BytesMessage format can only contain one body field.
    MapMessage
    Designer removes any body fields from the source or target definition. However, you can add new body fields.
  10. For messages of the type MapMessage, edit the body fields:
    • To add a new body field, click the Add button. When you add a new field, you can change the name, datatype, and precision of the field.
    • To remove a body field, click the Delete button.
    • To change the order of the body fields, use the up and down arrows.
  11. For JMS target definitions, optionally select the Not Null option for any body field.
    When you select Not Null, the field must contain a value when the PowerCenter Integration Service writes messages to the target during the session. Otherwise, the PowerCenter Integration Service generates an error for the field.
    When you leave Not Null blank and the mapping does not contain a link to the field in the target definition, the PowerCenter Integration Service does not include the field in the JMS target messages.

0 COMMENTS

We’d like to hear from you!