OPC-Classic-DAWrite node

Use the OPC-Classic-DAWrite node to write OPC DA data to your OPC Classic DA Server.

Purpose

Use the OPC-Classic-DAWrite node to change the value of a tag on your OPC Classic DA Server.

You can deploy the OPC-Classic-DAWrite node on Windows only.

Note: The OPC-Classic-DAWrite node affects the OPC Classic DA Server even if the overall message flow fails, that is, updates are not backed out.

The OPC-Classic-DAWrite node is contained within the Manufacturing drawer of the message flow palette, and is represented in the IBM® Integration Toolkit by the following image:

OPC-Classic-DAWrite node

Using the OPC-Classic-DAWrite node in a message flow

The OPC-Classic-DAWrite node is a mid-flow node.

The OPC-Classic-DAWrite node processes a TagData message that contains the address of an OPC Classic DA Server and a list of tags and values. The OPC-Classic-DAWrite node connects to the server and writes the specified values to the tags. The incoming message must be a DataObject domain message.

The following elements of the TagData message must be present:
  • TagData/Server
  • TagData/Tag/Name
  • TagData/Tag/Value
For example:
<NS1:TagData xmlns:NS1="com.ibm.manufacturing.tagData/v1.0">
 <ServerName>opcda://localhost/YourServer</ServerName>
 <Tag>
  <Name>ArrayOfString</Name>
  <Value>String1</Value>
  <Value>String2</Value>
  <Value>String3</Value>
  <Value>String4</Value>
 </Tag>
 <Tag>
  <Name>ArrayOfReal8</Name>
  <Value>6.94088287146E+3</Value>
  <Value>9.21019398201E+3</Value>
 </Tag>
 <Tag>
  <Name>Boolean</Name>
  <Value>false</Value>
 </Tag>
 <Tag>
  <Name>Int1</Name>
  <Value>99</Value>
 </Tag>
 <Tag>
  <Name>Int2</Name>
  <Value>11513</Value>
 </Tag>
 <Tag>
  <Name>Int4</Name>
  <Value>11921</Value>
 </Tag>
 <Tag>
  <Name>Money</Name>
  <Value>31919</Value>
 </Tag>
 <Tag>
  <Name>Qualities</Name>
  <Value>7828</Value>
 </Tag>
 <Tag>
  <Name>Real8</Name>
  <Value>1.111886036388E+4</Value>
 </Tag>
 <Tag>
  <Name>Real4</Name>
  <Value>5.9810869140625E+3</Value>
 </Tag>
 <Tag>
  <Name>Time</Name>
  <Value>2014-09-11T08:46:50</Value>
 </Tag>
 <Tag>
  <Name>UInt1</Name>
  <Value>248</Value>
 </Tag>
 <Tag>
  <Name>UInt2</Name>
  <Value>939</Value>
 </Tag>
 <Tag>
  <Name>UInt4</Name>
  <Value>25976</Value>
 </Tag>
 <Tag>
  <Name>String</Name>
  <Value>TEST_STRING</Value>
 </Tag>
</NS1:TagData> 

Multiple tags can be specified and array type tags can contain multiple values. For more information, see XML schema.

If the OPC-Classic-DAWrite node can connect to the server that is specified in the incoming message, the node outputs a message that contains the list of tags that are specified in the input message with the addition of a status code that indicates whether the write was successful.

If the server specified cannot be reached and the Failure terminal is connected, an exception is generated that is sent out of the Failure terminal. If the server specified cannot be reached and the Failure terminal is not connected, an exception is thrown back downstream.

Configuring the OPC-Classic-DAWrite node

The behavior of the OPC-Classic-DAWrite node is entirely controlled by the incoming message. Some node properties can be configured.

All mandatory properties for which you must enter a value (properties that do not have a default value defined) are marked with an asterisk in the user interface.

Terminals and properties

The OPC-Classic-DAWrite node terminals are described in the following table.
Terminal Description
In The input terminal that accepts a message for processing by the node.
Failure The output terminal to which a message is routed if an error occurs.
Out The output terminal that propagates the message after the processing of the write to the server.

The following tables describe the node properties. The column headed M indicates whether the property is mandatory (a mandatory property is marked with an asterisk if you must enter a value when no default is defined); the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the broker archive (BAR) file to deploy it).

The Description properties for the OPC-Classic-DAWrite node are described in the following table.
Property M C Default Description
Node name Yes No The node type, OPC-Classic-DAWrite. The name of the node.
Short description No No   A brief description of the node.
Long description No No   Text that describes the purpose of the node in the message flow.
Notices | Trademarks | Downloads | Library | Support

Copyright IBM Corporation 2016 Copyright IBM Corporation 2016.

		
		Last updated
		
	Last updated : 2016-07-30 06:30:51


Reference topicReference topic | Version 1.0.0.2 | ma00490