Echelon OpenLNS User Manual

Page 628

Advertising
background image

OpenLNS Programmer's Reference

591

OpenLNS uses the value of the

Measurement

System

field (either

U.S. or metric) on this tab to

determine the default format to use

for types such as SNVT_temp_f.

You can also specify a full format

name (i.e. SNVT_temp_f#SI for or
SNVT_temp_f#US)

to select a

specific format for that type. For

UNVTs, you must always specify a

fully-qualified format name.

2. In some cases, a format exists for a

given SNVT or UNVT that has the

same name as the underlying type.

This is called the root format for the

type, and it may be different from

the default format for that type. In

order to explicitly use the root

format, you will need to append a ‘#’

character to the format name you

write to this property to indicate

that you are specifying the format

name (and not the type name) for

this type.
For example, if you read the value

of a network variable of type

SNVT_time_stamp when the

CategoryPreferenceList property of

the FormatLocale object your

application is using is set to LO,

and you set the DsFormatType

property to SNVT_time_stamp, then

the data stored in the Value

property will be formatted using the

SNVT_time_stamp #LO format.

However, if you set the

DsFormatType property to

SNVT_time_stamp#, the data

stored in the Value property will be

formatted using the root

SNVT_time_stamp format.

3. A fully-qualified format name,

expressed in the following syntax:

"#<progID>[<scope>].<format
name>

"

In this syntax, the "#", "[", "]" and

"." characters are literal characters.

A hex byte string represents the

program ID. The scope is a

one-digit string. It represents a

filter that indicates relevant parts

Advertising