The following tables show the properties that you can set for a TDS format message set.
See Default TDS message set properties for the default settings of these properties for each of the industry standards.
Property | Type | Meaning |
---|---|---|
Messaging Standard | Enumerated | Specify the standard to be used for this wire format.
Select one of the following values:
If you are defining your own tagged/delimited messages, or are using a standard that is not included in the list of values shown, select either User Defined Text, if all your data is text, or User Defined Mixed, if not all your data is text. The value that you select for this property determines the default values of some of the other properties. The default is User Defined Text. |
Property | Type | Meaning |
---|---|---|
Group Indicator | String | Specify the default value of a special character or string that precedes the data that belongs to a group or complex type within the bit stream. |
Group Terminator | String | Specify the default value of a special character or string that terminates data that belongs to a group or a complex type within the bit stream. |
Delimiter | String | Specify the default 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 Length Elements Delimited). |
Suppress Absent Element Delimiters | Enumerated | Use this property to select whether you want delimiters
to be suppressed for elements that are missing within a message. Select from:
|
Tag Data Separator | String | Specify the default value of a special character or
string that separates the tag from the data. If you set the property Tag Data Separator, the Length of Tag property is ignored. 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 default length of a tag value. When the
message is parsed, this property allows tags to be extracted from the bit
stream. The Tag Data Separator and Length of Tag properties are mutually exclusive. If you set the property Tag Data Separator, the Length of Tag property is ignored. This property applies only to the tagged Data Element Separation methods (Tagged Delimited, Tagged Fixed Length, and Tagged Encoded Length). |
Property | Type | Meaning |
---|---|---|
Default CCSID | Integer | CCSID (Coded Character Set Identification) specifies
the mapping between character codes and symbols. You must specify a code set
that is supported by WebSphere® Message
Broker. This property stores the default CCSID for the message bit stream, but this value can be overridden when the message is processed (for example, by the CCSID in the header of a WebSphere MQ input message). |
Enumerated | This property applies only to elements and
attributes with a physical type of Text.
This property specifies whether a simple element or attribute value is to
be trimmed when it is parsed. The property does not apply to a simple element,
or attribute, with a logical type of Boolean or Binary. All trimming is applied to element
or attribute values before the conversion of the value to its logical type.
This property does not apply when writing elements or attributes. This property
only applies to a simple element, or attribute, that is contained within a
complex type or group that has the Justification property
set to Left Justify or Right Justify, and that satisfies one
of the following conditions:
White space characters include control characters that are in the range from U+0000 to U+001f and from U+007f to U+009f. You might need to use this property if you have data input that is mapped to a numeric simple type. For example, if the input data has leading spaces, you can set this property to Leading White Spaces to avoid data conversion problems when you process these fields. |
|
Escape Character | Button and String | Specify the escape character that is used to allow special
reserved characters (such as delimiters) to be included as part of data. You
must specify a single character only, or a mnemonic that represents a single
character. Escape characters apply only in variable length fields. Escape characters, on parsing, always escape the next character, and are always removed. Escape characters, on writing, are inserted in front of all the characters that are listed in Reserved Characters. |
Reserved Characters | String | Specify any special reserved characters. Either these
reserve characters must be preceded by the Escape
Character, or the data field that contains them must be delimited
by a pair of Quote Characters, if
they are to be included as part of the data. The Escape
Character, Quote Character,
delimiters, and group indicators must be included in this list. If the set of reserved characters is to be updated dynamically (in the case of EDIFACT and X12 when reserved characters, such as delimiters, are specified in service strings), you must use the supplied mnemonics to specify characters in this list. If you have specified Reserved Characters, an Escape Character or a Quote Character must also be specified. Reserved characters apply only in variable length fields. Reserved characters are not used when parsing. |
Derive default length from logical type | Check box | If this check box is selected, the value of an element's unset Length property is derived from the simple type of the element (string, binary, integer, and decimal, simple types only). |
Property | Type | Meaning |
---|---|---|
Decimal Point | String | Specify the character that is used to separate the whole part of a number from its fraction. |
Packed decimal positive code | String | Controls the positive sign that is used for packed decimal
fields. Valid values are C or F. Specify the character that is used to separate the whole part of a number from its fraction. |
Strict Numeric Checking | Check box | Use this property in conjunction with the Messaging
Standard property, the Virtual Decimal
Point property and the Precision property
of an element. Using this property allows you to apply stricter rules for
the checking of numbers. The rules for Strict
Numeric Checking are:
|
Derive sign from logical type | Check box | If this property is selected, an unset TDS Signed property attempts to derive its value from the simple type of the element (integer and decimal simple logical types only). For these logical types it applies only to the Integer, External Decimal, and Packed Decimal physical types. |
Default byte order | Enumerated | Controls the byte order of numbers that are represented
as binary integers for messages with no MQMD. Valid values are Big Endian or Little Endian. This property stores the default byte order for numbers that are represented as binary integers for messages with no MQMD, but this value can be overridden when the message is processed. |
Default packed decimal byte order | Enumerated | Controls the byte order of numbers that are represented
as packed decimal for messages with no MQMD. Valid values are Big Endian or Little Endian. This property stores the default byte order of numbers that are represented as packed decimal for messages with no MQMD, but this value can be overridden when the message is processed. |
Default float format | Enumerated | Controls the format of numbers that are represented
as float for messages with no MQMD. Valid values are S390, IEEE, or Reverse IEEE. This property stores the default format of numbers that are represented as float for messages with no MQMD, but this value can be overridden when the message is processed. |
Property | Type | Meaning |
---|---|---|
Text boolean true value | String | Specifies the character that represents the text Boolean true value. |
Text boolean false value | String | Specifies the character that represents the text Boolean false value. |
Text boolean null value | String | Specifies the character that represents the text Boolean null value. |
Binary boolean true value | String | Specifies a hexadecimal value that represents the binary Boolean true value. |
Binary boolean false value | String | Specifies a hexadecimal value that represents the binary Boolean false value. |
Binary boolean null value | String | Specifies a hexadecimal value that represents the binary Boolean null value. |
Property | Type | Meaning |
---|---|---|
Derive default dateTime format from logical type | Button | Select this option if you want the default dateTime
format to be determined by the logical type of the element or attribute. You can override this property for an element or attribute within a complex type. |
Use default dateTime format | Button and String | Select this option if you want to specify a default
dateTime format that is fixed for all elements or attributes of logical type
dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay, and gDay. You can override this property for an element or attribute within a complex type. For more information, see DateTime formats. |
Start of century for 2 digit years | Integer | This property determines how two-digit years are interpreted. Specify the two digits that start a 100-year window that contains the current year. For example, if you specify 89, and the current year is 2002, all two-digit dates are interpreted as being in the range 1989 to 2088. |
Days in First Week of Year | Enumerated | Specify the number of days of the new year that must
fall within the first week. The start of a year typically falls in the middle of a week. If the number of days in that week is less than the value specified here, the week is considered to be the last week of the previous year; therefore, week 1 starts some days into the new year. Otherwise, it is considered to be the first week of the new year; in this case, week 1 starts some days before the new year. Select Use Broker Locale, which causes the broker to get the information from the underlying platform, or select a number from the list that is displayed. |
First Day Of Week | Enumerated | Specify the day on which each new week starts. Select Use Broker Locale, which causes the broker to get the information from the underlying platform, or select a value from the list that is displayed. |
Strict DateTime Checking | Check box | Select this option if you want to restrict dateTimes
to a valid dateTime format. If Strict DateTime
Checking is selected, receiving an incorrect dateTime causes an error.
|
Time Zone | Enumerated | The value that you set for this property is used if
the value that you specified for the Default
DateTime Format property does not include Time Zone information. The initial value is Use Broker Locale, which causes the broker to get the information from the underlying platform. You can change this property by selecting from the list of values. |
Daylight Savings Time | Check box | Select this option if the area in the Time
Zone property observes Daylight Saving Time. If it does not observe
Daylight Saving Time, do not select this option. For example, if an area is selected in Time Zone and this option is not selected, the value passed represents the time zone without the Daylight Saving Time. |
Use input UTC format on output | Check box | This property applies to elements and attributes of
logical type xsd:dateTime or xsd:time that have a dateTime format of I, IU,
T, or TU, or that include ZZZ or ZZZU. Such elements and attributes can specify Coordinated Universal Time (UTC) by using either the Z character or timezone +00:00 in the value. On input, the MRM parser remembers the way that UTC was specified. If this property is selected, and the element or attribute is copied to an output message, the UTC format is preserved into the output message and overrides the format that is implied by the dateTime format property. If this property is cleared, or the element or attribute was not copied from an input message, the UTC format in the output message is controlled solely by the dateTime format property. |
Property | Type | Meaning |
---|---|---|
Output policy for missing elements | Enumerated | Controls whether the default value or null value is
used on output for missing elements. Valid values are UseDefaultValue or UseNullValue. |
Derive default length from logical type | Check box | If this property is selected, an unset TDS Length property attempts to derive its default value from the simple type of the element (string, binary, integer, and decimal simple logical types only). For these logical types, it applies only to the Binary, Text, Integer, External Decimal, and Packed Decimal physical types. |