Siemens SIMATIC PCS 7 User guide

SIMATIC
Process Control System PCS 7
Advanced Process Functions
Engineering Manual
System Manual
07/2016
A5E38719921-AA
Preface
Security information 1
APF Engineering at a glance 2
Configuring AS-OS
communication 3
APF Engineering Tool 4
Material management 5
Storage management 6
Parameter management 7
Archive management 8
Additional steps for
configuring 9
Diagnostics guide 10

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.
Siemens AG
Division Process Industries and Drives
Postfach 48 48
90026 NÜRNBERG
GERMANY
A5E38719921-AA
Ⓟ 08/2016 Subject to change
Copyright © Siemens AG 2016.
All rights reserved

Preface
Purpose of the manual
This document supports you in performing engineering with the Advanced Process Functions
(APF) software in the SIMATIC PCS 7 environment.
For information on installing and commissioning, refer to the manual "Advanced Process
Functions (APF) Installation and Configuration".
Core content
The following core issues are covered in this document:
● How is AS-OS communication configured?
● How is the APF engineering tool operated?
● How are the APF modules configured?
Validity
This documentation is valid for V2.1 of the APF software package.
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 3

Preface
Advanced Process Functions Engineering Manual
4System Manual, 07/2016, A5E38719921-AA

Table of contents
Preface.........................................................................................................................................................3
1Security information......................................................................................................................................9
2APF Engineering at a glance......................................................................................................................11
3 Configuring AS-OS communication............................................................................................................13
3.1 Setting up an S7 connection..................................................................................................13
3.2 User Archive Read Manager..................................................................................................15
3.2.1 Function block "FB_UA_RM"..................................................................................................15
3.2.2 Configuring the "FB_UA_RM" function block.........................................................................16
3.3 User Archive Write Manager..................................................................................................19
3.3.1 Function block "FB_UA_WM".................................................................................................19
3.3.2 Configuring the "FB_UA_WM" function block.........................................................................20
3.4 Creating raw data tags in WinCC...........................................................................................23
3.5 Registering WinCC tags in the WinCC Data Manager...........................................................26
3.6 Adapting WinCC actions........................................................................................................28
3.7 Checking redundancy tag in WinCC......................................................................................35
4 APF Engineering Tool................................................................................................................................37
4.1 Introduction............................................................................................................................37
4.2 Opening the APF engineering tool.........................................................................................39
4.3 Layout of the user interface....................................................................................................40
4.4 "Settings" dialog.....................................................................................................................43
4.5 Data formats...........................................................................................................................51
4.6 Block versioning.....................................................................................................................53
5 Material management.................................................................................................................................55
5.1 Overview................................................................................................................................55
5.2 Material classes.....................................................................................................................57
5.2.1 Creating and editing material classes....................................................................................57
5.2.2 Creating and editing attributes...............................................................................................59
5.3 Material types.........................................................................................................................63
5.4 Materials.................................................................................................................................65
5.5 Material triggers.....................................................................................................................66
5.6 Material lots............................................................................................................................69
5.7 Material lot status texts..........................................................................................................72
5.8 Generating AS function blocks...............................................................................................74
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 5

6 Storage management.................................................................................................................................75
6.1 Overview................................................................................................................................75
6.2 Storage location groups.........................................................................................................78
6.3 Storage locations...................................................................................................................80
6.4 Storage attributes...................................................................................................................81
6.5 Storage values.......................................................................................................................84
6.6 Storage location status texts..................................................................................................87
6.7 Storage procedural releases..................................................................................................89
6.8 Storage trigger.......................................................................................................................91
6.9 Generating an AS function block............................................................................................94
6.10 FB_SACT function block restrictions......................................................................................95
7 Parameter management.............................................................................................................................97
7.1 Overview................................................................................................................................97
7.2 Parameter groups .................................................................................................................99
7.2.1 Creating and editing parameter groups..................................................................................99
7.2.2 Creating and editing attributes.............................................................................................101
7.3 Normalization/Recalculation.................................................................................................103
7.4 Parameter sets.....................................................................................................................104
7.5 Parameter trigger.................................................................................................................105
7.6 Generating AS function blocks.............................................................................................107
8 Archive management................................................................................................................................109
8.1 Overview..............................................................................................................................109
8.2 Archive groups.....................................................................................................................110
8.3 Archive values......................................................................................................................113
8.4 Archive job status texts........................................................................................................115
8.5 Archive trigger......................................................................................................................117
8.6 Generating AS function blocks.............................................................................................120
9 Additional steps for configuring................................................................................................................121
9.1 Running the APF Integrator.................................................................................................121
9.2 Transferring APF process pictures to the plant hierarchy....................................................123
9.3 Automatically transferring changes of user archives............................................................124
9.4 Change to the archive structure, manual data transfer........................................................125
9.4.1 General information..............................................................................................................125
9.4.2 Single-user station...............................................................................................................126
9.4.3 Multi-user system (server / client)........................................................................................127
9.5 General information on the engineering tool........................................................................129
Table of contents
Advanced Process Functions Engineering Manual
6System Manual, 07/2016, A5E38719921-AA

10 Diagnostics guide.....................................................................................................................................131
10.1 Troubleshooting procedure..................................................................................................131
10.2 Useful information on error diagnostics................................................................................134
Table of contents
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 7

Table of contents
Advanced Process Functions Engineering Manual
8System Manual, 07/2016, A5E38719921-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 only form one element of such a concept.
Customer is responsible to prevent unauthorized access to its plants, systems, machines and
networks. Systems, machines and components should only be connected to the enterprise
network or the internet if and to the extent necessary and with appropriate security measures
(e.g. use of firewalls and network segmentation) in place.
Additionally, Siemens’ guidance on appropriate security measures should be taken into
account. For more information about industrial security, please visit:
http://www.siemens.com/industrialsecurity
Siemens’ products and solutions undergo continuous development to make them more secure.
Siemens strongly recommends to apply product updates as soon as available and to always
use 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:
http://www.siemens.com/industrialsecurity
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 9

Security information
Advanced Process Functions Engineering Manual
10 System Manual, 07/2016, A5E38719921-AA

APF Engineering at a glance 2
Introduction
In this manual, you can find information on the possibilities for configuring with APF (Advanced
Process Functions).
Configuration steps
APF Engineering involves the following basic steps:
1. Setting up the AS-OS communication
– Setting up the communication on the AS
- Setting up an S7 connection
- Configuring the User Archive Read Manager
- Configuring the User Archive Write Manager
– Setting up the communication on the OS
- Creating tags in WinCC
- Declaring the WinCC tags in the raw data trigger
- Adapting the global script actions
2. General settings in the APF engineering tool
3. Configuring the APF components with the APF engineering tool
– Material management
– Storage location management
– Parameter management
– Archive management
Requirements
The following requirements must be met for configuring with APF:
● SIMATIC PCS 7 has been installed without errors.
● APF has been installed without errors.
● The master data library must be in the same directory as the multiproject.
● All relevant steps from the PCS 7 Basic Engineering have been performed, and the PCS
7 OS has been compiled and downloaded.
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 11

● The APF configuration is complete.
● The APF Integrator has been run after completing the APF configuration.
Note
For information on installing and configuring APF, refer to the manual "Advanced Process
Functions (APF) Installation and Configuration".
The process pictures may be available in different versions. For example, the material lot
editor (.pdl picture) available by default as FB_MAT_LOT_ED (recommended for resolution
1280x1024), is also additionally available as FB_MAT_LOT_ED-1920 optimized for
1920x1080 resolution and an improved form.
In this manual, the process picture name is used without a suffixed number for both versions.
The inserted screen representations correspond to the PDL pictures with a resolution of
1280 and generally also apply for the PDL pictures in higher resolution and improved
display.
APF Engineering at a glance
Advanced Process Functions Engineering Manual
12 System Manual, 07/2016, A5E38719921-AA

Configuring AS-OS communication 3
3.1 Setting up an S7 connection
Introduction
An S7 connection must be set up for data exchange between the AS and OS. An important
step here is the assignment of the local ID. You need this when assigning the communication
block parameters on the AS.
Requirement
● The multiproject configured for APF is open in SIMATIC Manager.
For information on this, refer to the manual "Advanced Process Functions (APF) Installation
and Configuration".
Procedure
To create an S7 connection, follow these steps:
1. Open the network view (NetPro) in SIMATIC Manager.
2. Select the CPU of the SIMATIC station.
The connection table is displayed in the lower part of the NetPro window.
3. Insert an S7 connection via the shortcut menu.
4. Activate the "Show properties before inserting" check box.
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 13

5. Specify a local ID in the "Properties - S7 Connection" dialog.
Note
The local ID is needed for configuring the communication blocks of the User Archive Read
Manager and User Archive Write Manager.
6. Click "OK".
The connection is created and displayed in the connection table of the NetPro window.
7. If you want to configure a redundant connection to the OS, create a second connection
using the same procedure.
Configuring AS-OS communication
3.1 Setting up an S7 connection
Advanced Process Functions Engineering Manual
14 System Manual, 07/2016, A5E38719921-AA

3.2 User Archive Read Manager
The User Archive Read Manager consists of the "FB_UA_RM" function block and executes
the following functions:
● Reading one or more data records from the OS user archive to a data block on request
● Transferring read data to the requesting block
● Monitoring communication (generation of alarms)
No picture objects are required for the User Archive Read Manager. Execution of the User
Archive Read Manager is triggered via the interconnected APF modules.
3.2.1 Function block "FB_UA_RM"
Upon request, the "FB_UA_RM" function block reads data from an OS user archive via the
"BRCV" communication block (SFB13). It transfers the read data to the requesting block in the
AS.
Communication between the requesting block and the "FB_UA_RM" function block occurs at
the AS level using the "UDT_UA_R_REQ_ST" (request) and "UDT_UA_R_ST" (feedback)
structures.
The "FB_UA_RM" block can manage a maximum of 128 requests. Each request occupies a
separate structure input (UDT_UA_R_REQ_ST). The requesting block transfers its uniquely
identifying ID (REQ_ID) to the structure.
The read data are made available at an output structure (UDT_UA_R_ST) and identified with
the REQ_ID associated with the job. As a result, the requesting block is able to recognize that
the data belong to its read request.
OS tags are used to coordinate the data communication between the AS and OS. Appropriate
scripts associated with the function block and its functionalities are triggered for operator
control at the OS level.
Configuring AS-OS communication
3.2 User Archive Read Manager
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 15

5HTXHVWLQJEORFN,' HJ,' HJ,' HJ5HTXHVWLQJEORFN5HTXHVWLQJEORFN(UURU$/$50B3$ODUP6FULSW8VHUDUFKLYH/RJJLQJ,2YDULDEOHV%5&9FB_UA_RM
8'7B8$B5B5(4B675(4B675(4B675(4B678'7B8$B5B6748$B675(4B' OS
3.2.2 Configuring the "FB_UA_RM" function block
To configure the "FB_UA_RM" function block, follow these steps:
1. Create a new hierarchy folder in the PH.
2. Create a new CFC in the hierarchy folder, and open it in the CFC Editor.
3. Insert the "FB_UA_RM" function block from the master data library into the CFC.
Note
An "FB_UA_RM" block should run in a faster OB than the requesting blocks.
4. Rename the function block "UA_RM".
Note
The name "UA_RM" is specified by the APF system and must not be changed here or in
subsequent configuring steps. If you want to use several "FB_UA_RM" function blocks, you
must configure them in different CFCs.
Configuring AS-OS communication
3.2 User Archive Read Manager
Advanced Process Functions Engineering Manual
16 System Manual, 07/2016, A5E38719921-AA

5. Configure the inputs and outputs of the function block.
– For the "ID_1" input, enter the value of the local ID you specified for the configured S7
connection.
– Enter a unique value for the "R_ID_1" input, and keep track of it. You need this value
when configuring the OS tags.
– At the "ID" input, specify a unique ID for the block. Recommendation: "ID" = "R_ID_1".
1HW3UR:LQ&&&)&&KDUW
– Configure the other input and output parameters of the function block.
Note
You can find a detailed description of the input and output parameters in the block
description of the "FB_UA_RM" function block.
Configuring AS-OS communication
3.2 User Archive Read Manager
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 17

6. Compile the CFCs and download them to the AS.
7. Compile the OS.
Note
if you subsequently change the values for ID_1 / ID_2, you must perform one of the following
procedures:
● Perform a complete restart of the CPU (preferred)
● Re-instantiate the affected "FB_UA_RM" blocks in the CFC (= new data block), that
means rewire from the old instances, delete the old ones, rename the new ones, then
perform an AS delta compile and download and an OS delta compile and download.
Therefore, the definition of ID_1 and ID_2 should be well thought out.
Configuring AS-OS communication
3.2 User Archive Read Manager
Advanced Process Functions Engineering Manual
18 System Manual, 07/2016, A5E38719921-AA

3.3 User Archive Write Manager
The User Archive Write Manager consists of the "FB_UA_WM" function block and executes
the following functions:
● Writing one or more data records from an AS data block to an OS user archive on request.
● Monitoring communication (generation of alarms)
No picture objects are required for the User Archive Write Manager. Execution of the User
Archive Write Manager is triggered via the interconnected APF modules.
Note
An RM/WM module should run in a OB faster than the requesting blocks.
3.3.1 Function block "FB_UA_WM"
Upon request, the "FB_UA_WM" function block writes data to an OS user archive via the
"BSEND" communication block (SFB12).
The data to be written are copied from a requesting block. Communication between the
requesting block and the "FB_UA_WM" function block occurs at the AS level using the
"UDT_UA_W_REQ_ST" (request) and "UDT_UA_W_ST" (feedback) structures.
The "FB_UA_WM" function block can manage a maximum of 128 requests. Each request
occupies a separate structure input (UDT_UA_W_REQ_ST) in the block. The requesting block
transfers its uniquely identifying ID (REQ_ID) to the structure.
The feedback in response to a write request is stored in a structure output (UDT_UA_W_ST)
and identified with the REQ_ID associated with the job. As a result, the requesting block is
able to detect that the feedback data belong to its write request.
OS tags are used to coordinate the data communication between the AS and OS. Appropriate
scripts associated with the "FB_UA_WM" function block and its functionalities are triggered for
operator control at the OS level.
Configuring AS-OS communication
3.3 User Archive Write Manager
Advanced Process Functions Engineering Manual
System Manual, 07/2016, A5E38719921-AA 19

%ORFN:ULWHUHTXHVW,' HJ,' HJ,' HJ%ORFN:ULWHUHTXHVW%ORFN:ULWHUHTXHVW)HHGEDFN(UURU$/$50$ODUP6FULSW8VHUDUFKLYH/RJJLQJ,2YDULDEOHV%6(1'FB_UA_WM
8'7B8$B:B5(4B65(4B675(4B675(4B678'7B8$B:B6748$B675(4B' [[OS
3.3.2 Configuring the "FB_UA_WM" function block
To configure the "FB_UA_WM" function block, follow these steps:
1. Create a new hierarchy folder in the PH.
2. Create a new CFC in the hierarchy folder, and open it in the CFC Editor.
3. Insert the "FB_UA_WM" function block from the master data library into the CFC.
Note
An "FB_UA_WM" block OB should run in a faster OB than the requesting blocks.
4. Rename the function block "UA_WM".
Note
The name "UA_WM" is specified by the APF system and must not be changed here or in
subsequent configuring steps. If you want to use several "FB_UA_WM" function blocks,
you must configure them in different CFCs.
Configuring AS-OS communication
3.3 User Archive Write Manager
Advanced Process Functions Engineering Manual
20 System Manual, 07/2016, A5E38719921-AA