The TDS Format properties described here apply to:
Property | Type | Meaning |
---|---|---|
Tag | String | Specify the value used to identify the object in a message
bit stream If the object is simple and the Data
Element Separation property of the complex type or types in which
the object is a child is Tagged Delimited, Tagged Fixed Length, or Tagged Encoded Length, this property
must contain a non-empty value. Should the object be a complex element and the Data Element Separation property of its parent is Tagged Delimited, Tagged Fixed Length, or Tagged Encoded Length then the property can contain an empty value. The value for this property must be unique for every element in the message set, that is, no two elements in the message set can contain the same value for this property. |
Data Pattern | String | Specify the regular expression to be used by the parser to identify the data in the message to be assigned to the object. Used when the Data Element Separation method has been set to Use Data Pattern in the complex type. See Regular expression syntax for further details. |
Length | Integer | Specify
the expected length of the object in characters (except in the case of binary
objects, in which case the length value represents the length in bytes). This property applies to simple objects and to complex elements with a base type. If you give this property a value of 0, the Length Reference property is checked for a value. If you set the Data Element Separator property for the type to Fixed Length or Fixed Length AL3, either this property, or the Length Reference property, must contain a non 0 (or non NULL) value. |
Justification | Enumerated Type | Specify the justification of the object where the data being written or parsed is less than the fixed length value. This property is only used when a value is output as a fixed length string. Select one of the following values from the drop-down list:
|
Padding Character | String | Specify the padding character to be inserted or interpreted
on the writing or parsing of a fixed length object where the data is less
than the fixed length value. This property is only used when a value is output
as a fixed length string. Set this character in one of the following ways:
|
Repeating Element Delimiter | String | Specify the delimiter to be used between repeating elements. |
Length Reference | Enumerated type | Specify the identifier of a sibling Integer object,
the value of which dictates the length of the object in question. The sibling
object must be defined before the current object within the message structure.
For information about reordering elements, see Reordering objects. |
Property | Type | Meaning |
---|---|---|
Virtual Decimal Point | Button and Integer | Specify a nonzero integer representing the position
of an implied decimal point within a number, or specify 0 (zero, the default)
to use the formatting of Float or Decimal numbers as specified by the Precision property. If you specify a positive integer, the position of the decimal point is moved left from the right hand side of the number. For example, if you specify 3, the decimal value 1234 represents 1.234 If you specify a negative integer, the position of the decimal point is moved right from the right hand side of the number. For example, if you specify -3, the decimal value 1234 represents 1234000 |
Precision | Button and Integer | This
value is used if the Virtual Decimal Point property
value is 0, indicating that the decimal point is present in the data. It deals
with truncation, and specifies the number of digits that should follow the
decimal point. Either specify a number of digits:
Or select one of the following from the drop-down list:
|
Sign Orientation | Enumerated Type | Select the value that indicates the positioning of a
sign symbol within a numeric value, from the drop-down list:
If you set the value for this property to None, this is interpreted as having no sign, and an exception is thrown if a negative number is processed (on either input or output). If you set the value for this property Leading, this indicates that the sign is positioned ahead of the number, for example, -1234. Similarly, if you set this property to Trailing, the sign follows the number, for example, 1234-. If there is no explicit sign set, the number is assumed to be positive. |
Positive Sign | String | Specify the value that represents the positive symbol. If no value is set, "+" is assumed. The positive sign is not written when creating an output message, it is only used to recognize the positive sign when parsing a message bitstream. |
Negative Sign | String | Specify the value that represents the negative symbol. If no value is set, "-" is assumed. |
Property | Type | Meaning |
---|---|---|
Encoding Null | Enumerated Type | Select one of the following options from the drop-down
list. The option that you select determines the value that you must set for
the property Encoding Null Value:
For full information about using these options, see TDS Null handling options. |
Encoding Null Value | String | The use of this property depends on the Encoding
Null property, described above. The default value is zero. If you set the Encoding Null property for a dateTime object to NULLLogicalValue, you must set this property to an ISO8601 dateTime format. These formats are described in DateTime as STRING data. For example, specify a value conforming to yyyy-MM-dd'T'HH:mm:ss such as 1970-12-01. |
Related concepts
Message modeling
The message model
Related tasks
Developing message models
Working with message model objects
Related reference
Message model reference information
Message model object properties
Deprecated message model object properties
Compound element properties
Compound element TDS properties
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
ad16410_ |