Specify the property

When creating proxy points under an R2ObixClient, always select the specific property you want to display, rather than the parent root object (node) itself. For example, expand the entry for a BinaryOutput object and select its statusOutput property (Figure 2-13).

Figure 21. Select property of a discovered R2 object, vs. root (Node) object

Otherwise, if you select the root object rather than a child property, the watch is on the Href for that node. As a result, the watch returns every property of the object. However, only one “default property” is used by the R2ObixClient proxy point— all the other returned properties add overhead, reducing throughput.

NOTE: Starting in obixDriver builds 3.2.23, 3.3.26, and AX-3.4, proxying any property also provides the parent R2 object’s commands, by default. These appear as actions on each Obix proxy point. In previous obixDriver builds, only “root object” proxy points provided these command actions.

Typical properties selected for proxying/display include “statusOutput”, “prioritizedOutput”, or perhaps “sOut” or “pOut” (varies according to R2 object type). However, note any property is selectable.

In summary, selecting object properties (rather than their root objects) will have a big impact on performance of the oBIX integration. Typically, an order of magnitude or two can be gained by specifying a property for each proxy point, versus specifying the root object.

See the next section “Add notes for R2 Obix proxy points” for additional details.

Specify the property

Figure 21. Select property of a discovered R2 object, vs. root (Node) object

Related Links