beautypg.com

Echelon i.LON 100 e2 Internet Server User Manual

Page 199

background image

Table 70 TypeTranslatorRuleGet Properties

Property Description

The index number assigned to the Type Translator Rule must be in the range 0-

32,767. As mentioned earlier, you can use the TypeTranslatorRuleSet function
to create a new Type Translator Rule, or to modify an existing Type Translator

Rule. If you do not specify an index number in the parameter you supply
to TypeTranslatorRuleSet, the function will create a new Type Translator Rule

using the first available index number.
If you specify an index number that is already being used, the function will
overwrite the configuration of the Type Translator Rule using that index

number with the settings defined in the parameter.

A timestamp indicating the last time the configuration of the Type Translator

Rule was updated. This timestamp uses the following format:

The first segment of the time stamp (YYYY-MM-DD) represents the date the

configuration of the Type Translator Rule was last updated. The second segment
(THH:MM:SS) represents the time of day the configuration of the Type

Translator Rule was last updated, in UTC (Coordinated Universal Time).
UTC is the current term for what was commonly referred to as Greenwich
Meridian Time (GMT). Zero (0) hours UTC is midnight in Greenwich England,

which lies on the zero longitudinal meridian. Universal time is based on a 24

hour clock, therefore, an afternoon hour such as 4 pm UTC would expressed as
16:00 UTC. The Z appended to the timestamp indicates that it is in UTC.

A description of the Type Translator Rule. This can be a maximum of 228

characters long.

The name of the Type Translator Rule. The XML file created for this Type

Translator Rule will use this as its file name. For example, the XML file for the

rule defined in the sample parameter shown above would be:
temp_add05.XML.

The following characters are restricted:
/ \ : * ? “ < > * |

YYYY-MM-DDTHH:MM:SSZ

The name can be a maximum of 65 characters long. You will use it to reference

the rule when creating a Type Translator with the TypeTranslatorSet function.
For more information on the TypeTranslatorSet function, see Chapter 12, Ty

.

pe

Translator

i.

LON 100 Internet Server Program

13-6

mer’s Reference