UA_MonitoredItemOperateList

Overview

Type:

Function block

Available as of:

V2.0.0.0

Functional Description

The function block UA_MonitoredItemOperateList is used to update values of multiple monitored items using a list of monitored item handles and the corresponding subscription handle.

NOTE:

  • The UA_MonitoredItemOperateList function block can only be used in combination with the controller synchronization mode (UAMS_ControllerSync).

  • The values of the variables Variables, ValuesChanged, TimeStamps and NodeQualityIDs of the corresponding monitored item specified with the function block UA_MonitoredItemAddList are only valid after the function block UA_MonitoredItemOperateList returns Done = TRUE and no NodeErrorID.

  • If the UA_MonitoredItemOperateList function block is not called, the values of the monitored items are not updated.

Interface

Input

Data type

Description

Execute

BOOL

Upon a rising edge, the function block is being executed.

Also refer to Behavior of Function Blocks with the Input Execute.

Timeout

TIME

Maximum time to respond.

Value range: 2 s...60 s

If the value is out of range the upper or lower limit is applied.

Default value: GPL.Timeout

SubscriptionHdl

DWORD

Subscription handle.

MonitoredItemHdlCount

UINT

Number of monitored item handles in the MonitoredItemHdls array.

MonitoredItemHdls

ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF DWORD

Array containing the monitored item handles to be updated.

Output

Data type

Description

Done

BOOL

Indicates that the execution of the function block was completed successfully.

Busy

BOOL

Indicates that the execution of the function block is in progress.

Error

BOOL

Indicates that an error was detected during execution.

NOTE: Even if Error indicates FALSE, verify the corresponding ErrorIDs before processing the namespace indexes.

ErrorID

ET_Result

Provides additional diagnostic information as a numeric value.

For each specified namespace URI, a separate result is provided.

NodeErrorIDs

ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF ET_Result

Contains an error value for each element of the MonitoredItemHdls array.

Published

BOOL

Indicates that variables have been published since the last call. At least one element of the array ValuesChanged is TRUE.