Conn Tags

Question 1

actorTimeout

Answer 1

actorTimeout

Number

This tag may applied to connector recs to tune the timeout used for messaging to the connector’s actor thread. It must be a number with a duration unit. If omitted a default of 1min is used. This value effectively determines how long a blocking remote request should take before raising a timeout error. For protocols which communicate via HTTP/TCP it is also used to configure the socket’s receive timeout (including Haystack and oBIX connectors).

Question 2

connErr

Answer 2

connErr

Str

Error message associated when connStatus indicates an error condition. See connExt

Question 3

connLinger

Answer 3

connLinger

Number

Duration used for the default linger timeout when a connector is opened via theConn.openLinger method. If not configured then a default of 30sec is used.

Question 4

connPingFreq

Answer 4

connPingFreq

Number

Duration used to configure the auto-ping feature on a given connector. When this tag is configured the connector will automatically attempt a ping based on the configured frequency. For connectors which might not have watched points this ensures periodic checks of the connectivity status. If this tag is not defined on a connector then the feature is disabled.

Question 5

connState

Answer 5

connState

Str

Current connection state of a connector as one of the predefined strings:

closed: connection is closed
closing: a connection is currently being closed
open: connection is open
opening: a connection is currently being opened See connExt

Question 6

connStatus

Answer 6

• connStatus
• Str

Current status of a connector as one of the predefined strings:

* ok: all is okay
* fault: a configuration problem - see `connErr`
* down: a communication or network problem - see `connErr`
* disabled: manual disable of the connector
* unknown: we don't know anything (usually boot state) See [connExt](http://skyfoundry.com/doc/ext-conn/doc#conns)

<dl>
</dl>

Question 7

connTuning

Answer 7

connTuning

Marker

Marker applied to a rec which defines a tuning configuration. See connExt

Question 8

conntuningRef

Answer 8

connTuningRef

Ref

Reference to a tuning configuration defined by a connTuning rec. See connExt

Question 9

curCalibration

Answer 9

curCalibration

Number

Calibration value to apply to adjust the value read from the connector before updating curVal. The conversion is applied to the ConnPoint.updateCurOk value after curConvert is applied and before writing curVal to the database. See connExt

Question 10

curConvert

Answer 10

curConvert

Str

Conversion to apply when reading curVal from connector. The conversion is applied to the ConnPoint.updateCurOk value before applying curCalibration and writing curVal to the database. See connExt

Question 11

hisConvert

Answer 11

hisConvert

Str

Conversion to apply when reading history data from connector. The conversion is applied to each item passed to ConnPoint.updateHisOk before writing to the database. This conversion happens before the hisOnWrite conversion hooks. See connExt

Question 12

pollTime

Answer 12

pollTime

Number

Frequency between polls of curVal. See connExt.

Question 13

staleTime

Answer 13

staleTime

Number

Time before a point’s curStatus marked from “ok” to “stale” See connExt.

Question 14

writeConvert

Answer 14

writeConvert

Str

Conversion to apply when writing writeVal to the connector. The conversion is applied towriteVal before calling Conn.onWrite. See connExt

Question 15

writeMaxTime

Answer 15

writeMaxTime

Number

Maximum time between writes used to send perioid writes. See connExt.

Question 16

writeMinTime

Answer 16

writeMinTime

Number

Minimum time between writes used to throttle the speed of writes. See connExt.