Ps7opc B en-US
Ps7opc B en-US
Preface 2
Basics 3
SIMATIC
Installation and licensing 4
Process control system PCS 7
OpenPCS 7 (V9.1) 5
PCS 7 Engineering
Plant configurations 6
Function Manual
OpenPCS 7 interface 7
Appendix A
02/2021
A5E50316936-AA
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent damage
to property. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices
referring only to property damage have no safety alert symbol. These notices shown below are graded according to
the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will be
used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property
damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended or
approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance
are required to ensure that the products operate safely and without any problems. The permissible ambient
conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication may
be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software described.
Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this
publication is reviewed regularly and any necessary corrections are included in subsequent editions.
1 Security information.............................................................................................................................. 7
2 Preface ................................................................................................................................................... 9
3 Basics ................................................................................................................................................... 13
3.1 General information........................................................................................................... 13
3.2 Microsoft basics ................................................................................................................. 15
3.3 OPC Foundation................................................................................................................. 17
3.4 Components of OpenPCS 7 ................................................................................................ 18
3.5 Security concept for OPC UA connections in PCS 7 .............................................................. 21
3.6 OLE DB interface ................................................................................................................ 22
3.7 COM / DCOM components of OpenPCS 7 ............................................................................ 23
4 Installation and licensing .................................................................................................................... 25
4.1 Hardware requirements ..................................................................................................... 25
4.2 Installing the OpenPCS 7 station ........................................................................................ 26
4.3 Licensing of the OpenPCS 7 station .................................................................................... 28
4.4 Licensing of the OS-internal OPC server.............................................................................. 29
5 PCS 7 Engineering................................................................................................................................ 31
5.1 Configuring an OpenPCS 7 station ...................................................................................... 31
5.2 OpenPCS 7 and OS application on a shared PC station ........................................................ 33
5.3 Configuring an OPC client................................................................................................... 34
5.4 Loading the OpenPCS 7 station .......................................................................................... 35
5.5 Configuration support with the PCS 7 project wizard........................................................... 36
6 Plant configurations............................................................................................................................. 37
6.1 General configuration ........................................................................................................ 37
6.2 OpenPCS 7 without OS....................................................................................................... 39
6.3 OpenPCS 7 combined with an OS ....................................................................................... 40
6.3.1 OpenPCS 7 combined with an OS client.............................................................................. 40
6.3.2 OpenPCS 7 combined with an OS server............................................................................. 41
6.3.3 OpenPCS 7 combined with an OS single station system ...................................................... 41
6.4 OpenPCS 7 station for multiple PCS 7 projects .................................................................... 43
6.5 Linking two PCS 7 projects using OpenPCS 7....................................................................... 45
6.6 Plant configuration with firewall ......................................................................................... 47
6.7 Setting the Windows firewall for OpenPCS 7 ....................................................................... 48
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 3
Table of contents
OpenPCS 7 (V9.1)
4 Function Manual, 02/2021, A5E50316936-AA
Table of contents
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 5
Table of contents
OpenPCS 7 (V9.1)
6 Function Manual, 02/2021, A5E50316936-AA
Security information 1
Siemens provides products and solutions with industrial security functions that support the
secure operation of plants, systems, machines, and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is necessary
to implement – and continuously maintain – a holistic, state-of-the-art industrial security
concept. Siemens’ products and solutions form one element of such a concept.
Customers are responsible for preventing unauthorized access to their plants, systems,
machines and networks. These systems, machines and components should only be connected
to the enterprise network or the Internet if and only to the extent necessary and with appropriate
security measures (firewalls and/or network segmentation) in place.
You can find more information on protective measures in the area of industrial security by
visiting:
https://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development to make them more secure.
Siemens strongly recommends performing product updates as soon as they are available and
using only the latest product versions. Use of product versions that are no longer supported, and
failure to apply latest updates may increase customer’s exposure to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS Feed
under
https://www.siemens.com/industrialsecurity.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 7
Security information
OpenPCS 7 (V9.1)
8 Function Manual, 02/2021, A5E50316936-AA
Preface 2
Purpose of this documentation
PCS 7 is an open system that allows access to process values, archived process values and
hardware interrupts by third-party applications. PCS 7 uses the following industry standards of
the OPC Foundation for this purpose:
• OPC Unified Architecture (DA, HA, A&C)
• OPC Data Access
• OPC Historical Data Access
• OPC Alarm and Events
PCS 7 also supports access by third-party applications using the WinCC OLE DB database
mechanism.
This documentation describes access to one or more PCS 7 OS servers using the OpenPCS 7
station. The information provided here will show you the configuration options with OpenPCS 7
and help you get started with the configuration of the OpenPCS 7 station in PCS 7.
To familiarize yourself in detail with the topics relating to the OPC interfaces, you will also require
the OPC-documentation from the OPC Foundation. You can find the documentation on the
Internet at: OPC Foundation (www.opcfoundation.org).
Conventions
In this documentation, the names of elements in the software interface are specified in the
language of this documentation. If you have installed a multi-language package for the
operating system, some of the designations will be displayed in the basic operating system
language even after you change the language and will, therefore, differ from the designations
used in the documentation.
You can find the Siemens SIMATIC programs in the "Start" menu under Siemens Automation.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 9
Preface
As of PCS 7 V9.1
• Adaptation of Windows operating system
• OPC UA - read only property
• PUD Manager
The "PUD Manager" an innovative tool to access documentation, comes with PCS 7 USB flash
drive. Some of the highlights:
– Create your own Manual Collection.
– Customize the documentation set according to your needs.
– Efficient search engine to access your information.
For more information on PUD Manager, refer Process Control System PCS 7; PUD Manager
V2.1 Online Help.
OpenPCS 7 (V9.1)
10 Function Manual, 02/2021, A5E50316936-AA
Preface
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 11
Preface
OpenPCS 7 (V9.1)
12 Function Manual, 02/2021, A5E50316936-AA
Basics 3
3.1 General information
Overview
Higher-level process control systems for production planning, process data evaluation, and
process data management can access SIMATIC PCS 7 process data via the OpenPCS 7 station. The
higher-level systems are OPC clients of the OpenPCS 7 station.
23&FOLHQWV 2SHQ3&6VWDWLRQ
3&626FOLHQWV
)URQW
)LUHZDOO
%DFN
)LUHZDOO
7HUPLQDOEXV
3&626VHUYHU
3ODQWEXV
)LHOGEXV
Depending on the system configuration, the OpenPCS 7 station can provide data from various
OS servers and from a Process Historian. The OpenPCS 7 station hides the distribution of the data
in terms of:
• Time period (OS1, OS2, …, Process Historian)
• Location (OS1, OS2, …, Process Historian) and
• Redundancy (OS1 master, OS1 standby …)
OpenPCS 7 replaces @PCS 7, previously available in the context of SIMATIC PCS 7 and is, at the
same time, the equivalent of the Connectivity Station and the Connectivity Pack of the WinCC
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 13
Basics
3.1 General information
SCADA system. Direct access to SIMATIC BATCH and SIMATIC Route Control data is not possible
with OpenPCS 7.
Layout
The OpenPCS 7 station can be operated in various configurations:
• OpenPCS 7 station without OS client, based on a SIMATIC PCS 7 Industrial Workstation in the
client version. This is the recommended preferred configuration.
• OpenPCS 7 station on an OS client.
• OpenPCS 7 station on an OS single station.
• OpenPCS 7 station on the OS server.
Note
The hardware and software requirements of the PC station on which the OpenPCS 7 station
is to be installed must be met.
OpenPCS 7 (V9.1)
14 Function Manual, 02/2021, A5E50316936-AA
Basics
3.2 Microsoft basics
Microsoft basics
The basis of OPC "Classic" is provided by several Microsoft technologies. These technologies are
explained in the following section.
OPC
OPC stands for "OLE for Process Control".
OPC is a standardized, vendor-independent software interface that allows data to be exchanged
between hardware and software. One system can provide another system with process data via
OPC .
OLE
OLE means "Object Linking and Embedding", the technology for embedding objects in
documents.
COM
COM means "Component Object Model" and is necessary for the use of OPC.
COM is a central component of Windows operating systems and controls the interaction
between multiple software components. By using COM , the OPCserver effectively becomes part
of the Windows operating system and is therefore not dependent on file names, storage
locations and versions.
COM defines a standard that allows objects to be defined as self-contained units in Windows and
to access these units beyond the limits of a process.
COMobjects can be understood as extensions of the operating system. They are not dependent
on programming languages and are available in principle to all applications.
The data and code of the object are not directly accessible to the user of the COMobject.
DCOM
DCOM is the acronym for "Distributed Component Object Model". It is based on COM technology
and provides the additional option of communicating over a network.
Object
Objects are defined by properties and methods that can be used on objects.
Events
An event is used to control program flow. Program execution is not linear, instead special event
handling routines are executed whenever a specific event occurs.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 15
Basics
3.2 Microsoft basics
In terms of OpenPCS 7 and the OPC standard, events mean messages/operation messages of the
PCS 7-system.
DLL
It is possible to use DLLs with Microsoft Visual Basic (VB) and Microsoft Visual Basic for
Applications (VBA). DLL stands for Dynamic Link Library. A DLL is a dynamic link library. Users can
link the functionalities of a DLL into their own applications. If you want to program an OPCclient
with VB, make sure that the relevant automation interface DLL is selected in the VB Editor in
"Project > References".
Collection
Collections are objects that support count and item properties. A collection consists of a certain
number of items. An item can be collection-specific, any data structure, or an object. The count
property specifies the number of items in a collection. In Microsoft Visual Basic, each item in a
collection can be identified using loops.
OpenPCS 7 (V9.1)
16 Function Manual, 02/2021, A5E50316936-AA
Basics
3.3 OPC Foundation
OPC Foundation
The aim of the OPC Foundation is to ensure compatibility between different subsystems in
automation and process control engineering. Compatibility is achieved by creating and
maintaining open specifications for the standardization of communication between subsystems
of different manufacturers. This allows process data, alarms and messages as well as archived
process data to be exchanged between subsystems regardless of their manufacturer.
The OPC Foundation has more than 300 members worldwide. These include the most important
manufacturers of control systems, process instrumentation and process control systems
worldwide. SIEMENS is a member of the OPC Foundation.
The declared goal of the OPC Foundation is vertical integration of information from the field level
through to the enterprise level. Using the OPC standard, this integration is possible regardless of
the system and manufacturer.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 17
Basics
3.4 Components of OpenPCS 7
Overview
OpenPCS 7 provides the following components:
• OPC Unified Architecture (OPC UA server for OpenPCS 7)
• OPC "Classic":
– OPC DA (Data Access server)
– OPC HDA (Historical Data Access server)
– OPC A&E (Alarms & Events server)
– OPC "H" A&E (Historical Alarms & Events server)
• OLE DB
Note
For security reasons, we recommend converting the applications to OPC Unified Architecture
(UA). The OPC UA server uses the TCP/IP protocol to exchange data. Certificates are exchanged
for authorization between OPC UA server and OPC UA client. You can encrypt or sign data traffic
in addition.
In the following graphic, you can see all the OPC components that will run on the OpenPCS 7
station. The figure also shows the PCS 7environment. OLE DB starts a direct database query on
the PCS 7 OS server.
OpenPCS 7 (V9.1)
18 Function Manual, 02/2021, A5E50316936-AA
Basics
3.4 Components of OpenPCS 7
2SHQ3&6VHUYHU
23&8$6HUYHU
23&'$6HUYHU
23&FOLHQW 23&+'$6HUYHU
23&$ (6HUYHU
23&+$ (6HUYHU
(QWHUSULVH
1HWZRUN
)URQW
)LUHZDOO
3&626FOLHQW
%DFN)LUHZDOO
7HUPLQDOEXV
3ODQWEXV
6 6
)LHOGEXV
(7 (7
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 19
Basics
3.4 Components of OpenPCS 7
OLE-DB
The WinCC OLE DB Provider allows standardized and direct access to the archive data in the
Microsoft SQL server database on the OS server.
This setup permits access to all OS archive data, along with the associated process values,
message texts, and user texts.
OpenPCS 7 (V9.1)
20 Function Manual, 02/2021, A5E50316936-AA
Basics
3.5 Security concept for OPC UA connections in PCS 7
Additional information
You can find information on the structure and configuration of plants with OPC UA connections
in the following sections:
• Section "Plant configuration with firewall (Page 47)"
• Section "OPC Unified Architecture (OPC UA) (Page 53)"
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 21
Basics
3.6 OLE DB interface
OLE DB
OLE DB is an open standard for fast access to different databases. The connection between the
OLE DB level and the database is established by a database provider.
The WinCC OLE DB Provider has been tested and approved for PCS 7. The WinCC OLE DB Provider
allows access to the process value and message archives.
You can find additional information about this in the section "Basics of OLE DB (Page 102)".
OpenPCS 7 (V9.1)
22 Function Manual, 02/2021, A5E50316936-AA
Basics
3.7 COM / DCOM components of OpenPCS 7
2SHQ3&66WDWLRQ
&OLHQW$SSOLFDWLRQ
,QWHUSURFHVV
&RPPXQLFDWLRQ
,Q3URFHVV
&20 /53& /53& 6WXE /RFDO2EMHFW
&RPSRQHQW
&URVVSURFHVV &20
,Q3URFHVV6HUYHU ZLWK/LJKWZHLJKW /RFDO6HUYHU
53&
23&&OLHQW 2SHQ3&66WDWLRQ
&OLHQW$SSOLFDWLRQ
,QWHUSURFHVV
&RPPXQLFDWLRQ
/RFDO 5HPRWH
2EMHFW 53& 53& 6WXE 2EMHFW
3UR[\
&20
&20 &URVVQHWZRUNZLWK 5HPRWH6HUYHU
WUXH53&
5HPRWH
2EMHFW
3UR[\
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 23
Basics
3.7 COM / DCOM components of OpenPCS 7
OpenPCS 7 (V9.1)
24 Function Manual, 02/2021, A5E50316936-AA
Installation and licensing 4
4.1 Hardware requirements
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 25
Installation and licensing
4.2 Installing the OpenPCS 7 station
Configuration Requirements for installa‐ Intended use of the software Program package in the PCS 7 Setup
tion for the installation
OpenPCS 7 sta‐ Installation requirements This serves as software for a sepa‐ • "OpenPCS 7" package
tion without OS for the SIMATIC PCS 7 Work‐ rate OpenPCS 7 station without OS
client station with an OS client client functionality.
configuration
OpenPCS 7 sta‐ Installation requirements This serves to expand an existing OS • "OpenPCS 7 with OS‑Client" pack‐
tion with OS cli‐ for the SIMATIC PCS 7 Work‐ client with the functionality of an age (corresponds to the software
ent station with an OS client OpenPCS 7 station. packages: "OpenPCS 7" + "OS‑Cli‐
configuration ent")
OpenPCS 7 sta‐ Installation requirements This serves to expand an existing OS • "OpenPCS 7" package
tion on the OS for the OS single station single station with the functionality • Package "OS Single Station"
single station of an OpenPCS 7 station.
OpenPCS 7 sta‐ Installation requirements This serves to expand an existing OS • "OpenPCS 7" package
tion on the OS for the OS server server with the functionality of an • Package "OS-Server"
server OpenPCS 7 station.
Note
If you only purchase the "OpenPCS 7 (OS-Client)" software package, you will only receive the
license for OpenPCS 7 . The required licenses for OS clients must be obtained additionally and
must be available on the computer at runtime.
Requirement
Message queuing must be installed.
Procedure
An example procedure for the standalone variant is explained below:
1. Insert the "SIMATIC Process Control System; PCS 7" USB flash drive in the USB port.
2. Run the "SETUP.exe" installation program.
3. Select the setup language and click "Next".
4. Close all programs and click "Next".
5. Read the product instructions and click "Next".
6. Accept the license conditions and click "Next".
7. Select the setup type "Install" and click "Next".
8. Enter the user information and click "Next".
9. Select the package installation and click "Next".
OpenPCS 7 (V9.1)
26 Function Manual, 02/2021, A5E50316936-AA
Installation and licensing
4.2 Installing the OpenPCS 7 station
Note
Uninstalling PCS 7 software via the system setup is not supported.
The uninstallation of single software components via the Windows control panel is not
recommended.
Additional information
• You can find additional information about installation requirements in the system
documentation Process Control System PCS 7; PCS 7 - PC Configuration.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 27
Installation and licensing
4.3 Licensing of the OpenPCS 7 station
General
Two licenses are available for OpenPCS 7. The licenses for the OpenPCS 7 station are license keys
that must be transferred directly to the machine on which the OpenPCS 7 station runs using the
Automation License Manager. A license is required for each OpenPCS 7 station. The licenses for
the OpenPCS 7 station are single licenses. This means that a license server cannot be used for
OpenPCS 7.
Note
PCS 7data can be accessed via OpenPCS 7 under the following conditions as regards license keys:
• The OpenPCS 7 station / OS require a license for a PCS 7 OS. This is applicable for all
configurations of the OpenPCS 7 station.
• If you use the "OpenPCS 7 Station / OS" license key, the PCS 7 OS must be in process mode.
• If you use the "OpenPCS 7 station" license key, you can always access PCS 7data via OpenPCS
7.
• Access to the corresponding PCS 7data is only ensured when a license is available.
License Description
OpenPCS 7 station / OS License for the software to expand an existing operator station with the
OpenPCS 7 station functionality.
This is a single license for one installation.
OpenPCS 7 station License for one OpenPCS 7 software installation for a separate OpenPCS 7
station based on the hardware of the SIMATIC PCS 7 workstation (client
version).
This is a single license for one installation.
OpenPCS 7 (V9.1)
28 Function Manual, 02/2021, A5E50316936-AA
Installation and licensing
4.4 Licensing of the OS-internal OPC server
Licensing
The PCS 7 OS provides the following internal OPC servers on an OS server or an OS single station:
• SOPCSRVRWinCC.exe for OPC DA
• SOPCAESRVRWinCC.exe for OPC A&E
• SOPCHDASRVRWinCC.exe for OPC HDA
• OPCUASERVERWinCC.exe for OPC UA
These internal OPC servers can be used with OpenPCS 7-licenses. This is only possible if the
"OpenPCS 7 station / OS" or "OpenPCS 7 station" license is available on the OS station.
Note
If the internal OPC servers of an OS station are used, this represents additional load in terms of
the OS station's performance.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 29
Installation and licensing
4.4 Licensing of the OS-internal OPC server
OpenPCS 7 (V9.1)
30 Function Manual, 02/2021, A5E50316936-AA
PCS 7 Engineering 5
5.1 Configuring an OpenPCS 7 station
Introduction
The OpenPCS 7 station is configured as a SIMATIC PC station in the SIMATIC Manager. It includes
the "SPOSA application" object. SPOSA is the acronym for Single Point Of System Access. The OPC
client application can also be executed on the OpenPCS 7 station. During configuration, the
following steps need to be taken:
• Insertion of a SIMATIC PC station
• Insert and configure the SPOSA application in the hardware configuration of the SIMATIC PC
station
If you created the multiproject with the PCS 7wizard, you will already have inserted an
OpenPCS 7 station if you selected the appropriate option. You can also insert an OpenPCS 7
station by expanding the project later with the "Expand Project" PCS 7wizard. The steps required
to create an OpenPCS 7 station manually are explained in the following section.
Requirement
The PCS 7 project is open. You have created the OS servers and generated the server packages.
Procedure
1. Select the project into which you want to insert the OpenPCS 7 station, in the component
view of the SIMATIC Manager.
2. Select the menu command "Insert > Station > SIMATIC PC Station".
A new SIMATIC PC station is inserted into the selected project.
3. Select the SIMATIC PC station, select the menu command "Edit > Object Properties" and
enter the desired name for the PC station and the computer name.
4. Select the SIMATIC PC station in the component view and open the hardware configuration
by double-clicking on the "Configuration" object in the detailed view.
The SIMATIC PC station hardware configuration opens.
5. If the hardware catalog is not visible, select the menu command "View > Catalog".
6. Select the SPOSA application from "SIMATIC PC Station > HMI" in the hardware catalog and
drag it to the configuration table.
7. Save and compile the hardware configuration using the menu command "Station > Save and
Compile"
8. Expand the newly created PC station and the SPOSA application in the SIMATIC Manager.
9. Open the object properties of the "OpenPCS7_Station(1)" object and enter the download
path to the OpenPCS 7 station in the "PLC" tab.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 31
PCS 7 Engineering
5.1 Configuring an OpenPCS 7 station
OpenPCS 7 (V9.1)
32 Function Manual, 02/2021, A5E50316936-AA
PCS 7 Engineering
5.2 OpenPCS 7 and OS application on a shared PC station
Configuration
In the hardware configuration of the PC station, you configure a "SPOSA application" and a
"WinCC application client". Configuration of an "WinCC application" is possible as well.
• You specify the path to the target system of the OpenPCS 7-computer in the object properties
of the "SPOSA application".
• You configure the path to the target OS computer in the object properties of the "OS client
application".
Note
In a PCS 7-version lower than V7.1, a SPOSA application and an OS client cannot be configured
on the same SIMATIC PC station. In a PCS 7-version lower than V7.1, two PC stations with the
same computer name but with different PC station names must be configured.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 33
PCS 7 Engineering
5.3 Configuring an OPC client
Note
If you want to use the SIEMENS OPC Automation Interfaces, either the OPC client must be
executed on the OpenPCS 7 station or you will have to take manual steps to ensure that the
required files exist and are registered on the OPC client.
Note
If you want to use an OPC client for OPC "Classic" on a PC without an OpenPCS 7-installation, you
need to install the OPC proxy/stub components of the OPC Foundation. You can install these with
the "OPC Core Components 3.00 Redistributable" setup of the OPC Foundation. In this case, you
should also check the installation instructions of the OPC client vendor.
Additional information
• You can find more information about PCS 7 security concepts in the manual Security
Concept PCS 7.
OpenPCS 7 (V9.1)
34 Function Manual, 02/2021, A5E50316936-AA
PCS 7 Engineering
5.4 Loading the OpenPCS 7 station
Requirements
• The following components are installed on the PC station:
– Operating system
– OpenPCS 7 station software
• The terminal bus is configured on the OpenPCS 7 station.
• The OpenPCS 7 station is connected to the engineering station via the terminal bus.
• The protocol for the communication on the terminal bus is set to TCP/IP.
• The OpenPCS 7 station is configured in the PCS 7 project.
• The user logged in on the ES can access the shared Windows folder.
Default setting: "\\<OpenPCS 7 Station>\Automation"
• The PCS 7multiproject is open on the ES.
Procedure
1. Expand the PC station of the OpenPCS 7 station.
2. Expand the SPOSA application.
3. Right-click on the object below the SPOSA application.
4. Select " CPU > Download".
5. If no project has yet been loaded on the OpenPCS 7 station, the configuration is applied.
Configuration changes only take effect after a restart of the OpenPCS 7 station.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 35
PCS 7 Engineering
5.5 Configuration support with the PCS 7 project wizard
Requirement
You have an engineering station with at least a PCS 7 V8.0 installation.
Example
1. Open SIMATIC Manager.
2. Start the PCS 7 project wizard in the SIMATIC manager using the " File > ' New Project' Wizard"
menu.
3. Click the "Next" button in the "Introduction" dialog.
4. Select the required CPU in the "Which CPU are you using in your project?" dialog and then click
the "Next" button.
5. Click the " Preview >>>" button.
6. Select the "OpenPCS 7" option in the "Which objects are you still using?" dialog.
7. Click "Next".
8. Enter a directory name in the "Directory name" box in the "Where do you want to store the
multiproject?" dialog.
9. Click the "Browse" button and set the path for the storage location.
10.Click the "Finish" button.
11.Click "OK" in the "Message Number Assignment" dialog.
12.Insert a new PC station in your project.
13.Enter the computer name in the object properties of the PC station.
14.Open the hardware configuration and insert an OS application.
15.Compile the OS.
16.In the shortcut menu of the OpenPCS 7 station, select the menu command Assign OS
Server... .
17.In the dialog window "Assignment OS server for...", select the check box for OS server from
which the OpenPCS 7 requires station data.
18.Click "OK".
19.Following this, you will need to complete the project with the AS and OS engineering and
download the project.
OpenPCS 7 (V9.1)
36 Function Manual, 02/2021, A5E50316936-AA
Plant configurations 6
6.1 General configuration
Note
The OPC UA server provides READ and WRITE access to all variables from all PCS7 OS that are
connected to the OpenPCS 7 Station.
The following data of the archive server can be provided to the OpenPCS 7 station:
• Process value archives via OPC UA or OPC HDA
• Message archives via OPC "H" A&E
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 37
Plant configurations
6.1 General configuration
23&FOLHQWV 2SHQ3&6VWDWLRQ
3&626FOLHQWV )URQW
)LUHZDOO
%DFN
)LUHZDOO
7HUPLQDOEXV
5RXWH&RQWURO
3&626VHUYHU VHUYHU %$7&+VHUYHU $UFKLYHVHUYHU
3ODQWEXV
)LHOGEXV
OpenPCS 7 (V9.1)
38 Function Manual, 02/2021, A5E50316936-AA
Plant configurations
6.2 OpenPCS 7 without OS
23&FOLHQWV 2SHQ3&6VWDWLRQ
3&626FOLHQWV )URQW
)LUHZDOO
%DFN
)LUHZDOO
7HUPLQDOEXV
5RXWH&RQWURO
3&626VHUYHU VHUYHU %$7&+VHUYHU $UFKLYHVHUYHU
3ODQWEXV
)LHOGEXV
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 39
Plant configurations
6.3 OpenPCS 7 combined with an OS
3&626FOLHQWV
3&626FOLHQW
2SHQ3&6VWDWLRQ
23&FOLHQW
7HUPLQDOEXV
5RXWH&RQWURO
3&626VHUYHU VHUYHU %$7&+VHUYHU $UFKLYHVHUYHU
3ODQWEXV
)LHOGEXV
The OPC client can also run on a separate computer. This configuration is intended for small to
medium-sized plants.
3&626FOLHQW
3&626FOLHQWV 23&FOLHQW 2SHQ3&6VWDWLRQ
7HUPLQDOEXV
5RXWH&RQWURO
3&626VHUYHU %$7&+VHUYHU $UFKLYHVHUYHU
VHUYHU
3ODQWEXV
)LHOGEXV
OpenPCS 7 (V9.1)
40 Function Manual, 02/2021, A5E50316936-AA
Plant configurations
6.3 OpenPCS 7 combined with an OS
OpenPCS 7 on a server
In this configuration, the OpenPCS 7 station is also installed on an OS server. The OpenPCS 7
station provides data of one or more OS servers to OPC clients.
Note
Note that the OpenPCS 7 station affects the performance of the OS server. For large PCS 7 plants,
we recommend the use of a separate OpenPCS 7 station.
7HUPLQDOEXV
3ODQWEXV
)LHOGEXV
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 41
Plant configurations
6.3 OpenPCS 7 combined with an OS
26VLQJOHVWDWLRQV\VWHP 26PXOWLXVHUV\VWHP
26VLQJOHVWDWLRQ
ZLWKSDUDOOHO
2SHQ3&6VWDWLRQ
7HUPLQDOEXV
3&626VHUYHU 3&626VHUYHU
3ODQWEXV
)LHOGEXV
Note
An OS single-station system cannot be assigned to an OpenPCS 7 station. When OpenPCS 7 is
used, it is not possible to provide data of the OS single station system to an OPC client.
OpenPCS 7 (V9.1)
42 Function Manual, 02/2021, A5E50316936-AA
Plant configurations
6.4 OpenPCS 7 station for multiple PCS 7 projects
Example configuration
In this example configuration, an OpenPCS 7 station is used to make OS server data from two
PCS 7 projects available. Multiple OS servers can also be used per PCS 7 project.
(QWHUSULVHQHWZRUN
)LUHZDOO
23&FOLHQW
)LUHZDOO )LUHZDOO
7HUPLQDOEXV 7HUPLQDOEXV
3&626VHUYHU 3&626VHUYHU
3ODQWEXV 3ODQWEXV
6 6
)LHOGEXV )LHOGEXV
(7 (7
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 43
Plant configurations
6.4 OpenPCS 7 station for multiple PCS 7 projects
This example configuration has been released for identical PCS 7 versions in the PCS 7projects
A and B.
Note
Hybrid configurations with regard to PCS 7 versions are disabled.
Configuration
A SIMATIC PCS 7 station with a SPOSA application is configured in every PCS 7 project. The SPOSA
application is assigned to the OS server of the relevant PCS 7 project. The identical path to the
target system is configured and downloaded in both SPOSA applications.
OpenPCS 7 (V9.1)
44 Function Manual, 02/2021, A5E50316936-AA
Plant configurations
6.5 Linking two PCS 7 projects using OpenPCS 7
3&6SURMHFW$ 3&6SURMHFW%
3&626FOLHQW 2SHQ3&6VWDWLRQ
3&626FOLHQW
23&OLQN
)LUHZDOO )LUHZDOO
7HUPLQDOEXV
3ODQWEXV
6 6
)LHOGEXV
(7 (7
Application 1:
There are two PCS 7 projects, Project A and Project B, in a plant network. For technical reasons,
Project A needs to visualize data of Project B. The OPC channel of the PCS‑7 OS can be used for
this purpose.
Application 2:
If PCS 7 Project A and PCS 7 Project B use different PCS 7 versions, but support the same OPC
version. The OPC channel of the PCS 7 OS can be used for this purpose.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 45
Plant configurations
6.5 Linking two PCS 7 projects using OpenPCS 7
Application 3:
This configuration can also be used if Project B is a third-party product that provides an OPC
server and not a PCS 7 project. This requires that both projects support the same OPC standard.
Note
The OPC channel can only be used for OPC DA.
OpenPCS 7 (V9.1)
46 Function Manual, 02/2021, A5E50316936-AA
Plant configurations
6.6 Plant configuration with firewall
7HUPLQDOEXV
3&626VHUYHU
)LUHZDOO )LUHZDOO
3ODQWEXV
6
)LHOGEXV
(7
Additional information
• Security concept of OPC UA: Section "OPC Unified Architecture (OPC UA) (Page 53)"
• You can learn about the PCS 7 security concept in the PCS 7 Security concept manual
• Documentation Process Control System PCS 7; PCS 7 - PC Configuration
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 47
Plant configurations
6.7 Setting the Windows firewall for OpenPCS 7
Setting location
The settings must be configured in the Inbound rules in the "Windows Firewall with Advanced
Security" dialog.
OpenPCS 7 (V9.1)
48 Function Manual, 02/2021, A5E50316936-AA
Plant configurations
6.7 Setting the Windows firewall for OpenPCS 7
7. Recommendation:
– In the "Scope" step, select the option "These IP addresses" as the setting for the list "Which
local IP addresses does this rule apply to?".
– In the list, insert the IP addresses of the OpenPCS 7 station.
8. In the following steps, select any necessary plant-specific settings.
9. Enter a name for the profile in the input box in the "Name" step.
10.Click "Finish".
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 49
Plant configurations
6.8 Users and passwords in a workgroup
Example
If the user with the user name "User1" and the password "xyz" is logged on to the OpenPCS 7
station, an identical user must be created on the OPC client. If the user with the user name
"User2" and the password "abc" is logged on to the OPC client, an identical user must be created
on the OpenPCS 7 station.
0LFURVRIWZRUNJURXS
2SHQ3&6VWDWLRQ 23&FOLHQW
/RJLQ3DVVZRUG
/RJLQ3DVVZRUG
3&626FOLHQWV
)LUHZDOO )LUHZDOO
7HUPLQDOEXV
3&626VHUYHU
3ODQWEXV
6 6
)LHOGEXV
(7 (7
OpenPCS 7 (V9.1)
50 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface 7
7.1 Access options
Access options
The following table lists the access options via OPC to the following PC stations in PCS 7:
• PCS 7 OS server
• Maintenance Station
• Process Historian
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 51
OpenPCS 7 interface
7.2 Data transmission
Type of data transfer of OPC DA, OPC HDA and OPC A&E
This section explains the various types of data transfer with OPC "Classic".
Note
You can find the available asynchronous and synchronous read and write methods in the
following sections:
• OPC Data Access (OPC DA) - (SIEMENS OPC DA Automation Interface 2.0)
• OPC Historical Data Access (OPC HDA) - (SIEMENS OPC HDA Automation Interface 1.0)
• OPC Alarms and Events (OPC A&E) - (SIEMENS OPC A&E Automation Interface 1.0)
OpenPCS 7 (V9.1)
52 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Overview
You can find information about the following topics in the sections below:
• How the OPC UA server works (Page 54)
• Configuring the OPC UA server (Page 55)
• Security concept (Page 56)
• Supported OPC UA services and profiles (Page 58)
• Namespace of the OPC UA server (Page 59)
• OPC UA Data Access (Page 62)
• OPC UA Log Access (Page 63)
• OPC UA alarm & conditions (Page 64)
• Mapping the WinCC message system to OPC UA (Page 65)
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 53
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Operating principle
The OPC UA server for OpenPCS 7 provides the following data:
• Process values
• Values from measured value archives
• OS messages
Supported specifications
The OPC UA server supports the OPC UA specification 1.02.
You can find more information on UA functionality in the section "Supported OPC UA services
and profiles (Page 58)".
Installation
The OPC UA server is installed with OpenPCS 7 as a Windows service. The service is automatically
started when the computer is booted. The OPC UA server can only be used when the OpenPCS
7 station has been configured and loaded.
Configuration/accessibility
The OPC UA server is pre-configured during installation.
OPC UA server only supports the OPC UA binary protocol ("UA-TCP UA-SC UA binary"
communication profile) for the communication. The port number used can be configured.
You can find more information on this subject in the following sections:
• Section "Configuring the OPC UA server (Page 55)"
• Section "Supported OPC UA services and profiles (Page 58)"
Discovery Server
The "Discovery Server" is provided by the OPC Foundation. With the installation of OpenPCS 7,
the "Discovery Server" is installed by default as Windows service. The "Discovery Server" provides
OPC UA clients with information about OPC UA servers that are registered on the "Discovery
Server".
The OPC UA server for OpenPCS 7 registers itself at startup depending on its configuration with
no, one or multiple configured and available "Discovery Servers". Registration is repeated
cyclically.
Default setting: Registration on local Discovery Server
OpenPCS 7 (V9.1)
54 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
NOTICE
Changing the server configuration
Changing the server configuration incorrectly could cause malfunctions or security gaps! The
server configuration should therefore be performed only by qualified personnel.
Note
Applying a change to the server configuration
Changes to the server configuration do not become active until the OPC UA server is restarted.
Parameter Description
HostName Placeholder for the computer name. Used automatically.
Port TCP/IP - Port number
Do not use a port number that is already used by another application. Default
setting: 4863
Example for the setting in the configuration file of the OPC UA server:
<BaseAddresses>
<ua:String>opc.tcp://[HostName]:4863</ua:String>
<BaseAddresses>
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 55
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Server certificate
The server certificate (ApplicationCertificate) and its private key are stored in the certificate store
during the installation.
Default:
• Stores of the certificates used: [ApplicationPath]\PKI\CA\certs
• Stores of the private keys: [ApplicationPath]\PKI\CA\private
The private key folder of OPC UA Server is protected with restrictive access rights, and it can only
be accessed by OPC UA Server, which is the default setting. The administrators group can provide
READ/WRITE access to the administrator if changes are required in the private key folder, as the
administrators group is the owner of this folder.
OpenPCS 7 (V9.1)
56 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
User identity
The OPC UA server supports the authentication of the user of client applications.
In the OPC UA server configuration file, you can make the settings for authenticating users below
the "ServerConfiguration":
UserTokenPolicy "UserName".
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 57
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
OPC UA services
The following table summarizes the functionality supported by the OPC UA server:
OpenPCS 7 (V9.1)
58 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
The OPC UA server supports the OPC UA profiles shown in the following table with restrictions:
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 59
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
OpenPCS 7 (V9.1)
60 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
The following table shows the most important attributes of the OPC UA tags that represent an
OS tag. You can find the complete list of attributes in the "OPC UA Part 3 - Address Space Model
1.02 Specification" document under "§5.6":
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 61
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Access to OS messages
OPC UA clients can receive OS messages if you register the following node with the
"EventNotifier" attribute in a subscription:
• The start node of the OpenPCS 7 namespace ("OpenPCS7") allows you to receive the
messages from all the configured operator stations of PCS 7.
• Each node of a PCS 7 operator station allows you to receive the messages of this PCS 7
operator station.
OpenPCS 7 (V9.1)
62 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Note
Modification of archived data is not desired in a process control system. Therefore, only read
access to archived data is enabled for OPC UA in PCS 7.
You can read the values of archive tags in tag archives with an OPC UA client. Depending on the
configuration of the tag archive, the archive tag can contain either raw data or process values
already processed by the OS.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 63
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Acknowledgment
The "Acknowledge" method of the default OPC UA type "AcknowledgeableConditionType" is
used to acknowledge a message.
Only messages of the "WinCCAlarmConditionType" can be acknowledged.
ConditionRefresh
The "ConditionRefresh" method of the default OPC UA type "ConditionType" is used to detect
pending messages.
Additional information
For more information, refer to the OPC UA Specification, "Part 9: Alarms & Conditions".
7.3.8.2 Filters
The OPC UA client can define a filter for monitored event items.
The following operators are not supported by the OPC UA server:
• FilterOperator_Cast
• FilterOperator_BitwiseAnd
• FilterOperator_BitwiseOr
• FilterOperator_RelatedTo
• FilterOperator_InView
OpenPCS 7 (V9.1)
64 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
The event types add WinCC-specific message attributes to the basic type. These message
attributes are mapped 1:1 as UA properties and are described in more detail below.
The OPC UA server can pass WinCC event notifications to OPC UA clients (about subscriptions and
monitored event items), but does not have condition instances in its namespace.
Overview
The following table contains the attributes of the OS message system that are relevant and
configurable for OPC. These attributes are mapped 1:1 as UA Event Properties .
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 65
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
7.3.9.4 Priority
When configuring alarms in the message system, you can configure a priority from "0" to "16".
The OPC UA specification defines a value range of "1" to "1000" for the severity. "1" stands for the
lowest and "1000" for the highest severity.
For this reason, the values of the priority are mapped according to the OPC severity. In the
standard mapping, priority "0" is assigned to OPC severity "1" and priority "16" to OPC severity
"1000". All other priority values are obtained by linear interpolation between "0" and "1000".
OpenPCS 7 (V9.1)
66 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Attributes/properties of events
The following table shows the most important attributes/properties of an event and how the
WinCC message system provides the information:
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 67
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
Note
The following OPC UA condition or alarm properties are not supported by the OPC UA
server:
• BranchId
• LastSeverity
• InputNode
• ConfirmedState
• SuppressedState
• ShelvingState
• SuppressedOrShelved
• MaxTimeShelved
OpenPCS 7 (V9.1)
68 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.3 OPC Unified Architecture (OPC UA)
• If the OPC A&E server operates without hierarchical access, the following mapping also
applies to OPC UA:
SourceName Indicates the source of a message. The Source has the format "<Server pre‐
fix>::localhost::". The server prefix of a local computer is "@LOCALMACHINE".
Message Displays the message text of the corresponding message number.
Additional information
You can find information on this in the section "OPC A&E with hierarchical access (Page 88)".
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 69
OpenPCS 7 interface
7.4 OPC Data Access (OPC DA)
Overview
You can find information about the following topics in the section below:
• Introduction to the OPC Data Access interface (Page 70)
• How the OPC DA server works (Page 71)
Introduction
The data access interface is a vendor-independent worldwide standard for reading, writing and
monitoring process data. Communication is based on the Microsoft COM protocol. This standard
has gained acceptance both with users and manufacturers. The user programs, for example,
range from office applications to sophisticated HMI (Human Machine Interface) or SCADA
(Supervisory Control and Data Acquisition) systems.
OPC DA client
Data access clients can, for example, be Excel tables in conjunction with Visual Basic for
Applications (VBA). They may also be extensive applications created with Visual Basic or Visual
C++.
OPC DA server
Basically an OPC DA server makes process data available to an OPC DA client for read and write
access.
OPC DA servers can be programs that, for example, allow access to an automation system via a
serial interface. More complex programs are possible that provide access to large numbers of
tags on numerous devices using extensive communications mechanisms. This is the case with
OpenPCS 7.
OpenPCS 7 (V9.1)
70 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.4 OPC Data Access (OPC DA)
Requirement
To be able to set up successful OPC communication, the following requirements must be met:
• The PCS 7 OS project and the OPC DA server must be loaded and started.
• The computer of the OPC DA server can be reached by the OPC DA client via its IP address.
Note
In your PCS 7 OS project, variables can be grouped together in variable groups to provide
structuring. The variables must not have the same name as a variable group.
Operating principle
The OPC DA server supports OPC data access with the following specifications:
• 1.0a
• 2.0.
• 3.0.
The OPC DA server is a DCOM application. Using this software interface, the OPC DA server
provides the OPC DA client with the necessary information about PCS 7 OS tags. The OPC DA
server becomes active when it is accessed by the OPC DA client over a connection to the OPC DA
server.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 71
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Overview
You can find information about the following topics in the sections below:
• How the OPC HDA server works (Page 72)
• Data structure of the OPC HDA server (Page 73)
• Overview of supported attributes (Page 74)
• Overview of supported aggregates (Page 74)
• Overview of supported functions (Page 75)
• Time format of the OPC HDA server (Page 76)
• Quality codes of the OPC HDA server (Page 78)
• Write access supported by the OPC HDA server (Page 78)
The following sections show the data structure and the attributes, aggregates and functions
supported by the OPC HDA server. This is not a detailed description but rather an overview.
Detailed information is available in the "OPC Historical Data Access Specification" of the OPC
Foundation.
Operating principle
Using OPC HDA, it is possible to access archived data from the PCS 7servers. The OPC HDA server
is a DCOM application that provides the OPC HDA client with the required data from the PCS 7
OS archive system. Data is accessed via item handles. Only read access to archived data is
approved for PCS 7. The data can also be analyzed.
The OPC HDA server supports the OPC Historical Data Access 1.20 specification. This was
confirmed by the compliance test. All OPC HDA clients complying with the OPC Historical Data
Access 1.20 specification can access the OPC HDA server. The use of individually programmed
OPC HDA clients is the best way to meet the requirements.
OpenPCS 7 (V9.1)
72 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Rules
If you request historical values with the OPC HDA client, remember the following during
configuration:
• Select the cycle for a query so that the client has received the requested data before the next
query starts. If the cycles are too short, the result can be a large time offset when receiving
the data.
• The CPU load of the PCS 7 OS server depends on the number of variables per query.
Data structure
The data of the OPC HDA server is structured. The following table describes the data structure.
Element Description
Raw Data The raw data is the data transferred from the PCS 7 OS archive system for a
specified period. This data has a time stamp and a quality.
Attribute Return additional quality characteristics of the raw data. Attributes include
data type, information on archiving. Additional information is available in the
section "Overview of the supported attributes".
Aggregate Return a single value based on the raw data of a particular period. Aggregate
functions include average value, minimum and maximum. Additional infor‐
mation is available in the section "Overview of the supported aggregate func‐
tions".
StartTime/EndTime Specify the start and end time for the period.
Bounding Values Bounding values are the values recorded at the start and end time. If these do
not exist, the values closest to the time are used as the bounding values.
Item Handle The item handle is a unique assignment to a PCS 7 OS archive tag.
ItemID The ItemID is the unique identification of the PCS 7 OS archive tag. An item
handle can be fetched using the ItemID.
Additional information
• Additional information on the data structure of the OPC HDA is available in the
specification OPC Historical Data Access Specification V1.2 of the OPC Foundation.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 73
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Supported attributes
The following table lists the attributes supported by the OPC HDA server. You can find additional
information in the "OPC Historical Data Access Specification 1.20" of the OPC Foundation.
OpenPCS 7 (V9.1)
74 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Introduction
The following tables list the functions supported by the OPC HDA server. These functions can be
used by the OPC HDA client for data exchange. You can find additional information in the "OPC
Historical Data Access Specification 1.20" of the OPC Foundation.
Function Description
ReadRaw Specifies the raw data, its quality and its time stamp for the specified period.
ReadProcessed Returns the calculated value, the quality of the value and the time stamp for
the specified period. The calculated value depends on the selected aggre‐
gate.
ReadAtTime Specifies the raw data, its quality and its time stamp for a specific point in
time. If no value exists, it is interpolated for this point in time.
ReadAttribute Returns the attributes of the item and the time stamp for the specified period.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 75
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Time format
YYYY/MM/DD hh:mm:ss.msmsms
Parameter
YYYY = year
MM = month
DD = day
hh = hour
mm = minute
ss = second
ms = millisecond
Example of an entry
2011/08/10 09:27:30.000
Time format
Keyword +/-offset1 +/-offset(n)
The offset is the deviation from local time of the OPC HDA server.
OpenPCS 7 (V9.1)
76 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Keyword
NOW = current local time of the server
SECOND = current second
MINUTE = current minute
HOUR = current hour
DAY = current day
WEEK = current week
MONTH = current month (0-11)
YEAR = current year
Offset
+/-S = deviation in seconds
+/-M = deviation in minutes
+/-H = deviation in hours
+/-D = deviation in days
+/-W = deviation in weeks
+/-MO = deviation in months
+/-Y = deviation in years
Example
DAY - 1D = previous day
DAY-1D + 7H30 = previous day at 7:30 a.m.
MO-1D+5H = last day of the previous month at 5.00 a.m.
NOW-1H15M = 1 hour and 15 minutes ago
YEAR+3MO= April of this year
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 77
OpenPCS 7 interface
7.5 OPC Historical Data Access (OPC HDA)
Quality codes
The quality code is required to check the status and quality of the raw data. The following table
shows the quality codes of OPC HDA.
You can find additional information in the "OPC Historical Data Access Specification 1.20" of the
OPC Foundation.
Introduction
The OPC HDA specification of the OPC Foundation also defines write access to archived data.
Note
PCS 7 is a process control system. In a process control system, archived data must not be
modified. For this reason, write access to archived data using OPC HDA has not been enabled.
OpenPCS 7 (V9.1)
78 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Overview
You can find information on the following topics in the sections below:
• Introduction to OPC A&E (Page 79)
• Mapping the PCS 7 OS message system on OPC A&E (Page 81)
• Mapping the message classes and message types of PCS 7 OS on OPC A&E (Page 83)
• Mapping priorities of PCS 7 OS messages on OPC A&E (Page 83)
• Attributes of the PCS 7 OS message system (Page 83)
• Acknowledgment scheme (Page 85)
• Quality codes for OPC A&E (Page 87)
• OPC A&E with hierarchical access (Page 88)
• Upgrading OPC A&E (Page 94)
Note
You can find general information on these topics in the sections. Detailed information is
available in the "OPC Alarms and Events Custom Interface Standard V1.0" and "OPC Alarm and
Events Automation Interface Standard V1.01" specifications of the OPC Foundation.
Supported events
The OPC A&E server supports the following events:
• Condition-related event
• Simple event
• Tracking event
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 79
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Condition-related events
With a condition-related event server, the event is associated with a condition. A condition may
be the limit violation of a tag. On the PCS 7 OS, a message will be generated as soon as a limit
violation occurs. This message is shown as an alarm in OPC A&E.
Simple event
Simple events are messages that inform the OPC A&E client about events. Simple events include,
for example, the launching and closing of programs.
Note
Note the following when using redundant PCS 7 OS servers:
Simple events that are linked to internal tags are sent twice when comparing tags. The first
message is triggered by the OS master server, the second by the OS standby server.
Tracking event
If a change is made in the process control system, the OPC A&E client will receive a message. A
change can, for example, be a change to a control parameter in the faceplate of the controller
or the suppression of messages in the message system.
Note
When filtering for all alarms of a plant section, make sure that you replace the source with a
wildcard in the filter text, because the source is only generated in runtime for a tracking event.
For example, the filter text for all events from the "Plant1\Unit1\Tank1" area is "Server
prefix::*Plant1\Unit1\Tank1*" and not "Server prefix::Plant1\Plant1\Unit1\Tank1*".
OpenPCS 7 (V9.1)
80 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Additional information
• For additional information about "OPC - OLE for Open Connectivity" refer to the WinCC
Information System.
• Additional information about the OPC A&E can be found in the specification OPC Alarms &
Events 1.10.
Introduction
In PCS 7, program functionality in the automation system is configured using messaging capable
CFCblocks from the PCS 7library. After compiling the PCS 7 OS, the configuration messages exist
in the PCS 7 OS message system. These messages are mapped to the OPC A&E standard by the
OpenPCS 7 station implementation. The OS configuration defines which event in the process
triggers a message.
Overview
The OPC attribute class OPCEvent is used in OPC A&E to display events. The following table
shows selected OPC attributes and their meaning in the OS message system.
The events that use the configured attributes are shown in the third column of the table:
• "S" means a simple event
• "C" means a condition-related event
• "T" means a tracking event
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 81
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Note
The message classes and message types must be configured identically on the connected OS
servers if you operate the OPC A&E server as follows:
• On an OS client
• on a WinCCconnectivity station
• within the scope of OpenPCS 7
If the OS server is not configured identically, the OPC client that is used must access the
respective OS server directly.
OpenPCS 7 (V9.1)
82 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
7.6.3 Mapping the message classes and message types of PCS 7 OS on OPC A&E
Event category
Each combination of message class and message type is mapped to an event category on the
OPC A&E server. An event category is identified by a CategoryID and a category description.
The CategoryID is made up of the internal PCS 7 OS ID of the message class and message type.
The category description is made up of the name of the message class and message type.
The names of the message classes and message types can be obtained explicitly using the alarm
attributes CLASSNAME and TYPENAME.
Mapping priorities
The priority of messages is mapped by the OPC A&E server to the "Severity" attribute. When
configuring alarms in the message system, you can configure a priority from "0" to "16". The OPC
A&E specification defines a range of values from "1" to "1000" for the severity. "1" stands for the
lowest and "1000" for the highest severity. For this reason, the values of the priority are mapped
according to the OPC severity. In the standard mapping, priority "0" is assigned to OPC severity
"1" and priority "16" to OPC severity "1000". All other priority values are obtained by linear
interpolation between "0" and "1000".
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 83
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
OpenPCS 7 (V9.1)
84 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
ChangeMask
The "ChangeMask" parameter keeps track of where the message status was changed.
NewState
The "NewState" parameter indicates the message status after a change.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 85
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
● OPC_CONDITION_ACKED
OpenPCS 7 (V9.1)
86 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Note
Historical alarms and events are not acknowledged. The OPC A&E historical events interface has
read access only.
The following table shows the mapping of the "ChangeMask" and "New State" parameters to the
properties of the OPCEvent class of the "OPCSiemensAlarmEventAutomation" type library.
Quality codes
The quality code is required to check the status and quality of a message. The following table
shows the quality codes of OPC A&E.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 87
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
7.6.8.1 Differences between OPC A&E and OPC A&E with hierarchical access
OpenPCS 7 (V9.1)
88 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
syntax is used for the source in the Area Browser and for the message itself. A tracking event
occurs when an operation message is triggered in the system. The following figure shows an
example of the representation of a condition-related event in an OPC browser. The "Condition"
is shown in addition to "Area" and "Source":
Recommendation
Use an OPC A&E server with hierarchical access when creating new projects. If you upgrade an
existing project, the OPC A&E server can be used as before or the OPC A&E server can be
converted to hierarchical access. The conversion can be undone again without any loss of data.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 89
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Introduction
Process control messages, messages for Batch servers and Route Control servers are not
assigned to an area or group. For these messages, no designated area is assigned in the structure
of the OPC A&E access.
Requirement
• Process control messages are created on the OS servers.
• Messages for Batch servers and Route Control servers are created on the dedicated message
servers.
• No diagnostics area is present.
OpenPCS 7 (V9.1)
90 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 91
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Introduction
A PCS 7 project is generally divided into several system areas and diagnostic areas. This means
that messages are assigned to the areas.
The areas are shown as a hierarchy level in OPC A&E for hierarchical mapping.
Requirement
• The PCS 7 project contains areas or diagnostic areas.
OpenPCS 7 (V9.1)
92 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Introduction
In the PCS 7 project, alarm hiding groups are used to automatically hide messages. An alarm
hiding group can contain messages from several areas.
This section describes how OPC A&E accesses these messages.
Requirement
• Alarm hiding groups are configured in the OS project.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 93
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Options
The following options are available for updating a PCS 7 project with configured access via OPC
A&E:
• Conversion to OPC A&E with hierarchical access
• Retain OPC A&E without hierarchical access
Requirement
The PCS 7version of the project to be updated is PCS 7 V6.1 SP2 or higher.
OpenPCS 7 (V9.1)
94 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.6 OPC Alarms and Events (OPC A&E)
Preparation
Before performing the update, delete any "CCAeProvider.ini" file on the OS server or on the ES
directly in the OS project folder.
You can find the OS project folder in "wincproj" subfolder on the engineering station.
Note
Modified server prefix of the local computer
For OS projects in PCS 7 V6.1 SP2 or higher, note the following change in OPC A&E:
The server prefix of the local computer is now "@LOCALMACHINE" instead of "localhost".
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 95
OpenPCS 7 interface
7.7 OPC Historical Alarms and Events (OPC "H" A&E)
Overview
You can find information about the following topics in the section below:
• Introduction to OPC "H" A&E (Page 96)
• Reading archived messages (Page 97)
• Syntax for access to archived messages (Page 97)
• Read modes for archived messages (Page 99)
• Identifying archived messages (Page 100)
Note
Reading archived messages using OPC "H" A&E is a Siemens expansion of the OPC A&E standard.
Rule
After reading archived messages, you must not use the returned "ActiveTime" of a message
either for acknowledging the message or for tracking the transitions of the message. The
"ActiveTime" is not correct for archived messages. To make sure this is recognized, the OPC A&E
client must check the "EventType" of a message for the additional flag
"OPC_HAE_HISTORICAL_EVENTFLAG".
Note
You will find information on the additional flag in "Identifying archived messages".
OpenPCS 7 (V9.1)
96 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.7 OPC Historical Alarms and Events (OPC "H" A&E)
htStartTime parameter
This parameter specifies the time at which the messages and events are read from the archive.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 97
OpenPCS 7 interface
7.7 OPC Historical Alarms and Events (OPC "H" A&E)
htEndTime parameter
This parameter specifies the time up to which messages and events are read from the archive.
Example
The following table lists the parameters and their meaning and shows suitable examples.
OpenPCS 7 (V9.1)
98 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.7 OPC Historical Alarms and Events (OPC "H" A&E)
Note
The following notation is supported for the "htStartTime" and "htEndTime" parameters:
• Relative notations, for example NOW
• Symbolic values, for example NOW, YEAR, MONTH
• Absolute UTC date/time specified according to XML notation:
"2011-09-10T10:00:00.000Z".
The use of symbolic notation corresponds to the syntax of OPC Historical Data Access.
"read" mode
With the "read" mode, archived messages are read from a defined period in the past. The read
order of the messages is always chronological for each OS server from which alarms are read. By
setting the start and end time, you can specify whether the oldest message is output first or last.
If the start time is lower than the end time, the oldest message is output last.
If you want to use the "read" mode, execute the following functions on the subscription:
1. SetFilter
2. Refresh
A "SetFilter" during the "Refresh" is discarded.
If you activate the subscription during "Refresh", it will not affect the running of the refresh. The
historical events are still transferred with the refresh ID. The newly generated events are
transferred according to the standard behavior of an active subscription:
• Taking into account the set filter values with the exception of the "historical" source
"OPCHAEServer"
• Without refresh ID
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 99
OpenPCS 7 interface
7.7 OPC Historical Alarms and Events (OPC "H" A&E)
Note
Note that you must not specify an end time with "advise".
Principle
Archived messages are identified by an additional flag in the EventType.
This flag is connected with the real EventType via an OR link:
OpenPCS 7 (V9.1)
100 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.7 OPC Historical Alarms and Events (OPC "H" A&E)
Example 1
The archived messages and events of the last 30 minutes are output in "read" mode using the
following source filter. The oldest message per OS server is output first. The low limit value is also
returned:
OPCHAEServer hmode=read htStartTime=NOW-30M bBounds=TRUE
Example 2
The archived events of 1 September 2006 from 10.00 a.m. to 12.00 a.m. are output in "read"
mode using the following source filter. The newest message per OS server is output first. The
limit values of this time range are also returned:
OPCHAEServer hMode=read htStartTime=2006-09-01T12:00:00.000Z
htEndTime=2006-09-01T10:00:00.000Z bBounds=TRUE
Example 3
The archived messages and events of the last 30 minutes are output in "advise" mode using the
following source filter. After archived messages are read, the newly generated messages are
transferred as with an active subscription:
OPCHAEServer hmode=advise htStartTime=NOW-30M
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 101
OpenPCS 7 interface
7.8 OLE DB
7.8 OLE DB
Overview
You can find information about the following topics in the section below:
• Basics of OLE DB (Page 102)
• Establishing the connection to the database (Page 103)
• Access to the OLE DB provider (Page 104)
• Representation of the process value archive (Page 105)
• Querying process value archives (Page 106)
• Representation of the message archives (Page 109)
• Querying the message archives (Page 111)
Introduction
You can access process value and message archives using the OLE DB interface made available
by the PCS 7 OS and the corresponding database provider.
OLE DB
OLE DB is an open standard for fast access to different databases. It is irrelevant whether or not
the database is relational. The connection between the OLE DB level and the database is
established by an OLE DB Provider. OLE DB interfaces and providers are available from various
vendors. OLE DB provides remote access to the database.
The WinCC OLE DB Provider has been tested and approved for PCS 7.
Table 7-1 Options for accessing PCS 7 data with the WinCC OLE DB Provider:
OpenPCS 7 (V9.1)
102 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.8 OLE DB
Note
When the OS server closes a full archive and opens a new archive, there is a brief time when no
data is read from the message and process value archives via the WinCC OLE DB Provider.
ConnectionString
The connection between the application, which reads data via the OLE DB, and the archive
database, is established via the Connection object with ActiveX Data Objects (ADO). One of the
important parameters here is the ConnectionString. The ConnectionString contains all
information necessary for access to the database using the OLE DB Provider.
Parameter Description
Provider Name of the OLE DB Provider: e.g. WinCCOLEDBProvider
Catalog For transparent access, enter the following for "Catalog":
Catalog = <PCS 7 OS Name>
Data Source For transparent access to a redundant operator station, enter the following for "Data Source":
Data Source = <Symbolic computer name>::\WinCC
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 103
OpenPCS 7 interface
7.8 OLE DB
Access options
In PCS 7, the WinCC OLE DB Provider provides access to message and process value archives of
the PCS 7 OS.
OpenPCS 7 (V9.1)
104 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.8 OLE DB
Configuration options
To access the databases with the WinCC OLE DB Provider, you can write your own applications.
For communication with the WinCC OLE DB Provider, ADO DB is used in applications. ADO DB
can, for example, be used with Visual Basic or VBA.
Note
Special characters in tag names
In terms of the tag names, remember that programming languages such as Visual Basic,
VBScript or VBA only permit the following characters in tag names:
"A...Z", "a...z", "0...9" and "_". If you use special characters such as "," or ";" in tag names in WinCC ,
the script will abort with an error message. In this case, use the "Tag ID" to address a tag in the
script if it has special characters in the name. We also recommend that you use the "Tag ID" to
improve performance.
Basic procedure
1. The OLE DB application must always run on the OpenPCS 7 station. Remote access is not
possible.
2. With swapped archives, establish the connection between the SQL database and the
swapped archives with the WinCC Archive Connector.
Note
The WinCC RT archives in the folder "<Project folder> \ ArchiveManager" and the
subdirectories belonging to it must not be connected or disconnected using the Archive
Connector because the connection to the SQL Server is managed by the WinCC basic system.
3. Establish the connection to the database, for example, by using MS Excel or your own
application. Specify the required selection criteria and read the archive data.
4. For example, you can display the results of the query in MS Excel or export it as a CSV file.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 105
OpenPCS 7 interface
7.8 OLE DB
Principle
You can access a process value archive with the following query. The data can be selected using
filter criteria. The queries are transferred to the database with the command object.
Syntax
TAG:R, <ValueID oder ValueName>,<TimeBegin>,<TimeEnd>[,<SQL_clause>]
[,<TimeStep>]
Parameter Description
ValueID ValueID from the database table. Can be named more than once, for example:
"TAG:R,(ValueID_1;ValueID_2;ValueID_x),<TimeBegin>,<TimeEnd>"
ValueName ValueName in the format 'ArchiveName\Value_Name'. The <ValueName> parameter
must be enclosed in single quotes. Multiple naming is possible, for example:
"TAG:R,('ValueName_1';'ValueName_2';'ValueName_x'), <TimeBegin>,<TimeEnd>"
Note
With tag names, remember that programming languages such as Visual Basic, VBScript
or VBA only permit the following characters in tag names:
"A...Z", "a...z", "0...9" and "_".
If you use special characters such as "," or ";" in tag names in WinCC , the script will abort
with an error message. In this case, use the "Tag ID" to address a tag in the script if it has
special characters in the name.
TimeBegin Start time in the format:
'YYYY-MM-DD hh:mm:ss.msc'
If you use <TimeStep> , then <TimeBegin> must be specified as real time. Relative times
or "0000-00-00 00:00:00.000" are not possible.
TimeEnd End time in the format:
'YYYY-MM-DD hh:mm:ss.msc'
OpenPCS 7 (V9.1)
106 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.8 OLE DB
Parameter Description
SQL_Clause Filter criterion in SQL syntax:
[WHERE search_condition] [ORDER BY {order_expression [ASC|DESC] } ]
The criterion "ORDER BY" can only be used with a specified sort order "{order_expression
[ASC|DESC] }" .
TimeStep Values in the specified time interval are grouped together beginning at the start time
<TimeBegin>.
Format: 'TIMESTEP=x,y'
x = period in seconds
y = aggregate function type
The interval result is returned for an interval depending on the type of aggregate func‐
tion. The following values are possible for the type of aggregate function:
• Without interpolation:
If there are no values in the period, no period result will be returned.
1 (FIRST): First value
2 (LAST): Last value
3 (MIN): Minimum value
4 (MAX): Maximum value
5 (AVG): Average
6 (SUM): Sum
7 (COUNT): Number of values
• With interpolation:
An interval result is returned for every interval. This is done with linear interpolation.
There is no extrapolation.
257 (FIRST_INTERPOLATED): First value
258 (LAST_INTERPOLATED): Last value
259 (MIN_INTERPOLATED): Minimum value
260 (MAX_INTERPOLATED): Maximum value
261 (AVG_INTERPOLATED): Average
262 (SUM_INTERPOLATED): Sum
263 (COUNT_INTERPOLATED): Number of values
Example: With TIMESTEP=60,257 , an interpolated value is returned for each 60 second
period:
"TAG:R,1,'2004-07-09 09:03:00.000','0000-00-00 00:10:00.000','TIMESTEP=60,257'"
Rule
Note the following:
• <TimeBegin> and <TimeEnd> may not both be "ZERO" = "0000-00-00 00:00:00.000".
• In order to read data, <TimeBegin> must come before <TimeEnd>. For reverse sorting, use
the parameter "Order by-Clause" .
• To improve performance, use the "ValueID" in the query instead of "ValueName". You can get
the "ValueID" from the "Archive" table.
• With process values, some applications cannot handle the time with a resolution of 1 ms and
this can lead to inaccuracies.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 107
OpenPCS 7 interface
7.8 OLE DB
Example 1:
Reads the values of ValueID 1 from start time 9:03 a.m. to end time 9:10 a.m.
"TAG:R,1,'2004-07-09 09:03:00.000','2004-07-09 09:10:00.000'"
Note
If you want to query a relative period from a connected archive database, enter this in the
following format:
0000-00-DD hh:mm:ss.msc
If you specify a period in months, the content may be incorrect since a month can have between
28 and 31 days.
Example 2:
Reads starting from the absolute time of "TimeBegin" to the end of the recording, in other words,
to the last archived value.
<TimeBegin> = '2003-02-02 12:00:00.000',
<TimeEnd> = '0000-00-0000:00:00.000'
Example 3:
Reads 10 seconds further starting from the absolute time of "TimeBegin" .
<TimeBegin> = '2003-02-02 12:00:00.000',
<TimeEnd> = '0000-00-00 00:00:10.000'
Example 4:
Reads 10 seconds back starting from the absolute time of "TimeEnd".
<TimeBegin> = '0000-00-00 00:00:10.000',
<TimeEnd> = '2003-02-02 12:00:00.000'
OpenPCS 7 (V9.1)
108 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.8 OLE DB
Example 5:
Reads the values of the last hour for several ValueIDs (1;3;5;6) , starting at the time of the last
archived value.
"TAG:R,(1;3;5;6),'0000-00-00 01:00:00.000',
'0000-00-0000:00:00.000'"
Multiple return values for one query by filtering the tag value
Example 6:
The following query also uses the <SQL_Clause> parameter and returns all values of tags with
the ValueID "3" and "6" that are below 50 or over 100.
"TAG:R,(3;6),<TimeBegin>,<TimeEnd>,'WHERE RealValue > 100 OR
RealValue < 50'"
Example 7:
The following query uses the <TimeStep> parameter and returns all values of the ValueID "1" ,
starting at "TimeBegin" for the next 5 minutes at intervals of "60" seconds with aggregate
function type "5" = "average value without interpolation".
"TAG:R,1,'2004-10-13 17:00:00.000','0000-00-00 00:05:00.000',
'TIMESTEP=60,5'"
Example 8:
The following query uses the <TimeStep> parameter and returns all values of theValueIDs "1"
and "2" , starting at "TimeBegin" until 2 minutes later at intervals of "15" seconds with aggregate
function type "261" = "average value without interpolation".
"TAG:R,(1;2),'2004-10-13 17:00:00.000','0000-00-00 00:02:00.000',
'TIMESTEP=15,261'"
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 109
OpenPCS 7 interface
7.8 OLE DB
OpenPCS 7 (V9.1)
110 Function Manual, 02/2021, A5E50316936-AA
OpenPCS 7 interface
7.8 OLE DB
Principle
Use the following query to access a message archive. The data can be selected using filter
criteria. The query is transferred to the database with the command object.
Information on the status of messages is available in the WinCC Information System in "Working
with WinCC > ANSI-C Function Descriptions > Appendix > Structure Definitions >
MSG_RTDATA_STRUCT Structure Definition".
Syntax
ALARMVIEW:SELECT * FROM <ViewName>[WHERE <Condition>...., optional]
Parameter Description
ViewName Name of the database table.
The table must be specified in the required language. The "ViewName" for the five Eu‐
ropean languages is, for example:
ALGVIEWDEU: German message archive data
ALGVIEWENU: English message archive data
ALGVIEWESP: Spanish message archive data
ALGVIEWFRA: French message archive data
ALGVIEWITA: Italian message archive data
Note
The languages that are installed on the PCS 7 OS or configured in the PCS 7 OS Text
Library are supported. Information on the possible query languages and the correspond‐
ing "ViewName" in the SQL server is available in the connected message archives in
"Views". Here, all languages and their identifications, such as "ALGVIEWENU", are dis‐
played that are supported in the particular archive.
Condition Filter criterion e.g.:
DateTime>'2003-06-01' AND DateTime<'2003-07-01'
DateTime>'2003-06-01 17:30:00'
MsgNo = 5
MsgNo in (4, 5)
State = 2
With DateTime, the time can only be specified in absolute format.
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 111
OpenPCS 7 interface
7.8 OLE DB
Example 1:
Reads all entries of message number 5 that were recorded after 5 July 2003.
"ALARMVIEW:SELECT * FROM ALGVIEWENU WHERE MsgNo = 5 AND
DateTime>'2003-07-05'"
Example 2:
Reads all messages with the time stamp between 3 July 2003 and 5 July 2003.
"ALARMVIEW:SELECT * FROM ALGVIEWENU WHERE DateTime>'2003-07-03' AND
DateTime<'2003-07-05'"
OpenPCS 7 (V9.1)
112 Function Manual, 02/2021, A5E50316936-AA
Appendix A
A.1 Commissioning
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 113
Appendix
A.1 Commissioning
OpenPCS 7 (V9.1)
114 Function Manual, 02/2021, A5E50316936-AA
Lists and folders B
B.1 List of sources
Sources
[1] OPC Foundation, OPC Unified Architecture Release 1.02, Parts 1..11
[2] OPC Foundation, Data Access Custom Interface Specification 3.0
[3] OPC Foundation, Data Access Automation Interface Standard 2.02
[4] OPC Foundation, Alarms and Events Custom Interface Standard 1.10
[5] OPC Foundation, Alarm & Events Automation Interface Standard 1.01
[6] OPC Foundation, Historical Data Access Specification 1.20
[7] OPC Foundation, Historical Data Access Automation Interface Standard 1.0
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 115
Lists and folders
B.2 List of abbreviations/acronyms
List of abbreviations/acronyms
Abbreviation/ Description
acronym
APC Advanced Process Control
AS Automation System
CAL Client Access License
COM Component Object Model
CPU Central Processor Unit
DA Data Access
DCOM Distributed Component Object Model
DLL Dynamic Link Library
ES Engineering system
HDA Historical Data Access
HMI Human Machine Interface
HW Hardware
LRPC Lightweight Remote Procedure Call
OLE Object Linking and Embedding
OLE DB Object Linking and Embedding for Data Base
OPC previously: OLE for Process Control, now: Openness, Productivity and Collaboration
OPC UA OPC Unified Architecture
OS Operator Station (PCS 7 OS) or Operating System
PC Personal Computer
PCS 7 Process Control System 7
PH Process Historian
RPC Remote Procedure Call
SFC Sequential Function Chart
SP Service pack
SPOSA Single Point of System Access
SQL Structured Query Language
WinCC Windows Control Center
OpenPCS 7 (V9.1)
116 Function Manual, 02/2021, A5E50316936-AA
Index
OLE-DB, 20
OPC, 15
A OPC "H" A&E (Historical Alarms & Events server), 20
OPC A&E (Alarms & Events server), 20
Application 1, 45
OPC client configuration outside PCS 7, 34
Application 2, 45
OPC client engineering within PCS 7, 34
Application 3, 46
OPC DA (Data Access server), 20
OPC DA client, 70
OPC DA server, 70
C OPC Data Access (OPC DA), 70
Collection, 16 OPC Foundation, 17
COM, 15 OPC HDA (Historical Data Access server), 20
COM / DCOM components used by OpenPCS 7, 23 OPC UA
Construct redundant connections for OpenPCS 7 Conformance units, 58
stations in PCS 7, 39 Display of the logging tags, 61
Creating a firewall for the OPC client, 48 Mapping of the WinCC tags, 60
Profile, 58
OPC UA (Unified Architecture server), 19
D OPC UA Data Access, 62
OpenPCS 7 combined with an OS client, 40
DCOM, 15
OpenPCS 7 on a server, 41
DLL, 16
OpenPCS 7 on an OS single station system, 41
Documentation
OpenPCS 7 station without installed OS client, 39
Access options, 10
Overview, 13, 18
for planning and configuration, 10
E P
Plant configuration of the OPC DA link, 45
Events, 15
G S
Setting location, 48
General OpenPCS 7 configuration, 37
T
L
The PCS 7 project wizard, 36
Layout, 14
W
M
Windows Firewall settings, 48
Main entry, 15
Microsoft basics, 15
O
OLE, 15
OLE DB, 22
OpenPCS 7 (V9.1)
Function Manual, 02/2021, A5E50316936-AA 117
Index
OpenPCS 7 (V9.1)
118 Function Manual, 02/2021, A5E50316936-AA