Unitary

Pre-APOGEE

APOGEE

BACnet

PXC.A

 

 

 

 

Syntax

SETVAL(srcValSpec)

srcValSpec

A specifier for the value to write to the set of object properties. srcValSpec may be passed in as:

- A literal numeric value (for example, 1.0, -50)

- A reserved word specifying an enumerated value

- An object reference (for example, BAC_7_AO_11, KwMeter)

SETVAL(targPropSpec)

targPropSpec

A specifier for the property to be written. targPropSpec may be passed in as:

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

- An abbreviated property name.

SETVAL(targObjRef1, targObjRef2, ...targObjRef14)

targObjRefs

A specifier for the target object(s) of the write operation. Multiple objects may be specified. The same property will be written in each target object. An targObjectRef may be passed in using the format for an object reference (for example, BAC_7_AO_11, KwMeter).

Use

Writes the value of a specified property in one or more object instances.

SetVal 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 write the suppress event notification value to objects SupplyTemp and RoomTemp in device Room101:

10 SetVal(0, @SupEvtNotf, [Room101]SupplyTemp, [Room101]RoomTemp)
or
10 SetVal(0, 4972, [Room101]SupplyTemp, [Room101]RoomTemp)

Notes

Only properties of numeric data types and binary data types can be written using SetVal.

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