Syntax

Unitary

Pre-APOGEE

APOGEE

BACnet

PXC.A

 

 

 

 

GETVAL(targObjRef)

targObjRef

A specifier for the target object, using the format for an object reference (for example, BAC_7_AO_11, KwMeter). The value read from the source object property will be written to the target object's present value property.

GETVAL(srcObjRef)

srcObjRef

A specifier for the source object, using the format for an object reference (for example, BAC_7_AO_11, KwMeter).

GETVAL(srcPropSpec)

srcPropSpec

A specifier for the property to be read from the source object. srcPropSpec may be passed in as:

- A numeric BACnetPropertyIdentifier from the standard range or a proprietary range

- An abbreviated property name

GETVAL(srcIndex)

srcIndex

An optional specifier for the target object(s) of the write operation. Between 1-14 objects may be specified. The same property will be written in each target object. An objectRef may be passed in using the format for an object reference (for example, BAC_7_AO_11, KwMeter).

Use

GetVal is a new statement that allows PPCL access to individual object properties and supports either a numeric property number or a textual property short name. Note that only properties with numeric data types or arrays of numeric data types can be read or written in PPCL programs. The PPCL engine will handle conversions between numeric types (Real, Unsigned, Integer).

Example

To read the reliability value from object RoomTemp10 GetVal(TheRoomTemp, [Room101]RoomTemp), Rlb in device Room101 and save it as the present-value of local object TheRoomTemp:

10 GetVal(TheRoomTemp, [Room101]RoomTemp), Rlb

To read priority slot 5 from object RoomTemp in device Room101 and save it in local object TheLockVal:

10 GetVal(TheLockVal, [Room101]RoomTemp, PrioArr, 5)

Notes

Only properties of numeric data types can be read using GetVal.

See Appendix B−Property Short Names, Numbers, and Descriptions.