Errata exists for this version of the document.

The QueueName parameter with DataType String specifies the queue in the Broker that receives NetworkMessages sent by the Publisher. This could be the name of a queue or topic defined in the Broker.

The ResourceUri property of DataType String allows the transport implementation to look up the configured key from the corresponding KeyCredentialConfigurationType instance defined in OPC 10000-12 to use for authenticating access to the specified queue.

If this String is not null, it overrides the ResourceUri of the PubSubConnection authentication settings.

The parameter AuthenticationProfileUri of DataType String allows the selection of the authentication protocol used by the transport implementation for authenticating access to the specified queue.

If this String is not null, it overrides the AuthenticationProfileUri of the PubSubConnection transport settings defined in 6.4.2.1.2.

The RequestedDeliveryGuarantee parameter with DataType BrokerTransportQualityOfService specifies the delivery guarantees that shall apply to all NetworkMessages published by the WriterGroup unless otherwise specified on the DataSetWriter transport settings. The DataType BrokerTransportQualityOfService is defined in 6.4.2.2.5.

The value NotSpecified_0 is not allowed on the WriterGroup. If the selected delivery guarantee cannot be applied, the WriterGroup shall set the state to Error_3.

The BrokerTransportQualityOfService Enumeration DataType is formally defined in Table 71.

The mapping of quality of service to the broker transport specific implementation is defined in 7.3.4.5 for AMQP and 7.3.5.5 for MQTT.

Table 69 – BrokerTransportQualityOfService Values

Value

Description

NotSpecified_0

The value is not specified and the value of the parent object shall be used.

BestEffort_1

The transport shall make the best effort to deliver a message. Worst case this means data loss or data duplication are possible.

AtLeastOnce_2

The transport guarantees that the message shall be delivered at least once, but duplication is possible. Readers must de-duplicate based on message id or sequence number.

AtMostOnce_3

The transport guarantees that the message shall be sent once, but if it is lost it is not sent again.

ExactlyOnce_4

The transport handshake guarantees that the message shall be delivered to the broker exactly once and not more or less.

This Structure DataType is used to represent the Broker specific transport mapping parameters for WriterGroups. It is a subtype of the WriterGroupTransportDataType defined in 6.2.5.6.2.

The BrokerWriterGroupTransportDataType is formally defined in Table 70.

Table 70 – BrokerWriterGroupTransportDataType Structure

Name

Type

Description

BrokerWriterGroupTransportDataType

Structure

queueName

String

Defined in 6.4.2.2.1.

resourceUri

String

Defined in 6.4.2.2.2.

authenticationProfileUri

String

Defined in 6.4.2.2.3.

requestedDeliveryGuarantee

BrokerTransportQualityOfService

Defined in 6.4.2.2.4.