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. |
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.
|
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:
The choice of which of these padding character forms is used for an MRM element will depend 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 will be sufficient and when this padding character is used, it will be converted to the target codepage of the output MRM message being generated. If a padding character is required that cannot easily be entered in the padding character field, then the Unicode mnemonic format can be used to specify the required character. When used, this Unicode value will also be converted to the target codepage of the MRM message being generated. If a padding character is required that is not subject to data conversion, then the hexadecimal format can be used. This gives the option of specifying a padding character that is inserted directly in the output message. If this format is used then you must ensure that this hexadecimal is valid for the codepage of any output messages that are created using these MRM definitions. If you are converting a message from one code page to another, then you must ensure that the converted value of the padding character is valid for this codepage. For example, when converting from ASCII to the codepage 500, if you have specified the numeric 8 as your padding character then 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 should not be greater than U+007F. You should note that if you enter a Unicode mnemonic or numeric value, it is considered to be the character represented by that number in UTF-8. |
DateTime Format | String | Specify a template for date and time. The default DateTime format is dependent on the logical type of the object. For information on the defaults for the dateTime format according to the logical type see DateTime defaults by logical type. See DateTime formats for details of date and time formats. |