Echelon OpenLNS - Manual (Page 470)

OpenLNS Programmer's Reference 433
Added to API LNS Release 3.20.
PrincipalNv
Summary Returns the principal NetworkVariable object associated with
this LonMarkObject object.
This information is accessed from the functional profile
template file associated with this LonMarkObject object.
Availability Local, full, and lightweight clients.
Syntax nvObject = lmObject.PrincipalNv
Element Description
lmObject The LonMarkObject object to be acted
on.
nvObject The principal network variable of the
LonMarkObject object.
Data Type NetworkVariable object.
Read/Write Read only.
Added to API Prior to LNS Release 3.0.
ProgrammaticName
Summary Returns the programmatic name of the LonMarkObject .
This property contains the orignal base name of the
LonMarkObject or network variable as "programmed" in the
device containing the object.
•
For static LonMarkObject objects, LNS initially acquires
the name from the functional profile template file or
external interface associated with the device.
• For dynamic LonMarkObject objects, you will specify the
name to use when you create the object with the
appropriate Add method.
Initially, the Name property, which represents the user name
of the LonMarkObject, will also be set to the same value as
the ProgrammaticName property. The Name property can be
subsequently changed for all LonMarkObject objects,
allowing OpenLNS applications to create their own
identifying names for those objects.
This property can be a maximum of 16 characters long, and
must conform to the character restrictions defined in version
3.3 and later of the LonMark Application Layer
Interoperability Guidelines. You may not use the following
characters in the ProgrammaticName property: the forward
slash (/), back slash (\), period (.), and colon (:).
Availability Local, full, and lightweight clients.
Syntax progName = Object. ProgrammaticName