beautypg.com

Programid, Scope, Scope and programid – Echelon OpenLNS User Manual

Page 404: Scope an

background image

OpenLNS Programmer's Reference

367

points in permanent monitor sets.

Syntax

precisionValue = object.Precision

Element

Description

precisionValue The precision of the configuration

property value. This element has

a

range between 0–17.

object

The

FormatSpec

or

ConfigProperty

object to be acted upon.

Data Type

Integer.

Read/Write

Read/write.

Added to API

Prior to LNS Release 3.0.

ProgramId

Summary

Contains the program ID of the

FormatSpec

object. The

program ID is stored as a unique 16-digit hexadecimal

number in the following format:

FM:MM:MM:CC:CC:UU:TT:NN.

Note: You may not use colons when writing the program ID.

For a device with a program ID of

80:00:01:01:28:80:04:02,

you can write 8000010128800402 in this property.

Each FormatSpec object references a type. OpenLNS uses the

ProgramId property in conjunction with the Scope property of

the applicable FormatSpec object to determine which

resource file contains the type’s definition.
For FormatSpec objects, the Scope property will only be used

to identify the correct type if the FormatType property is set

to lcaFormatTypeNamed (0), which indicates that the

FormatSpec

object represents a user-defined type. In this

case, the user-defined type to use within the resource file

referenced by this property is identified by the FormatName

property. If the FormatType property is not set to

lcaFormatTypeNamed (0), OpenLNS will use the Index

property to determine the type associated with the

FormatSpec object.
The data stored in the ProgramId property of the

FormatSpec object varies, depending on the sort of object that

the FormatSpec applies to.

If the FormatSpec applies to a data point acquired

through a network variable that is using a standard type,

or to a monitor point that is being used to monitor a

standard network variable, the ProgramId property will

be set to 0000000000000000.

If the FormatSpec applies to a data point acquired

through a network variable that is using a user-defined

type, or to a monitor point that is being used to monitor a

user-defined network variable, the ProgramId property