Object PmVar (Variable)

Description:

The PmVar object represents one data variable of the Pma object.
This variable holds more information in itself (value, name, index, etc.), and therefore it is represented by the object. Then the object has got this information as its properties.
the PmVar object can be created in objects: PmaData, PmaOpcDaClientGroup, PmaCommGroup, PmaTrendGroup, PmaCommMsg.

Properties and methods:

Extension()	Data extension access
GetBit()	Returns the bit in the value of the variable
ChangedOnLastWrite	Flag showing if the value was changed by last writing
Index	Index of the variable in the object
Name	Name of the variable
Note	Note of the variable
Owner	Returns reference to the PmVar object owner in the Pma object tree
Quality	Quality of the variable value
SetBit()	Sets the bit in the value of the variable
SetValue()	Writing the value, quality and time of the source simultaneously
TimeChange	Time of last writing into the variable that changed value
TimeSource	Time of value origin in the value source
TimeWrite	Time of last writing into the variable
Unit	Physical unit of the variable (only for PmaData and PmaTrendGroup)
Value	Value of the variable
ValueBeforeChange	Last value before changing to current value

Obsolete properties and methods:

Bit	Value of one bit of the variable

Configuration windows:

Variable	Setting the properties of one variable
Data binding of the PmVar object	Definition of the data binding of the variable to another value
Multi items adding	Multiple definition of new variables

Related objects:

Data extensions	The data extensions are PROMOTIC system components, extending the basic functionality of PmVar data items (variables). Each data extension type is used for specific purpose (e.g. limit excess alarm, OPC server or connection to the PmaComm object, trends, etc.).

Note:

In the script PmVar variables can be obtained following ways:

Example1:

Following objects PmaData, PmaCommGroup, PmaOpcDaClientGroup, PmaTrendGroup: The variables of these objects are located on the "Data" tab.

JavaScriptVBScriptSelect and copy to clipboard



// by the Item method of these objects, for example

oTemperature2 = pMe.Pm("/Data").Item("Temperature2");


// or directly by the Pm method with the #vars identifier, for example

oTemperature2 = pMe.Pm("/Data/#vars/Temperature2");

Example2:

For PmaCommMsg object: This object contains got two groups of variables located on the Data-sent and Data-received tabs.

JavaScriptVBScriptSelect and copy to clipboard



// by methods WriteVars and ReadVars, for example

oSnd1 = pMe.Pm("/PmaComm/PmaCommMsg").WriteVars("Snd1");

oRcv4 = pMe.Pm("/PmaComm/PmaCommMsg").ReadVars("Rcv4");


// or directly by the Pm method with the #sndvars and #rcvvars identificators, for example

oSnd1 = pMe.Pm("/PmaComm/PmaCommMsg/#sndvars/Snd1");

oRcv4 = pMe.Pm("/PmaComm/PmaCommMsg/#rcvvars/Rcv4");

Data extensions:
The PmVar object directly contains only basic functionality (most important common properties).
The functionality of the PmVar can be extended by adding one or more data extensions.
Each data extension is then contained in the PmVar object in the form of a subobject (e.g. ExtAlarmAnalog, ExtComm, …), accessible by the PmVar.Extension method or by means of the Data extensions identifier.