The TDS Format properties described here apply to:
Property | Type | Meaning |
---|---|---|
Tag | String | Specify the value that is 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. If the object is a complex element and the Data Element Separation property of its parent is Tagged Delimited, Tagged Fixed Length, or Tagged Encoded Length, 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 that is to be used by the parser to identify the data in the message to be assigned to the object. This property is 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. |
Interpret Element Value | Enumerated type | Specify whether
values stored within this object must be interpreted as having significance
for the parser and, if so, the type of interpretation that must occur. This
interpretation is generally standard-specific and is therefore hard-coded. The possible values for this property are:
Note: The Message
Key enumeration has been deprecated
|
Repeating Element Delimiter | String | Specify the delimiter that is to be used between repeating
elements. This delimiter is used only when the element repeats and the Data Element Separation of the parent group or complex type is set to All Elements Delimited or Variable Length Elements Delimited. A default value is provided if the above conditions are true as follows:
If none of the above rules are met, a default is not applied. |
Property | Type | Meaning |
---|---|---|
Physical Type | Enumerated type | The Physical Type can
be set to Characters and Messaging Standard Alternate. This
property tells the TDS parser whether the data in the message is the normal
TDS character format, or is another alternate form that has a specific messaging
standard such as TLOG. The available values and the default value depend on
both Messaging Standard and
the logical type. If the logical type of the object is dateTime, float, or integer, this property is disabled. If the Messaging Standard property (at the message set level) is set to other than TLOG , the Physical Type property is disabled. If the Messaging Standard property (at the message set level) is set to TLOG and the logical type of the object is set to a Boolean, decimal or string type, the Physical Type property can be set to Characters or Messaging Standard Alternate. |
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 value that is not 0 or NULL. |
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 that is 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:
The choice of which of these padding character forms is used for an MRM element depends on the padding character required and whether the padding character is to be subject to data conversion. In most cases, the specification of a padding character is sufficient, and when this padding character is used, it is converted to the target code page of the output MRM message that is being generated. If a padding character is required that cannot easily be entered in the padding character field, the Unicode mnemonic format can be used to specify the required character. When used, this Unicode value is also converted to the target code page of the MRM message that is being generated. If a padding character is required that is not subject to data conversion, the hexadecimal format can be used. This gives the option of specifying a padding character that is inserted directly into the output message. If this format is used, you must ensure that this hexadecimal value is valid for the code page of any output messages that are created using these MRM definitions. If you are converting a message from one code page to another, you must ensure that the converted value of the padding character is valid for this code page. For example, when converting from ASCII to code page 500, if you have specified the numeric 8 as your padding character, this is converted from 0x08 to 0x15, the ASCII and EBCDIC representations of 'back space'. There is a currently a restriction that the value of your padding character must not be greater than U+007F. Note that if you enter a Unicode mnemonic or numeric value, it is considered to be the character that is represented by that number in UTF-8. |
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 |
---|---|---|
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. |
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
ad15620_ |