GetMonitoredItems is used to get information about monitored items of a subscription. Its intended use is defined in OPC 10000-4.

Signature

GetMonitoredItems(

[in] UInt32 subscriptionId

[out] UInt32[] serverHandles

[out] UInt32[] clientHandles

);

Argument

Description

subscriptionId

Identifier of the subscription.

serverHandles

Array of monitoredItemIds (serverHandles) for all MonitoredItems of the Subscription identified by subscriptionId

clientHandles

Array of clientHandles for all MonitoredItems of the Subscription identified by subscriptionId

Method Result Codes (defined in Call Service)

Result Code

Description

Bad_SubscriptionIdInvalid

Defined in OPC 10000-4

Bad_UserAccessDenied

Defined in OPC 10000-4

The Method was not called in the context of the Session that owns the Subscription.

Table 94 specifies the AddressSpace representation for the GetMonitoredItems Method.

Table 94 – GetMonitoredItems Method AddressSpace Definition

Attribute

Value

BrowseName

GetMonitoredItems

References

NodeClass

BrowseName

DataType

TypeDefinition

ModellingRule

HasProperty

Variable

InputArguments

Argument[]

PropertyType

Mandatory

HasProperty

Variable

OutputArguments

Argument[]

PropertyType

Mandatory

ResendData is used to get the current values of the data monitored items of a Subscription where the MonitoringMode is set to Reporting. Its intended use is defined in OPC 10000-4.

Signature

ResendData(

[in] UInt32 subscriptionId

);

Argument

Description

subscriptionId

Identifier of the Subscription to refresh.

Method Result Codes (defined in Call Service)

Result Code

Description

Bad_SubscriptionIdInvalid

Defined in OPC 10000-4

Bad_UserAccessDenied

Defined in OPC 10000-4

The Method was not called in the context of the Session that owns the Subscription.

Table 95 specifies the AddressSpace representation for the ResendData Method.

Table 95 – ResendData Method AddressSpace Definition

Attribute

Value

BrowseName

ResendData

References

NodeClass

BrowseName

DataType

TypeDefinition

ModellingRule

HasProperty

Variable

InputArguments

Argument[]

PropertyType

Mandatory

SetSubscriptionDurable Method is used to set a Subscription into a mode where MonitoredItem data and event queues are stored and delivered even if an OPC UA Client was disconnected for a longer time or the OPC UA Server was restarted. Its intended use is defined in OPC 10000-4.

Signature

SetSubscriptionDurable(

[in] UInt32 subscriptionId

[in] UInt32 lifetimeInHours

[out] UInt32 revisedLifetimeInHours

);

Argument

Description

subscriptionId

Identifier of the Subscription.

lifetimeInHours

The requested lifetime in hours for the durable Subscription.

revisedLifetimeInHours

The revised lifetime in hours the Server applied to the durable Subscription.

Method Result Codes (defined in Call Service)

Result Code

Description

Bad_SubscriptionIdInvalid

Defined in OPC 10000-4

Bad_InvalidState

Defined in OPC 10000-4

This is returned when a Subscription already contains MonitoredItems.

Bad_UserAccessDenied

Defined in OPC 10000-4

The Method was not called in the context of the Session that owns the Subscription.

Table 96 specifies the AddressSpace representation for the SetSubscriptionDurable Method.

Table 96 – SetSubscriptionDurable Method AddressSpace Definition

Attribute

Value

BrowseName

SetSubscriptionDurable

References

NodeClass

BrowseName

DataType

TypeDefinition

ModellingRule

HasProperty

Variable

InputArguments

Argument[]

PropertyType

Mandatory

HasProperty

Variable

OutputArguments

Argument[]

PropertyType

Mandatory

The Method RequestServerStateChange allows a Client to request a state change in the Server.

The Client shall provide credentials with administrative rights when invoking this Method on the Server.

Signature

RequestServerStateChange(

[in] ServerState state

[in] DateTime estimatedReturnTime

[in] UInt32 secondsTillShutdown

[in] LocalizedText reason

[in] Boolean restart

);

Argument

Description

state

The requested target state for the Server. If the new state is accepted by the Server, the State in the ServerStatus is updated with the new value.

estimatedReturnTime

Indicates the time at which the Server is expected to be available in the state RUNNING_0. If no estimate is known, a null DateTime shall be provided. This time will be available in the EstimatedReturnTime Property.

This parameter shall be ignored by the Server and the Property EstimatedReturnTime shall be set to null if the new state is RUNNING_0.

secondsTillShutdown

The number of seconds until a Server shutdown. This parameter is ignored unless the state is set to SHUTDOWN_4 or restart is set to True.

reason

A localized text string that describes the reason for the state change request.

restart

A flag indicating if the Server should be restarted before it attempts to change into the requested change. If the restart is True the server changes it state to SHUTDOWN_4 before the restart if secondsTillShutdown is not 0.

Method Result Codes (defined in Call Service)

Result Code

Description

Bad_UserAccessDenied

The current user is not authorized to invoke the method

Bad_InvalidState

The requested state was not accepted by the server

Table 97 specifies the AddressSpace representation for the RequestServerStateChange Method.

Table 97 – RequestServerStateChange Method AddressSpace Definition

Attribute

Value

BrowseName

RequestServerStateChange

References

NodeClass

BrowseName

DataType

TypeDefinition

ModellingRule

HasProperty

Variable

InputArguments

Argument[]

PropertyType

Mandatory