7 Common parameter type definitions ToC Previous Next

7.16 MonitoringParameters ToC Previous Next

The components of this parameter are defined in Table 139.

Table 139 – MonitoringParameters

Name Type Description
MonitoringParameters structure Parameters that define the monitoring characteristics of a MonitoredItem.
   clientHandle IntegerId Client-supplied id of the MonitoredItem. This id is used in Notifications generated for the list Node. The IntegerId type is defined in 7.14.
   samplingInterval Duration The interval that defines the fastest rate at which the MonitoredItem(s) should be accessed and evaluated. This interval is defined in milliseconds.
The value 0 indicates that the Server should use the fastest practical rate.
The value -1 indicates that the default sampling interval defined by the publishing interval of the Subscription is requested. A different sampling interval is used if the publishing interval is not a supported sampling interval. Any negative number is interpreted as -1. The sampling interval is not changed if the publishing interval is changed by a subsequent call to the ModifySubscription Service.
The Server uses this parameter to assign the MonitoredItems to a sampling interval that it supports.
The assigned interval is provided in the revisedSamplingInterval parameter. The Server shall always return a revisedSamplingInterval that is equal or higher than the requested samplingInterval. If the requested samplingInterval is higher than the maximum sampling interval supported by the Server, the maximum sampling interval is returned.
   filter Extensible Parameter
MonitoringFilter
A filter used by the Server to determine if the MonitoredItem should generate a Notification. If not used, this parameter is null. The MonitoringFilter parameter type is an extensible parameter type specified in 7.17. It specifies the types of filters that can be used.
   queueSize Counter The requested size of the MonitoredItem queue.
The following values have special meaning for data monitored items:
Value Meaning
0 or 1 the Server returns the default queue size which shall be 1 as revisedQueueSize for data monitored items. The queue has a single entry, effectively disabling queuing.
For values larger than one a first-in-first-out queue is to be used. The Server may limit the size in revisedQueueSize. In the case of a queue overflow, the Overflow bit (flag) in the InfoBits portion of the DataValue statusCode is set in the new value.

The following values have special meaning for event monitored items:
Value Meaning
0 the Server returns the default queue size for Event Notifications as revisedQueueSize for event monitored items.
1 the Server returns the minimum queue size the Server requires for Event Notifications as revisedQueueSize.
MaxUInt32 the Server returns the maximum queue size that the Server can support for Event Notifications as revisedQueueSize.
If a Client chooses a value between the minimum and maximum settings of the Server the value shall be returned in the revisedQueueSize. If the requested queueSize is outside the minimum or maximum, the Server shall return the corresponding bounding value.
In the case of a queue overflow, an Event of the type EventQueueOverflowEventType is generated.
   discardOldest Boolean A boolean parameter that specifies the discard policy when the queue is full and a new Notification is to be queued. It has the following values:
   TRUE the oldest (first) Notification in the queue is discarded. The new Notification is added to the end of the queue.
   FALSE the last Notification added to the queue gets replaced with the new Notification.

Previous Next