Professional Documents
Culture Documents
Release Information
Uniformance 300 Document Revision: 12 Document Revision Date: January, 2010 Document ID: pim2901.pdf Document PARs Fixed:
Document Revision 12
Honeywell Process Solutions 1860 W. Rose Garden Ln Phoenix, Arizona 85027-2708 USA
WWW.HONEYWELL.COM/PS
Email:
Honeywell Global TAC India +91-20- 66039400 +91-20- 66039800 Honeywell Automation India Ltd. 56 and 57, Hadapsar Industrial Estate Hadapsar, Pune 411 013, India Global-TAC-India@honeywell.com
Korea Contact: Phone: Facsimile: Mail: Honeywell Global TAC Korea +82-2-799-6317 +82-11-9227-6324 +82-2-792-9015 Honeywell Co., Ltd 4F, Sangam IT Tower B4-4 Block 1590, DMC Sangam-dong, Mapo-gu, Seoul, 121-836, Korea Global-TAC-Korea@honeywell.com
Email:
Peoples Republic of China Contact: Honeywell Global TAC China Phone: +86- 21-52574568 Mail: Honeywell (China) Co., Ltd 33/F, Tower A, City Center, 100 Zunyi Rd. Shanghai 200051, Peoples Republic of China Email: Global-TAC-China@honeywell.com Singapore Contact: Phone: Facsimile: Mail: Global TAC South East Asia +65-6580-3500 +65-6580-3501 +65-6445-3033 Honeywell Private Limited Honeywell Building 17, Changi Business Park Central 1 Singapore 486073 GTAC-SEA@honeywell.com Global TAC Taiwan +886- 7- 536 2567 +886-7-536 2039 Honeywell Taiwan Ltd. 17F-1, No. 260, Jhongshan 2nd Road. Cianjhen District Kaohsiung, Taiwan, ROC Global-TAC-Taiwan@honeywell.com
Email:
Japan Contact: Phone: Facsimile: Mail: Global TAC Japan +81-3-6730-7160 +81-3-6730-7228 Honeywell Japan Inc. New Pier Takeshiba, South Tower Building, 20th Floor, 1-16-1 Kaigan, Minato-ku, Tokyo 105-0022, Japan Global-TAC-JapanJA25@honeywell.com
Email:
Elsewhere Call your nearest Honeywell office. World Wide Web Honeywell Solution Support Online: http://www.honeywell.com/ps Training Classes Honeywell Automation College: http://www.automationcollege.com
Contents
1. About This Document.......................................................................................... 9 1.1 1.2 1.3 2. Document Scope....................................................................................... 9 Intended Audience .................................................................................... 9 Additional References ............................................................................... 9
Getting Started ................................................................................................... 11 2.1 2.2 2.3 2.4 Introduction to the PHD OPC Server ...................................................... 11 Supported OPC standards ................................................................... 11 PHD OPC Server Requirements............................................................. 12 Where to Install PHD OPC Server Software........................................... 12 PHD OPC Server Registry Settings........................................................ 13 To enable/disable tag browsing............................................................ 13 Cached browsing.................................................................................. 14 To enable AFM tag routing and put download ..................................... 14
3.
Configuring the PHD OPC Server..................................................................... 15 3.1 3.2 Overview .................................................................................................15 View/Modify DCOM Configuration of PHD OPC Server ......................... 15 To configure DCOM settings for the machine default .......................... 16 To configure properties of the PHD OPC Server COM components ... 28
4.
Overview of Uniformance PHD ......................................................................... 37 4.1 4.2 4.3 4.4 4.5 4.6 Uniformance PHD Components.............................................................. 37 PHD Server Functionality........................................................................ 39 Multiple PHD Server Systems................................................................. 40 PHD OPC Server Instances.................................................................... 42 Read/Write Access to PHD Data ............................................................ 43 Introduction to PHD Security................................................................... 43 Enabling/disabling PHD Server security............................................... 44 Changing user rights ............................................................................ 44
Uniformance - PHD OPC Server User Guide vii
Contents
4.7 5.
Using the PHD OPC Server ...............................................................................47 5.1 5.2 5.3 Overview .................................................................................................47 Guidelines for Accessing PHD Values.................................................... 47 Creating a PHD OPC Server Client Application...................................... 48 Required expertise ............................................................................... 48 Software developer tools ...................................................................... 48 PHD OPC Data Standards for Client Applications.................................. 49 PHD OPC name forms ......................................................................... 50 Supported data types ........................................................................... 50 Array indexing....................................................................................... 51 Enumerated data types ........................................................................ 51 Interpreting data quality ........................................................................ 53 Data confidence versus data quality .................................................... 54 Out of range and NaN values............................................................... 54 Data for requested time of NOW .......................................................... 54 Extrapolated values .............................................................................. 55 Interpolated values ............................................................................... 55 INTERPOLATIVE (snapshot) ............................................................... 55
5.4
Glossary
1.2
Intended Audience
The document assumes you are skilled in performing Windows operating system administrative tasks.
1.3
Additional References
The following list identifies documents that may be sources of reference for the material discussed in this publication.
Document Title Uniformance - PHD System Manual Uniformance - PHD User Guide Uniformance PHD Installation Guide Uniformance - Database System Specification and Technical Data OLE for Process Control Data Access Standard Version 3 OLE for Process Control Data Historical Data Access Version 1.2 Document ID pim0301 pim0201 in6001 ph03300 See NOTE See NOTE
NOTE: Information on OPC automation standards can be found in the publicly available OPC specifications at www.opcfoundation.org. Uniformance - PHD OPC Server User Guide 9
2. Getting Started
2.1 Introduction to the PHD OPC Server
The PHD OPC Server is a Uniformance component that implements OLE for Process Control (OPC) interfaces as a method of access to a Uniformance Process History Database (PHD) Server. The interfaces enable client applications to access a single Uniformance PHD Server. A Uniformance PHD Server stores variable data from a variety of process related sources. All data values stored in a PHD Server are maintained over time in history archives. The PHD Server provides interfaces through which clients may access the current or historical values from its storage. The PHD OPC Server is an independent executable program it can reside on the same machine as the PHD Server or on a remote server. The OPC standard interface specifies a standard set of interface semantics for access to data values. The PHD OPC Server is compliant with both the OPC DA and OPC HDA standards, described as follows: OPC DA OPC HDA The OPC Data Access (DA) standard interface allows clients to gain access to real-time (current) data values maintained by a PHD Server. The OPC Historical Data Access (HDA) standard interface allows clients to gain access to historical data values maintained by a PHD Server.
Supported OPC standards The PHD OPC Server is compliant with the following OPC standard versions:
2.2
Hardware environment
Item CPU Memory Hard Disk Requirement (minimum) Intel Pentium Pro 64 MB 128 MB free space
Software environment
Item Operating System Requirement
A supported Microsoft Windows operating system. (See the
purposes. PHD OPC Server Requires the installation of PHD Server software on at least one computer system within the same network domain.
Network environment
Item Network Protocols Requirement Ethernet, TCP/IP, Microsoft application layer software (RPC and DCOM). One of the following name services must be available: DNS WINS Local Host File
2.3
Description
Installs the OPC Client DLLs and registers the OPC Server name on this machine.
Install Type
Server
Description
Installs the complete OPC server, registers the OPC Client DLLs, and registers the OPC Server name.
If you install Server on a separate node from the PHD Server, then the PHD OPC Server will use the PHD Server's API Server instead of accessing the PHD Server directly. You should be aware that this connection counts against the maximum number of users for the API Server. (For information on the APIServer registry settings, refer the PHD System Manual, pim0301.pdf.) You only need to install Client on client nodes that are separate from the Server node. Note: For security reasons, Honeywell recommends that Server and Client be on the same side of a firewall as the PHD Server; otherwise, OPC requires that you open additional ports in the Firewall. Since OPC uses DCOM, and DCOM uses many dynamically assigned ports, OPC will not work well with a firewall. REFERENCE: For the software installation procedure, refer to the PHD Installation Guide (in6001.pdf).
2.4
To enable/disable tag browsing PHD OPC Server tag browsing is disabled by default. The tag browsing can be enabled by changing the registry setting under the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Honeywell\Uniformance\OPCServer Set the following REG_DWORD value to control the PHD OPC Servers browse capabilities:
BrowseMode = 0 Automatic Mode - Disabled if on PHD Server machine Uniformance - PHD OPC Server User Guide 13
Cached browsing Tag browsing has the potential to be a slow and memory intensive process. Browsing may be performed in a cached mode. If cached browsing is enabled, all PHD tags "queried" during the first browse are "cached" in memory. Any subsequent requests to browse for tags will go to this cache for tag information. If disabled, each browse request will go to PHD for tag information. The advantage of caching is that any subsequent browse request is quicker after the first request; however, with cached browsing enabled, you will not see updated or new PHD tags through the browse. The cached browsing can be enabled by changing the registry setting under the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Honeywell\Uniformance\OPCServer\ CacheBrowseInfo Valid options are: 0 : Disabled 1 : Enabled To enable AFM tag routing and put download For the output of an Advanced Formula Manager (AFM) tag to be routable and put downloadable, the HDAInsertsUsePutData registry key MUST have value of 1.
To establish specific user rights to launch, access, and configure the PHD OPC Server. To run the server on a remote computer.
3.2
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Note: Do not attempt to modify DCOM settings without a thorough understanding of the impact it may have on your system.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
On Windows 2000:
Note: For Windows 2000, the tabs in the Distributed COM Configuration Properties screen appear slightly different than those in the Windows 2003/XP My Computer Properties screen. In most of the steps in this procedure, we used Windows 2003/XP screen examples to illustrate the correct settings.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
On Windows 2003/XP: Click the COM Security tab. On Windows 2000: Click the Default Security tab. Default COM Security - Access Permissions - Edit Limits
On Windows 2003/XP: Under Access Permissions, click Edit Limits. On Windows 2000: Steps 6, 7, and 8 are not applicable - skip to Step 12.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step
10
Add the local group NETWORK to the list, and make sure Remote Access is allowed, as shown in the following screen example.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step TIP:
Action
On Windows 2003/XP, to add the local group NETWORK, do the following: 1) Click Add. 2) From the 'Locations' window, select the name of this machine.
3) Click OK. 4) The 'Select Users or Groups' window appears. Click Advanced.
5) Click Find Now (shown in the following screen example) 6) In the search results, select NETWORK.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step
Action
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step 11
Action Click OK to close the 'Access Permission' window. Default COM Security - Access Permissions - Edit Default
12
On Windows 2003/XP: Under Access Permissions click Edit Default. On Windows 2000: Under Default Access Permissions click Edit Default.
13
Add the Everyone group and ensure that it has the correct permissions, as shown in the following screen examples.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step
Action On Windows 2003/XP: Ensure that the Everyone group has Remote Access, as shown in the following screen example.
On Windows 2000: Ensure that the Everyone group has Allow Access selected for Type of Access.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
Default COM Security - Launch Permissions - Edit Default 15 On Windows 2003/XP: Under Launch Permissions click Edit Default. On Windows 2000: Under Default Launch Permissions click Edit Default. 16 Add the Everyone group and ensure that it has the correct permissions, as shown in the following screen examples. Windows 2003/XP:
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
17
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step 3
Action Click the Location tab. Edit the properties as shown in the following screen example. The PHD OPC Server runs on the local system by default. If you wish to run the Server on a remote machine, select 'Run application on the following computer' and enter the computer name. You may need to install the PHD OPC Server software on the remote computer before you can configure it to execute there.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
The Security tab is used to customize the access, launch, and configuration permissions for a selected individual COM component. On Windows 2000, normally you need not change these settings. Skip to Step X. On Windows 2003/XP, under Launch and Activation Permissions, select Customize and click Edit.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step 5
Action Add the Distributed COM Users group to the list if it is not there already. Ensure the Distributed COM Users group has Remote Launch and Remote Activation enabled, as shown in the following screen example.
Click OK.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step 7
Action On the Security tab, under Access Permissions, select Customize and click Edit.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Step 8
Action Add the Distributed COM Users group to the list if it is not there already. Ensure the Distributed COM Users group has Remote Access enabled, as shown in the following screen example.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
Action
By default, the PHD OPC Server runs under the identity of The Launching user - the user who initially launches it. If you wish the server to run under a specific user identity, select This User and enter the username and password. Launch of the PHD OPC Server with the identity of The interactive user is often used for interactive client applications that use asynchronous operations that require the server to execute callbacks with the appropriate identity. Note: Ensure that the selected user identity has rights to access and launch the component.
10
Repeat this procedure (steps 1-9) for the Uniformance PHD OPC DA Server component.
3 Configuring the PHD OPC Server 3.2 View/Modify DCOM Configuration of PHD OPC Server
4.2
4.3
Operate so a single server effectively hides, or Shadows, one or more additional servers from view by some client applications. In this configuration, all servers share the identical configuration data. Shadow servers provide for isolation of the client from other server environments while also distributing the dynamic load. Operate as peers, where clients must access each server directly. Unlike the Shadow server configuration, peer servers are autonomous, each having its own unique configuration data. Operate as a mixture of both shadow and peer configurations.
The following figure illustrates the complexity you may encounter in a multiple PHD Server system where multiple DCS systems have also been integrated, and the historical real-time database is configured for use by applications in both the Level 3 and Level 4 operating domains. The configuration illustrated in the following figure is representative of many existing Uniformance PHD installations. When DCS systems are introduced to such configurations, the PHD OPC Server provides the consistent interface to each PHD Server; however, the DCS system and its functions for system management and security introduce additional complexity which should be considered in the system configuration.
The system configuration represented in the previous figure has three Uniformance PHD Servers used by clients. Multiple PHD Servers often provide distributed history storage to a varied group of clients, thereby providing better security and more predictable system loading. In this example diagram, the client applications executing on computers in the Level 4 LAN are isolated from
Uniformance PHD OPC Server User Guide 41
access to Level 3 and the control system environment by the Shadow PHD server. They are still able to access data provided to the Shadow by the PHD Servers on the Level 3 LAN. The previous diagram illustrates the following configuraton:
Shadow and Collector PHD Servers share a common reference database, maintained by a SQL Server RDBMS located on Shadow. Both servers share the identical configuration information. This allows Shadow to maintain identical data as Collector by retrieving its data and storing it locally. The Clients accessing history data through Shadow (typically, the Level 4 clients) are able to access data collected by Collector transparently. This configuration is commonly used to isolate a Level 3 history server, in this case, Collector, from any dynamic load imposed by client data queries from Level 4. In addition, the existence of PHD Server Collector is unknown to the Level 4 clients, allowing greater control on the security of the Level 3 system. Peer PHD Server uses its own reference data independent from that shared by the other two servers, effectively isolating this server from Level 4 entirely. Its configuration and the data values it stores are not accessable to Level 4 clients; however, you can replicate configuration information from this server in a configuration database used by the other two PHD Servers, so they provide access to a portion, or all, of the historical data maintained by Peer. Both Collector and Peer are configured to use real-time interfaces that collect data from the same DCS. These two servers, using separate databases, operate as peers and may be configured to store data samples for the same point variable.
4.4
On each PHDServer,
Or
On each client that wants to use OPC to connect to a particular PHD Server.
4.5
4.6
A user's access right to each configurable object in the PHD database (Tag, Interface, and Function) may be granted by a Role. A role is a configuration entity in PHD, reflecting the set of privileges that may be assumed by a given user on an object. The basic privileges that may be granted are Read, Write and Configure. For example, you can define a role that enables the user to write values to tags configured in PHD. You can assign this role to individual PHD Tags, or to an RDI that in turn has numerous tags assigned to it. A user with this role can write data to a tag with the same role. However, the ability to write data to a tag in PHD, and to the data source, such as the DCS, is restricted by additional configuration options on each individual tag.
Uniformance PHD OPC Server User Guide 43
Once implemented, PHD security is absolute. All access is governed by the privileges granted by the roles assigned to the user and PHD objects. There are no default privileges. Enabling/disabling PHD Server security The security configuration controlled by the PHD Server is optional, and may be enabled or disabled:
When security is Disabled PHD data is Public, and security is limited to the validation of a user name and password when connection is made to the server. All requests to read and write values are honored, with the exception that the ability to write data values may be restricted by configuration attributes for each point.variable. "Private", and users must be configured by name in PHD before access to any data is allowed. In addition, a user is configured with a specific set of rights, or role, which governs the operations that may be performed.
Enabled
Changing user rights It is not possible for a PHD user to dynamically assume a new role. Since users are associated with roles after logging on to the PHD Server, changing a users access rights requires you to first change the PHD reference database. The user must log out and log back in to assume the new rights.
4.7
Interpolation derives a value at a specific time between stored data values. Extrapolation derives values for a point in time that has not yet been stored.
REFERENCE: For detailed descriptions of PHD interpolation and extrapolation, refer to the PHD User Guide (pim0201).
5.2
5 Using the PHD OPC Server 5.3 Creating a PHD OPC Server Client Application
5.3
Required expertise Developing an OPC client application is not a trivial undertaking. You must be familiar with OPC and the underlying Microsoft DCOM architecture, and should be well versed in the development of applications in Visual C++ or Visual Basic. There are numerous documents available that will help you obtain the necessary expertise. If you are developing an OPC client application that uses the PHD OPC Server, become familiar with the Uniformance PHD to understand the fundamentals of its implementation and the services it provides. Software developer tools The standard OPC interface definitions and run-time libraries are provided by Microsoft Corporation on Windows development platforms. Any client application developed using Microsoft tools and libraries can access data through the PHD OPC Server. Typically, Microsoft Visual Basic and Visual C++ are used to create a client application that uses OPC methods to access data from an PHD OPC Server. You can choose from several commercially available software tool sets to accomplish this task.
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
5.4
HRESULT In order to make the return interface consistent with OPC APIs, the PHD OPC Server uses a consistent 32-bit return value called HRESULT. Each API description includes a table of returned HRESULT values. PHD OPC interfaces return the following status values:
S_OK E_FAIL E_ABORT OPC_E_UNKNOWNITEMID OPC_E_BADRIGHTS E_ACCESSDENIED E_NOTIMPL E_INVALIDARG E_UNEXPECTED E_NOINTERFACE E_POINTER E_OUTOFMEMORY
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
PHD OPC name forms You can access data items by name using the OPC standard interfaces. The PHD OPC Server accepts item names as identifiers of PHD Server tags. The name syntax is a free form text string. Item name conventions The system-wide naming conventions used to identify a DCS point.variable must be consistent throughout all system components. Variable names configured in the DCS must match, and be closely coordinated with those configured in PHD Server database. PHD tag name conventions REFERENCE: For PHD tag naming conventions, refer to the Tag Configuration form in the PHD User Guide (pim0201). Supported data types The following table shows the supported data types common to Honeywell, and how the PHD OPC Server maps them into OPC data. The PHD OPC Server supports access of the following data types. In the case where the source attribute is set to BARRAY the OPC Server will return an array of values. The actual data type will depend on the data stored in PHD, since the data is actually stored as a Safe Array and can contain different data types. Otherwise each item maps to a single PHD tag whether or not it came from an array on the source system.
This Honeywell data type Real 32 bit IEEE format (float) Real 64 bit IEEE format (double) Standard and Self Defining Enumeration Ordinal String Integer 32 bit signed Integer 64 bit signed Binary SRC_ATTRIB is set to BARRAY Binary All other cases Maps to this OPC type VT_R4 VT_R8 VT_BSTR VT_I4 VT_BSTR VT_I4 VT_CY VT_* | VT_ARRAY VT_UI1 | VT_ARRAY
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
Array indexing PHD support for array data types depends on the real-time data interface (collector) being used. Each element of an array type DCS parameter must be configured as a separate PHD Tag. If you need to access an array element through the PHD OPC Server, you must configure a corresponding PHD Tag for the element. For example, the following DCS names would map to specific PHD tags, each of which must be configured in PHD to reference a specific element of the point parameter named A100.PV: [lcn1\]A100.PV[(1) [lcn1\]A100.PV[(2) [lcn1\]A100.PV[(n) REFERENCE: For more information about configuring tags in PHD, please refer to the PHD User Guide (pim0201). REFERENCE: For more information about binary array tags in PHD, please refer to the PHD Array Tag User Guide (pim3701). Enumerated data types PHD provides two methods for managing ordinal/enumeration data. Method 1: In PHD 210 and later, you can create an enumeration string table and PHD chooses the correct string from the enumeration table based on the ordinal value collected from the control system. The digital enumeration ordinal would be defined as integer tag. To designate the integer tag as a digital enumeration, you must enable the tags Digital Enumeration flag, and then specify the name of the digital enumeration table, allowing PHD to map the enumeration in the table to that ordinal. Users can request the data as a string, in which case PHD returns the enumeration rather than the ordinal. Method 2: Alternatively, the collector can retrieve the enumeration string from the control system. You can configure values for enumeration variables in PHD as either of the base types, Integer or String. To obtain values for both types from a single variable, you must configure two independent PHD tags, one to store the Integer value for the enumeration ordinal, and the other to store the string representation. When you configure PHD to store enumeration types, use a convenient convention to select the PHD name. For example:
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
The above examples are item names as referenced through the PHD OPC Server. Each would be configured in PHD to reference the same DCS point.variable, such as GEN1.MODE. The data type stored for the PHD variable would be either Integer or String. The use of convention, which adds subscript text in the name to differentiate the data type, simplifies application development and system administration of the name space.
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
Interpreting data quality The PHD Server represents data quality as a percentage of confidence, with a range of 0 to 100 %. Under most conditions, a data value is always represented by a confidence of 100%, indicating a good value, a confidence of 0, indicating a uncertain value. Normally, values between 0 and 100 are reserved for representation of confidence as a result of extrapolation from known good values. A special confidence factor value of 1 is reserved to indicate when data is not available and must be considered bad quality. This Bad Data status normally indicates a period of outage caused by server shutdown or loss of communications with the DCS. The confidence factor assigned to a value is derived at the time the data value is collected from the remote data owner, such as the DCS. The confidence is derived from the specific status of the value as reflected by the underlying DCS system. Using a simple percentage of confidence in value storage relieves the PHD Server from having to store specific status indication that would require distinct interpretation for each type of DCS or other equipment from which data is collected. The PHD OPC Server translates the PHD confidence factor to the appropriate OPC Data Quality indications.
PHD Confidence Factor 100 -1 Quality Good Bad OPC Quality Sub-Status Non-Specific No Data (Comm Failure, Nan) >0 and <100 Uncertain Non-Specific
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
Data confidence versus data quality Applications programs that insert data into PHD, for example, using PHD Manual Input tags, should (but are not guaranteed to) follow these conventions. An application may choose to assign any confidence between -1 and 100 to a PHD data value when it is stored.
A confidence of 100% 0 50% (degraded confidence) Is assigned to this data value A data value known to be accurate. A data value that is derived, extrapolated or otherwise "assumed". A data value which can be accurately extrapolated by regression formula using values recently stored in the PHD database that are known to be valid. Any error that prevents an RDI from presenting a data value obtained from the DCS interface, for example, a communications error, is a No Data condition. This has a data value of 0.
-1
Out of range and NaN values By definition, an Out of Range data value is any value that exceeds the configured Range Hi or Range Low for the PHD tag. With only one exception, all out of range values are arbitrarily assigned a confidence of zero when inserted into PHD by collectors. In addition, Out of Range values are clamped to the PHD configured range limit that was exceeded. The only exception to this convention is NaN (not a number) values collected from the DCS by the collector. PHD assigns NaN values a confidence factor of 1, the same as No Data. Data for requested time of NOW The PHD OPC Server, by default, returns as-stored (or raw) data values obtained from the PHD Server. Process data values are periodically collected and stored in the history database. This means that data values are periodic, and a data value returned to a client for a requested time of NOW may actually be the most recent value, not a real-time current value.
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
Extrapolated values You can use the PHD OPC Server to return extrapolated values. To use extrapolation, the OPC items specified by the client must refer to PHD tags that are configured appropriately. The PHD Server configuration allows you to use syntax to specify the dynamic use of extrapolation when values are referenced - this syntax is specified in the source tag specification of the tag configuration. The specific notation invokes a dynamic data reduction (virtual calculation) by the PHD Server to perform the extrapolation. For example, the following syntax specified in the source tag specification field of the PHD tag SRC_A.A100PV.extrap invokes extrapolation of the current value from the PHD tag SRC_A.A100.PV: SRC_A.A100.PV{,,NOW,NOW,} Since an extrapolated value is derived from actual data prior to the specific request time, it has a confidence factor of less than 100%. The PHD OPC Server translates the PHD value confidence to OPC data quality. For extrapolated values, the OPC data quality is always Uncertain, and the sub-status is NonSpecific. For the definition of the mapping of PHD data confidence to OPC data quality, refer to Interpreting data quality in this guide. Interpolated values The PHD OPC Server calculates interpolative and time average aggregates as follows. INTERPOLATIVE (snapshot) For PHD tags configured with non-float data types (not Float or Double), or with Manual Input enabled, or with Interpolation Method of Step, the PHD OPC Server uses stepped interpolation; otherwise it uses linear interpolation. TIMEAVERAGE For the time-weighted average aggregate, the PHD OPC Server uses linear interpolation. REFERENCE: For other aggregates, refer to the OPC HDA Specification (Custom Interface Specification Version 1.2_Errata 1) Feb 9, 2004. http://www.opcfoundation.org/forum/viewtopic.php?t=345&postdays=0&postorder=asc&star t=0
5 Using the PHD OPC Server 5.4 PHD OPC Data Standards for Client Applications
Index
using NaN values, 54 array indexing using out of range values, 54 for client applications, 51 data types client applications for client applications, 50 creating for PHD OPC Server, 48 DCOM creating standard for OPC, 48 running DCOMCNFG, 15 common reference database, 42 setting up when configuring, 15 confidence DCOMCNFG, running, 15 interpreting data quality, 53 default installation configuration, using, 15 confidence versus quality, 54 setting up the DCOM, 15 configuring PHD OPC Server defining using default installation configuration, 15 array indexing, 51 creating confidence, 54 client applications for PHD OPC Server, 48 data data quality, 53 data quality data types, 50 interpreting, 53 enumerated data types, 51 data standards extrapolated values, 55 array indexing, 51 interpolated values, 45 for client applications, 49 name syntax, 50 interpreting data quality, 53 NaN values, 54 OPC standards and conventions, 49 out of range values, 54 PHD OPC name forms, 50 peer server, 40 supporting data types, 50 quality, 54 supporting enumerated data types, 51 shadow server, 40 understanding confidence versus quality, 54 Distributed COM Users group, 34 using extrapolated values, 55 document
Uniformance - PHD OPC Server User Guide 57
Index
about the sections, 9 document, about, 9 references, 9 enumerated data types supporting for client applications, 51 example PHD server setup, 40 extrapolated values, using, 55 HRESULT OPC standards and conventions, 49 indexing, array, 51 interpolation, defining, 45 Launch and Activation Permissions, 31 modifying configuration properties for COM components, 15 multiple PHD Servers, 40 configuring peer server, 40 configuring shadow server, 40 name forms for PHD OPC, 50 naming PHD Servers, 50 NaN values, using, 54 OPC standards and conventions for client applications, 49 HRESULT, 49 out of range values, using, 54 peer server, configuring in PHD, 40 typical system, 40
58 Uniformance - PHD OPC Server User Guide
PHD OPC name forms for client applications, 50 PHD OPC Server about the User Guide, 9 configuring using default installation, 1535 PHD security administering, 43 user rights, 44 using from PHD Server, 44 PHD Server configuring multiple, 40 naming conventions in TPS domain, 50 PHD servers example, 40 security change of user rights, 44 using PHD Server configuration, 44 setting up DCOM for default installation configuration, 15 shadow server, configuring in PHD, 40 standard OPC client application creating, 48 Uniformance client applications, 43 Uniformance PHD OPC HDA Server, 28 User Guide, about, 9 references, 9
Index
user rights,change, 44 using PHD OPC Server creating client applications, 48 data standards, 49