Page 1 Preface Security information APF Engineering at a glance SIMATIC Configuring AS-OS communication Process Control System PCS 7 Advanced Process Functions APF Engineering Tool Engineering Manual Material management System Manual Storage management Parameter management Archive management Additional steps for configuring Diagnostics guide 07/2016 A5E38719921-AA...
Page 2 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.
Page 3: 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".
Page 4 Preface Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 5: Table Of Contents
Table of contents Preface.................................3 Security information............................9 APF Engineering at a glance........................11 Configuring AS-OS communication......................13 Setting up an S7 connection....................13 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 User Archive Write Manager....................19 3.3.1 Function block "FB_UA_WM"....................19 3.3.2 Configuring the "FB_UA_WM"...
Page 6 Table of contents Storage management..........................75 Overview..........................75 Storage location groups......................78 Storage locations........................80 Storage attributes........................81 Storage values........................84 Storage location status texts....................87 Storage procedural releases....................89 Storage trigger........................91 Generating an AS function block....................94 6.10 FB_SACT function block restrictions..................95 Parameter management..........................97 Overview..........................97 Parameter groups .........................99 7.2.1 Creating and editing parameter groups..................99 7.2.2...
Page 7: Advanced Process Functions Engineering Manual
Table of contents Diagnostics guide.............................131 10.1 Troubleshooting procedure....................131 10.2 Useful information on error diagnostics................134 Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 8 Table of contents Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 9: Security Information
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.
Page 10 Security information Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 11: Apf Engineering At A Glance
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.
Page 12 APF Engineering at a glance ● 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.
Page 13: Configuring As-Os Communication
Configuring AS-OS communication 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.
Page 14 Configuring AS-OS communication 3.1 Setting up an S7 connection 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.
Page 15: User Archive Read Manager
Configuring AS-OS communication 3.2 User Archive Read Manager 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 ●...
Page 16: Configuring The "Fb_Ua_Rm" Function Block
Configuring AS-OS communication 3.2 User Archive Read Manager FB_UA_RM 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.
Page 17 Configuring AS-OS communication 3.2 User Archive Read Manager 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.
Page 18 Configuring AS-OS communication 3.2 User Archive Read Manager 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: ●...
Page 19: User Archive Write Manager
Configuring AS-OS communication 3.3 User Archive Write Manager 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. ●...
Page 20: Configuring The "Fb_Ua_Wm" Function Block
Configuring AS-OS communication 3.3 User Archive Write Manager FB_UA_WM 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.
Page 21 Configuring AS-OS communication 3.3 User Archive Write Manager 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 in a later configuring step.
Page 22 Configuring AS-OS communication 3.3 User Archive Write Manager 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: ●...
Page 23: Creating Raw Data Tags In Wincc
Configuring AS-OS communication 3.4 Creating raw data tags in WinCC Creating raw data tags in WinCC Introduction Tags are created in the WinCC Tag Management to configure a connection to the communication blocks of the User Archive Read Manager (FB_UA_RM) and the User Archive Write Manager (FB_UA_WM).
Page 24 Configuring AS-OS communication 3.4 Creating raw data tags in WinCC 7. In the "R_ID" field, enter the value that you have configured for the "R_ID1" input parameter of the associated "FB_UA_RM" function block. 8. Select the "BSEND/BRCV" option. 9. Close the dialog box by clicking "OK". User Archive Write Manager To create the tags for data exchange with the "FB_UA_WM"...
Page 25 Configuring AS-OS communication 3.4 Creating raw data tags in WinCC 7. In the "R_ID" field, enter the value that you have configured for the "R_ID1" input parameter of the associated "FB_UA_WM" function block. 8. Select the "BSEND/BRCV" option. 9. Close the dialog box by clicking "OK". Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 26: Registering Wincc Tags In The Wincc Data Manager
Configuring AS-OS communication 3.5 Registering WinCC tags in the WinCC Data Manager Registering WinCC tags in the WinCC Data Manager Introduction All tags that are configured in WinCC for data exchange between the "FB_UA_RM" and "FB_UA_WM" blocks and the OS must be registered in the WinCC Data Manager. For this, the tags must be entered as a trigger in the "FB_RawDataTrigger.pas"...
Page 27 Configuring AS-OS communication 3.5 Registering WinCC tags in the WinCC Data Manager Example In the following example, the multiproject contains one "FB_UA_RM" block and one "FB_UA_WM" block. The blocks are configured in CFCs of the same name. The associated WinCC tags are entered as triggers: Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 28: Adapting Wincc Actions
Configuring AS-OS communication 3.6 Adapting WinCC actions Adapting WinCC actions Introduction Scripts are triggered using WinCC actions for data exchange between the AS and OS. Based on an APF template, one C-action must be created for each configured "FB_UA_RM" and "FB_UA_WM"...
Page 29 Configuring AS-OS communication 3.6 Adapting WinCC actions 3. Enter a value in the "Tag name" field according to the following pattern: Name_CFC_chart/UA_RM.OS_TRIG – The "Name_CFC_chart" prefix refers to the CFC in which the "FB_UA_RM" function block is configured as a communication partner. See Function block "FB_UA_RM"...
Page 30 Configuring AS-OS communication 3.6 Adapting WinCC actions 6. Adapt the action script accordingly for the created trigger tag. 7. Save and close the action. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 31 Configuring AS-OS communication 3.6 Adapting WinCC actions Example In the following example, the "FB_UA_RM" block is located in the CFC named "FB_UA_RM". The block name in the CFC is always the same (UA_RM). The name of the trigger tag consists of the CFC name "FB_UA_RM"...
Page 32 Configuring AS-OS communication 3.6 Adapting WinCC actions 3. Enter a value in the "Tag name" field according to the following pattern: Name_CFC_chart/UA_WM.OS_TRIG – The "Name_CFC_chart" prefix refers to the CFC in which the "FB_UA_WM" function block is configured as a communication partner. See Function block "FB_UA_WM"...
Page 33 Configuring AS-OS communication 3.6 Adapting WinCC actions 6. Adapt the action script accordingly for the created trigger tag. 7. Save and close the action. Example In the following example, the "FB_UA_WM" block is located in the CFC named "FB_UA_WM". The block name in the CFC is always the same (UA_WM). The name of the trigger tags consists of the CFC chart name "FB_UA_WM"...
Page 34 Configuring AS-OS communication 3.6 Adapting WinCC actions Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 35: Checking Redundancy Tag In Wincc
Configuring AS-OS communication 3.7 Checking redundancy tag in WinCC Checking redundancy tag in WinCC Introduction To run two OS servers in a redundant configuration, an internal WinCC tag (Redundancy_active) that is created automatically by the engineering tool is used. This tag is also required in non-redundant systems.
Page 36 Configuring AS-OS communication 3.7 Checking redundancy tag in WinCC Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 37: Apf Engineering Tool
APF Engineering Tool Introduction With the help of the APF engineering tool, you can configure the following APF modules: ● Material management ● Storage management ● Parameter management ● Archive management You specify the data for the individual APF modules on a project-specific basis in the engineering tool and generate user archives in which the data are saved.
Page 38 APF Engineering Tool 4.1 Introduction Note Following configuration with the APF engineering tool or in the case of configuration changes, the APF Integrator must be run. For more information, refer to the section "Running the APF Integrator (Page 121)". Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 39: Opening The Apf Engineering Tool
APF Engineering Tool 4.2 Opening the APF engineering tool Opening the APF engineering tool Introduction Following successful APF installation, the APF engineering tool is available in WinCC Explorer under the entry "APF engineering tools" and can be run from there. Requirement ●...
Page 40: Layout Of The User Interface
APF Engineering Tool 4.3 Layout of the user interface Layout of the user interface The following figure shows the layout of the user interface of the APF engineering tool: ① Menu bar: You can find all the commands needed to operate the APF engineering tool in the menu bar. ②...
Page 41 APF Engineering Tool 4.3 Layout of the user interface Command Explanation Print Prints the current working area Printer Setup Opens a dialog where you set up the printer Close Closes the APF engineering tool ● "Edit" menu The following table shows the commands that are grouped in the "Edit" menu: Command Explanation Undo...
Page 42 APF Engineering Tool 4.3 Layout of the user interface Icon/Button Explanation Calls information about the installed version of the APF engineering tool You can use this button to customize the display of buttons in the toolbar. Reset Textlib IDs The "Reset Textlib IDs" button, which is available in some dialogs, has the following effect: ●...
Page 43: Settings" Dialog
APF Engineering Tool 4.4 "Settings" dialog "Settings" dialog The "Settings" dialog is opened via the "File" menu or the toolbar button. Available settings there include: ● Display of user archives of the individual APF modules ● Setting the numbering of APF message texts in Alarm Logging ●...
Page 44 APF Engineering Tool 4.4 "Settings" dialog Area Explanation Backup directory 1 First backup directory path for APF user archive data backups Backup directory 2 Second backup directory path for APF user ar‐ chive data backups (optional) SIMATIC BATCH If used, set the check mark and select the PCell "Material management"...
Page 45 APF Engineering Tool 4.4 "Settings" dialog The "Material management" tab consists of the following areas: ● Archive names This area shows the pre-assigned user archives in which the material management data are saved. Area User archive Explanation Class archive FB_MATCLASS Definition of the material classes Type archive FB_MATTYPE...
Page 46 APF Engineering Tool 4.4 "Settings" dialog "Storage management" tab In the "Storage management" tab, you can find information and settings for the "Storage management" APF module. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 47 APF Engineering Tool 4.4 "Settings" dialog The "Storage management" tab consists of the following areas: ● Archive names This area shows the pre-assigned user archives in which the storage management data are saved. Area User archive Explanation Group archive FB_STORGROUP Definition of the storage location groups Actual value archive FB_STORVALUE...
Page 48 APF Engineering Tool 4.4 "Settings" dialog "Parameter management" tab In the "Parameter management" tab, you can find information and settings for the "Parameter management" APF module. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 49 APF Engineering Tool 4.4 "Settings" dialog The "Parameter management" tab consists of the following areas: ● Archive names This area shows the pre-assigned user archives in which the parameter management data are saved. Area User archive Explanation Group archive FB_PARAMGROUP Definition of the parameter groups Attribute archive FB_PARAMATTRIB...
Page 50 APF Engineering Tool 4.4 "Settings" dialog "Archive management" tab In the "Archive management" tab, you can find information and settings for the "Archive management" APF module. The "Archive management" tab consists of the following areas: ● Archive names This area shows the pre-assigned user archives in which the archive management data are saved.
Page 51: Data Formats
APF Engineering Tool 4.5 Data formats Data formats Enumerations All modules that access user archives can operate with the S7 data type "enumeration". Enumerations must be created in SIMATIC Manager for this. You do this in the project folder under "Global declarations". For details on configuring and working with multilingual enumerations, refer to the SIMATIC Manager help.
Page 52 APF Engineering Tool 4.5 Data formats Date format In S7, only the years 1990 to 2089 are specified in the "DATE_AND_TIME" data type because the year is represented by two digits only. All inputs and outputs of a block that are to represent date/time are based on the S7 "DATE_AND_TIME"...
Page 53: Block Versioning
APF Engineering Tool 4.6 Block versioning Block versioning Objective The sections below describe how the engineering tool, depending on the defined parameters and attributes ● Generates function blocks with corresponding inputs/outputs. ● Generates the user archive with corresponding column names. This means there may be inconsistencies when changing parameters and attributes if the workflow is not followed correctly.
Page 54 APF Engineering Tool 4.6 Block versioning Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 55: Material Management
Material management Overview The "Material management" APF module is used to implement automation tasks such as the following: ● Material master data management ● Material lot data management User archives You can find information on the material management user archives in the "Material management"...
Page 56 Material management 5.1 Overview AS function blocks To generate the function blocks for the material management, the following blocks are used as templates. Function block (FB) Number Function FB_XXXMA FB1777 ● Provision of the material master data in the user archive via the User Archive Read Manager in the ●...
Page 57: Material Classes
Material management 5.2 Material classes Material classes You can use the APF engineering tool to define material classes and generate a function block of type "FB_XXXMA" for each material class. The material classes are saved in the "FB_MATCLASS" user archive. The material classes are displayed in a selection list in the process picture.
Page 58 Material management 5.2 Material classes 3. Select the "New" command in the shortcut menu. The "Add material class" dialog opens. 4. Enter a name for the material class and click the "OK" button. The material class is created with default properties and displayed in the navigation area. Editing material classes In the working area of the APF engineering tool, you can edit the following properties of the material classes:...
Page 59: Creating And Editing Attributes
Material management 5.2 Material classes To edit the properties of a material class, follow these steps: 1. Select the required material class in the navigation area. The properties of the selected material class are displayed in the working area. 2. Define the properties of the material class in the working area of the engineering tool. 3.
Page 60 Material management 5.2 Material classes Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 61 Material management 5.2 Material classes Adding new attributes to a material class To add an attribute to a material class, follow these steps: 1. Select the required material class in the navigation area of the APF engineering tool. All attributes of the selected material class are displayed in the working area. 2.
Page 62 Material management 5.2 Material classes 3. Click the "Save" button to save the changes. 4. Click the "Dismiss" button to discard the changes. Deleting attributes To delete an attribute, follow these steps: 1. Select the row of the attribute. 2. Select the "Delete row" command in the "Edit" menu. The attribute is removed from the working area.
Page 63: Material Types
Material management 5.3 Material types Material types You can assign up to ten material types to each material class. The material types are saved in the "FB_MATTYPE_XXX" user archives. The material types are displayed in a selection list in the process picture. Creating material types To create a material type, follow these steps: 1.
Page 64 Material management 5.3 Material types Editing material types To edit the properties of a material type, follow these steps: 1. Select the "Material types" group in the navigation area of the APF engineering tool. All defined material types are displayed in a table in the working area. 2.
Page 65: Materials
Material management 5.4 Materials Materials You create the materials in Runtime using the "FB_MAT_ED.PDL" process picture. Each material is assigned to a material class and a material type and defined by the values that are specified for the individual attributes of the material class. The created materials are saved in the "FB_MATERIAL_XXX"...
Page 66: Material Triggers
Material management 5.5 Material triggers Material triggers You can configure triggers for data backup operations. These start the backup of user archive data at defined intervals. The following triggers are used for backing up the configuration data of the material management.
Page 67 Material management 5.5 Material triggers Configuring a trigger To configure a trigger with the APF engineering tool, follow these steps: 1. Select the "Material trigger" group in the navigation area of the APF engineering tool. The triggers are displayed in the working area. 2.
Page 68 Material management 5.5 Material triggers 4. Click "OK". 5. The "Edit trigger" dialog closes. 6. Click the "Save" button in the working area of the APF engineering tool to apply the changes. 7. Click the "Dismiss" button in the working area of the APF engineering tool to discard the changes.
Page 69: Material Lots
Material management 5.6 Material lots Material lots You create and edit the material lots in Runtime using the "FB_MAT_LOT_ED.PDL" process picture. Each material lot is assigned to a material class, a material type, and a material. The created material lots are saved in the "FB_MATERIAL_LOT" user archive. You can use the APF engineering tool to define up to 100 material lot attributes and generate a function block of type "FB_MLOT".
Page 70 Material management 5.6 Material lots Adding attributes To add an attribute, follow these steps: 1. Select the "Material lots" group in the navigation area of the APF engineering tool. All defined attributes are displayed in the working area. 2. Specify the number of the function block that is generated for the material lot management. Note Block numbers FB1775-1795 are reserved for APF blocks and must not be overwritten.
Page 71 Material management 5.6 Material lots Editing attributes To edit the attributes, follow these steps: 1. Select the "Material lots" group in the navigation area of the APF engineering tool. All defined attributes of the material lots are displayed in the working area. 2.
Page 72: Material Lot Status Texts
Material management 5.7 Material lot status texts Material lot status texts With the help of the APF engineering tool, you can define various states for the material lots. The status texts are displayed in a selection list in the process picture. Creating status texts To define a status text, follow these steps: 1.
Page 73 Material management 5.7 Material lot status texts Deleting status texts To delete a status, follow these steps: 1. Select the row of the status text to be deleted. 2. Select the "Delete row" command in the "Edit" menu. The status text is removed. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 74: Generating As Function Blocks
Material management 5.8 Generating AS function blocks Generating AS function blocks Following configuration of the material classes and material lots, you can generate function blocks using the "Generate blocks" button of the APF engineering tool. Material classes A function block of type "FB_XXXMA" is generated for each created material class and stored in the master data library.
Page 75: Storage Management
Storage management Overview The "Storage management" APF module is used to implement automation tasks such as the following: ● Coordination of the storage locations ● Comparison of target and actual values of the storage locations ● Posting and clearing materials and material lots (including partial quantities) ●...
Page 76 Storage management 6.1 Overview Picture objects Explanation @FB_Account.PDL Faceplate for two-step posting of materials / material lots in the storage locations @FB_ShowMatLots.PDL Faceplate for displaying material lots during the materi‐ al search @FB_32BitsRel.PDL Faceplate for displaying procedural releases in the "FB_STOR.PDL"...
Page 77 Storage management 6.1 Overview Function block (FB) Number Function FT_ST_AC FB1782 Performs posting and clearing processes of materials / material lots from the AS FB_SACT FB1783 Performs fast update of up to ten actual values for up to 25 "FB_STOR" blocks The "FB_SACT"...
Page 78: Storage Location Groups
Storage management 6.2 Storage location groups Storage location groups With the help of the APF engineering tool, you can define up to 30 storage location groups. The storage location groups are saved in the "FB_STORGROUP" user archive. The storage location groups are displayed in a selection list in the process picture. Creating storage location groups To create a storage location group, follow these steps: 1.
Page 79 Storage management 6.2 Storage location groups 4. Click in the empty row of the table in the working area and specify the following properties: Column Explanation Name Name of the storage location group TXTLIB ID for multilingual management in the text library (non-editable; as‐ signed automatically) Description Description of the storage location group...
Page 80: Storage Locations
Storage management 6.3 Storage locations Storage locations You create and edit the storage locations in Runtime using the "FB_STOR_ED.PDL" process picture. Each storage location is assigned to a storage location group. The created storage locations are stored in the "FB_STORAGE" user archive. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 81: Storage Attributes
Storage management 6.4 Storage attributes Storage attributes With the help of the APF engineering tool, you can define up to 50 storage attributes. An output is created for each attribute when the function blocks are generated for the storage management. The attribute data are saved in the "FB_STORATTRIB" user archive. The storage location attributes are displayed and can be assigned with values for each selected storage location in the process picture.
Page 82 Storage management 6.4 Storage attributes Creating attributes To create an attribute, follow these steps: 1. Select the "Storage attributes" group in the navigation area of the APF engineering tool. 2. Specify the number of material lots permitted per storage location. If this setting is subsequently modified, the corresponding function blocks must be created again.
Page 83 Storage management 6.4 Storage attributes Editing attributes To edit the attributes, follow these steps: 1. Select the "Storage attributes" group in the navigation area of the APF engineering tool. All defined attributes are displayed in the working area. 2. Click in the row of the attribute to be edited and make the required changes. 3.
Page 84: Storage Values
Storage management 6.5 Storage values Storage values With the help of the APF engineering tool, you can define up to 50 storage values. An input is created for each actual value when the function blocks are generated for the storage management.
Page 85 Storage management 6.5 Storage values Creating actual values To define an actual value, follow these steps: 1. Select the "Storage values" group in the navigation area of the APF engineering tool. All defined values are displayed in the working area.. 2.
Page 86 Storage management 6.5 Storage values Deleting actual values To delete an actual value, follow these steps: 1. Select the row of the value to be deleted. 2. Select the "Delete row" command in the "Edit" menu. 3. The value is removed from the working area. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 87: Storage Location Status Texts
Storage management 6.6 Storage location status texts Storage location status texts With the help of the APF engineering tool, you can define various status texts for the storage locations. The status texts are displayed in the process picture and used for the storage location and material searches.
Page 88 Storage management 6.6 Storage location status texts Editing status texts To edit a status, follow these steps: 1. Select the "Storage location status texts" group in the navigation area of the APF engineering tool. All defined status texts are displayed in the working area. 2.
Page 89: Storage Procedural Releases
Storage management 6.7 Storage procedural releases Storage procedural releases With the help of the APF engineering tool, you can define up to 128 procedural releases. These are saved in the "FB_PROCEDURES" user archive. The representation of the release fields in the process picture corresponds to a 32-bit integer value: Each release occupies one single bit in the 32-bit integer value.
Page 90 Storage management 6.7 Storage procedural releases Editing procedural releases To edit a procedural release, follow these steps: 1. Select the "Storage procedural releases" group in the navigation area of the APF engineering tool. All defined procedural releases are displayed in the working area. 2.
Page 91: Storage Trigger
Storage management 6.8 Storage trigger Storage trigger You can configure triggers for data backup operations. These start the backup of user archive data at defined intervals. The following triggers are used for backing up the configuration data of the storage management.
Page 92 Storage management 6.8 Storage trigger Configuring a trigger To configure a trigger with the APF engineering tool, follow these steps: 1. Select the "Storage trigger" group in the navigation area of the APF engineering tool. The storage triggers are displayed in the working area. 2.
Page 93 Storage management 6.8 Storage trigger 4. Click "OK". 5. The "Edit trigger" dialog closes. 6. Click the "Save" button in the working area of the APF engineering tool to apply the changes. 7. Click the "Dismiss" button in the working area of the APF engineering tool to discard the changes.
Page 94: Generating An As Function Block
Storage management 6.9 Generating an AS function block Generating an AS function block Following configuration of the storage management, you can generate the "FB_STORI" and "FB_STORR" function blocks using the "Generate FBs" button of the APF engineering tool. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 95: Fb_Sact Function Block Restrictions
Storage management 6.10 FB_SACT function block restrictions 6.10 FB_SACT function block restrictions This block is used for updating the storage location overview screen "FB_STOR.pdl". The maximum volume of data that can be sent using raw data via the BSEND function block may be reached with this block (16230 bytes).
Page 96 Storage management 6.10 FB_SACT function block restrictions Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 97: Parameter Management
Parameter management Overview The "Parameter management" APF module is used to implement automation tasks such as the following: ● Creating and managing parameter set data and their properties ● Specifying of limits and parameter set releases ● Normalizing/recalculating attribute values of the parameter sets User archives You can find information on the user archives of parameter management in the "Parameter management"...
Page 98 Parameter management 7.1 Overview AS function blocks To generate the function blocks for the parameter management, the APF engineering tool uses the "FB_XXXPA" function block (FB1784) as a template. The functions of this function block include the following: ● Provision of the parameter set data in the user archive via the User Archive Read Manager in the AS ●...
Page 99: Parameter Groups
Parameter management 7.2 Parameter groups Parameter groups With the help of the APF engineering tool, you can define parameter groups. A function block of type "FB_XXXPA" is generated for each parameter group. The parameter groups are saved in the "FB_PARAMGROUP" user archive. The parameter groups are displayed in a selection list in the process picture.
Page 100 Parameter management 7.2 Parameter groups 3. Select the "New" command in the shortcut menu. The "Add Parameter group" dialog opens. 4. Enter a name for the parameter group and click the "OK" button. The parameter group is created with default properties and displayed in the navigation area. Editing a parameter group In the working area of the APF engineering tool, you can edit the following properties of the parameter groups:...
Page 101: Creating And Editing Attributes
Parameter management 7.2 Parameter groups 7.2.2 Creating and editing attributes You can define up to 100 attributes for each parameter group. An output is created for each attribute when the corresponding function block is generated. The attribute data are saved in the "FB_PARAMATTRIB_XXX"...
Page 102 Parameter management 7.2 Parameter groups Column Explanation Position in the visualization order Name Name of the attribute Unit of the attribute Format Format of the attribute Enum_Mat Name/coding of an enumeration The "ENUM_MAT" field can only be selected if you have set "ENU‐ MERATION"...
Page 103: Normalization/Recalculation
Parameter management 7.3 Normalization/Recalculation Normalization/Recalculation With the help of the APF engineering tool, you can specify whether normalization/recalculation is performed for each attribute of a parameter group. This is specified using the "Norm" value of the attributes. You can enter the following values in the "Norm" field: ●...
Page 104: Parameter Sets
Parameter management 7.4 Parameter sets Parameter sets You create the parameter sets in Runtime using the "FB_PARAM_ED.PDL" process picture. Each parameter set is assigned to a parameter group and is defined by the values that are specified for the individual attributes of the parameter group. The created parameter sets are stored in the "FB_PARAM_XXX"...
Page 105: Parameter Trigger
Parameter management 7.5 Parameter trigger Parameter trigger You can configure triggers for data backup operations. These start the backup of user archive data at defined intervals. The following triggers are used for backing up the data of the parameter management. Trigger Function FB_PMBackupTriggerEN.pas...
Page 106 Parameter management 7.5 Parameter trigger 3. Configure the trigger using the following settings: Area/check box Explanation Name Name of the trigger (non-editable) Cycle Intervals for executing the actions in runtime: Standard cycle Hourly Daily Weekly Monthly Annually Enabled Activation of the trigger Cycle time Timing for executing the actions (depending on the cycle setting)
Page 107: Generating As Function Blocks
Parameter management 7.6 Generating AS function blocks Generating AS function blocks Following configuration of the parameter groups and their attributes, you can generate the corresponding function blocks using the "Generate FBs" button of the APF engineering tool. A function block of type "FB_XXXPA" is generated for each created parameter group and stored in the master data library.
Page 108 Parameter management 7.6 Generating AS function blocks Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 109: Archive Management
Archive management Overview The "Archive management" APF module is used to implement automation tasks such as the following: ● Creating and updating of archiving data records ● One-time export and configurable deletion of archive data records for external post- processing User archives You can find information on the archive management user archives in the "Archive management"...
Page 110: Archive Groups
Archive management 8.2 Archive groups Archive groups With the help of the APF engineering tool, you can define archive groups with different data structures. For each created archive group, the APF engineering tool generates the "FB_XXXAI" and "FB_XXXAR" function blocks. Creating archive groups To create an archive group, follow these steps: 1.
Page 111 Archive management 8.2 Archive groups Field Explanation Reserve The minimum number of data records (free capacity) in the archive below which the system starts to delete data records. No. DS to delete Number of archive data records to be deleted Example: ●...
Page 112 Archive management 8.2 Archive groups To edit the properties of an archive group, follow these steps: 1. Select the required archive group in the navigation area. The properties of the selected archive group are displayed in the working area. 2. Edit the properties of the archive group. 3.
Page 113: Archive Values
Archive management 8.3 Archive values Archive values You can assign up to 100 values to each archive group. For batch-related archiving, 25 default values are created automatically. Creating archive values To create values for an archive group, follow these steps: 1.
Page 114 Archive management 8.3 Archive values Editing archive values To edit created values, follow these steps: 1. Select the required archive group in the navigation area of the APF engineering tool. All defined values of the selected archive group are displayed in the working area. 2.
Page 115: Archive Job Status Texts
Archive management 8.4 Archive job status texts Archive job status texts In the "Status texts" group in the navigation area of the APF engineering tool, you can define various status texts for the archive jobs. Creating status texts To create a status text, follow these steps: 1.
Page 116 Archive management 8.4 Archive job status texts The status text is removed from the working area. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 117: Archive Trigger
Archive management 8.5 Archive trigger Archive trigger You can configure triggers for the export and backup operations. These start the backup of user archive data at defined intervals. The following triggers are used for backing up the configuration data of the archive management.
Page 118 Archive management 8.5 Archive trigger Configuring a trigger To configure a trigger, follow these steps: 1. Select the "Archive trigger" group in the navigation area of the APF engineering tool. The archive triggers are displayed in the working area. 2. Click the "Edit" button in the row of the required trigger. The "Edit trigger"...
Page 119 Archive management 8.5 Archive trigger 4. Click "OK". 5. The "Edit trigger" dialog closes. 6. Click the "Save" button in the working area of the APF engineering tool to apply the changes. 7. Click the "Dismiss" button in the working area of the APF engineering tool to discard the changes.
Page 120: Generating As Function Blocks
Archive management 8.6 Generating AS function blocks Generating AS function blocks Following configuration of the archive groups and their values, you can generate the associated function blocks using the "Generate FBs" button of the APF engineering tool. Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 121: Additional Steps For Configuring
Additional steps for configuring Running the APF Integrator Following configuration with the APF engineering tool, the APF Integrator must be run in all OS projects to transfer the configured data to the entire project level. Note The file FB_Configuration.ini is transferred automatically from the Engineering Tool. Thus it is not imperative that the APF Integrator is run in the case of changes that do not exclusively affect the .ini file.
Page 122 Additional steps for configuring 9.1 Running the APF Integrator 3. Click the "Integrate" button. 4. Close the "Server - Integrator" dialog after the APF Integrator has been run successfully. Note If the "Overwrite user-specific functions" check box is selected, the following functions are overwritten in the FB_UA_USER_SPECIFIC subfolder: ●...
Page 123: Transferring Apf Process Pictures To The Plant Hierarchy
Additional steps for configuring 9.2 Transferring APF process pictures to the plant hierarchy Transferring APF process pictures to the plant hierarchy Preconfigured WinCC objects (process pictures and faceplates) are available for operator control and monitoring of the APF modules on the OS. To assign the process pictures to the corresponding hierarchy folders of the PH, these folders must be imported into the component view of SIMATIC Manager.
Page 124: Automatically Transferring Changes Of User Archives
Additional steps for configuring 9.3 Automatically transferring changes of user archives Automatically transferring changes of user archives Objective Changes to groups, classes, parameters, and attributes made with the engineering tool usually produce new or modified tables, table columns, and contents in user archives. This initially only happens on the engineering station (ES).
Page 125: Change To The Archive Structure, Manual Data Transfer
Additional steps for configuring 9.4 Change to the archive structure, manual data transfer Change to the archive structure, manual data transfer 9.4.1 General information The automatic metadata synchronization described above does not always result in obtaining the available runtime data. The engineering tool generates a corresponding warning in these cases.
Page 126: Single-User Station
Additional steps for configuring 9.4 Change to the archive structure, manual data transfer 9.4.2 Single-user station Requirements ● No read or write access is being performed to the archive to be changed. ● No changes have yet been made Note We recommend that you do not perform this procedure in runtime.
Page 127: Multi-User System (Server / Client)
Additional steps for configuring 9.4 Change to the archive structure, manual data transfer 9.4.3 Multi-user system (server / client) Requirements ● No read or write access is being performed to the archive to be changed. ● No changes have yet been made Note We recommend that you do not perform this procedure in runtime.
Page 128 Additional steps for configuring 9.4 Change to the archive structure, manual data transfer 13.Adapt the exported content from step 2 to the new archive structure (a new column has been added and this column has now also to be added to the CSV file). This can be done using MS Excel or a similar program.
Page 129: General Information On The Engineering Tool
Additional steps for configuring 9.5 General information on the engineering tool General information on the engineering tool Following a structural change (for example, adding a new attribute), you should also promptly regenerate and use the block after saving. Otherwise, problems may occur due to non- matching data structures between block users archive and editor dialog.
Page 130 Additional steps for configuring 9.5 General information on the engineering tool Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...
Page 131: Diagnostics Guide
Diagnostics guide 10.1 Troubleshooting procedure Ini file One of the greatest sources of errors in the configuration phase is the inconsistent use of the ini file (FB_Configuration.ini). This file must be identical on each OS computer in the project. Problems can arise if some of the OS project computers are operating with a modified ini file, while others are still using an old ini file which has not been adapted to the project.
Page 132 Diagnostics guide 10.1 Troubleshooting procedure This means there are two types of archives. They are listed in the table below: Archive name Type Explanation FB_MATCLASS Configuration List of all material classes FB_MATTYPE_xxx Configuration List of material types of material class xxx FB_MATATTRIB_xxx Configuration Structure of material class xxx...
Page 133 Diagnostics guide 10.1 Troubleshooting procedure User archive structure The structure (number and format of columns) of a runtime archive consists of a fixed columns component (e.g., name and ID) and a variable component. The variable column component depends on the configuration with the relevant engineering tool. For every attribute / parameter generated, a column in the correct format (integer, string, etc.) is created in the runtime archive and a row in the corresponding configuration archive (FB_yyyATTRIB_xxx or FB_yyyVALUE_xxx).
Page 134: Useful Information On Error Diagnostics
Log files Various log files are available to help you diagnose problems using APF. Engineering tool The engineering tool log files can be accessed at <Program Files path>\SIEMENS\WINCC \diagnose\APF_Engineering_##.txt. Integrator The APF Integrator log file can be accessed at <Program Files Path>\SIEMENS\WINCC \diagnose\logfile_integrator.txt...
Page 135 Diagnostics guide 10.2 Useful information on error diagnostics Activating / deactivating diagnostic messages You can enable and disable a number of different diagnostic levels on the APF_Debug.pdl diagnostic screen: ● bDebugModul01: Enables/disables outputs in the C console ● bDebugModul02: Enables/disables diagnostics in the APF_OS_AS_Diag.log logfile ●...
Page 136 Diagnostics guide 10.2 Useful information on error diagnostics Advanced Process Functions Engineering Manual System Manual, 07/2016, A5E38719921-AA...

Siemens SIMATIC PCS 7 System Manual

1 Security Information

2 APF Engineering at a Glance

3 Configuring AS-OS Communication

4 APF Engineering Tool

5 Material Management

6 Storage Management

7 Parameter Management

8 Archive Management

9 Additional Steps for Configuring

Quick Links

Related Manuals for Siemens SIMATIC PCS 7

Summary of Contents for Siemens SIMATIC PCS 7

Table of Contents