WebSphere Message Brokers
File: ad06780_
Writer: Terry Cowling

Reference topic

This build: July 31, 2007 21:22:52

Global group TDS properties

Field Identification

Property Type Meaning
Data Element Separation Enumerated type Select one of the following values to specify the method that is used to separate the data elements within the type.
  • Tagged Delimited. This value indicates that all elements within the complex type are identified by a tag, and are separated by the value that is specified in the optional Delimiter property (if specified). You must set the Tag property for all child elements of simple type, and you can set the Delimiter property to a non-empty value. See Global element TDS properties. You must also set the Tag Data Separator or the Length of Tag property.
  • Tagged Fixed Length. This value indicates that each element is identified by a tag, and the data has a fixed length. There are no delimiters. You must set the Tag property for each of the child elements of this complex type, and each child element must have a Length or Length Reference property assigned to it. You must also set the Tag Data Separator or the Length of Tag property.
  • Tagged Encoded Length. This value indicates that all elements within the complex type are separated by a tag, and a length field follows each tag. There are no delimiters. The tag can be fixed length, as set by the Length of Tag property, or variable length delimited by the Tag Data Separator property. You must also set the Length Of Encoded Length property so that the parser knows the size of the length field, and set the Extra Chars in Encoded Length property to tell the parser what to subtract from the value in the Length Of Encoded Length property to get the actual length of the data that follows the length field.

    This method provides a more flexible way of handling ACORD AL3 standard messages than using the Fixed Length AL3 value, by allowing different parts of the messages to be at different versions of the ACORD AL3 standard.

  • All Elements Delimited. This value indicates that all elements within the complex type are separated by a delimiter. You must set a value in the Delimiter property.
  • Variable Length Elements Delimited. This value indicates that some of the elements within the complex type might be of variable length; if they are, they must be delimited by the value that is specified in the Delimiter property.
  • Use Data Pattern. This value indicates that the parser determines the elements by matching the data with the regular expression that is set in the Data Pattern property of the element or type member. See Message definition file properties.
  • Fixed Length. This value indicates that all elements within the complex type are fixed length. The next data element is accessed by adding the value of the Length property to the offset. See Global element TDS properties. If you set the Data Element Separation property of a complex type to Fixed Length, you must also set the Data Element Separation property of all complex children of this type to Fixed Length. Each child element must have a Length or Length Reference property assigned to it.
  • Fixed Length AL3. This value has a similar meaning to the separation type Fixed Length, but also indicates to the parser that a number of predefined rules with regard to missing optional elements, encoded lengths, and versioning, must be applied. If you set the Data Element Separation property of a complex type to Fixed Length AL3, you must also set the Data Element Separation property of all complex children of this type to Fixed Length AL3.
  • Undefined. This value is set automatically if you set the Type Composition property of a complex type to Message, and you cannot change it to any other value.

    Do not set the Type Composition property to Empty, Choice, Unordered Set, Ordered Set, Sequence, or Simple Unordered Set. If you do, you cannot check in the type.

Group Indicator String Specify the value of a special character, or string, that precedes the data that belongs to a group, or a complex type, within the bit stream.
Group Terminator String Specify the value of a special character, or string, that terminates the data that belongs to a group, or a complex type, within the bit stream.
Delimiter String Specify the value of a special character, or string, that specifies the delimiter that is used between data elements.

This property applies only to the delimited Data Element Separation methods (Tagged Delimited, All Elements Delimited, and Variable Elements Delimited).

Suppress Absent Element Delimiters Enumerated type Use this property to select whether you want delimiters to be suppressed for elements that are missing within a message.
Select from:
  • End Of Type. Use this option to suppress the delimiter when an element is missing. For example, if the model has been defined to have up to 3 elements and only 2 are present, the last delimiter can be omitted from the message.
  • Never. Use this option to ensure that even if optional elements are not present, all delimiters are written out. This option should be used when the same delimiter is used to delimit parent and child objects. For example, if an optional child element is missing, message processing applications could not tell where the child elements in a message ended and the next parent element started, if the delimiters are all the same.
Observe Element Length Check box This property is applicable when Data Element Separation is All Elements Delimited, and tells the TDS parser to take any Length property of child elements or attributes into account. The default value depends on the setting of the Messaging Standard property (at the message set level) and the Data Element Separation property.
  • If Data Element Separation is All Elements Delimited and the Messaging Standard is set to TLOG, this property should be set. For all other messaging standards it should not be set.
  • If Data Element Separation is Tagged Delimited, this property should not be set.
  • If Data Element Separation is Tagged Fixed Length, Fixed Length, Fixed Length AL3, or Variable Length Elements Delimited, this property is set and is disabled.
  • For all other data element separation methods, this property is not set and is disabled.
Any other combination generates a task list warning.
Tag Data Separator Button and String Specify the value of a special character or string that separates the Tag from the data. The Tag Data Separator and Length of Tag properties are mutually exclusive.

If you set the property Tag Data Separator, it overrides Length of Tag.

This property applies only to the tagged Data Element Separation methods (Tagged Delimited, Tagged Fixed Length, and Tagged Encoded Length).

Length of Tag Integer Specify the length of a tag value. When the message is parsed, this allows tags to be extracted from the bit stream if the Tag Data Separator property is not set.

The Tag Data Separator and Length of Tag properties are mutually exclusive. If you set the property Tag Data Separator, it overrides this value.

This property applies only to the tagged Data Element Separation methods (Tagged Delimited, Tagged Fixed Length, and Tagged Encoded Length).

Length of Encoded Length Integer Specifies the number of characters (not bytes) after a tag that are used for the length field. Enter a value from 0 to 2 147 483 647.

You must set this property if you have set the Data Element Separation property to Tagged Encoded Length; it is not valid otherwise.

The actual number of data characters that are parsed depends on the value of the Extra Chars in Encoded Length property.

Extra Chars in Encoded Length Integer (Only valid if the Data Element Separation method is set to Tagged Encoded Length.) Specifies the number of extra characters included in the value found in the length field. (For example, the value in the length might include the size of the length field itself as well as the size of the data field, or it might be the total size of the tag, length, and data fields.)

Enter a value from 0 to 2 147 483 647. The parser subtracts this number from the number found in the length field to get the number of data characters that follow the length field.

You must set this property if you have set the Data Element Separation property to Tagged Encoded Length, and the actual number of data characters is less than the value found in the length field.

Related concepts
Physical formats in the MRM domain
TDS format
TDS format: Relationship to the logical model
Related tasks
Working with physical properties
Configuring physical properties
Related reference
Message model object properties
Physical properties for message model objects
Custom Wire Format physical properties for message model objects
XML wire format physical properties for message model objects
Documentation properties for all message set objects
Message model object properties by object
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:22:52

ad06780_ This topic's URL is: