User Manual

212 Appendix A - Programmer’s Reference
If the priority specified in the nPrioAuthority parameter is equal to or higher than the
priority currently assigned to the data point, this method returns a STATUS value of OK and the
priority used by the FPM application to write to the data point is reset to 255. All applications in
which the data point is registered are notified that they can write values to the data point, and the
application with highest priority is able to write values to the data point.
To include multiple instances of an FPM in the calculation of the data point priority, you must use
the SetDpProperty(UCPTpriority)method to set the cfgUCPTpriority property of the
data point accordingly.
If the priority level specified is lower than the priority currently assigned to the data point, this
method returns a STATUS value of ERROR.
EXAMPLE
The following example demonstrates a ResetPriority()method that attempts to reset the
priority of a data point declared in an FPM application using a priority of 200.
STATUS st = ResetPriority (nviSetPoint, 200);
if (st==ERROR) //if current DP priority >200
{
printf("DP Reset Priority too Low");
}
FPM Application Data Point Property Methods
For the data points declared in an FPM application, you can use specific data point property methods in
the Work()and OnTimer()routines get their names, times of last update, and statuses, and to get
and set their priorities. The following table displays the valid scope of the data point property
methods in an FPM application.
FPM Application Scope
Property Name
Initialize() Work() OnTimer() Shutdown()
FPM::Dp::cfgUCPTname — Read Read —
FPM::Dp::cfgUCPTAliasName — Read/Write Read/Write —
FPM::Dp::dataUCPTlastUpdate — Read Read —
FPM::Dp::dataUCPTstatus — Read Read —
FPM::Dp::dataUCPTpriority — Read/Write Read/Write —
Notes:
• You can also use these data point property methods to get the properties of the external data points
on the SmartServer. External data points include those data points on the internal SmartServer
device [i.LON App (Internal)] and the data points of the external devices connected to the
SmartServer.
• Using the data point property methods extensively may significantly impact the performance of
the SmartServer; therefore, it is recommended that you use these methods sparingly.
GetDpPropertyAsString(UCPTname)
You can use the GetDpPropertyAsString(name) method in the Work()and
OnTimer()routines of an FPM application to read the name of the data point.
SYNTAX
const char* GetDpPropertyAsString(FPM::Dp::cfgUCPTname)