© 2009 Kepware TechnologiesKEPServerEX5 Help
9www.kepware.comKEPServerEX5 HelpOPC client applications in use today still support this original specification, OPC Data Access 2.0 enhanced OPC to b
99www.kepware.comKEPServerEX5 Help Descriptions of the General Options dialog parameters are as follows.Immediately attempt to establish a Runtime co
100www.kepware.comKEPServerEX5 Helpinvoked by a client application. If the server were to shut down without warning, those changes could be lost. Topr
101www.kepware.comKEPServerEX5 HelpEvent Log DisplayThe Event Filter helps users tailor the Event Log's contents to meet the application's r
102www.kepware.comKEPServerEX5 Help Descriptions of the parameters are as follows.The Margin parameter sets the distance from the edge of the Event L
103www.kepware.comKEPServerEX5 Helpbeing reimported). Note: A new configuration file will be created in the same folder as the server project file, co
104www.kepware.comKEPServerEX5 Help Descriptions of the parameters are as follows.When enabled, Enable OPC 1.0 allows the server to accept OPC client
105www.kepware.comKEPServerEX5 Helpmeet the needs of rare OPC clients. Normally these options will not need to be adjusted for a majority of the OPC c
106www.kepware.comKEPServerEX5 Help1,200 would be converted to One Thousand - Twelve Hundred if converted using English metrics, but would beOne and T
107www.kepware.comKEPServerEX5 HelpDDE, enabling it will cause the server to automatically register its share names and start the Net DDE service mana
108www.kepware.comKEPServerEX5 Help Note: In order for both proper FastDDE/SuiteLink operation and for this page to be displayed in the server's
10www.kepware.comKEPServerEX5 HelpWhen Interactive is selected, the Runtime will remain stopped until a client attempts to connect to it. Once started
109www.kepware.comKEPServerEX5 HelpiFIX process database (PDB) tags and the server tags. To access this tab, click File | Project Properties. Note: Th
110www.kepware.comKEPServerEX5 Helpidle tags on a 15 second cycle, a tag may not get set inactive at precisely this time from its last Read; it could
111www.kepware.comKEPServerEX5 Helpexamined for a value greater than 9 (A-F hex). If a hexadecimal valuebetween A and F is found, a range alarm is gen
112www.kepware.comKEPServerEX5 Helpalarm state, or OK.Result=(((InputData - Lo_egu)/Span_egu) * 255) + .5.Write Algorithm VariablesLo_egu - the low en
113www.kepware.comKEPServerEX5 Helpmost significant bits are ignored.Read AlgorithmReads from a 16-bit register using the following algorithm:Result =
114www.kepware.comKEPServerEX5 Help 14AL Signal ConditioningDescription14-bit binary number.Input Range0 - 16383.ScalingScales 14-bit binary values to
115www.kepware.comKEPServerEX5 HelpWrite AlgorithmWrites to a 16-bit register with alarming using the same algorithm as15BN, and returns a status indi
116www.kepware.comKEPServerEX5 HelpResult =((Raw_value/32000) * Span_egu) + Lo_egu.Read Algorithm VariablesLo_egu - the database block's low engi
117www.kepware.comKEPServerEX5 HelpWhat is the Alias Map? Note 1: For possible additional syntax, refer to the DDE client's specific help documen
118www.kepware.comKEPServerEX5 Helpan array of data values, the text string written should have this delimiter format. When poking to an array tag in
11www.kepware.comKEPServerEX5 HelpAdding and Editing User AccountsThe Administrator can create additional user accounts by clicking on the New User ic
119www.kepware.comKEPServerEX5 Help2. Click on the New Alias icon, which appears as . 3. In the tree browse where the tag that will be referenced is
120www.kepware.comKEPServerEX5 Help= <DDE service name>|Mac1Cell2!ToolDepth Note 1: If Net DDE is enabled, the Alias Map entries will be registe
121www.kepware.comKEPServerEX5 Help Note: The server will validate any request for items against the Alias Map before responding back to the clientapp
122www.kepware.comKEPServerEX5 HelpEach device has now been defined underits own channel. In this newconfiguration, a single path of executionis dedic
123www.kepware.comKEPServerEX5 Help How To... Use Ethernet EncapsulationThe Ethernet Encapsulation mode has been designed to provide communications wi
124www.kepware.comKEPServerEX5 Help Note: For unsolicited drivers that support Ethernet encapsulation, users will have to configure the port and the p
125www.kepware.comKEPServerEX5 HelpEthernet operation. When a new device is added to the channel, the Ethernet Encapsulation settings can be used tose
126www.kepware.comKEPServerEX5 HelpModule '<module>' is unsigned or has a corrupt signatureMove object '<group>' to &a
127www.kepware.comKEPServerEX5 HelpUnable to load driver DLL '<driver name>'Unable to load the '<driver name>' driver
128www.kepware.comKEPServerEX5 HelpAttempt to add OPC client item '<item name>' failedAttempting to automatically generate tags for de
12www.kepware.comKEPServerEX5 Helpdesktop. When User Management is enabled, this console requires a valid user login in order to be accessed. Administ
129www.kepware.comKEPServerEX5 HelpNote:Every attempt is made to ensure backwards compatibility in the server so that projects created in older versio
130www.kepware.comKEPServerEX5 Helpadding the item from the client.4. If attempting to add an item but used incorrect syntax: Correct the syntax and t
131www.kepware.comKEPServerEX5 HelpSource:Runtime Possible Cause:Although the server is regenerating tags for the tag database, it has been set not to
132www.kepware.comKEPServerEX5 HelpSource:Runtime Possible Cause:The connected user has been idle for more than 15 minutes, and so the server automati
133www.kepware.comKEPServerEX5 HelpInformation Source:Runtime Possible Cause:1. A client application has programmatically Enabled/Disabled Data Collec
134www.kepware.comKEPServerEX5 HelpDemo timer updated. '<time remaining>'Error Type:Warning Possible Cause:None. Solution:None. Demons
135www.kepware.comKEPServerEX5 HelpDevice '<device name>' has been auto-demotedError Type:Warning Source:Runtime Possible Cause:Commun
136www.kepware.comKEPServerEX5 HelpPossible Cause:The user is attempting to license a driver or component without the Runtime enabled and running. Sol
137www.kepware.comKEPServerEX5 HelpRejecting attempt to delete referenced object '<item name>'Error Type:Warning Source:Runtime Possib
138www.kepware.comKEPServerEX5 HelpStarting '<driver name>' device driverError Type:Warning Possible Cause:The server successfully loa
13www.kepware.comKEPServerEX5 Help ConnectionFor security reasons, users cannot just connect to the Runtime. Thus, the Communicate using port paramete
139www.kepware.comKEPServerEX5 HelpSolution:Contact the OEM/Vendor for more information and support. Unable to generate a tag database for device &apo
140www.kepware.comKEPServerEX5 HelpSource:Runtime Possible Cause:The client application sent a write to an item and it was rejected. Solution:1. The t
141www.kepware.comKEPServerEX5 HelpServer Configuration Error MessagesThe following error/warning messages may be generated. Click on the link for a d
142www.kepware.comKEPServerEX5 Help'<driver name>' device driver unloaded from memoryError Type:Information Source:Configuration Possi
143www.kepware.comKEPServerEX5 Help Solution:Re-run the server install and select the specified plug-in for installation. A client application has &ap
144www.kepware.comKEPServerEX5 HelpThis message indicates that two Channel Wizard pages were created with the same ID. Solution:Contact Technical Supp
145www.kepware.comKEPServerEX5 HelpError importing CSV tag record '<record number>': Tag or group name exceeds 256charactersError Type
146www.kepware.comKEPServerEX5 HelpThe IP address that is specified for a device on an Ethernet Encapsulated channel is not a valid IP address. Soluti
147www.kepware.comKEPServerEX5 HelpMaximum device count exceeded for the lite version '<driver name>' driver licenseError Type:Warning
148www.kepware.comKEPServerEX5 HelpThe specified project was opened. Solution:N/A. Required schema file '<schema name>' not foundError
14www.kepware.comKEPServerEX5 Help Descriptions of the parameters are as follows.Process Mode: This parameter is used to specify whether the server w
149www.kepware.comKEPServerEX5 HelpPossible Cause:OPC Diagnostics capturing were stopped by a connected Configuration. Solution:N/A. Unable to add cha
150www.kepware.comKEPServerEX5 HelpPossible Cause:The server was unable to back up the server project to the specified file location. Solution:1. Ensu
151www.kepware.comKEPServerEX5 HelpSolution:Contact Technical support and verify which version should be installed for the version of the server being
152www.kepware.comKEPServerEX5 HelpLine dropped at remote site on '<modem name>'Modem line closed: '<modem name>'Modem
153www.kepware.comKEPServerEX5 HelpN/A. , Software flow controlError Type:Information Source:TAPI Manager Possible Cause:Software Flow control has bee
154www.kepware.comKEPServerEX5 Help Failed to open modem line '<modem name>' [TAPI error]Error Type:Error Source:TAPI Manager Possible
155www.kepware.comKEPServerEX5 Help Solution:None available. Line '<modem name>' connected at '<baud rate>' baudError
156www.kepware.comKEPServerEX5 HelpSolution:N/A. Modem line closed: '<modem name>'Error Type:Warning Source:TAPI Manager Possible Caus
157www.kepware.comKEPServerEX5 HelpIf the modem was recently installed, try stopping and restarting the server. The PC may need to be rebooted in orde
158www.kepware.comKEPServerEX5 HelpSolution:1. Hang up and then try again later.2. Verify that the remote modem is configured to answer calls. TAPI co
15www.kepware.comKEPServerEX5 Help Descriptions of the parameters are as follows:OPC Connection Security: This parameter allows users to select authe
159www.kepware.comKEPServerEX5 HelpTAPI Manager was unable to apply to Configuration changes to the server. Solution:1. Verify the cabling to the mode
160www.kepware.comKEPServerEX5 HelpThe server was not able to add the NIO interface. Solution:The server could be in use by a client application. In t
KEPServerEX5 Help161www.kepware.comIndex- _ -_ Error control 152_ Forced error control 152_ Hardware flow control 152_ Software flow contr
Index162www.kepware.comDevice '<device name>' has been auto-demoted 135Device '<device name>' has been auto-promote
KEPServerEX5 Help163www.kepware.com- M -Maximum channel count exceeded for the liteversion '<driver name>' driver license 146Maxim
Index164www.kepware.comStopping '<driver name>' device driver 138Stopping '<plug-in name>' plug-in 138Stoppi
16www.kepware.comKEPServerEX5 Helpare logged into it. Descriptions of the parameters are as follows.Preserve log on disk: This parameter enables the
17www.kepware.comKEPServerEX5 Help Descriptions of the parameters are as follows.Cache Lifetime: This parameter is used to determine how long the ser
18www.kepware.comKEPServerEX5 Help Property TagsTag Properties are available as additional tags that can be accessed by any Data Access client by appe
KEPServerEX5 Help1Table of Contents...
19www.kepware.comKEPServerEX5 Helpautomatically generated. Descriptions of the selections are as follows.Do not generate on startup, the default cond
20www.kepware.comKEPServerEX5 HelpThe Add generated tags to the following group was left blank. "MyGroup" was entered in the Add generated t
21www.kepware.comKEPServerEX5 HelpUncheckedThe server will automatically generate the device's tags in a simple list without anysubgrouping. In t
22www.kepware.comKEPServerEX5 HelpChannel-Level System Tags / SerialChannel-Level System Tags / EthernetDevice-level System Tags / Serial and Ethernet
23www.kepware.comKEPServerEX5 Helpadapters available for use on this PC. The string returned will contain allof the NIC names and their IP assignments
24www.kepware.comKEPServerEX5 HelpRTS mode. The _RtsLineRaise is defined as a long value. The validrange is 10 - 2550 milliseconds. The Manual RTS mod
25www.kepware.comKEPServerEX5 HelpEncapsulation is selected.This is a Read Only tag._NetworkAdapterClass: Parameter TagThe _NetworkAdapter tag is a ta
26www.kepware.comKEPServerEX5 Helpapplies to all drivers equally.This is a Read/Write tag._InterRequestDelayThe _InterRequestDelay is a tag that allow
27www.kepware.comKEPServerEX5 Helprequest timeouts and retries without a response.See Also: Device Properties - Timing.This is a Read Only tag._Simula
28www.kepware.comKEPServerEX5 Help The _System branch found under the DeviceName branch is always available. If referencing a system tag from a DDEapp
2Contents2...
29www.kepware.comKEPServerEX5 Help_AddressThe _Address property tag indicates the current address for the tag it isreferencing._DescriptionThe _Descri
30www.kepware.comKEPServerEX5 Helpconfigured timeout and retry count for the device. This tag is formattedas an unsigned 32 bit integer and will event
31www.kepware.comKEPServerEX5 Help The _Statistics branch found under the Channel branch will only appear when diagnostics are enabled for the channel
32www.kepware.comKEPServerEX5 HelpAttempting to issue a dial commandwhile the Mode tag is set to 2(incoming call only) will generate anerror._DialNumb
33www.kepware.comKEPServerEX5 HelpCanonical format is the following:+<country code>[space](<areacode>)[space]<phone number>example:
34www.kepware.comKEPServerEX5 Help11Calling19Answering Last Event ValuesLastEventReason for Change-1<blank> [no events have occurred yet]0Initia
35www.kepware.comKEPServerEX5 Helpassigned IP address. The list of available NICs will include both unique NIC cards and NICs that have multiple IPsas
36www.kepware.comKEPServerEX5 HelpConfiguring the Initiating ModemThis server uses the Windows TAPI interface to access modems attached to the PC. The
37www.kepware.comKEPServerEX5 Help 1. Load the direct connect project and then double-click on the Channel Name. This will invoke the current directco
38www.kepware.comKEPServerEX5 Help To add a new phonebook tag, simply click on the New Phonebook icon to display the Phone Number dialog. ExampleA pho
KEPServerEX5 Help3...
39www.kepware.comKEPServerEX5 Helpgood idea, some OPC client applications may have a limited display window when browsing the tag space of anOPC serve
40www.kepware.comKEPServerEX5 Help OPC Diagnostic FeaturesThe Find Dialog can be used to search for specific text within the diagnostics view. This ai
41www.kepware.comKEPServerEX5 Help Each method (such as, GetErrorString) of every OPC Data Access 1.0, 2.0 and 3.0 interface (such as, IOPCCommon)supp
42www.kepware.comKEPServerEX5 HelpSince diagnostic information affects memory/file storage, users can decide the maximum number of OPC diagnosticevent
43www.kepware.comKEPServerEX5 Helpability to set and query a Locale ID which would be in effect for the particular client/server session. That is, the
44www.kepware.comKEPServerEX5 Helpnode (e.g. the units in a cell).QueryOrganization - Provides a way to determine if the underlying system is inheren
45www.kepware.comKEPServerEX5 Helpcan be obtained from Read cache for those items and whether or not they are included in the IAdvisesubscription to t
46www.kepware.comKEPServerEX5 Help'queued' and the function will return immediately so that the client can continue to run. Each operation i
47www.kepware.comKEPServerEX5 HelpIDataObject connections as in the past.EnumConnectionPoints - Creates an enumerator for the Connection Points suppo
48www.kepware.comKEPServerEX5 Help Note: The Diagnostic Window operates in a modeless form that allows it to exist while other dialogs in the server a
4Contents4...
49www.kepware.comKEPServerEX5 Helpeffect in the protocol view. Remember to display the diagnostic window before accessing any parameter dialogs. Once
50www.kepware.comKEPServerEX5 Helpkeep in mind that it can affect the speed of update if the size is set to large. Larger font sizes also prevent user
51www.kepware.comKEPServerEX5 Helpidentical communication parameters; for example, two serial drivers cannot use COM1. For the correct communicationpa
52www.kepware.comKEPServerEX5 Help Note: With the server's online full-time operation, these parameters can be changed at any time. This includes
53www.kepware.comKEPServerEX5 HelpReport Comm. Errors turns the reporting of low level communications errors On or Off. When enabled, low-level error
54www.kepware.comKEPServerEX5 Help By selecting a specific NIC interface, users will be able to force the driver to send all Ethernet communication th
55www.kepware.comKEPServerEX5 Help For those drivers that support it, the RTS Manual selection enables the setting of three timing parameters. Thesese
56www.kepware.comKEPServerEX5 Help Note: With the server's online full-time operation, these parameters can be changed at any time. Utilize the U
57www.kepware.comKEPServerEX5 Help 1. Write all values for all tags'Write all values for all tags' forces the server to attempt to Write eve
58www.kepware.comKEPServerEX5 Helpenhancements before they are used in a production environment. Channel Properties - Ethernet EncapsulationEthernet E
KEPServerEX5 Help5...
59www.kepware.comKEPServerEX5 HelpThe Network Adapter parameter's drop-down list is used to select the network adapter.The IP Address parameter
60www.kepware.comKEPServerEX5 HelpAdding a DeviceDevices can be added using the New Device Wizard both at the initial setup and afterwards. To do so,
61www.kepware.comKEPServerEX5 HelpFigure 2 - Ethernet Device Properties Device NamesDevice Names, which are logical user-defined names for the device,
62www.kepware.comKEPServerEX5 Helpparameter can be used to disable a physical device for servicing. After a device has been disabled, no communication
63www.kepware.comKEPServerEX5 Help Device-level Ethernet Encapsulation SettingsDescriptions of the parameters are as follows.IP Address: This paramet
64www.kepware.comKEPServerEX5 Help Connection TimeoutThis parameter, used primarily by Ethernet based drivers, controls the amount of time required to
65www.kepware.comKEPServerEX5 Helpwill override the normal polling frequency of tags associated with the device, as well as one-shot Reads and writes.
66www.kepware.comKEPServerEX5 Helpbe attempted during the off-scan period. The default setting always sends write requests regardless of thedemotion p
67www.kepware.comKEPServerEX5 Helpdriver being used. To determine how an address should be entered, use the Hints button next to the AddressParameter.
68www.kepware.comKEPServerEX5 Helpconnect, the server will create a virtual tag for that location and will start scanning for data automatically. To s
6www.kepware.comKEPServerEX5 Help CONTENTS IntroductionConnectivityServer AdministrationTag ManagementCommunications ManagementBuilt-In DiagnosticsBa
69www.kepware.comKEPServerEX5 Help Note: User-defined tags support scaling. Tag ScalingThis server supports Tag Scaling, which allows raw data from th
70www.kepware.comKEPServerEX5 Helpdata. When this occurs, the scaled value is also forced outside of the established range. Toprevent this from occurr
71www.kepware.comKEPServerEX5 Help To add a new tag group to the project, right-click on either an existing device or tag group branch and select New
72www.kepware.comKEPServerEX5 Help Tag groups can be added at any level from the device-level down, and multiple tag groups can be nested together to
73www.kepware.comKEPServerEX5 HelpTo delete manually created aliases, click .To import an alias map as a .CSV file, click .To export an alias map
74www.kepware.comKEPServerEX5 HelpTopic update rate found in many DDE only servers. The valid range is 0 to 99999990 milliseconds. The default is0 mil
75www.kepware.comKEPServerEX5 Help Note: Now that the server is running, a project may be created. Starting a New ProjectThis server must be configure
76www.kepware.comKEPServerEX5 HelpNew Channel by Edit | Add Channel New Channel by Context Menu 2. For simplicity, leave the channel name "Channe
77www.kepware.comKEPServerEX5 Help Important: A a small red "x" should be visible below the channel icon. This denotes that the channel does
78www.kepware.comKEPServerEX5 HelpNew Device by Context Menu 2. For simplicity, leave the device name "Device1." Note: The number of dialog
7www.kepware.comKEPServerEX5 Helpin order for the application to operate as designed. This application supports the following Microsoft Windows operat
79www.kepware.comKEPServerEX5 Help 5. To complete the addition of the device, click Next | Finish. Note: The server is now ready to start providing da
80www.kepware.comKEPServerEX5 HelpAdd Tag by Edit | New Tag Add Tag by Context Menu 3. Edit the controls to match the following content (as shown in t
81www.kepware.comKEPServerEX5 Help For additional information, click the Help button in the Hints dialog. This invokes the driver specific help docume
82www.kepware.comKEPServerEX5 Help Adding Tag ScalingWhen defining a new tag in the server, users have the option of applying tag scaling, which allow
83www.kepware.comKEPServerEX5 Help 2. In this example, Linear Scaling has been selected. The raw value range allows users to specify what they expect
84www.kepware.comKEPServerEX5 Helpclicking File | Save. Users can overwrite the existing project or save the edits as a new project. They are also giv
85www.kepware.comKEPServerEX5 Help Establishing a Connection3. Next, establish a connection by clicking Edit | New Server Connection. Alternatively, r
86www.kepware.comKEPServerEX5 HelpConnect to Server by the Context Menu Note 1: By default, the Server Selection dialog is configured with the Prog ID
87www.kepware.comKEPServerEX5 Help Adding a Group by Toolbar Icon Adding a Group by Context Menu 5. For the purposes of this example, edit the Group P
88www.kepware.comKEPServerEX5 Helpto eliminate or reduce noise content in the data by only detecting changes when they exceed the percentage changetha
8www.kepware.comKEPServerEX5 Helpmaximum number of supported channels. The information available is as follows.Summary provides the driver name and
89www.kepware.comKEPServerEX5 HelpClient should appear as shown below. The first tag, "MyFirstTag," should contain a changing value. The se
90www.kepware.comKEPServerEX5 Help. If no new data has been entered, clicking OK will not send data to the server. ConclusionAt this point, all of the
91www.kepware.comKEPServerEX5 Help Since the server supports the use of simultaneous multiple communications drivers, users can add a number ofchannel
92www.kepware.comKEPServerEX5 Help For Serial based drivers, the Communications dialog is used to set the Serial Port, Baud rate, Data bits, Parity, S
93www.kepware.comKEPServerEX5 Help New Device - NameA Device Name can be the same from one channel to the next; however, each device under a channel m
94www.kepware.comKEPServerEX5 Help Note: Within an OPC client, the combination of channel name and device name would appear as ChannelName.DeviceName.
95www.kepware.comKEPServerEX5 Help Note: With the server's online full-time operation, these parameters can be changes at any time. If the commun
96www.kepware.comKEPServerEX5 Help If the communications driver is either Ethernet-based or supports an unconventional station or node name, the dialo
97www.kepware.comKEPServerEX5 HelpNote: With the server's online full-time operation, these parameters can be changed at any time. Any changes ma
98www.kepware.comKEPServerEX5 Help Server OptionsGeneral OptionsThe server's online full-time mode of operation places some special requirements
Comments to this Manuals