Afcon Software and Electronics Ltd

Transcription

1 P-CIM TRAINING MANUAL

2 Afcon Software and Electronics Ltd 1/8/07 2

3 P-CIM 7.70 Basic Training Manual Contents About this Manual...11 License and Registration P-CIM I/O Counters Support Ordering New Software Introduction About P-CIM Minimum System Requirements...16 Installing P-CIM...17 Downloading P-CIM from the Internet Uninstalling P-CIM P-CIM Interface P-CIM icons groups...20 Creating the P-CIM Group shortcu... t 20 P-CIM Group Modules P-CIM Architecture...26 Project Architecture Communications Layer...28 Database Layer Application Layer...30 Project Management Creating Projects...33 Workflow for Creating the Yogurt Project /8/07 3

4 Afcon Software and Electronics Ltd Working with Projects...36 Default Projects Deleting Projects...37 Backing Up Projects...37 Project Setup Settings Restoring Projects Designing the Yogurt Project Yogurt Production Workflow...44 Requirements for Building an Automation System Communication Layer...46 About the Communications Layer...47 P-CIM Drivers...47 Defining Driver Parameters...49 P-CIM Communication Setup...49 New Ports Fine Tuning Parameters...50 Defining Polling Configurations P-CIM Syntax for Driver Addresses Checking Communications...56 Data Scope 56 Working in the Data Scope Alarm Summary - System Messages Communications Layer Troubleshooting Error Messages Indicating Problems during Initialization of the Driver Error Messages Indicating Writing to an Undefined Memory Range in the PLC 61 Error Message Indicating Communication Failure Defining Data Items...63 INI File Editor...65 Syntax Manager /8/07 4

5 P-CIM 7.70 Basic Training Manual Syntax Legend...70 To View the Aliases List in the Syntax Manager...70 Animation Editor...71 Toolbox...72 Selected Object Signs...73 Creating a New Display Drawing a Graphical Object...76 Basic Information Adding Properties to Graphical Objects...85 Property References...85 The Visibility Property The Fill Color Property The Fluid Fill Property The Orientation Property The Output Text Property...96 The Input Text Property...99 The Slider Property The Action Button Property Basic Information Basic P-CIM Action Commands Cells Basic Information for Designing Cells $Variables Dummy Variables Dummy Variable Syntax DBSR Functions DBSR Conversions Conversion LIN (Linear) /8/07 5

6 Afcon Software and Electronics Ltd AutoActions Creating Startup and Shutdown Actions Running the Operator Workstation during P-CIM Startup Defining AutoOpen/AutoClose Actions Defining AutoActions Database Editor About the Database Editor Configuring the Database Data Blocks Types of Database Blocks OLEDB Database Alarms Configuring Alarms Defining an Analog Alarm Defining an Alarm in an Alarm Block Displaying Alarms Alarms Status Advanced Alarm Handler About the Advanced Alarm Handler Building an Advanced Alarms System Planning Alarm Categories Planning Advanced Alarm Handler Zones Defining Data Blocks Advanced Parameters Configuring Alarms Viewing Alarms Working in the Advanced Alarm Handler Window Zones Menu /8/07 6

7 P-CIM 7.70 Basic Training Manual View Menu Filtering Views Customizing the List Sorting Alarms Customizing the Toolbar Setting Alarm Message Colors Archiving Handling Alarms Acknowledging alarms Erasing Alarms Purging Alarms Trends Real-time Trends Displaying a Real-time Trend Historical Trends History Collection Displaying a Historical Trend Dynamic Trends DOT Fields About Dot Fields ACK ALMHigh ALMLow ALMEnable Dynamic Display About Dynamic Displays The.GRP File Creating a Dynamic Display /8/07 7

8 Afcon Software and Electronics Ltd Creating the Main Display Recipes About Recipes Defining Recipes Using Recipes during Runtime Loading Recipes Learning Recipes Reports About Reports Defining and Formatting Report Templates Defining a TXT Report Running and Viewing Reports Defining a DBF Report Defining the Supreme Report Text File Server About the Text File Server Defining the DDE Address to the Text File Reading INI File Data Defining the DDE Link to the INI File Security Security Privileges Defining Users and Passwords Logging In During Runtime Logging Out During Runtime Security for Operator Workstation Menu Commands Security for Opening a Display Adding Authorization to Specific Controls in a Specific Display Runtime Keyboard and Mouse Security /8/07 8

9 P-CIM 7.70 Basic Training Manual Displaying Windows Keyboard Combination Commands Displaying Secure Windows Password Editor Modules Security File Security Audit Trail Toolbar About the Toolbar Editor Appendix 1 Shortcuts, Tips & Recommendations Shortcut Keys Tips Recommendations Appendix... 2 Glossary Contact Information /8/07 9

10 Afcon Software and Electronics Ltd Copyright The information in this document is subject to change without notice and does not represent a commitment by Afcon Software and Electronics Ltd. No part of this document may be used or reproduced in any manner whatever without written permission from Afcon Software and Electronics Ltd. The software described in this document is provided under a license agreement or a nondisclosure agreement. The software may be used or copied only under the terms of the agreement. It is against the law to copy this software on any other medium for any purpose other than the buyer's personal use. Copyright 1987 Afcon Software and Electronics Ltd. All rights reserved. P-CIM and P-CIM logos are registered trademarks of Afcon Software and Electronics Ltd.. Afcon and the Afcon logos are registered trademarks ofafcon Software and Electronics Ltd. Windows is a trademark of Microsoft Corporation. 1/8/07 10

11 P-CIM 7.70 Basic Training Manual About this Manual This manual should provide you with the information needed to build your first project. Before using P- CIM software, you should be familiar with XP and Windows 2000 operating systems or Windows 2003 Server. You should also know how to run an IBM or compatible PC. During this course we refer to the Yogurt Project, which AFCON built for a large milk product manufacturers. We suggest that as you go through the manual and learn about the various modules, you consult Appendix 1, Shortcuts, Tips and Recommendations. For more information about the P-CIM Supreme Report, refer to the Supreme Report User Guide, located in the documentation scetion on the Afcon CD. Manual Symbols The following icons are used in this manual: This sign is for notes This sign is for exercises This sign is for tips This sign is for rules During the course the following terms are used when working with the mouse: Term Drag (Left) click Right click Double click Description Moving a selected object while continuously pressing the left mouse button. Clicking on the left mouse button. Clicking on the right mouse button. Right clicking normally opens a dropdown menu. Two quick left mouse button clicks. In P-CIM the following terms refer the P-CIM key: Plug SEK Key Dongle 1/8/07 11

12 Afcon Software and Electronics Ltd License and Registration The license and registration forms are part of P-CIM software. Please complete them and return them to us. P-CIM I/O Counters The number of I/O points and P-CIM application, either runtime or development, are defined in the P- CIM SEK. Support Any questions that you have during the course can be discussed with your instructor. After the course, you can your questions to the following address: Ordering New Software To order new software contact: 1/8/07 12

13 P-CIM 7.70 Basic Training Manual 1/8/07 13

14 Afcon Software and Electronics Ltd Chapter 1 Introduction This chapter introduces you to P-CIM. Also discussed are the requirements for running P-CIM and how to install and uninstall the program. In this chapter you will learn. About P-CIM About the requirements for running P-CIM How to install P-CIM How to uninstall P-CIM 1/8/07 14

15 P-CIM 7.70 Basic Training Manual 1.1 About P-CIM P-CIM software is used to design a customized control and automation project that runs your workplace. In a P-CIM project, P-CIM database continually collects and data in real-time. Results of the process are analyzed, and when necessary, events and alarms are sent to the responsible personnel. P-CIM runs on PCs, and is connected to Programmable Logic Controllers (PLC) and field devices, or to third-party databases. During this course we will be referring to the Yogurt Project, which AFCON built for a large milk product manufacturers. Below is an illustration of a P-CIM project. Operator Workstations P-CIM P-CIM P-CIM Redundant Servers P-CIM P-CIM Web Cellular PLC Controllers P L A N T F L O O R 1/8/07 15

16 Afcon Software and Electronics Ltd 1.2 Minimum System Requirements P-CIM version 7.70 supports Windows 2000, Windows XP and Windows 2003 Server. Intel Pentium 4 256MB RAM 15GB free disk space for initial installation VGA display card with 16MB of memory Parallel printer port or USB Network adapter and fixed IP address for network applications Microsoft IIS for P-CIM Web server (for P-CIM Web and/or Supreme Report Web portal) MIcrosoft Access or SQL server (for P-CIM database and/or Supreme Report database) Optional. 1/8/07 16

17 P-CIM 7.70 Basic Training Manual 1.3 Installing P-CIM Before installing P-CIM restart your computer and make sure the program is not running. Install P-CIM from the P-CIM from the CD or, downloaded from the Afcon web site at the following address: Installing P-CIM from the Afcon CD 1. Insert the Afcon CD into the CD drive. Wait for it to open on your screen. 2. Click P-CIM and then click the Install P-CIM Packages option. 3. Click the latest P-CIM version, and then click P-CIM/Install P-CIM packages/p-cim The Install Shield runs and the Welcome dialog box opens. Click Next. If you have a previous version of P-CIM installed the Choice dialog box opens. 5. In Choice dialog box select to either: Add the version of P-CIM to your Windows system, as well as the one that you already have. To replace the current P-CIM version and to upgrade it. 6. Click Next to continue. The Select Destination Directory dialog box opens. The default is Pcim Either browse and select a new directory for the program or, accept the directory that appears in the dialog box. Click Next to run the Setup. 8. The Supreme Report installation wizard runs. Click next to start the installation process. A message informs you that the installation process was successfully completed. 9. Restart Windows before running P-CIM for the first time. Downloading P-CIM from the Internet 1 In your Internet browser open the Afcon site at the following URL: 2 From the Downloads section click P-CIM Packages and select P-CIM Version Continue installation by following the instructions on the previous page from instruction 4. Creating the P-CIM Group shortcut After installing the software, connect the Software Enabled Key (SEK) to enable all the application s features. 1. Select the following: Start/Programs/AFCON P-CIM (7.70). 2. Click the AFCON P-CIM (7.70) icon and press the Ctrl button. 3. Still pressing the Ctrl button, drag the icon on to your desktop. The P-CIM Group icon opens on your desktop. 4. Double click the P-CIM Group icon to open the P-CIM Group interface. 1/8/07 17

18 Afcon Software and Electronics Ltd 1.4 Uninstalling P-CIM 1. Close the application by clicking the P-CIM Shutdown icon. Log off your computer. 2. From the P-CIM icons group double click the Uninstall icon. The Uninstall dialog box opens. 3. In this dialog box select: 4. Automatic, to remove the P-CIM application from your computer without removing existing project files. 5. Custom, to remove the P-CIM application and selected projects files. 6. Click Next to open the Perform Uninstall dialog box. 7. Click Finish to continue the Uninstall process. A message box opens. 8. Click Yes, to confirm that you want to remove the application or No, not to. 9. The application is removed from your computer. Click OK to end the Uninstall process. 1/8/07 18

19 P-CIM 7.70 Basic Training Manual Chapter 2 P-CIM Interface Access P-CIM and its modules an Explorer like interface, created after installing P-CIM. Throughout this manual this interface is referred to as the P-CIM Group. In this chapter you will learn. To add the P-CIM Group shortcut to your desktop About P-CIM Group icons 1/8/07 19

20 Afcon Software and Electronics Ltd 2.1 P-CIM icons groups As of P-CIM version 7.50 the P-CIM icons are grouped into four groups to provide quick and easy access to P-CIM modules. The icons are placed under the following groups: Administrative Tools containing administrative security utilities. These include the Modules Security, Audit Trail, Password Editor, HASP install and HASP remove. Development containing modules used to develop and maintain projects. Included are: Animation Editor, Database Editor, Dispatcher, INI File Editor, Maintenance Manager, Message Setup, Network and Redundancy Editor, OPC Browser and Gateway Editor and Progate modules, Recipe Editor, Report Editor, Supreme Report Studio,SER Editor, Syntax Manager and Toolbar Editor module. Runtime contains modules accessed during P-CIM run-time. Included are: Alarm and Advanced Alarm Handler modules, Operator Workstation, OPC Gateway and Maintenance Manager, Progate Runtime, Supreme Report Runtime, P-CIM Video, Scheduler and Task Switcher modules. Tools contains modules used to perform maintenance tasks. Included are: Data Scope, Database Utility, Audit Trail, Disk Space Size Predictor, Sender, FTP Utility, Global Font Replacement, Open Historian Cleanup Utility, OPC Browser Displays Conversion and History Viewer. Access P-CIM modules from the P-CIM Group. It is more convenient to create a shortcut to the P-CIM Group on your desktop Creating the P-CIM Group shortcut 1 Select the following: Start/Programs/AFCON P-CIM (7.70). 2. Click the icon and press the Ctrl button. Still pressing the Ctrl button, drag the icon on to your desktop. The P-CIM Group icon opens on your desktop. 3. Double click the P-CIM Group icon to open the P-CIM Group interface. 1/8/07 20

21 P-CIM 7.70 Basic Training Manual 2.2 P-CIM Group Modules Table 1: P-CIM Modules P-CIM Setup P-CIM Startup Use this module to install P-CIM and its drivers and to define communication features. Use it also to create P-CIM projects, and to then backup and restore them This module starts up P-CIM P-CIM Shutdown This module shuts down P-CIM and its running processes P-CIM Restart This module restarts P-CIM and its running processes P-CIM Network Setup Use this module to define and change network stations. Alarm Handler Data Scope Animation Editor This module displays system and alarm messages. It has two windows, Current Alarm and Alarm Summary. A diagnostic tool used to display and change items and their values during runtime. Use this module to create the graphic displays the operator sees during runtime in the Operator Workstation module. 1/8/07 21

22 Afcon Software and Electronics Ltd Table 1: P-CIM Modules (Continued) Syntax Manager Database Editor Advanced Alarm Handler INI File Editor Operator Workstation Recipe Editor Report Editor Use this module to view and create the syntax used in a P-CIM project. This module opens the dialog box where P-CIM data blocks can be defined. Use of data blocks comprise of creating alarms and collecting history. This module is an alarms management tool. It enables the user to view, organize, oversee, notice and analyze alarms. Use this module as a viewer for INI files, and where P-CIM module parameters can be changed, and aliases can be created. This module displays the runtime graphic interface designed in the Animation Editor. Use this module to create or change a recipe template. A recipe is a group of values related to specific dynamic data addresses. Use this module to create report templates. Toolbar Editor Use this tool to create a customized tool bar. SER Editor Use this module to define up to 32 different events Smart Tags Editor Password Editor Modules Security Audit Trail Use to recieve values of items during runtime. Used when working with extenal databases. Use this module to manage users accounts and assign password, control access level, keys and controls and to use Windows Authorization security. Use this module to assign security levels to each of P-CIM modules Use this module to record changes made to P-CIM modules Message Log History Viewer OPC Browser Use this module to configure operator action messages sent from the Operator Workstation to the Daily Log when plant personnel activate controls (InputText, Slider, and Buttons). Use this module to import CSV files to HIS and HST files and to export records to HIS, HST and OLEDB database and convert HIS formatted files to HST formatted files Use this module to connect to remote OPC servers 1/8/07 22

23 P-CIM 7.70 Basic Training Manual Table 1: P-CIM Modules (Continued) OPC gateway Use this module to configure the OPC gateway settings Dispatcher Maintenance Manager Redundancy Manager Progate Runtime Use this module to configure messages' settings and schedules Use this module to perform maintenance related tasks Use this module to configure redundancy network between two or more P-CIM servers Use this module to run the Progate application Supreme Report Studio Supreme Report Runtime Use the Supreme Report Studio to design and produce PDF based reports based on records retrieved directly from the P-CIM database. Use this module to generate either schedules or on demand reports. Uninstall P-CIM Use this module to uninstall P-CIM. Exercise. Playtime!! In this exercise you will open P-CIM modules and check out their menus and options. Table 2: P-CIM Modules Table (Sheet 1 of 2) Icon Module Questions Answers P-CIM Startup What is the purpose of this module? Which five P-CIM modules are displayed in your computer s task bar during startup? 1/8/07 23

24 Afcon Software and Electronics Ltd Table 2: P-CIM Modules Table (Sheet 2 of 2) Animation Editor What is the purpose of this module? Database Editor INI File Editor Data Scope What is the purpose of this module? How many data block types are there? What is the purpose of this module? Which file opens in the INI File Editor? What is the purpose of this module? P-CIM Shutdown During P-CIM shutdown do all open modules automatically close? 1 Open the modules displayed in the P-CIM Modules table by double clicking on their icons in the P- CIM Group interface. 2 Check out their menus and options. 3 When will each module be used? 4 Write in your answers in the P-CIM Modules table Answers column. 1/8/07 24

25 P-CIM 7.70 Basic Training Manual 1/8/07 25

26 Afcon Software and Electronics Ltd Chapter 3 P-CIM Architecture This section discusses P-CIM architecture, which is built in three layers. In this chapter you will learn. How data arrives from the plant floor to P-CIM How data is processed About the different P-CIM layers and their role in P-CIM 1/8/07 26

27 P-CIM 7.70 Basic Training Manual Project Architecture P-CIM is built in layered format. During runtime, data in the P-CIM project is transferred through the layers bidirectionally. Communications layer, receiving information from the workplace through the PLC and then transferring it to the database server. The following modules are used in this layer: P-CIM Communication Setup Alarm Summary Windows Data Scope Driver Server Database layer, analyzing data, processing events and alarms and sending them to the user. The following modules are used in this layer: Database Server Database Editor Alarm Handler Advanced Alarm Handler Application layer, displaying data and alarms to operators. The following modules are used in this layer: Animation Editor Operator Workstation Report Editor Recipe Editor Basic Server Text File Server Toolbar Editor 1/8/07 27

28 Afcon Software and Electronics Ltd Communications Layer 1/8/07 28

29 P-CIM 7.70 Basic Training Manual Database Layer 1/8/07 29

30 Afcon Software and Electronics Ltd Application Layer 1/8/07 30

31 P-CIM 7.70 Basic Training Manual 1/8/07 31

32 Afcon Software and Electronics Ltd Chapter 4 Project Management Use the Project Setup dialog box to manage the P-CIM project opened from the P-CIM icons group. In this chapter you will learn. * How to create a P-CIM project * About project directories * To define a default project * To backup, delete and restore a project P-CIM software Sub tree for each P-CIM version installed on the operating system Projects for each P-CIM version Sub tree for each project containing a virtual folder for each subject, where each virtual folder when selected in the P-CIM tree, displays its description and real path on the right pane of this window 1/8/07 32

33 P-CIM 7.70 Basic Training Manual Creating Projects The Project Setup window to manage the P-CIM project accessed by clicking the P-CIM Setup icon in the P-CIM Group. This window displays the project tree, which contains all installed P-CIM versions and all P-CIM projects that have been created. Each project is represented in the tree by a folder with the project s name, under which there are subfolders that are displayed as branches containing data for different subfolders By default, project files are saved under the project s folder and not under the subfolders. To use the subfolders, change their path location from the project s path to another directory. 1/8/07 33

34 Afcon Software and Electronics Ltd Workflow for Creating the Yogurt Project Connect the P-CIM plug to the PC. Define the project in the P-CIM Setup dialog box. Install the P-CIM driver and define driver properties. Startup P-CIM. Check communication between the PC and the controller. Define database blocks and aliases. Create the graphical display, add properties to it and then open the Operator Workstation. Add AutoActions to the display or to the Operator Workstation. Define Advanced Alarm Handler tree zones, alarms and history and connect them to the blocks in the database. Define reports, recipes, security, and toolbar. 1/8/07 34

35 P-CIM 7.70 Basic Training Manual Exercise creating the Yogurt project In this exercise you will create a new project named Yogurt. Table 3: New Project Table Field Project name Project description Text Yogurt Yogurt production 1. In the P-CIM Group, double click the P-CIM Setup icon to open the P-CIM Setup dialog box, and then click the Project Setup button to open the Project Setup window. 2. Open the New Project dialog box by either: Right clicking in the tree and selecting New. Clicking the New button on the tool bar. - The Description of the project can be modified in the Properties dialog box. 3. Complete this dialog box using the information in the New Project table. 4. Click the OK button. The name of the project and its description displayed in the window s right pane. The window s title bar displays the default project in use. A project name must be without spaces and have no more than eight characters. 1/8/07 35

36 Afcon Software and Electronics Ltd Exercise changing a directory path In this exercise you will change the Yogurt project s communication directory path. 1. Open the Properties dialog box by either: Expending the Projects menu, expending a project, clicking on the folders and rightclicking and selecting Properties. Selecting the subfolder of the project in the tree, and then clicking the Properties button in the toolbar. Selecting the subfolder of the project in the tree, and in the Edit menu selecting the Properties option. When creating a display folder the following sub directory paths must be modified: PcimACT PcimDRW PcimUPD For example: C:Pcim7.50\Yogurt\Displays 2. Type in a new path (Com) and click OK to confirm. The new directory is displayed in the right pane of the Project Setup window Working with Projects Set the project as default, back it up, restore or delete it once created. Default Projects In P-CIM you can create any number of projects however, the default project is always opened during P-CIM Startup. 1/8/07 36

37 P-CIM 7.70 Basic Training Manual Defining a default project In the Projects Tree, select a project and then either: Right click and choose the Set as Default option. Click the Default button on the toolbar. Open the File menu and select the Set as Default option. The default project s name is displayed in the title bar. Deleting Projects Projects are deleted from the system in the Project Setup window. Deleting a project removes all files from system. Deleting a project 1. Select the project and then either: Right click and select Delete. Click the Delete button on the toolbar. In the File menu, select the Delete option. 2. In the message box that opens, click Yes to remove the project. To delete a default project, first define a new default project and then delete the original one. Backing Up Projects You can backup a project into several disk directories that can be restored. Backup your projects for the following reasons: To save a copy of the project to replace a damaged project. During project development, where projects are periodically saved during the different development stages. To transfer a project to another computer. When backing up a project you can select to backup all the project s directories or to backup specific directories only. During project backup, select the backup location. The default is Pcim32.bak. Project Setup Settings Using the Project Setup module you can modify the settings controlling the functionality and visibility of P-CIM modules. Starting from version 7.50 of P-CIM, you no longer need to modify the switches using the INI files (using the INI File Editor). Many of the frequently used switches are accessible from the P- CIM Project Setup window. 1/8/07 37

38 Afcon Software and Electronics Ltd Exercise changing the Yogurt project s settings Changing project's settings Under each project you find a list of modules and their switches. 1. Expand the Advanced Alarm Handler subfolder. 1/8/07 38

39 P-CIM 7.70 Basic Training Manual 2. Select the Current Alarm Window Size and Position option. Notice the current settings on the right-hand side of the screen. 3. To change the current settings double-click on the left side of the screen. The following window opens: 4. Change the window's position by resizing the window's position or by typing in the window's size and position and click Adjust Window Size and Position for a preview. 5. Click OK to save the settings and close this dialog box. Every switch contains a short description that helps you to change its settings. 1/8/07 39

40 Afcon Software and Electronics Ltd Exercise creating a backup project In this exercise you will create and back up the Yogurt project. 1. Click the P-CIM Setup icon to open the P-CIM Setup dialog box and then click the Backup Project button to open the P-CIM Backup Project dialog box. You can back up large projects into one disk directory: Default and minimum disk size: bytes. Maximum disk size: 2 Giga. 2. In the Select Project to Backup field, click the arrow and scroll to find the Yogurt project. 3. In the Target Folder field, browse to find the folder to which the project will be backed up to. 4. To include alarms and historical data stored on an OLEDB database (MS Access or SQL server), click the Include OLEDB Alarm or include OLEDB History check boxes. 5. Click the Create Backup button. 6. To backup specific folders (and not a whole project), click the Custom button to open the Custom Backup dialog box and select the relevant folders. The default is that all folders are backed up. 7. Click Create Backup. The project is backed up to the target folder. Restoring Projects The last project that was backed up is the suggested project to restore. You can however, select and restore a different project. The Restore Project option can only be activated when P-CIM is not running. 1/8/07 40

41 P-CIM 7.70 Basic Training Manual Exercise restoring the Yogurt project In this exercise you will restore the Yogurt project. 1. Click the P-CIM Setup icon to open the P-CIM Setup dialog box and then click the Restore Project button to open the Restore Project dialog box. From P-CIM version 7.01 and higher, during the Restore process P-CIM converts displays to match the computer s display settings. When the convert process begins, if there are no displays a message informs you that there are no displays. 2. Browse and select the Yogurt folder. 3. Click the Next button. The Restore Setup program runs. If the name of the project exists in the system the second Restore Project dialog box opens. To override a project select the first option and click Next. Restore setup will run and a message box opens telling you the project has been restored. Click OK. To restore the project as a new P-CIM project, select the second option and click Next. The Rename Project dialog box opens. Type in the project name and click the Next button. 1/8/07 41

42 Afcon Software and Electronics Ltd 4. In the message box that opens, select Yes to define the project as the default project, or No not to. Click OK to continue. 5. A new message box opens telling you the Restore Project process was performed successfully. Click OK to exit this option. 1/8/07 42

43 P-CIM 7.70 Basic Training Manual Chapter 5 Designing the Yogurt Project The project that you are about to design is for a large milk products manufacturer. Yogurt, the product has six main production steps. In this chapter you will learn. About the Yogurt project Requirements for building the Yogurt project 1/8/07 43

44 Afcon Software and Electronics Ltd Yogurt Production Workflow Milk arrives at the factory where it is transferred into containers and pasteurized. Fermentation agents are added to the milk. The milk is mixed for 15 minutes. 18 hours later the ph level is checked. The yogurt is mixed with fruit and flavors. The yogurt is cooled in refrigerated containers. The yogurt is bottled and packed. The Yogurt Production Room has two stations and two operators. The operator oversees the yogurt making process through the Operator Workspace interface on the station s computer. The Operator Workspace interface has buttons linking to each production stage and it's substages Requirements for Building an Automation System The following components are used in the Yogurt Project: Communication and drivers, to control production hardware and for data transfer. Aliases, which are text names used as shortcuts for addresses whereby simplifying the process. Database blocks, for comparing values and producing alarms and history: 1/8/07 44

45 P-CIM 7.70 Basic Training Manual Analog value blocks Alarm blocks Graphic displays, which are developed in the Animation Editor and used during runtime to control and display data to and from the plant floor. AutoActions, which are used to add automatic actions. Dynamic displays, which build a faster and more efficient project. Alarms, used to warn the operator of predefined conditions in the process. History and Trends, for saving historical events. Reports, to document the process on a periodical basis. Recipes, which define activities that are performed at specific times. Text file server, enabling reading and writing values from files and the database. Password Editor, to define authorization to the project s displays, controls and menus. Toolbar, to create a tool bar containing the tools used to navigate the project and to perform predefined actions. 1/8/07 45

46 Afcon Software and Electronics Ltd Chapter 6 Communication Layer This chapter discusses the Communication Layer, which supports transmission of data between P-CIM and the plant floor. In this chapter you will learn. * About P-CIM drivers and how they are installed in a project * About P-CIM communication setup * How the Data Scope is used to verify communication between the plant floor and P-CIM * How the Alarm Summary module is used to verify communication between the plant floor and P-CIM 1/8/07 46

47 P-CIM 7.70 Basic Training Manual About the Communications Layer The Communications layer communicates with external devices and transfers data from them to the P- CIM modules. This layer operates in the background and is bidirectional. The communications layer is divided into two: External, which performs two-way communication between port Comms, network devices and controller communication cards and P-CIM. Internal processing layers, which manage the requested items (from the DDE client application) and then transfers this data to the external layer from which it is transferred to the devices. P-CIM Drivers Drivers are installed from the Afcon CD and are the communication protocols used in the application. There are two P-CIM driver types: P-CIM native drivers, (PFWDRVR). OPC drivers, which are not discussed in this manual. Before installing a driver, make sure that P-CIM is not running. 1/8/07 47

48 Afcon Software and Electronics Ltd Exercise installing the Modbus driver In this exercise you will install the Modbus driver into the Yogurt project. 1. Insert the Afcon CD into the CD drive on your computer. Wait for it to open on your screen. 2. Select P-CIM and then select Communication Drivers to open the Communication Drivers dialog box. Drivers can also be downloaded from the AFCON web site and installed in a project through the P-CIM Setup, Install Drivers button. 3. Select the Modbus driver. To view information about the driver, click the Open Documentation button and jump to its documentation. 4. Click the Install Driver button. Setup runs, and the Welcome dialog box opens. 5. Click Next, and Next again to open the Driver Setup dialog box. 6. Select the Yogurt project, and then click Next to continue. At the end of the process, a message opens informing you the Modbus driver has been installed into the Yogurt project. 1/8/07 48

49 P-CIM 7.70 Basic Training Manual Defining Driver Parameters P-CIM Communication Setup Driver parameters are defined in the P-CIM Communication Setup dialog box. Accessing the Communication Setup dialog box 1. Open P-CIM and double click the P-CIM Setup icon to open the P-CIM Setup dialog box. 2. Click P-CIM Communication Setup button to open the P-CIM Communications Setup dialog box. To save the port properties to file, click Yes on the message box that opens. This dialog box has the following fields and buttons: Table 4: Communication Setup Field Assigned ports Description This table lists the ports assigned to the project: Port Indicating the logical port name, which represents the physical devices and their communication parameters in the application. Driver Mode Indicating the port s driver, which is the name of driver as it appears during installation. Indicating the type of mode running: Normal running mode. Emulation mode, whereby the driver does not communicate with field devices, but reads/writes internally. New Properties Opens the Port Properties dialog box where a new port can be assigned to a driver. Opens the P-CIM Configurator dialog box where the physical communication parameters and transport parameters are defined. New Ports A new port is created in the Port Properties dialog box where each driver installed can be assigned to one or more logical ports. 1/8/07 49

50 Afcon Software and Electronics Ltd Assigning a New Port 1. In the P-CIM Communications Setup dialog box, click the New button or press Alt+N to open the Port Properties dialog box. A message box opens. Click Yes to save the changes to the DRVR Port INI file. This dialog box has the following fields: Table 5: New Port Settings Field Port name Driver name Bit numbering system Lowest bit number Emulation mode Description Defines the logical port number. A logical port number can be any number between 1 and 255. This name defines the name of the driver as it appears during installation and must be selected from the field s dropdown list. This field defines the read/write bit access used. For example if Octal is used the digits 8,9 are not available. There are three bit numbering systems: * Octal * Decimal * Hexadecimal The notation used to reference the least significant bit 0 or 1 in the register. Whereby the driver does not communicate with field devices, but reads/writes internally. Fine Tuning Parameters Fine tuning parameters are defined in the P-CIM Configurator dialog box. A different Configurator dialog box opens for each driver type. The P-CIM Configurator dialog box has two sections: Scheduling, which is basically the same for each driver. This section defines the rate of data update, error detection and recovery timing, and polling of specific addresses. Transport, which varies according to the driver. This section can define: Transport type (which is the physical interface) for example, serial or network adapter. Transport parameters; for example, baud rate. 1/8/07 50

51 P-CIM 7.70 Basic Training Manual Defining driver communications fine-tuning parameters 1 In the P-CIM Communication Setup dialog box, select a logical port and either: 2 Click the Properties button to open the P-CIM Configurator dialog box. Or, 3 Select a logical port and then press ALT+P to open the P-CIM Configurator dialog box. 1/8/07 51

52 Afcon Software and Electronics Ltd The Configurator dialog box has the following fields and buttons: Table 6: Fine Tuning Settings Field P-CIM port Description Displays the port selected in the P-CIM Communication Properties dialog box, Assigned Ports field. Scheduling Polling configuration Time-out Default scan time Max retries Min. reconnect Default PLC type When clicked opens the Polling Configuration dialog box. Use polling configurations to define scan time for blocks of driver addresses that are different to the default scan time. The driver waits the defined amount of time for a valid reply from the PLC. It then retries the transaction according to the maximum retries number if a reply is not received or is garbled. The default value is 1-second, ranging from 0.5 to 50 seconds. Defines the default interval between every read action of each address. Default value is 0, indicating continually. Defines the number of communication retries performed before declaring communication failure. A retry is an attempt to send a task to the PLC. Default is 3 retries. The minimum amount of time in minutes the P-CIM driver waits before trying to reconnect to a PLC declared as failed. Default is 1-minute. Defines the number of digits in the default PLC address. Transport Parameters This section of the dialog box opens differently for each driver installed and the connections supported by the driver. However, the following three fields will be displayed: Network type Transport parameters Station parameters This list displays the physical interface supported by the driver. For example, RS232, Ethernet. This button opens the Transport parameters section, which can define: * Transport type (which is the physical interface) for example, serial or network adapter. * Transport parameters; for example, baud rate. This option is used when the PLC number is not only a consecutive PLC number in the network, but also represents other functionalities:, such as an IP address. 1/8/07 52

53 P-CIM 7.70 Basic Training Manual Defining Polling Configurations Use polling configurations to define scan time for groups of addresses that are different to the default scan time. This is useful for reducing overflow and for defining higher priority addresses. Polling block definitions are defined in the Add Polling Configuration dialog box. These definitions are displayed in the Polling Configuration dialog box. Accessing the Polling Configuration dialog box 1. In the P-CIM Configurator dialog box, click the Polling Configuration button. 2. The Polling Configuration dialog box has the following fields and buttons: Table 7: Polling Configuration Field Block PLC Start address Quantity Scan time OnScan Description Block number. This field is automatically filled with a consecutive number. The number of the relevant PLC. The first address in the addresses block. The total number of addresses in the addresses block. Defines the interval between every read action for this block of addresses. This interval is different to the default scan time. The scan time is valid only when addresses are advised. Defines that this block of addresses is constantly scanned according to the block s scan time. This option can overload your system, therefore, only use it when necessary. 1/8/07 53

54 Afcon Software and Electronics Ltd Table 7: Polling Configuration (Continued) Add Opens the Add Polling Block dialog box where Polling Configurations can be defined. Exercise defining driver configurations 1. In this exercise you will assign a port to the Yogurt project and then define communication parameters for it. 2. Follow the instructions on page 49 and define a port using the following parameters: Port Name = 1 Driver Name = Modbus 3. In the Configurator dialog box select the following: Network type = RS Define the Transport Parameters as follows: Transport type = COM port to which the RS232 cable is connected. 5. Define the other parameters according to the PLC definitions. 1/8/07 54

55 P-CIM 7.70 Basic Training Manual P-CIM Syntax for Driver Addresses The format in which communication addresses are mentioned in P-CIM is driver dependent. Using direct access, P-CIM modules can retrieve raw data directly from communication drivers. Direct access addresses are referenced through dynamic data addresses by specifying the Server, Topic and Item as follows: Table 8: Addresses Syntax Field Server name Topic name Item Description DBSR PCIM The item is specified in generic format: Port:PLC:Address:Bit Where: Port number is the assigned P-CIM port used for the data as specified in the P- CIM Communication Setup dialog box. PLC number is the number of the PLC in the PLC network (syntax is driver dependant). Address is the address of the data element (syntax is driver dependant). Bit number is the number of a specific bit in a word or register (syntax is driver dependant). Examples: 2:4:40001:2 refers to bit 2 of register #40001 on PLC #4 that is connected to Port #2. 1:1:10001 refers to input #10001 on PLC #1 that is connected to Port #1. DDE is a Microsoft protocol that enables data exchange between two different programs. For example, P-CIM and Excel. 1/8/07 55

56 Afcon Software and Electronics Ltd Checking Communications Communications between P-CIM and the PLC are constantly tested during project development. Therefore, always check communications when you start to develop your project. The following tools are used to check communications between the PLC and the PC: Data Scope Alarm Summary Data Scope During project development the Data Scope can be used to monitor and modify values and status of up to 16 data items of a specific server and topic. This module can also be used after project development when installing and integrating the project in the workplace. In the communications layer the Data Scope is used to: Check communication between P-CIM and the PLC. Check and modify the values of data as quickly and efficiently as possible. Working in the Data Scope Opening the Data Scope 1. Start up P-CIM and then double click the Data Scope icon in the Tools icons group. 1/8/07 56

57 P-CIM 7.70 Basic Training Manual When the OK field is checked this indicates that the item is valid. The Server and Topic names are displayed in the Data Scope title bar. Server default name = DBSR Topic = PCIM. Exercise - working in the Data Scope In this exercise communication between P-CIM and the PLC are tested using the Data Scope. Table 9: Item Addresses Table Address Number Item Addresses 1 1:1: :1:40001:1 3 1:1:1 1. Open the Data Scope. 2. In the Item field, type the first item address from the Item Addresses table. 3. Click OK. 1/8/07 57

58 Afcon Software and Electronics Ltd Scan, indicates that a database block is being scanned AEnb, indicates that a database block alarm is enabled AAct, indicates that the alarm condition of a database block is active Ack, indicates that the database alarm has not been acknowledged OK, indicates that the item is valid 4. Check that the Value field is filled and that the OK checkbox is checked. 5. In the Item field, insert the second and third item addresses from the Item Addresses table. 6. Click OK and check the results. 7. In the File menu select the Save option to save the items. These items are displayed the next time that the Data Scope is opened. The Value field is constantly updated with new values sent from the server. In the Options menu, select Always on Top to always display this window on top of other programs Alarm Summary - System Messages System messages display events occurring in P-CIM modules. For example: Success/failure status of module initialization. Communication between P-CIM and a device. Communication between P-CIM nodes (in a networked application). Viewing system messages 1. On your computer task bar, click the Alarm Handler icon and select Alarm Summary to display the System Messages window. The data in the Alarm Summary is written into the Daily Log file. 1/8/07 58

59 P-CIM 7.70 Basic Training Manual When the Alarm Summary first opens on your screen, move the side ruler to the top to view all the system messages in the list. This list can be customized in the Options menu. For example, to display node numbers or to modify font type. During P-CIM startup Alarm Summary messages are renewed. Previous messages can be viewed in the Daily Log. To view them, in the Alarm Summary window open the File menu and select the Show Daily Log option. 1/8/07 59

60 Afcon Software and Electronics Ltd 6.1 Communications Layer Troubleshooting Error Messages Indicating Problems during Initialization of the Driver Problem The above messages indicate that the server cannot locate or has failed to open a COM port or that there is no COM port. Workaround Open the Driver Configurator dialog box and check that the defined COM port exists on your PC. Start up P-CIM. Problem The COM port is being used by another software program. Workaround Shut down the open software and try connecting again. 1/8/07 60

61 P-CIM 7.70 Basic Training Manual Error Messages Indicating Writing to an Undefined Memory Range in the PLC Problem This error message is displayed when the requested PLC address is not defined in the PLC. Workaround Check if this address is defined in the PLC. Error Message Indicating Communication Failure Problem This error message is displayed when the driver does not receive a response from the external device. Workaround Check the physical connections, such as the cable and power. Check communication parameters in the Driver Configurator dialog box, such as COM port and baud rate. 1/8/07 61

62 Afcon Software and Electronics Ltd 1/8/07 62

63 P-CIM 7.70 Basic Training Manual Chapter 7 Defining Data Items This chapter discusses the variables that are created in aliases and used in the Yogurt project. In this chapter you will learn. About the INI File Editor About aliases About the Syntax Manager 1/8/07 63

64 Afcon Software and Electronics Ltd 7.1 Aliases Aliases are text names used as shortcuts for addresses. Aliases should always be defined at the beginning of project development. When developing a project it is recommended to use aliases for textual names of addresses. Since aliases are easily replaced and modified, this saves time in project maintenance. Aliases are saved under the project in the PFWALIAS.TXT file under the virtual Utilities folder. After an alias is created it can immediately be incorporated into a P-CIM project. In the application an alias is held between the characters & &. For example, the alias: &PcimPath& refers to: xx:\pcim32\ where the P-CIM installation is saved. An alias name can contain up to 255 characters and can include most printable characters including spaces. An alias is not case sensitive. The following characters cannot be used: = ^ & P-CIM has a number of built in aliases, which can be viewed in the Syntax Manager when the Aliases option is selected. 1/8/07 64

65 P-CIM 7.70 Basic Training Manual 7.1 INI File Editor The INI File Editor can be used to create, modify and/or delete your project s INI files and aliases. INI files hold P-CIM and P-CIM project parameters. In specific circumstances, these parameters can be modified in the INI File Editor. Accessing the INI File Editor To open the INI File Editor, double click on the group. INI File Editor icon in the P-CIM Development File Path, when clicked opens the Browse dialog box where another.ini file can be selected. By default, the PFWALIAS.TXT file is displayed. To add a section and token 1. In the Section field, type in the name of the new section. 2. In the Token field, type in the name of the new token. 3. In the String field, type in the name of the new string. 4. Click the Add Section button to add the section the INI file. To modify a token 1. Click the File Path bar and browse to select a Section. 2. Select the Token from the Settings list and update the string. 3. Click the Change button to update the string. 1/8/07 65

66 Afcon Software and Electronics Ltd Exercise - creating and testing an alias In this exercise you will define the aliases used in the Yogurt project using the information in the Aliases table. 1. Open the INI File Editor. By default, the PFWAlias.TXT opens displaying the Aliases section. 2. In the Token field, type in PLC. 3. In the String field, type in 1:1: 4. Click Add to add the alias to the Alias list. 5. Create all the aliases in the Aliases table using the information in the P-CIM Alias Name and Alias Reference columns. Table 10: Aliases Table P-CIM Alias Name Alias Reference Data Type Data Description PLC 1:1: PLC number Temperature Analog Temperature SetTemp Analog Set temperature Valve_ALM Analog Valve alarm TLevel_ Analog Tank level for TK 1 TLevel_ Analog Tank level for TK 2 Pressure Analog Production line pressure Tsouring_ Analog Souring agent Tsouring_ Analog Souring agent Tfruit_ Analog Fruit quantity Tfruit_ Analog Fruit quantity Cleaning Analog Cleaning quantity Barcode Analog Flavor code Valve_3V101 1 Digital Valve No: 3V101 Valve_3V102 2 Digital Valve No: 3V102 Valve_3V103 3 Digital Valve No: 3V103 Valve_3V201 4 Digital Valve No: 3V201 Valve_3V202 5 Digital Valve No: 3V202 Valve_3V203 6 Digital Valve No: 3V203 1/8/07 66

67 P-CIM 7.70 Basic Training Manual Table 10: Aliases Table (Continued) TMix_1 11 Digital Mixer tank 1 TMix_2 12 Digital Mixer tank 2 CleaningAct 13 Digital Cleaning process 6. Open the Data Scope and enter the following: &plc&&temperature&. To view an alias in the Data Scope, in the Options menu select Alias Show. 1/8/07 67

68 Afcon Software and Electronics Ltd 7.2 Syntax Manager The Syntax Manager is a tool that holds the following information: P-CIM system blocks, variables and functions. User defined aliases and blocks. Expressions, which are not discussed in this manual. When an item is selected in the Syntax Manager the syntax that is used in the project for the item is displayed. To access the Syntax Manager double click the Group. Syntax Manager icon in the P-CIM Development 1/8/07 68

69 P-CIM 7.70 Basic Training Manual Clicking F2 when working in any P-CIM module opens the Syntax Manager. Selecting a field, clicking the Shift key and then pressing the Help button opens P- CIM Help. This dialog box has the following fields: Table 11: Syntax Manager Module Section Syntax tool bar Syntax separators Edit Workspace Insert Description When a button in this bar is clicked, it is added to the currently created item s syntax. There are two syntax separators:, Comma that is used as a list separator. ; Semi-colon which is used as a commands separator. This section has the following options: Expression DDE address Item This section is used to create the item s syntax. The options in this section contain item types from different servers, and aliases and commands. When an option in this section is clicked its items list is displayed. Dbsr Pcim Gdisplay Pcim Pfwalarm Pcim Aliases Commands When clicked displays the following items: Blocks, when clicked displays the database server blocks defined by the user. $Variables, when clicked displays database server $Variables. Functions, when clicked displays database server functions. This option, when clicked displays Operator Workstation items. This option, when clicked displays Advanced Alarm server items. This option, when clicked displays user defined and built in aliases. This option, when clicked displays commands, files and dbase functions. dbase functions Description Check When checked this field displays built in application expressions. When an expression is selected, it can be added to the string and items in the workspace. When an item is clicked its description is displayed in this field. When this button is clicked, it checks that the syntax is legal. When syntax is illegal, a message opens informing you how to correct it. 1/8/07 69

70 Afcon Software and Electronics Ltd Table 11: Syntax Manager Module (Continued) Apply When clicked, applies the content of the Edit section into the field of the dialog box from which the Syntax Manager was opened Syntax Legend The following symbols are used in the Syntax Manager Description field. Table 12: Syntax Legend Syntax Description {} The information in these brackets is mandatory. [] The information in these brackets is optional. {XX YY ZZ } [XX YY ZZ] DDE Select one of the parameters in the brackets between each separator. Select one of the parameters in the brackets between each separator. The DDE reference: SERVER TOPIC ITEM. These symbols are not part of commands. To View the Aliases List in the Syntax Manager 1. Double click the Syntax Manager icon in the P-CIM Development group to open the Syntax Manager interface and then click Aliases. Or, 2. Press the F2 key on your keyboard. 1/8/07 70

71 P-CIM 7.70 Basic Training Manual Chapter 8 Animation Editor The Animation Editor is used to develop the graphical display of a P-CIM project. A display is a collection of objects illustrating the plant floor and its devices. It can show data and can also receive operator input. During runtime, the display is shown in the Operator Workstation on the operator s station, and acts as an interface between the operator and the plant floor. In this chapter the names OBJECT and GRAPHICAL OBJECT both refer to the image that is created in the Animation Editor interface. In this chapter you will learn how to. * Create a new graphic display * Define display settings * Draw objects and or add clipart objects * Add properties to an object * Create and edit cells * View the object in the Operator Workstation Create the graphical display Add properties to objects Add functions to objects Add $variables to objects Open the Operator Workstation and check the display in runtime 1/8/07 71

72 Afcon Software and Electronics Ltd 8.1 The Animation Editor Interface Accessing the Animation Editor In the P-CIM Development Group, double click the Animation Editor icon. When first accessed the Animation Editor opens displaying the following: Title bar, showing the name of the module, project, and display names Menu bar, holding the Animation Editor menu options Toolbox, displaying the animation tools The display name in the title bar is updated when you save your display. An * asterisk appears in the Animation Editor title bar after changes have been made in a display. The * disappears after the display is saved Toolbox The Toolbox is displayed when the Animation Editor opens. Its tools are used for creating the graphical display. 1/8/07 72

73 P-CIM 7.70 Basic Training Manual Selection tool Table 13: Animation Editor Tools Toggles between the Toolbox and the Clipart Library Line tool Square tool Round edged square tool Circle tool Rotating tool Zoom out tool Restore zoom tool Zoom in tool Text tool Color fill tool Line style tool Displays the current color/line/text selection Line (L), Text (T), Background (B), and Fill (F) Color tool Color palette Selected Object Signs When working in the Animation Editor you will see the following selection squares: This square indicates a selected object without properties This square indicates a selected object that has properties This square indicates multiple selected objects 1/8/07 73

74 Afcon Software and Electronics Ltd This square indicates the object is a cell Creating a New Display The first step in this stage of project development is to create a display: A display is created in an empty window where the objects representing the devices on the plant floor are drawn. Each display can have customized settings, for example; how it is opened in the Operator Workstation during runtime. To improve accuracy when drawing objects, a grid can be defined and displayed in the interface. The module s status bar can be defined to display the type, size and location of selected objects. Exercise - creating a display In this exercise you will change the background color of the display. You will also add the Grid option to help you align objects as you work. 1. In the Animation Editor interface, select New to open a new display and then in the Display menu select Style to open the Display Style dialog box. 2. Change the background color of the display by clicking the Color button and then selecting any new color from the Color palette. 1/8/07 74

75 P-CIM 7.70 Basic Training Manual 3. Click OK to confirm and to exit the dialog box. 4. Add a grid to the display, from the Options menu select the Grid option and then define grid properties. 1/8/07 75

76 Afcon Software and Electronics Ltd 8.2 Drawing a Graphical Object Graphical objects are either drawn using the toolbox tools or copied from the Clipart Library. Objects can be edited, cut/copied/pasted, rotated, resized, grouped and aligned Basic Information Below is basic information that can help you to create your display. Selecting an object Click the Selection tool in the toolbox and then click on an object. After the object is selected, it is surrounded by selection squares. Selecting multiple objects Using the Selection tool either: Draw around the objects. Hold the Shift key and then click each object. The selected objects are surrounded by squares. Saved objects To save objects, from the File menu select either: Save Save As Save All When a display is saved, two files are created: DRW files holding graphics UPD files holding updated data An * asterisk appears in the Animation Editor title bar after changes have been made in a display and disappears after the display is saved. Rotating an object 1. Select an object. 2. From the toolbox, select the Rotating tool. The selection action square appears in the middle of the object. 1/8/07 76

77 P-CIM 7.70 Basic Training Manual Not all Clipart buttons can be rotated. 3. Place your cursor in the object next to the selection square and slowly turn the object. Copying, cutting, and pasting objects Use the Edit menu options, right click menu, and/or Ctrl keys to copy/cut /paste objects. A short cut to copying/pasting an object is to select the object, press the Shift button and to drag the object to another location where it is automatically pasted in. Grouping and ungrouping graphical objects When working with many objects it is convenient to group all objects into one. 1. Using the Selection tool, draw around the objects of the group. Or, Using the Selection tool, hold the Shift button and click on each object in the group. The selected objects are surrounded by the multiple selection squares. 2. Either right click and select the Groups option or, in the Change menu select Arrange, and then select the Group option. The objects are grouped into one object. 3. To ungroup the group: Select the group, in the Change menu select Arrange, and then select the Ungroup option. An object looses all its properties when it is added to a group. Resizing objects To resize an object proportionally, select the object and then drag one of its corners either in or out. To change the objects width, select an object and then drag one of its sides either in or out. To change the height of an object, select the object and then drag the top or bottom of the object 1/8/07 77

78 Afcon Software and Electronics Ltd up or down. Moving objects To move objects either: Click in the middle of the object, and then drag it to a new location in the Animation Editor interface. Click in the middle of an object and press the Shift key. Your mouse curser changes into a cross. Keep pressing the Shift key and then press the relevant direction arrows on your keyboard. To move more than one object: ªSelect the objects and then click in the middle (of the selected objects) and drag them to their new location. Setting object order Use this option to select a graphical object and to then send it to the back or front of a display. Select an object. In the Change menu select the Order option and then either: Select Move to Front so that the object is displayed in front of other objects. Select Move to Back so that the object is displayed behind other objects. You can also select an object and then right click and select either Move to Back or Move to Front. Aligning objects When working in a display you can align objects automatically. 1. Select the objects to be aligned. 2. Either right click and select the Align option or, in the Change menu select the Align option to open the Align Objects dialog box. 1/8/07 78

79 P-CIM 7.70 Basic Training Manual Working with a grid may help you. From the Options menu select Grid and then define grid parameters. 3 Click the alignment type. The selected graphical objects are displayed accordingly. 4 Click the Close button to exit this option. Status Bar The status bar is displayed when the Status option is checked in the Options menu. To view the status bar, check that the Task Bar does not cover it by clicking the reduce the size of the window. Restore button to To move an object, select it and press the Shift button. Then press the keyboard s left/right/up/down arrow keys. 1/8/07 79

80 Afcon Software and Electronics Ltd Undo To undo your last action, from the Edit menu select the Undo option, or right click and select Undo, or use the Ctrl + Z key. Adding text to a display Select the Text tool from the toolbox. The Create Text dialog box opens. 1. Type in the new text. 2. To modify the Font, click the Font button to open the Fonts dialog box. Modify the text style and then click OK to save the new definitions. The next time you add text to a display, the new font parameters are displayed. To change text color, select the text and in the Color Fill Commands button click the T button. Select a color from the color palette. The color of the text is updated with the new color. From P-CIM version 7.01, a font option can be disabled. This feature is useful when a group of text is selected and not all the font options are required. For example, the font type can be replaced without changing size. When selecting a clipart object some objects have larger selection squares indicating that they are cells. 1/8/07 80

81 P-CIM 7.70 Basic Training Manual Viewing/searching and replacing objects 1 From the Windows menu, select the List Animation option. This list can also be saved into a CSV file in the Animation Editor s UPD directory. To do so, click the Save button.shortcut Keys The following keys can also be used: Ctrl + X, cuts graphical objects from a display. Ctrl + C, copies graphical objects from a display. Ctrl + V, pastes graphical objects into a display. Ctrl + Z, undoes the last action. Ctrl + -, moves a graphical object to the back. Ctrl + +, moves a graphical object to the front. 1/8/07 81

82 Afcon Software and Electronics Ltd Exercise working in a display In this exercise you will draw a basic display using the objects described in the Working in a Display table and the instructions below. Once selected, the pencil can draw any number of shapes. To return to normal mouse mode, click on a different tool in the toolbox or, select an option from one of the menus. Table 14: Working in a Display Table Object Square 1 Square 2 Clipart object 1 Clipart object 2 Description Orange, line width 4 pixel Gradient colors of orange and yellow Blower from the Symbol Library Tank from Instruments Library 1. In the toolbox, click the Square tool. Your mouse cursor changes shape into a pencil. Using the pencil, draw two squares. 2. Select the first square, and then select the Color Fill Commands button from the toolbox. Click the F button and then click the Color Fill button to open the Colors dropdown list. Color the square orange by clicking Solid and then choosing an orange color from the color palette. 3. Select the second square, and then select the Color Fill Commands button. Click the F button, and then click the Color Fill button to open the Colors dropdown list. 4. Add a gradient color by clicking the Gradient button and selecting a gradient pattern. Click the 1/8/07 82

83 P-CIM 7.70 Basic Training Manual Close button. The object is filled in gradient shades of orange. 5. To add a second gradient color, in the Color Fill Commands button click the B button and select a yellow color from the color palette. 6. Select the first square and then click the Line Definitions tool to open a dropdown list. Select the Width option and change the line s width to 4 pixels. 7. Add a clipart object, by clicking the Toggle button to display the Clipart icons. Click the Symbol Factory icon to open the Symbol Factory Clipart library. In the Categories field, scroll and select the Blowers category and then choose a blower. Double click, or click the Copy button to automatically return to the Animation Editor interface and paste the object into the display. Click the Instruments icon in the Clipart Library and select a tank. Click on an object and then slowly drag it into the Animation Editor interface. Exercise creating the Arrival display The display below illustrates how milk tanks are received at the Yogurt plant. In this exercise you will use the toolbox tools and clipart to draw the display s graphical objects. At the end of the exercise your drawing should look similar to the one below. 8. From the Display menu, select Style to open the Display Style dialog box. Change the background Color to light blue. Table 15: Arrival Display Properties Object Description 1 Light blue background 2 Clouds from Clipart Symbols Factory, Nature Library 3 Olive green mountain from Clipart Symbols Factory, Nature Library 4 Gray building from Clipart Symbols Factory, Buildings Library 5 Big gray rectangle 6 Gray building from Clipart Symbols Factory, Buildings Library 1/8/07 83

84 Afcon Software and Electronics Ltd Table 15: Arrival Display Properties (Continued) 7 Brick pattern from Clipart Symbols Factory, Textures Library 8 Truck from Clipart Symbols Factory, Vehicles Library 9 Thick bland line 10 Brick wall from Clipart Symbols Factory, Textures Library 11 Text Reception Font type Trial bold Font size 10 Font color Black 1. Select a cloud from the Clipart Nature Library and copy and paste it in the top of the display. 2. Select a mountain from the Clipart Nature Library. Change its color to olive green by clicking on Options to open the Options dialog box. Change the Fill Color Mode to Solid, and then click on Fill Color and select the color olive green. Copy the mountain and paste it in the top part of the display in the middle. 3. Select a building from the Clipart Buildings Library. Copy and paste it into the upper right side of the display. Resize it so that it is proportional to the display. 4. Draw a rectangle, color it gray and resize it so that it covers two thirds of the display s height and stretches all of its width. Move the rectangle to the bottom of the display. 5. Select another building from the Clipart Buildings Library. Copy and paste it into the upper left side of the display (on top of the gray rectangle) and then resize it. 6. Select a brick pattern from the Clipart Textures Library. Copy and paste it into the left side of the display in the middle. Resize as required. 7. Select a truck from the Clipart Vehicles Library. Open the Options and in the Orientation field select Horizontal. Click OK and then copy and paste the truck into the display next to the brick wall. Select the truck, from the Change menu select Order and then select the Send to back option. 8. Draw a vertical black line, change the width to 4 pixels and resize it so that it stretches across the display. Move it under the brick wall. 9. Copy the brick wall and paste it under the black line. Copy and paste the pattern until you have a brick wall across the bottom of the display. 10. Click the Text tool to open the Text dialog box. Type in the word Reception and customize the text font. Click OK and then drag the word to the building on the left above the truck. Save the display as Arrival. 1/8/07 84

85 P-CIM 7.70 Basic Training Manual 8.3 Properties When Properties are added to an object they define how the object is displayed and acts during runtime. There are three types of properties: Indicator properties, defining how an object is displayed. Control properties, defining how an object acts during runtime. Special properties, defining how data and history about the object are displayed Adding Properties to Graphical Objects After properties are added to an object, the object becomes dynamic and is displayed in the Operator Workstation. Graphical objects can be displayed during runtime as either: Static, representing devices on the plant floor. Dynamic, displaying/controlling information about devices during runtime. The object s properties are linked to the communication address of the device. During runtime the object is displayed according to the assigned property and to the device s status. For example, an object can have properties that cause it to change color when a specified event occurs during runtime. An object that has properties assigned is known as an updated object. When defining properties the communication address is defined in DDE Format: Server Topic Item. Property References * The MYSID (My Symbol Id) token is used to reference the object name that is defined in the Symbol Id field in the following property types: In a control - in the prompt. In an action button - in the action definition. In any other animation property - in the server, topic or item. * The MYDID (My Display ID) token][can be used instead of writing the name of the display. Accessing the Properties List dialog box Select an object and open the Properties List dialog box by either: Double clicking on the object. Right clicking on the object and selecting Properties List. Using the Ctrl + P key. Selecting the object and then from the Update menu selecting Properties List. 1/8/07 85

86 Afcon Software and Electronics Ltd The Visibility Property The Visibility property, when added to an object, defines how the object appears in the Operator Workstation. During runtime, an object can be visible, invisible, or blink according to the object s item value, which can be either: 0 (Off) or any number other than 0 (On). Exercise creating an object that blinks In this exercise you will create two tanks. Each tank will have a circular window that has the Visibility property assigned. At runtime, the tank s windows blink when Yogurt is mixed. 1. Open a new display and save it as Product. Table 16: Visibility Table Object and Parameters Description Circular Window Parameters Object Circle Color Line Line width White Black 4 pixel Property Visibility 1/8/07 86

87 P-CIM 7.70 Basic Training Manual Table 16: Visibility Table (Continued) Visibility Definitions Symbol Id TMix_1 TMix_2 Server DBSR DBSR Topic PCIM PCIM Item &PLC&TMix_1& &PLC&TMix_2& When off Visible Visible When on Blink Primary = White Alternate = Black Blink Primary = White Alternate = Black Text for Tank 1 Text for Tank 2 3TK1 3TK2 2. Define the background color. 3. Open the Tanks category from the Clipart Symbols Factory and copy and paste a tank into your display. 4. Draw a circle to represent the circular window. Add the Circular Window Parameters that are defined in the Visibility table to the circle. Move the circle to the top section of the tank. 5. Add the following text to the tank: 3TK1 6. Add the Visibility property to the circular window. Double click the circle and then click the Visibility button to open the Visibility dialog box. When adding visibility to a clipart object bitmap, always ungroup the object, fill the object with the blink color and then add visibility. The color of the object must be the same color as the primary color otherwise; it will blink in a different color. You can also scroll the color palette by clicking either the Primary or Alternate buttons. 1/8/07 87

88 Afcon Software and Electronics Ltd 7. Add the Symbol Id and DDE Item using the information in the Visibility table. 8. Click the Blink Colors button to open the Blink Colors dialog box. 9. Click the Primary button and select the color white from the color palette and then click the Alternate button and select the color black. Click the Add button to add these colors to the list. Click OK to save the definition. 10. Duplicate the tank. 11. Save the updated display and then open the Operator Workstation by either: * From the File menu selecting the Operator Workstation option. * Using the Ctrl + W shortcut key. 12. In the Operator Workstation File menu, select Open to access the Open File dialog box and then select the Product file from the list. Click OK. The display opens. 13. Open the Data Scope and in the Item field type &PLC&&TMix_1& and then enter the value 1 and click OK. 14. Return to the Operator Workstation and check that the circular window blinks. The color combinations in the Blink List are global throughout the project. This means that: * When a primary color is defined, all objects that have this primary color will blink with the same alternate color combination. * The color of an object and its blink primary color must be the same. * When a color in a combination changes, restart the Operator Workstation to view these changes. 1/8/07 88

89 P-CIM 7.70 Basic Training Manual The Fill Color Property The Fill Color property causes an object s color (in the Operator Workstation display) to change when the object s values change during runtime. Exercise creating an object that changes color In this exercise you will create six valves where each valve has the Fill Color property. During runtime when the valve is active, it changes color to green. Check that P-CIM is running before opening the Operator Workstation. Using the picture on page 86 as an example, add a valve and piping to the mixer tanks. 1. Double click Valve 3V101 to open the Properties List dialog box. Table 17: Fill Color Property Table Object Valve Pipes Description Valve category from Clipart Symbol Library. Pipes category from Clipart Symbol Library. 1/8/07 89

90 Afcon Software and Electronics Ltd Table 17: Fill Color Property Table Valve text 3V101 Symbol Id &PLC&&Valve_3V101& 3V102 3V103 3V201 3V202 3V203 &PLC&&Valve_3V102& &PLC&&Valve_3V103& &PLC&&Valve_3V201& &PLC&&Valve_3V202& &PLC&&Valve_3V203& Property Server Topic Fill Color DBSR PCIM Item Color by Digital value Digital value colors Colors Red Green 2. Click on the Fill Color button to open the Fill Color dialog box. 3. Fill the Symbol Id, Server and Topic fields using the information in the Fill Color Property table. These instructions can also be used to define: Text color, whereby text changes color during runtime. Line color, whereby the line changes color during runtime. 4. Click the Digital Value option to open the next dialog box. 1/8/07 90

91 P-CIM 7.70 Basic Training Manual 5. In the Colors field, click the 0 button and select red from the color palette. 6. Click the 1 button and select green. 7. Click OK to return to the Fill Color Properties dialog box. 8. Create the valve text using the information in the Fill Color Property table. 9. Define the other five valves using the instructions above and the information in the table. 10. Save the updated display and then open the Operator Workstation by either: From the File menu selecting the Operator Workstation option. Using the Ctrl + W shortcut key. 11. In the Operator Workstation File menu, select Open to access the Open File dialog box and then select the Product file from the list. Click OK. The display opens. 12. To update/refresh an opened display, from the File menu select the Revert to Saved option or press the Alt + F + T key The Fluid Fill Property During runtime, the value of the object is displayed as a fluid level in the Operator Workstation. 1/8/07 91

92 Afcon Software and Electronics Ltd The fluid fill property cannot be used with Text, Action Buttons, Sliders, Orientation properties and Trends. In addition, gradient colors cannot be used. Exercise - creating an object displaying fluid fill In this exercise, the Fluid Fill property is added to the fluid measurement bar on the mixer tanks to display the milk level in the tank. 1. Draw a rectangle using the Square tool. Place the rectangle vertically on the right side of 3TK1. 1/8/07 92

93 P-CIM 7.70 Basic Training Manual Table 18: Fluid Fill Property Table Field Rectangle Symbol Id for tank 1 Symbol Id for tank 2 Property Server Topic Item for tank 1 Item for tank 2 Description Square from toolbox TLevel_1 TLevel_2 Fluid Fill DBSR PCIM &PLC&&TLevel_1& &PLC&&TLevel_2& Min. value Max value Min. object fill Max object fill 100 Direction Style Up Bar 2. Double click the rectangle to open the Properties List dialog box. Click the Fluid Fill button to open the Fluid Fill dialog box. 1/8/07 93

94 Afcon Software and Electronics Ltd 3. Fill this dialog box using the information in the Fluid Fill Property table. 4. Copy and paste the rectangle and its properties onto 3TK2. 5. In Tank 3TK2 change the Item to &PLC&&TLevel_2&. 6. Click OK to save and exit this dialog box. 7. Save the updated display and then open the Operator Workstation by either: From the File menu selecting the Operator Workstation option. Using the Ctrl + W shortcut key. 8. In the Operator Workstation File menu, select Open to access the Open File dialog box and then select the Product file from the list. Click OK. The display opens. 9. To update/refresh an opened display, from the File menu select the Revert to Saved option or press the Alt + F + T key The Orientation Property During runtime, the Orientation property displays movement in a device. For example, wheels turning during a process. Exercise adding the Orientation property In this exercise the Orientation property is added to the production line s pressure meter. 1/8/07 94

95 P-CIM 7.70 Basic Training Manual 1/8/07 95

96 Afcon Software and Electronics Ltd 1. Using the toolbox and Clipart copy and paste a clock and move it to under the lowest pipe. 2. Double click on the clock hand to open the Properties List dialog box. 3. Click the Orientation button to open the Orientation dialog box. Table 19: Orientation Property Table Field Square Clock Clock hand Symbol Id Server Topic Description Toolbox Clipart Clock Library Clipart Clock Library &PLC&&Pressure& DBSR PCIM Item At start Value 0 Angle 90 At end Value 10 Angle 360 Direction Clockwise Pivot displacement 5 4. Complete this dialog box using the information in the Orientation Property table. 5. To view Orientation properties during runtime, save the updated display and then either from the File menu select the Operator Workstation option or, use the Ctrl + W key. 6. To update/refresh an opened display, from the File menu select the Revert to Saved option or press Alt + F + T The Output Text Property During runtime the values of an item can be displayed either as text or numbers. When the value of an item changes on the plant floor, the display in the Operator Workstation is automatically updated with these new values. The value displayed can be customized and shown in different formats. For example, date and time format, integer and real format, upper or lower case character format or, a numerical value that can be displayed as customized text. 1/8/07 96

97 P-CIM 7.70 Basic Training Manual Exercise displaying numbers and text during runtime In this exercise you will create six text objects and add the Output Text property to them to indicate the status of each valve in text format. 1. Using the toolbox Text tool, create a text object that has five characters and move it next to Valve 3V Double click the text object to open the Properties List dialog box. Table 20: Output Text Property Table Field Description 6 text objects 5 characters 1/8/07 97

98 Afcon Software and Electronics Ltd Table 20: Output Text Property Table Symbol Id &Valve_3V101& &Valve_3V102& &Valve_3V103& &Valve_3V201& &Valve_3V202& &Valve_3V203& Server Topic Item Text for On Text for Off DBSR PCIM &PLC& Open Close 3. Click the Output Text button to open the Output Text dialog box. The number of characters typed in the Format field is the number of characters displayed in the text box in the Operator Workstation during runtime. 4. Fill the Symbol Id, Server, Topic and Item fields using the information in the Output Text Property table. 5. Click the Text for On/Off option. The Command/Indication section opens. 1/8/07 98

99 P-CIM 7.70 Basic Training Manual 6. In the Indication On field, type Open. 7. In the Indication Off field type Close. 8. Click OK. * The number of characters in the Format field is displayed next to it. This defines the number of characters that are displayed during runtime. * Remember that a full stop/decimal point is also a character. For example, 1.2 is three characters. 9. Create five more text objects using the instructions above and the information in the Output Text Property table. 10. To view output text properties during runtime, save the updated display and then either from the File menu select the Operator Workstation option or use the Ctrl + W key. 11. To update/refresh an opened display, from the File menu select the Revert to Saved option or press Alt + F + T The Input Text Property During runtime, the operator can control processes remotely by writing values to objects. Current and new values are displayed in the Input Text field. When input text is defined, the Output Text dialog box is automatically filled with the same definitions. Exercise modifying numbers and text during runtime In this exercise you will create two tables both with two columns and with three rows. You will then add the Input Text property to each row s text. During runtime, the operator can enter values into the table to control the amount of souring agent, fill level and fruit quantity added to the tanks. 1/8/07 99

100 Afcon Software and Electronics Ltd 1/8/07 100

101 P-CIM 7.70 Basic Training Manual Table 21: Input Text Table Field Description 2 tables Built from one Frames Clipart rectangle, copied and pasted six times and arranged and grouped Column 1 text Souring Fill level Fruit 6 text objects 4 characters Symbol Id &plc&&tsouring_1& &plc&&tlevel_1& &plc&&tfruit_1& &plc&&tsouring_2& &plc&&tlevel_2& &plc&&tfruit_2& Server Topic DBSR PCIM Item Free format text 4 characters 1. Create a table with two columns and three rows using the information in the Input Text table. 2. Create three text objects named Souring, Fill level and Fruit and position them in the first column where each text object is displayed in a different row. 3. Create a new text object that has four characters. Move it to the table s first row, second column. Open the Properties List dialog box. 4. Click the Input Text button to open the Input Text dialog box. 5. Complete this dialog box using the information in the Input Text table. 6. Click OK. 7. Using the instructions above and the information in the Input Text table. Create Input text for Fill level and Fruit. 8. Duplicate the table and its contents and place it next to Tank 3TK2. 9. Update the Symbol Ids for each Input Text property. 10. Save the display. When selecting Format type, check that the number of characters matches the number of characters in the text that you have written in the text object in the display. If this number is higher, the extra characters will not fit in the text box. 1/8/07 101

102 Afcon Software and Electronics Ltd The Slider Property A slider enables an operator to change analog values in a device by dragging an object that has slider properties. Slider position can be changed according to the value changes in the device. If the Position property is used together with Slider property, the new slider position is displayed in the Operator Workstation. For the slider to work, both the Value and Position fields in both the Slider and Position properties must be identical. When selecting a slider from the Slider Clipart Library, remember that the slider has two sections that are not grouped. Exercise displaying an object s slider during runtime In this exercise you will add the cleaning materials tank and its pipes. A slider is positioned next to the cleaning tank. The Slider property will be assigned to the slider handle, enabling the operator to control the amount of cleaning liquid used during the cleaning process. The Position property is also added, so that the slider handle can be used to define the slider s position according to the slider s current value. Text with the Input property will be added to the tank s window as an additional control option for the operator. 1/8/07 102

103 P-CIM 7.70 Basic Training Manual 1. Using the information in the Slider Properties table, add the cleaning tank, pipes and slider objects to the display. Table 22: Slider Property Table Field Materials tank Pipes Slider Property 1 Property 2 Symbol Id Topic Item Only when released Description Tanks Clipart Library. Pipes Clipart Library. From either the Sliders Clipart Library or drawn using the toolbox tools. Vertical Slider. Vertical Position. &PLC&&Cleaning& PCIM II Selected Input text for cleaning tank window Symbol Id Server Topic Item &Cleaning& Dbsr Pcim &PLC& 2. Select the slider handle and click the Properties List dialog box. 3. Click the Slider Vertical button to open the Vertical Slider dialog box. 1/8/07 103

104 Afcon Software and Electronics Ltd 4. Fill the Symbol Id, Server, Topic and Item fields using the information in the Slider Property table. 5. In the Left Value field, click the Adjust button to jump to the slider, and then drag the slider handle to its new position. Repeat these instructions and define Right Value parameters. 6. In the Left Position field, click the Adjust button to jump to the slider and then drag the slider handle to its new position. Repeat these instructions and define Right Position parameters. 7. In the Sets field, click the Only When Released option. 8. Click OK and return to the Properties List dialog box and add the Input text. 9. Repeat the above instructions for the Position property. Copy the values appearing in the Position field into the Slider property. 10. To view slider and position properties during runtime, save the updated display and then either from the File menu select the Operator Workstation option or, use the Ctrl + W key. 11. To update/refresh an opened display, from the File menu select the Revert to Saved option or press Alt + F + T. 1/8/07 104

105 P-CIM 7.70 Basic Training Manual 8.4 The Action Button Property An operator can perform commands by clicking on an object that has an Action Button property defined. An Action Button property can have more than one command. Actions can be performed either by: Clicking a button. Releasing a button. In P-CIM there are many types of commands for example: DDE commands, which change DDE address values. Display commands, which are connected to display parameters. Task commands, which are performed on other programs, such as Excel. * Dynamic Data Exchange (DDE) is a Microsoft protocol that enables data exchange between two different programs. (For example, P-CIM and Excel). * The Server and Topic are not defined for Action Buttons when using the DBSR Server and Topic. * The Server and Topic are always defined when the action is attached to an external server for example Excel Basic Information There are a number of parameters that reoccur in the Properties dialog box, as follows: Key Press Attributes, defining the following key press attributes: Beep, where a beeping sound is heard when the button is pressed. Invert, where the button colors are inverted when the button is pressed. Repeat action, where the action is repeated for as long as the button is pressed. Mouse Operations, defining the following attributes: Click, where a single click on the mouse activates the command action (clicking or releasing a button). Double click, where a double click on the mouse activates the command action. Accelerator Key, when an accelerator key is used during runtime it activates the Action Button. When clicked, opens the controls keyboard window, where action hot keys can be defined. Log, records Action Button events in the Alarm Summary window. To enable this option during runtime, in the Operator Workstation Options menu, check the Operators Action Log option Basic P-CIM Action Commands The information in this table describes some of the basic P-CIM commands. These commands can be used in Action Buttons, AutoActions, Reports, Recipes and more. For further information on P-CIM commands, consult the P-CIM Help. 1/8/07 105

106 Afcon Software and Electronics Ltd Table 23: Basic Action Commands Command Description Syntax Example SET Either Writes a specified value into a DDE address. Set DDE {value DDE} When the following is defined: Set Dbsr Pcim!AV1 10 the result is AV1 = 10 Or Writes values from one DDE address into another DDE address. DEC Decrements a DDE variable by a specified amount. Dec DDE [value DDE] When the following is defined: Dec Dbsr Pcim!AV1 2 The result is the value in AV1 minus 2. If no value is specified, the default value is 1. INC Increments a DDE variable by a specified amount. Inc DDE [value DDE] When the following is defined: Inc Dbsr Pcim!AV1 2 The result is the value in AV1 plus 2. If no value is specified the default value is 1. INV Inverts a digital DDE variable (0 to 1 or 1 to 0). Inv DDE When the following is defined: Inv Dbsr Pcim!DV1 The result is the opposite of the original value. OPEN Opens a display in the Operator Workstation. (The position of the display and its mode can also be defined). Open [{display wildcar d} [mode] [x,y] [-G:group]] When the following is defined: Open Main The Main display opens in the Operator Workstation. CLOSE Closes a display in the Operator Workstation. Close [display wildcard ] When the following is defined: Close Main The Main display closes in the Operator Workstation. RUN Runs a task. Run [path]program [args] When the following is defined: Run C:\Program Files\Microsoft Office\Office\Excel.exe The Excel program runs. 1/8/07 106

107 P-CIM 7.70 Basic Training Manual Exercise using the SET command When completing the Sets fields we suggest using the Only When Released option for increased efficiency. In this exercise you will create eight Action Buttons that open and close valves using the SET command. DO NOT FILL THE SERVER AND TOPIC FIELDS IF YOU ARE USING THE DBSR SERVER AND PCIM TOPIC. 1. Draw a square and color it with gradients of gray. 2. Copy a green and a red button from the Clipart Library. 3. Position the buttons on top of the square under the 3TK1 tank. 1/8/07 107

108 Afcon Software and Electronics Ltd 4. Double click the green button to open the Properties List dialog box. 5. Click the Action Button to open the Action Button dialog box. 6. Complete this dialog box using the information in the SET Command table. 7. Define the parameters for the red button using the information in the SET Command table. Table 24: SET Command Table Field Square Action buttons Text objects Description Gradient gray Green and red selected from the Buttons Clipart Library 3V102 3V103 3V202 3V203 1/8/07 108

109 P-CIM 7.70 Basic Training Manual Table 24: SET Command Table (Continued) Symbol Ids Prompt Set!&Plc&&Valve_3V102& 1 Set!&Plc&&Valve_3V102& 0 Set!&Plc&&Valve_3V103& 1 Set!&Plc&&Valve_3V103& 0 Set!&plc&&Valve_3V202& 1 Set!&plc&&Valve_3V202& 0 Set!&Plc&&Valve_3V203& 1 Set!&Plc&&Valve_3V203& 0 Open Valve3V102 Close Valve3V102 Open Valve3V103 Close Valve3V103 Open Valve3V202 Close Valve3V202 Open Valve3V203 Close Valve3V203 Action up Invert button colors Mouse operation Checked Checked 8. Select and duplicate the green and red buttons and update their properties using the Duplicate command. Position them under the first set of action buttons. 9. Select and duplicate the four Action buttons and the gray squares and position them under the 3TK2 tank. Update their properties using the information in the SET Command table. 10. Add a text object indicating the object s valve next to the relevant button. 11. Save the display. Since the Action Down option immediately performs the defined action after the button is pressed, we recommend using the Action Up option only. This will give operators more control over the system and enable them to prevent unwanted actions if the button is accidentally pressed. Command actions can be written either: * By clicking the dropdown list, selecting a command and then editing it. * In the Syntax Manager by copying and pasting the command into the Action field. * Manually typing in the command. * To define more than one command, click the Expand button and then select the next command. The program automatically separates the commands with a; separator. You can also add comma separators between commands manually. 1/8/07 109

110 Afcon Software and Electronics Ltd Exercise adding the INVERT command In this exercise you will add the INVERT command to valves 3V101 and 3V201 which when clicked open or close the valve. 1. Double click valve 3V101 to open the Properties List dialog box. 2. Click the Action Button to open the Action Button dialog box. Table 25: INVERT Command Table Field Valves Description 3V101 and 3V201 Symbol Ids &PLC&&Valve_3V101& Prompt Click to open/close valve &PLC&&Valve_3V201& Click to open/close valve Action up Inv! Invert button colors Mouse operation Checked Checked 1/8/07 110

111 P-CIM 7.70 Basic Training Manual 3. Complete the fields in this dialog box using the information in the INVERT Command table. 4. Repeat the above instructions and define the INVERT command for valve 3V201. Exercise creating buttons with the OPEN command In this exercise you will create two buttons that can be used to move between the Arrival and Product displays. 1. Open the Arrival display and draw a gray rectangle. Position it in the middle of the right wing (side) of the right building. 2. Double click the rectangle to open the Properties List dialog box. Complete this dialog box using the information in the Production/Arrival Buttons table. Table 26: Production/Arrival Buttons Table Field Description Arrival display button Gray background Text object Production Product display button Gray arrow from Clipart Library Text object To arrival Symbol Ids Open Product Prompt To Production Open Arrival To Arrival Action up Invert button colors Mouse operation Checked Checked 3. Add the Production text to the rectangle and click OK. 4. Open the Production display and create a button using the instructions above and the information in the Production/Arrival Buttons table. 1/8/07 111

112 Afcon Software and Electronics Ltd 5. Open the Arrival display in the Operator Workstation. Click the Production button to jump to the Product display Cells A cell is a collection of objects and their properties that are grouped together into one entity. Cells can be built from objects drawn using the toolbox tools or, from clipart objects (that may have built in properties). After a cell is created it is considered as one object. The properties that were attached to each object remain and apply to the cell. A cell can be edited, copied, pasted and broken. A clipart cell s objects can be broken into individual objects where each cell object retains its original properties. The List Cells dialog box lists all the cells in the display. This dialog box is opened from the Windows menu. 1/8/07 112

113 P-CIM 7.70 Basic Training Manual Exercise creating a cell from graphical objects In this exercise you will create a cell from a number of dynamic objects. 1. In the Product display, select tank 3TK1, the circular window, the bar and the text. 2. From the Cell menu, select the Make/Design Cell option. The Make/Design Cell dialog box opens. 3. In the Id field type 3TK1. 4. In the Description field type Tank 3TK1. 5. Click the OK button to save the cell. 6. Save the display. Basic Information for Designing Cells Editing cells, right click on a cell and select the Edit Cell option. Breaking cells, right click on a cell and select the Break Cell option. Editing a cell without breaking it, press the Alt key and then select the cell object. Selecting cell properties, right click anywhere in the display and select List Cells to open the List Cells dialog box: Select, displays the selected object. Modify, opens the Edit Cells dialog box. Details, displays a list of all the objects in a cell that can be selected or modified. * When creating cells from more that one cell, the cells are first broken into individual objects and then regrouped into one cell. * The Prompt, Original and Actual fields are only displayed when the objects have properties. 1/8/07 113

114 Afcon Software and Electronics Ltd 8.5 $Variables $Variables are built in internal variables that provide information about the system. They can be used throughout the application. For example, the $Variable $Time and $Date return the computer s current time and date. P-CIM has numerous $Variables, which can be viewed in the Syntax Manager by clicking the $Variables option. During runtime $Variables are read every 1000 milliseconds. $Variables are the address (DDE) items (Server Topic Item) that are added to the Item field. They are used in displays to show graphic objects, reports, database blocks, AutoAction triggers and more and are always part of DBSR PCIM. For example, DBSR PCIM$Time or!$time. Unless otherwise stated $Variables are read only. Table 27: $Variables Table $Variable $time $date $datedbf $seconds $toggle $freemem $DS $DL $DF $actiondbgeb $gtimer $lastevent Description Returns the computer s current time of day displayed as a decimal number in HHMMSS (24 hour) format. Returns the computer s current date displayed as a number with the decimal digits in YYMMDD format. Displays the computer s current date in YYYY/MM/DD format. Returns the computer s current time of day seconds as a decimal number in SS (0-59) format. Toggles between 0 and 1 (normally used to display an object that blinks). Displays the amount of free memory on the computer. String type variable. By default up to 10 $DS variables can be defined. Each string contains up to 80 characters. Read/write. Note: The default can be expanded. Long type variable. By default up to 10 $DL variables can be defined. Each long variable is a double worded format type. Read/write. Note: The default can be expanded. Float type variable. By default up to 10 $DF variables can be defined. Each float variable is a double worded format type. Read/write. Note: The default can be expanded. Displays debug actions. When moved to 1 displays all activities in the Operator Workstation. Read/write. Displays an internal timer. Up to 32 characters can be defined. The default can be expanded. Returns the last event as written in the Alarm Handler. Up to 80 characters can be used. Read/write. 1/8/07 114

115 P-CIM 7.70 Basic Training Manual Names of $Variables are not case sensitive. Exercise - displaying time, date and last event In this exercise you will create a rectangle displaying the time, date and last activity performed. 1. Open the Product display and draw a white rectangle. Position it in the bottom left corner of the display. 2. Using the Text tool, create text with 8 characters. Format the text font and type. 3. Open the Properties List dialog box, double click the Output Text button to open the Output Text dialog box. 1/8/07 115

116 Afcon Software and Electronics Ltd Table 28: Information Bar Table Field Object Time text Description White rectangle Number of characters Symbol Id Server Topic 8 $Time DBSR PCIM Item Date text Format Formatted text Number of characters Symbol Id Server Topic Formatted text, hh:mm:ss Checked 8 $Date DBSR PCIM Item Last event text Format Formatted text Number of characters Symbol Id Server Topic Formatted text, DD/MM/YY Checked Up to 80 characters $LastEvent DBSR PCIM Item Format Formatted text None Free formatted text 4. Define the Time text using the information in the Information Bar table. 5. Define the Date and Last Event texts using the information above and the Information Bar table. 6. Click OK to confirm. 7. Position the text in the white rectangle. Click OK to save. 1/8/07 116

117 P-CIM 7.70 Basic Training Manual 8.6 Dummy Variables These internal variables are used for a variety of calculations, control and other application related functions. Dummy variables can be updated by the user or changed by other P-CIM modules. Dummy Variable Syntax The following dummy variables are used throughout a project. Table 29: Dummy Variable Syntax Dummy Variable Analog Digital Syntax A:1, A:2, A:3 D:1, D:2, D:3 Dummy variables are not counted in the SEK. 1/8/07 117

118 Afcon Software and Electronics Ltd 8.7 DBSR Functions The DBSR has built in internal functions that can be used to process values and to get results to/from the plant floor. P-CIM functions can be viewed in the Syntax Manager by clicking the Functions option. When using DDE format the function is entered in the Item field for example: Server - Dbsr Topic - PCIM Item Table 30: DBSR Functions Function @N2S Trigger AutoActions at the same time of day every day. Converts, encodes, and produces the analog (numeric) result of the binary weighted values of up to 32 digital (Off/On) input/output variables. Optionally, the function sets a variable specified to the value of the result. Reading the function returns a string to the client translated from the server number through a table. Optionally, sets a variable specified to the string value. Writing a string to the function translates it to a number through a separate table and sends it to [varin0] [,varin1] [,varin2]... varin, file, table [,table_r [,prec]]) Exercise using function In this exercise you will create input and output text. The operator, using function, can enter a code number for Yogurt flavoring. The flavor s string text, matching the code is displayed in the output text. 1/8/07 118

119 P-CIM 7.70 Basic Training Manual 1. Open Notepad and create an INI file using the information in Function table. Save the file as: Tank.INI under the Yogurt folder. 2. Open the Product display and add another two rows to the SET Command table. Table Function Table Field Tank.INI file Text objects Description Saved in the P-CIM Yogurt folder has the following syntax: [flavor] 1 = strawberry 2 = pineapple Default = natural Barcode Input text = 4 characters Input text Symbol Id &PLC&&Barcode& Server Topic DBSR PCIM Item Format Free formatted text XXXX Checked Text objects Flavor Output text = 9 characters 1/8/07 119

120 Afcon Software and Electronics Ltd Field Description Output text Symbol Id Flavor Server Topic Item Format Free formatted text DBSR XXXXXXXXX Checked 3. Create the Barcode text object and position it in the table under Fruit. 4. Create input text using the information in Function table. 5. Using the instructions above and the information in Function table, create the Flavor text. Save the display. 6. Open the Product display in the Operator Workstation and select File/Revert to Saved. 7. In the Barcode field type a new value. Check the text displayed in the Flavor field. 1/8/07 120

121 P-CIM 7.70 Basic Training Manual 8.8 DBSR Conversions The DBSR (Database Server) has a number of predefined conversions that convert raw values into engineering units. Unless otherwise defined, DBSR Conversions are bidirectional. When creating this syntax, the conversion statement is separated from the Item by a, comma followed by the conversion name and its parameters. To view DBSR Conversions, open the Syntax Manager, Functions section and scroll to the end of the list. Table 32: Conversions Syntax Conv(param1, param2,..), for example Lin itemname,conv(param1,param2, paramn) DBSR PCIM!itemname,conv(param1,param2,..,. ) Where: conv = conversion name. Indicates the Item field of a DDE link. Indicates a complete DDE link. 1/8/07 121

122 Afcon Software and Electronics Ltd 8.9 Conversion LIN (Linear) The LIN conversion has four parameters which represent the two points in a conversion line. Each parameter can have up to 15 digits, however the result of the conversion will have 7 digits. LIN syntax is as follows: Table 33: LIN Syntax Syntax Where: LIN LIN Indicates the name of the conversion. Slow Slow Indicates the server side s low point, this number must be less than the Shigh number. Shigh Shigh Indicates the server side s high point, this number must be higher than the Slow number. Clow Clow Indicates the client side s low point, this number must be lower than the Chigh number. Chigh Chigh Indicates the client side s high point, this number must be higher than the Clow number. LIN Conversion syntax must have all three, commas included. Exercise using the linear conversion to display temperature The temperature thermostat sends a signal of 4-20mA which is converted by the PLC to the range In this exercise you will use the Linear conversion to display the values to the operator according to the scale range of written on thermostat PT Run the Datascope. 2 In the Item field enter the following text: 1:1:40001,Lin(0,4095,0,100). 3 Compare the value received in the Value field to the value received for 1:1: /8/07 122

123 P-CIM 7.70 Basic Training Manual 1/8/07 123

124 Afcon Software and Electronics Ltd Chapter 9 AutoActions Use AutoActions during runtime to automatically perform predefined commands and actions. In this chapter you will learn about. * Creating Startup and Shutdown actions * Running the Operator Workstation during P-CIM Startup * Defining AutoOpen/AutoClose actions * Defining AutoActions 1/8/07 124

125 P-CIM 7.70 Basic Training Manual 9.1 AutoActions AutoActions trigger action commands that are performed according to predefined conditions. During runtime, AutoActions run automatically and without operator interference. AutoActions are triggered by events or at set times. Display AutoActions can only be defined after the display is saved. The following types of AutoActions can be defined: Operator Workstation AutoActions, attached to the Operator Workstation and are triggered when the Operator Workstation is open regardless of the display, as follows: Startup Action, triggered when opening the Operator Workstation. Shutdown Action, triggered when shutting down the Operator Workstation. AutoActions, triggered by data changes. For instructions see Defining AutoActions page 127. Display AutoActions, which are attached to a specific display and are only triggered when the display is opened during runtime, as follows: AutoOpen, triggered when a specific display opens. AutoClose, triggered when the display closes. AutoActions, triggered by data changes. For instructions see Defining AutoActions page 127. * AutoActions defined for the Operator Workstation are saved after clicking OK in the Autoactions dialog box. Whereas: AutoActions defined for a display are saved after saving the display. * When a display name is untitled AutoActions cannot be defined. First save the display and then open the Operator Workstation Creating Startup and Shutdown Actions These AutoActions are triggered either when starting up or shutting down the Operator Workstation. Exercise opening the Arrival display in the Operator Workstation during startup 1/8/07 125

126 Afcon Software and Electronics Ltd In this exercise you will use the Startup Action to define that the Arrival display opens automatically in the Operator Workstation during P-CIM startup. To define that previously opened displays are not opened during P-CIM Startup, make sure that the Startup with Last Displays option is not checked. 1. From the Animation Editor Options menu, Operator Workstation Setup option, select Startup Action to open the Startup Action dialog box. DO NOT FILL THE SERVER AND TOPIC FIELDS IF YOU ARE USING THE DBSR SERVER AND P-CIM TOPIC. 2. In the Action field type the following: Open Arrival. 3. Click OK Running the Operator Workstation during P-CIM Startup To open the Operator Workstation module on P-CIM Startup, in the P-CIM Project Setup window expand the Startup menu and double-click the Startup modules subfolder. 1/8/07 126

127 P-CIM 7.70 Basic Training Manual 1. Click Browse to locate the Operator Workstation executable, Gdisplay, located in the P-CIM installation folder. From the Mode pull-down menu select the Normal option. Click Save. 2. Restart P-CIM, check that the Operator Workstation opens automatically showing the Arrival display Defining AutoOpen/AutoClose Actions From the Displays menu select either: AutoOpen Action AutoClose Action The AutoOpen/AutoClose Action dialog box opens. To complete this dialog box see instructions for Creating Startup/Shutdown AutoActions on page Defining AutoActions AutoActions can be defined for both Operator Workstation and Display. To open the AutoActions dialog box either: In the Animation Editor Display menu select AutoActions. In the Animation Editor Options menu select Operator Workstation Settings and then select AutoActions. 1/8/07 127

128 Afcon Software and Electronics Ltd Exercise defining the automatic cleaning process In this exercise AutoActions are used to define the tank s daily cleaning process, which is run by activating the cleaning valve. 1. In the Animation Editor Options menu select Operator Workstation Settings and then select AutoActions to open the AutoActions dialog box. In Edit mode the following signs! are automatically written by the program at the beginning of the command. Do not write them manually. 1/8/07 128

129 P-CIM 7.70 Basic Training Manual This dialog box has the following fields: Table 34: Automatic Cleaning Settings Field Name Trigger Mode Description Holding a unique name of up to 15 characters without spaces. A condition whose value causes the action to be performed. A trigger is an expression or variable and has DDE format (Server Topic Item). Defining which value changes in the trigger will causes the command to be performed: Repeat Up Down Performs the command after any non-zero value changes. Performs the command after zero to non zero value changes. Performs the command after non zero to zero value changes. Edit action Skip first trigger data Active on load Opens the Edit Action dialog box where you can define the action. When checked indicates that the first time that the AutoActions are read the trigger is ignored. When checked AutoActions are active during runtime. This can be turned off and on again during development. 2. Define the StartCleaning AutoAction using the information in the Creating an AutoAction table. Table 35: Creating an AutoAction Table Field Description Start clean AutoAction Name StartCleaning Trigger Mode!@Attime(16300X) Up Action Set!&PLC&&CleaningAct& 1 Skip first trigger data Checked Stop clean AutoAction Name StopCleaning Trigger Mode!@Attime(16450X) Up Action Set!&PLC&&CleaningAct& 0 Active on load Skip first trigger data Checked Checked 1/8/07 129

130 Afcon Software and Electronics Ltd 3. Click the Add button to add this AutoAction to the list. 4. Define the Stop Cleaning AutoAction. 5. Click OK to confirm and to exit this dialog box. The AutoAction will be triggered during runtime when the computer time is 16:30 and 16:45. 1/8/07 130

131 P-CIM 7.70 Basic Training Manual 1/8/07 131

132 Afcon Software and Electronics Ltd Chapter 10 Database Editor Use the Database Editor to define database blocks. Data blocks are defined for generating alarms and history collection. Instructions for defining database blocks can be found in the Alarms Chapter. In this chapter you will learn about. * Data block types * Configuring the database 1/8/07 132

133 P-CIM 7.70 Basic Training Manual 10.1 About the Database Editor The P-CIM database is a set of items, addresses and data blocks that process and log data. Real time and historical data can be retrieved, stored and processed in the database. Data blocks are created in the Database Editor, which is accessed by double clicking the Database Editor icon from the Development group. * The Database Editor can only be fully accessed when P-CIM is running. * ALWAYS click the SaveDB button to save your configurations before exiting this dialog box Configuring the Database By default, a specified number of data blocks can be defined for each type of data block. This number can be modified in the Database Configuration dialog box. These modifications are only available after P-CIM shutdown and restart. 1/8/07 133

134 Afcon Software and Electronics Ltd For optimized use of the database, the number of data blocks allocated should match the number used in the project. Accessing the Database Configuration dialog box This dialog box can be opened from the Database menu by selecting the Configure option. To modify data block quantity, make your changes and click the Configure button Data Blocks A data block is a database element used for processing data. It has the following functionalities: * Provides an operator interface. * Generates alarms. * Collects history. * Exchanges data with external devices and internal variables. 1/8/07 134

135 P-CIM 7.70 Basic Training Manual * Exchanges data between blocks. * Converts raw data Types of Database Blocks There are eight types of data blocks: There are parameters that can be defined for all data blocks Table 36: Database Blocks Types Block Name Analog value Analog pointer Digital value Digital pointer Calculation Boolean String pointer Alarm Description This block is used for analog variables. Analog values are constantly scanned. Alarms can be generated and history collected. This block is used for analog variables, mainly for data conversion. An analog pointer type of block is scanned upon request. This block is used for digital variables. Digital values are constantly scanned. Alarms can be generated. This block is used for digital variables and is scanned only upon request. This block can perform calculations on analog and digital block values. These blocks are constantly scanned. Alarms can be generated and history collected. This block is used for boolean algebraic calculations, which are constantly scanned. Alarms can be generated. This block receives up to twenty 16 bit word values from registers in a PLC or other devices and converts them into a text string of up to 40 characters. This block enables definition of up to 80 digital alarms. Each alarm block reads 5 registers of 16 bits, each from up to five different Plus, and relates to each bit as a separate alarm. A different alarm status can be defined for each different bit. Alarm status can be: On, Off, Change Of State. To avoid system overload, use blocks for alarm generation and historical recording only. regardless if the block is used for alarm oror history: f 1/8/07 135

136 Afcon Software and Electronics Ltd Table 37: Data Block Parameters Field Name Address Desc Target & target logic Utility table Description Holding the name of the data block. Holds the data address of the following: * Driver address. * Internal dummy variable. * System $Variable. * Third party DDE server. Holds a description of the data block. Up to 80 characters and spaces can be used. This feature is for advanced P-CIM use only. This field holds the following parameters: Scan time The frequency that the data block is scanned. The range is seconds, where 1-second is the default. Phase time Low scale High scale Conversion Engr units Defines the initial delay between first loading and processing the data block. The range is 1-255, where 1-second is the default. Defines the lowest range of values handled by this block. Defines the highest range of values handled by this block. The name of the data conversion into engineering units (driver specific list). The name of the engineering unit displayed in the alarm message of the associated block and in the Historical Trend. The name of the engineering units supports up to four characters. Alarm table This field defines alarm parameters. It has the following options: Enable Advanced on alarm on RTN Report to normal status When checked defines that the data block processes alarms. When checked defines that the alarm is handled in the Advanced Alarm Handler module. When checked defines that an is sent when an alarm is issued. When checked defines that is sent when the alarm returns to normal status. When checked defines that a message is sent to the Alarm Handler when normal status is resumed. 1/8/07 136

137 P-CIM 7.70 Basic Training Manual Field Description Alarm wait Daily log Print Beep Screen Low alarm Low Low alarm High alarm High High alarm ROC alarm Alarm display Deadband Alarm zone Smoothing Defines the amount of time before an alarm is actually generated. When checked defines that the alarm is written to the Daily Log file. When checked defines that the alarm is printed to the default printer. When checked defines that when an alarm is generated the operator s computer beeps. When checked defines that the alarm is written to the Alarm Summary window. Defines that an alarm is triggered when a block value reaches or drops below this point. Defines that an alarm is triggered when a block value reaches or drops below this point. Defines that an alarm is triggered when a block value reaches or is higher than this point. Defines that an alarm is triggered when a block value reaches or is higher than this point. Defining the alarm rate of change, whereby an alarm is issued if the deviation between two readings is equal to or is greater than this number. Defines that a display pops up in the Operator Workstation when an alarm is generated. To enable this option in the Operator Workstation Special menu check the Last Alarm Display option. Defines the range after which a high/low level alarm returns to normal status: * A high alarm condition returns to normal only after the block s value has increased below the high alarm setpoint minus deadband. * A low alarm condition return to normal only after the block s value has risen above the low alarm setpoint plus the deadband. Defines that the alarm is attached to a zone in the Alarm Summary window. P-CIM has 10 zones and one system zone that send system messages. Filters incoming readings according to the result of the average of the number of samples defined. For example if 5 is defined, smoothing is performed every 5 samples. 1/8/07 137

138 Afcon Software and Electronics Ltd Data Blocks Parameters Field Trend table Description This field defines History collection for analog value and calculation blocks. It has the following options: HT factor Historical Term Trend Factor. Use when backwardscompatibility with pre-7.50 projects is required. The number of readings (0-255) to be averaged for each point recorded in the Historical Trend file: 0 indicates that there are no readings. 255 indicates that this feature is available at runtime. HST factor HT step HST Period New format of Historical Term Trend Factor. Enables faster data logging and setting the historical file's size. The number of readings (0-255) to be averaged for each point recorded in the Historical Trend file: 0 indicates that there are no readings. 255 indicates that this feature is available at runtime. H. T. Step, defines the difference between the new average and the previous value saved in the History file, and causes the new average to be written in the file. The difference is written as a percentage of the engineering span of the block: * Low/high limit of an Analog Value block in the Output table. * Low alarm/high alarm of a Calculation block. Enables historical data collection of a period of up to a month into a single file. Choose the time period, in months, to collect historical data in a single file. You cannot use both HT Factor and HST Factor settings at the same time. According to the project's needs, choose either type. 1/8/07 138

139 P-CIM 7.70 Basic Training Manual 10.2 OLEDB Database P-CIM version 7.50 includes OLE (MS Access and MS SQL Server) standard database support. Providing built-in support for external standard databases extends the P-CIM database ability by scalability, storage capacity, search and querying options, project backup and restores options and disaster recovery. Projects that currently use P-CIM proprietary database can be migrated in P-CIM version 7.50 to MS Access or MS SQL databases. All included data, including alarms and historical records, is migrated to the OLE database. Database backup and restore actions can be performed using an OLE database, enabling quick and easy saving and restoring projects to and from various databases. If the data is to be stored on an SQL Server, the server and Data base must be configured before performing the following procedure. For more information on using OLEDB database refer to the P-CIM Advanced Training Manual. 1/8/07 139

140 Afcon Software and Electronics Ltd Chapter 11 Alarms In P-CIM alarms are used to warn the operator about critical status in the system and in the plant s devices. In this chapter you will learn about. * Analog alarms * Digital alarms * Where alarms are displayed * How alarms are handled 1/8/07 140

141 P-CIM 7.70 Basic Training Manual 11.1 Configuring Alarms Alarms are configured in the Database Editor in data blocks. Different types of alarms can be defined with different triggers and parameters. Each type of alarm has a separate tab in the Database Editor dialog box. Alarms can be either: * Analog, where an alarm is triggered after an analog variable changes above or below specified set points. * Digital, where an alarm is received after changes in digital variable status, for example On or Off, or any updates Defining an Analog Alarm Exercise - defining analog alarms In this exercise you will define four analog alarms for milk temperature and PH level using the information in the tables: * Alarm 1 TANK3TK1_PH Table * Alarm 2 TANK3TK1_TEMPERATURE Table * Alarm 3 TANK3TK2_PH Table * Alarm 4 TANK3TK2_TEMPERATURE Table 1. Click the Database Editor icon to open the Database Editor. 2. In the Analog Value tab, type the name of the data block and then click the Add button to open the Analog Value Modify dialog box. 1/8/07 141

142 Afcon Software and Electronics Ltd 3. Complete this dialog box using the information in the Alarm 1 TANK3TK1_PH table. Table 38: Alarm 1 TANK3TK1_PH Table General Info Utility Table Alarm Table Name TANK3TK1_PH Scan time 1 Enable Checked Address &PLC&40013 Phase time 1 Low alarm 2 Desc TANK 3TK1 PH level Low scale -10 High alarm 7 High scale 20 ROC alarm 0 Deadband 0 Table 39: Alarm 2 TANK3TK1_TEMPERATURE Table General Info Utility Table Alarm Table Name TANK3TK1_TEMPERATURE Scan time 1 Enable Checked Address &PLC&40014 Phase time 1 Low alarm 0 Desc TANK 3TK1 TEMPERATURE Low scale -10 High alarm 5 High scale 20 ROC alarm 2 Deadband 0 1/8/07 142

143 P-CIM 7.70 Basic Training Manual Table 40: Alarm 3 TANK3TK2_PH Table General Info Utility Table Alarm Table Name TANK3TK2_PH Scan time 1 Enable Checked Address &PLC&40015 Phase time 1 Low alarm 2 Desc TANK 3TK2 PH level Low scale -10 High alarm 7 High scale 20 ROC alarm 0 Deadband 0 Table 41: Alarm 4 TANK3TK2_TEMPERATURE Table General Info Utility Table Alarm Table Name TANK3TK2_TEMPERATURE Scan time 1 Enable Checked Address &PLC&40016 Phase time 1 Low alarm 0 Desc TANK 3TK2 TEMPERATURE Low scale -10 High alarm 5 High scale 20 ROC alarm 2 Deadband 0 4. Create the other three analog alarms using the information in the tables above. 5. Save the database by clicking the Save DB button. 6. Run the DataScope and type Tank3Tk1 in the Item field. In the Value field type Open the Alarm Handler and check that the alarm is displayed. Block names can be applied from the Syntax Manager module Blocks options Defining an Alarm in an Alarm Block Each alarm block reads five addresses (registers) of 16 bits each. That is, up to 80 digital alarms from up to five different PLCs, relating to each bit as a separate alarm. A different alarm can be defined for each bit. 1/8/07 143

144 Afcon Software and Electronics Ltd Exercise creating a digital alarm In this exercise you will define an alarm block that creates an alarm when a valve is faulty. 1. Open the Database Editor and click the Alarm tab. 2. In the Name field type: Valve_alm and then click the Add button. The Valve_ALM dialog box opens. 3. In the Address fields type: &PLC&&Valve_ALM&. 4. Check the Enable checkbox and then select Bit 1 of Address 1. The next dialog box opens. Table 42: Entry Valve of Tank 3TK1 Table Field Name Description Valve_ALM 1/8/07 144

145 P-CIM 7.70 Basic Training Manual Table 42: Entry Valve of Tank 3TK1 Table Enable Address 1 Checked &PLC&&Valve_Alm& Name Description Alarm type Text for 0 Text for 1 Enabled ALM_3V101 Failure in entry valve tank 3TK1 On Off On Checked Table 43: Fruit Valve of Tank 3TK1 Table Field Name Enable Address 1 Description Valve_ALM Checked &PLC&&Valve_Alm& Name Description Alarm type Text for 0 Text for 1 Enabled ALM_3V102 Failure in fruit valve tank 3TK1 On Off On Checked 5. Complete this dialog box using the information in the Entry Valve of Tank 3TK1 table. Table 44: Souring Agent Valve of Tank 3TK1 Table Field Name Enable Description Valve_ALM Checked 1/8/07 145

146 Afcon Software and Electronics Ltd Table 44: Souring Agent Valve of Tank 3TK1 Table (Continued) Address 1 &PLC&&Valve_Alm& Name Description Alarm type Text for 0 Text for 1 Enabled ALM_3V103 Failure in sour agent valve tank 3TK1 On Off On Checked 6. Save your settings and exit the dialog box. 7. Click the Save DB button to save the database. 8. Simulate an alarm as follows: * Open the Product display and add the text Fault next to valve 3V101. * Define a Visibility property for the text Fault. The Item is ALM_3V101. * Save the display. 9. Run the DataScope. In the Item field type: ALM_3V101 and in the Value field type 1. Check that the text Fault appears in the Product display Displaying Alarms In P-CIM, alarms can be viewed in the Alarm Handler module, which automatically opens during P-CIM Startup. The Alarm Handler displays: * System events and alarms chronologically. * Active alarm messages. There are two windows: * Alarm Summary, displaying all alarms and messages. The Alarm Summary window can be customized in the Window Style dialog box, which can be accessed from the Options menu, Window Style option, Window Style dialog box. * Current Alarm, displaying current active alarms. This window is used to view and acknowledge active alarms. By default, the Alarm Handler can handle up to 256 alarm and event messages in the Alarm Summary, and up to 100 messages in the Current Alarm window. Uncheck the Close option in the Window Style dialog box to prevent the Alarm Summary and Current Alarms windows closing during runtime. 1/8/07 146

147 P-CIM 7.70 Basic Training Manual Alarms Status Alarms have the following default colors: Table 45: Alarm Status Colors Red Grey Blue Black Active alarm. Alarms that are no longer in alarm condition. Acknowledged alarms. System messages. 1/8/07 147

148 Afcon Software and Electronics Ltd Exercise triggering and viewing an alarm that is displayed for out of range temperatures In this exercise you will trigger an alarm that is displayed when the temperature of the milk is out of the defined range. The alarm is displayed in the Alarm Handler where it will be acknowledged. 1. Open the Data Scope and in the Item field type the following: TANK3TK1_TEMPERATURE. 2. In the Value field type the number 0 and then click the OK button. The Alarm is issued and can be viewed in the Current Alarm window. 3. Open the Current Alarm window. To acknowledge the alarm either: Select the alarm and click it. Select the alarm and in the Acknowledge menu select the Ack Messages option. 1/8/07 148

149 P-CIM 7.70 Basic Training Manual Chapter 12 Advanced Alarm Handler The Advanced Alarm Handler (AAH) is a tool for organizing, monitoring, acknowledging and analyzing alarms. In this chapter you will learn about. * Building an Advanced Alarm system * Zones * Functional and Location hierarchy trees 1/8/07 149

150 Afcon Software and Electronics Ltd 12.1 About the Advanced Alarm Handler Use the Advanced Alarm Handler (AAH) module to define the logical order that alarms are displayed during runtime. In the Advanced Alarm Handler, alarms are independently classified and viewed according to class (alarms or events), priority (0 999), and category. Advanced alarms can be displayed in the Functional and Location hierarchy trees, where alarms can be organized both functionally and geographically Building an Advanced Alarms System The first stages in building an AAH system are: * Understanding the system s requirements. * Designing the system. If your application is in a network, the physical location of the AAH database and node numbers must be taken into consideration. Planning Alarm Categories During alarms definition, alarms are assigned to a category that is handled by the AAH. The category s attribute indicates the service or the activity to which the alarm or event is related. For example, devices, electricity supply. The AAH module supports up to 1000 alarm categories. Each category can be customized with a unique number, icon and/or a free text description. During runtime advanced alarms can be sorted according to category. 1/8/07 150

151 P-CIM 7.70 Basic Training Manual Exercise creating a new AAH category In this exercise you will create a new alarm category called Electricity Valve. 1. Open the Database Editor. In the Database menu, select Zones to open the Zones dialog box. 2. Click the Categories button to open the Categories dialog box. 3. Scroll the Categories List and select the tap icon. 4. In the Name field type Electricity Valve and then click the Change button. 5. Click OK. The electricity valve category is added to the Categories List. Planning Advanced Alarm Handler Zones Two hierarchy trees can be built in the Advanced Alarm Handler: * Functional * Location Each tree can have up to five nested sub-branches (zones) where each branch can have up to 999 sub branches. Each branch can have a name of up to 20 characters. 1/8/07 151

152 Afcon Software and Electronics Ltd Exercise creating a functional tree and its branches In this exercise you will create a functional hierarchy tree and its branches using the information in the Functional Hierarchy Tree: 1. In the Database Editor, Database menu select Zones to open the Zones dialog box. 2. Click the Zones button to open the Advanced Zones dialog box. 3. Click the Functional option to display the functional tree. 4. Click the Functional folder and then click the Create button. A new folder is created. Rename the branch by typing Tank 3TK1 in the Name field. Click the Change button. Table 46: Functional Hierarchy Tree Table Branch Tank 3TK1 Sub branch Entry valve Fruit valve Sour agent valve Clean valve Exit valve 1/8/07 152

153 P-CIM 7.70 Basic Training Manual Table 46: Functional Hierarchy Tree Table (Continued) Tank 3TK2 Entry valve Fruit valve Sour agent valve Clean valve Exit valve 5. Select the Tank 3TK1 folder and then click the Create button to create a new sub-branch. Rename the sub-branch by typing Entry Valve in the Name field. Click the Change button. 6. Create four more sub-branches using the above instructions and the information in the Functional Hierarchy Tree table. 7. Follow the above instructions and create sub-branches for Tank 3TK2. Exercise creating a location tree and its branches In this exercise you will create a location hierarchy tree and its branches using the information below. 1. Click the Location option to display the location tree. 2. Select the Location folder and click the Create button. A new folder is created. Rename the folder by typing Reception in the Name field. 1/8/07 153

154 Afcon Software and Electronics Ltd Table 47: Location Tree Table Object Branches Description Reception Pasteurization Production Packing 3. Create three more folders using the instructions above and the information in the Location Tree table. 4. Click the OK button twice to close the Zones dialog box Defining Data Blocks Advanced Parameters The advanced parameters of a data block are defined in the Database Editor in the following block types: * Analog value * Digital value * Boolean * Calculation * Alarm bit Advanced alarms can have the following parameters defined: * Class, which can be either an alarm or an event type class. * Category * Priority, between 0-999, where 0 is the highest priority. * Zone, which can be attached to a branch of either or both the location or functional trees Configuring Alarms Advanced Alarms are defined in the Database Editor. Blocks are only displayed in the Advanced Alarm Handler after they are assigned to it by clicking the Advanced button in the various tabs of the different block types. Exercise defining advanced alarm parameters In this exercise you will define advanced alarm parameters for the tank s valves in the valve_alm 1/8/07 154

155 P-CIM 7.70 Basic Training Manual block using the information in the table below. 1. In the Database Editor module, Block Directory dialog box, open the Alarm tab. 2. Double click the Valve_ALM entry to open the Alarm Modify dialog box. 3. Click Bit 1; in the dialog box that opens click the Advanced button to open the Advanced Alarm dialog box. Table 48: Defining Advanced Alarm Parameters Table Alarm Block Category Functional Branch Location Branch Valve_ALM Alarm bit ALM_3v101 Electricity valve Tank3TK1/Entry valve Production ALM_3v102 Electricity valve Tank3TK1/Fruit valve Production ALM_3v103 Electricity valve Tank3TK1/Sour valve Production 4. In the Category list, select the Electricity Valve. 5. Check the Functional checkbox and select the Entry Valve sub-branch and then click the Attach button. 6. Repeat Step 5 and define the Location tree. 7. Click OK and OK again. 8. Add bits 2 and 3 using the instructions above and the information in the Defining Advanced Alarm Parameters table. 9. Click OK and then click the Save DB button and close the Database Editor module. 1/8/07 155

156 Afcon Software and Electronics Ltd 12.3 Viewing Alarms Advanced alarms are displayed in the Advanced Alarms window. This window can be customized whereby the alarms displayed in the window can be filtered and displayed in different views. The Advanced Alarm Handler has three windows: * Current Alarm window, which is displayed when the module opens. * Alarm Log window, which is accessed from the Current Alarm window. * Alarm Archives window, which is accessed from the Alarm Log window. Accessing the Advanced Alarm Handler To open this option, double click the Group to display the Current Alarm window. Advanced Alarm Handler icon in the P-CIM Runtime Advanced Alarm Handler messages are updated when the Database Editor is closed only Working in the Advanced Alarm Handler Window Zones Menu Use the Zone options and tool bar icons to: * Expand/collapse the Alarms Tree. * Select Indicate Alarmed Branch to color branches containing alarms. * Toggle to move between the location and functional trees. View Menu Use the View options and tool bar icons to: * Display both alarms and zones, alarms only or zones only. * Filter and display the Alarms Tree in three different view options, which are defined in the Select Criteria dialog box. * Customize the columns displayed in the Alarms Field in the Customize List dialog box. * Sort alarms according to type, priority etc. 1/8/07 156

157 P-CIM 7.70 Basic Training Manual * Display a specified number of alarms. Options Menu Use the Options commands and tool bar icons to: * Set the Beep and Popup options by checking Options/Beep or Options/Popup. * Add options to the tool bar in the Customize Toolbar dialog box. * Modify alarm color indications in the Color dialog box. * Define user access permission to menus by checking the Menu Authorization option. Filtering Views This option enables you to create three different filtered views. An alarm filter parameter is a dbase range expression against which each message is checked. A range expression is built out of either a single relational conditional or a logical condition holding several relational conditions. * Accessing the Set Criteria dialog box To access the Set Criteria dialog box select View/Set Criteria. 1/8/07 157

158 Afcon Software and Electronics Ltd The Set Criteria dialog box has the following fields: Table 49: Set Criteria Dialog Box Options Field Edit Work area Edit features Fields X:xxx DBase functions Operator tools Description Where the view for which filtering criteria is selected. The area where the filtering expression is defined by the user. Click the relevant button to cut/copy/paste/select all. Listing the built in Advanced Alarm fields displayed in the Current Alarm window s table. When a string is selected it appears in the work area. Listing all data types that are valid for the selected field. When a string is selected it appears in the work area. Listing the built in database functions. When a function is selected it can be added to the string and items in the work area. This section is used to write an expression, and has the following sub fields: Operator Keyboard Date-Time This keyboard holds the operators that are used to build an expression. When clicked opens the Date and Time dialog box: Relative, when selected defines that the view will display filtered alarms according to the defined number of previous days. Absolute, when selected defines that the view displays alarms from and to a specific date and specific time. Separate Enclosure When clicked adds a list separator to string in the work area. Select an enclosure type and add it to the work area. Check Description After creating a view, check this button to verify that the filter expressions defined for this view work. Displays information about the selected string and functions. Examples: DAT->CATEGORY=5 specifies that messages are in category 5. CUR->START_TIME>=<2005/1/11-12:00 specifies that messages appear after 12:00 on 11 January /8/07 158

159 P-CIM 7.70 Basic Training Manual Customizing the List This option enables you to set the columns displayed in the Advanced Alarm Handler windows. In the View menu, select Customize List to open the Customize List dialog box. The Customize List dialog box has the following fields: Table 50: Customize List Options Field Time format Available fields Add Remove Alarm fields Reset Move up/move down Description Sets the format in which the time and date is displayed. This field is only relevant when columns indicating time and date are added to the Alarm Fields. Lists the fields that can be displayed in the Advanced Alarm Handler columns. When clicked adds a selected field to the Available/Alarm Fields. When clicked removes a selected field from the Available/Alarm Fields. Lists all the selected columns that will be displayed in the Advanced Alarm Handler. When clicked returns the Customized List to the default settings. Moves an entry up/down. The columns in the Advanced Alarm Handler will be displayed according to this order. Sorting Alarms Messages displayed in the List View can be sorted according to fields. For example, category, tag and so on. This is true for messages in fields that are not displayed in the List View. 1/8/07 159

160 Afcon Software and Electronics Ltd To sort messages from fields that are not in the List View, select View/Sort by, or double click the column type. Alarm fields that are not selected in the Customize List dialog box can also be selected in the Sort by option, where the type of alarm will be listed without any additional information. Defining View Top Options This option enables you to view only the most critical alarm messages in the current sort key. 1. To open this dialog box select View/View Top. 2. Enter the number of levels below the highest order in the current key: * Select 0 to view all rows. * Select 1 to 999 to view the selected number of rows. Customizing the Toolbar The icons in the tool bar can be added/removed through the Customize Toolbar dialog box. To open this dialog box select Options/Customize Toolbar. The Customize Toolbar dialog box has the following fields: Table 51: Customize Toolbar Options Field Add Remove Description When clicked adds an icon option to the tool bar. When clicked removes an icon option from the tool bar. 1/8/07 160

161 P-CIM 7.70 Basic Training Manual Table 51: Customize Toolbar Options Reset Move up/move down When clicked returns the Customized Toolbar dialog box to the default settings. Moves an icon up/down. The tool bar is displayed according to this order. Setting Alarm Message Colors There are five types of alarm messages where each alarm type is displayed in a different color. Default alarm color codes are as follows: Table 52: Alarms Messages Colors Red Brown Light green Dark green Shocking pink Alarm active, not acknowledged. Alarm active, acknowledged. Alarm not active, not acknowledged. Alarm not active, acknowledged. Event. 1. To change a color, select Options/Color to open the Colors dialog box. 2. Select a color from the list and then click the alarm/event type. 3. Click OK to save and confirm these modifications. 1/8/07 161

162 Afcon Software and Electronics Ltd Archiving The Advanced Alarm Handler can be configured to save messages (in the alarmlog.dbf) file. Messages prior to these days are removed and saved in the alarmarch.dbf archive files. Archiving is defined in the Alarm Log window. The information collected in these files can be used to generate reports. Setting archive schedule parameters To open the Alarm Log window in the Current Alarm window File menu select the Alarm Log window option. In the Alarm Log window Archives menu select Schedule to open the Schedule dialog box. This dialog box has the following fields: Table 53: Archive Settings Field Archive alarms older than XX days Archive alarms at (hh:mm) Description Defines the number of days that alarms are saved after which they are archived in the archive files. For example, if 30 is selected, alarms that have been in the log for 30 days will be archived. Defines the time at which alarms are archived. 1. Define the archive days and hours and then click OK. 2. To actually enable the archiving option, in the Archives menu check the Enable Archives Operation option Handling Alarms Acknowledging alarms Select the message(s) to acknowledge and then either: * Select Acknowledge from the Alarms menu. * Click the Ack alarms icon. * Right click the alarm. This option is only available when the following is defined in: File: PfwAlarm.INI Section: [StateCurAlarmWindow] Token: EnableInstantAck = 1 1/8/07 162

163 P-CIM 7.70 Basic Training Manual Erasing Alarms Select the message(s) to erase, and then select Erase from the Alarms menu. These alarms are deleted from the Alarm file only, and are not removed from the Log file. Purging Alarms This option is used to automatically remove alarms from the Current Alarm window. There are the following purge options: * Remove (purge) all alarms from the current alarm view on P-CIM startup. * Select the alarm condition by which the alarm is removed online. To access the Purge dialog box, in the Alarms menu select Purge. This dialog box has the following fields: Table 54: Purging Alarms Field Purge all on startup Disable purge Description Removes all specified alarm types from the Advanced Alarm Handler window during P-CIM startup. Disables the Purge process. Alarms that were: Cleared Removes alarms that were cleared. Acknowledged Ack or cleared Ack and cleared Removes alarms that were acknowledged. Removes alarms that were acknowledged or cleared. Purges alarms that were acknowledged and cleared. 1/8/07 163

164 Afcon Software and Electronics Ltd Exercise simulating and handling alarms in the Current Alarm window In this exercise you will simulate alarms from the 3V101 valve and view and acknowledge the generated alarm in the Current Alarm window. 1 Check that the Database Editor is closed. 2 Open the Data Scope and type the following in the Item field: ALM_3V Change the Value from Off to On. 4 Click OK. 5 Open the Current Alarm Window and acknowledge the alarm. 1/8/07 164

165 P-CIM 7.70 Basic Training Manual Chapter 13 Trends Use trends to view values of a variable or a process in a graph that is displayed in the Operator Workstation. During runtime, the trend graph is continually updated as the address s values change. Scroll the graph to view previous values. The trend s historical data collection continues even when the display is not active. P-CIM has a number of Trends. This manual discusses Real-time, Historical and Dynamic Trends, which can be defined in a display. Each Trend can have up to eight variables. In this chapter you will learn about. Creating a real-time Trend Displaying a real-time Trend Historical Trends History collection Creating a historical Trend Displaying a historical Trend Creating a dynamic Trend 1/8/07 165

166 Afcon Software and Electronics Ltd 13.1 Real-time Trends Real-time Trends are created in the Animation Editor. They display real-time activities whose values are automatically updated in the Operator Workstation. As values change, the Trend continually displays the latest real-time values. Addresses in a real-time trend can be a direct address. Exercise creating a real-time trend In this exercise you will create a real-time trend that displays the temperature of Tanks 3TK1 and 3TK2. 1. Create a new display. 2. Draw a rectangle and select it. 3. Double click on the rectangle to open the Properties List dialog box. Click the Trends button to open the Trends Properties dialog box. 1/8/07 166

167 P-CIM 7.70 Basic Training Manual 4. Check that the Real-time option is selected. Table 55: Pen Dialog Box Parameters Table Field Pen 1 Pen 2 Server DBSR DBSR Topic PCIM PCIM Item &PLC&40014 &PLC&40016 Pattern ####.### ####.### Scale top Scale bottom Style Line Line EGU C C Background color Default Default Pad color Default Default Pen1 color Default Default 5. Click on Pen1 to display the Pen parameter fields. 6. Complete this section using the information in Table 1 Pen Dialog Box Parameters. 7. Click OK. 8. Click the Time X Axis button to display the Time X Axis fields. 9. Complete this section using the information in Table 2 Time X Axis Dialog Box. Table 56: Time X Axis Dialog Box Table Field Description Time span 60 Span units Seconds Sample time 1 Sample units Seconds 10. Click OK. 11. Click the Value Y Axis button to display the Value Y Axis fields. 1/8/07 167

168 Afcon Software and Electronics Ltd Table 57: Value Y Axis Dialog Box Table Field Show gridlines Number of major divisions Number of minor divisions Description Checked Default Default 12. Complete this section using the information in Table 3 Time Y Axis Dialog Box. 13. Click OK. 14. Click the Panel Layout button to display the panel buttons and then check the Legend and Report checkboxes. 15. Create Pen2 using the instructions above and the information in tables 1, 2, and Click OK. 17. In the Symbol Id field type RealtimeTrend. 18. Click OK, and then save the display as Manage. Icon Icon Name Function Table 58: Panel Layout Table Legend Report Zoom Opens a dialog box of the current trend legend displaying the DDE parameters (Server, Topic, Item) of the pens. Opens a dialog box displaying trend data in tabular layout, which can be printed. Enables the Zoom In and Zoom Out options. Modify trend Opens a dialog box where you can modify the historical trend s parameters. Switch left scales Switches to the next pen scales when the scales are on the left. Switch right scales Switches to the next pen scales when the scales are on the right. Scroll time Enables scrolling historical data. Play pause Stops/resumes the trend. 1/8/07 168

169 P-CIM 7.70 Basic Training Manual Table 58: Panel Layout Table (Continued) Scroll batch Enables scrolling in batches. Move trend Enables selecting and temporarily moving a trend line. Crosshairs Displays the XY parameters in the status bar of a selected trend line. Vert hairline Displays the vertical parameters in the status bar of a selected trend line. Jump to max Jumps to the maximum values. Jump to min. Jumps to the minimum values. Displaying a Real-time Trend In the Operator Workstation open the Manage file. Value updates can be simulated in the Data Scope and viewed during runtime in the trend displayed in the Operator Workstation. 1/8/07 169

170 Afcon Software and Electronics Ltd 13.2 Historical Trends A Historical Trend displays historical data collected by the database server. The address in the historical trend must be a database block that collects history History Collection Data can be saved in historical files and viewed in a historical trend in the Operator Workstation. The historical file created is saved in the following format: YYDDMMnn.HIS. History collection on data blocks is defined in the Database Editor in the Trend Table section. The following parameters can be defined: HST Factor, New format of Historical Term Trend Factor. Enables faster data logging and setting the historical file's size. The number of readings (0-255) to be averaged for each point. HST Period, enables historical data collection of a period of up to a month into a single file. Choose the time period, in months, to collect historical data in a single file. H. T. Factor, defines the number of readings that will be averaged for a point to be recorded in the historical trend file. This is defined as a multiple of the scan time, in the range of 1 to 254. H. T. Step, defines the difference between the new average and the previous value saved in the history file, and causes the new average to be written in the file. The difference is written as a percentage of the engineering span of the block: Low/high limit of an analog value block in the Output table. Low alarm/high alarm of a calculation block. Use either the HST or H.T history file format for each database value. Exercise defining history collection of a temperature block In this exercise you will define that temperature blocks for Tanks 3TK1and 3TK2 collect history. 1. In the Database Editor, double click TANK3TK1_TEMPERATURE to open the second Analog Database Editor dialog box. 2. In the HT Factor field type the number Click OK to return to the first dialog box and then using the instructions above define the 1/8/07 170

171 P-CIM 7.70 Basic Training Manual TANK3TK2_TEMPERATURE block. 4. Click Save DB to save the changes. To modify the number of history blocks, open the Database Configurator and change the History quantity. Exercise creating a historical trend In this exercise you will create a historical trend that displays the temperature of tanks 3TK1 and 3TK2. A historical trend is created in the Animation Editor. 1. Draw a rectangle and select it. 2. Double click on the rectangle to open the Properties List dialog box. 3. Click the Trend button to open the Trends Properties dialog box. Table 59: Pen Dialog Box Parameters Table Field Server Topic Item Description DBSR PCIM TANK3TK1_TEMPERATURE Pattern ####.### Scale top 40 Scale bottom -30 Style Background color Pad color Pen1 color Line Default Default Default 1/8/07 171

172 Afcon Software and Electronics Ltd 4. Check that the Historical option is selected. 5. Click on Pen1 to display the Pen parameter fields. 6. Complete this section using the information in Table 1 Pen Dialog Box Parameters. 7. Click OK. 8. Click the Time X Axis button to display the Time X Axis fields. Table 60: Time X Axis Dialog Box Table Field Description Time span 60 Span units Seconds Sample time 1 Sample units Seconds Time base Before Days 0000 Hours 00 Minutes Complete this section using the information in Table 2 Time X Axis Dialog Box. 10. Click the Time Base button to display the Time Base fields. 11. Complete this section using the information in Table 2 Time X Axis Dialog Box. Table 61: Time Y Axis Dialog Box Table Field Show gridlines Number of major divisions Number of minor divisions Description Checked Default Default 12. Click OK twice. 13. Click the Value Y Axis button to display the Value Y Axis fields. 14. Complete this section using the information in Table 3 Time Y Axis Dialog Box. 15. Click OK. 16. Click the Panel Layout button to display the panel buttons and then click all the buttons in this dialog box. 17. Click OK. 1/8/07 172

173 P-CIM 7.70 Basic Training Manual 18. In the Symbol Id field type HistoricalTrend. 19. Click OK and then save the display. Displaying a Historical Trend In the Operator Workstation open the Manage file, and select the Revert to Saved option to display the Historical Trend. Value updates can be simulated in the Data Scope and viewed during runtime in the Trend displayed in the Operator Workstation. 1/8/07 173

174 Afcon Software and Electronics Ltd 13.3 Dynamic Trends P-CIM 7.50 supports creating Dynamic Trends at any moment in the Operator Workstation. Select up to 8 dynamic items to be included in the trend. Each item is represented in a separate pen and modified from the Dynamic Trend's interface in the same way as the operator would create or update an historical trend. Use the dynamic trend to present historical data that was collected over a long period of time. The trend's sample time is automatically calculated based on the time span. The trend's sample time is automatically calculated based on the defined time span. Items that do not collect historical records cannot be used to create a dynamic trend. If the operator has selected more than 8 items for the dynamic trend, only the first 8 items will be used to create the trend. It is possible to open several displays concurrently. Dynamic Trend option is supported only by P-CIM SEK version 7.50 and above. Working with dynamic trends 1. From an open display in the Operator Workstation select up to 8 items by left-clicking them while holding down the Shift button. A red square suggests a selected item. 1/8/07 174

175 P-CIM 7.70 Basic Training Manual 2. Right-click to display a menu. 3. Select the Historical Trend option to create a dynamic trend based on the data collected by the selected items, the following window is displayed 1/8/07 175

176 Afcon Software and Electronics Ltd 4. To change the trend's settings click the button. The following window is displayed. 5. Using the trend's parameters window it is possible to revise the trend's settings. Click the button to change the time span, time span choices are: Seconds, Minutes, Days and Hours. The following window appears. 6. Click the Time base button to change the trends time base. The following window is displayed. 1/8/07 176

177 P-CIM 7.70 Basic Training Manual 7. Click the name of the pen to change a pen's settings. The following window is displayed: 8. Change the settings accordingly. 9. Click the button to export the trend to a spreadsheet application, such as Microsoft Excel. The following window appears: 1/8/07 177

178 Afcon Software and Electronics Ltd 10. Click the Print All button to print all data in the window.select Print View to print only the presented information in the window.select Excel View to export all items' data to Microsoft Excel spreadsheet application. It is possible to save the data in Excel format. 11. Click to close the dynamic trend window without saving the settings and changes that were made and return to the previous display. 1/8/07 178

179 P-CIM 7.70 Basic Training Manual 1/8/07 179

180 Afcon Software and Electronics Ltd Chapter 14 DOT Fields Use Dot fields during P-CIM runtime to access data blocks' parameters. During runtime the operator, when working in a display, writes a value to the dot field to change data block parameters. The data block is immediately modified (without opening the Database Editor). Dot fields are used to enable, disable and acknowledge alarms, change set points, stop and start generating history and more. In this chapter you will learn about. * Accessing and working with dot fields *.ACK dot field *.ALMHigh dot field *.ALMLow dot field *.ALMEnable dot field 1/8/07 180

181 P-CIM 7.70 Basic Training Manual 14.1 About Dot Fields A list of all dot fields for data blocks can be found in the Syntax Manager DotFields field, which displays the available dot fields for a selected data block. Accessing and working with dot fields 1. Open the Syntax Manager from the P-CIM Development Group. 2. In the Insert field, select Blocks. 3. In the Blocks field, click a block type to display the relevant block dot fields. 4. Double click on the block type. 5. In the DotField, double click a dot field. The selected block and dot field syntax are added to the work area of the Syntax Manager ACK This dot field is used to indicate whether an alarm has been acknowledged or not. It also enables the operator to acknowledge an alarm by modifying the dot field value. 1/8/07 181

182 Afcon Software and Electronics Ltd Table 62: Dot Fields Properties Term Applicable tags Indicates Type Read Description AV, DV, BIT, CL, BL. Alarm condition acknowledged status. R/W, digital. State, data type (as saved on the clipboard) requested by client. This can be: Not acknowledged Acknowledged Operator Workstation Output Text - Formatted text property AlmNAck AlmAck This status is displayed when an alarm has been acknowledged or, when the alarm returns to normal status. All other properties 1 0 Write To acknowledge a data type (as saved on the clipboard) requested by the client. Operator Workstation Input Text - Formatted text Property AlmAck or 1 All other properties 1 As of P-CIM version 7.00, the NotReturnToAckifNormal = 0 (default) switch can cause behavior changes in the AlmAck status. This switch is accessed using the P-CIM Project Setup as follows: From the project's folder's, expand the Database Server and double-click the Alarm Ack Status Return to normal behavior subdirectory. If this switch is set to 1, the.ack dot field status does not change when the alarm returns to normal status and remains as AlmNAck ALMHigh This dot field displays the highest alarm level defined for a block in the Database Editor. The alarm level can be updated during runtime by the operator. 1/8/07 182

183 P-CIM 7.70 Basic Training Manual Table 63:.ALMHigh Term Applicable tags Indicates Type Read Write Description AV, CL. Highest alarm level. R/W, analog, floating. Number Number ALMLow This dot field displays the lowest alarm level defined for a block in the Database Editor. The alarm level can be updated during runtime by the operator. Table 64:.ALMLow Term Applicable tags Indicates Type Read Write Description AV, CL. Lowest alarm level. R/W, analog, floating. Number Number ALMEnable This dot field indicates if alarm processing is enabled or disabled. During runtime the.almenable dot field enables the operator to enable or disable processing of alarms. Table 65:.ALMEnable Term Applicable tags Indicates Type Read Description AV, DV, BIT, CL, BL Alarm processing disabled or enabled. R/W, digital. Data type per clipboard format requested by client. Disabled Enabled Operator Workstation 1/8/07 183

184 Afcon Software and Electronics Ltd Table 65:.ALMEnable (Continued) Output Text - Formatted text AlmDsb AlmEnb All other 0 1 Write The command (data type same as Read). Exercise adding dot fields to a display In this exercise you will create a new display with input/output text and dot fields. During runtime when an input text field is filled, the operator can enable/disable alarms and view alarm status. 1. Open a new display and save it as: Valvealm. Resize it and add a background color. 2. Create a text object and add the following text: Enable/Disable Alarm. Table 66: Valve Alarm Table Field Display title Description Valvealm 1/8/07 184

185 P-CIM 7.70 Basic Training Manual Table 66: Valve Alarm Table Text objects Two text objects as follows: Enable/Disable Alarm Alarm Status Input/output text objects Text properties applied to: Two text objects Symbol Id Input Output Server/Topic /Item Format Mode 1 Enable/disable Alarm text ALM_3V101AlmEnabl e Selecte d Selecte d DBSR PCIM Free formatted 2 Alarm status text ALM_3V101AlmStatu s Selecte d DBSR PCIM Text for On/ Off: On = enable Off = disable for both commands and indications. Alarm indicators Close button This table has been added for the convenience of the operator. It has five text objects: Alarm Indicators 0=Normal 10=On 9=Off 11=COS Action up command: Close][ 3. Create another text object and add Input text properties using the information defined for number 1 in the Valve Alarm table. Position this text opposite the first text object. 4. Create the Alarm Status text and Output text objects using the instructions above and the information defined for number 2 in the Valve Alarm table. 5. Optional, create the Alarm Indicators table. 6. Optional, create a button and add the following Action Up command: Close][. 7. Open the Valvealm display in the Operator Workstation and enable/disable the alarm. Open the DataScope in the Item field type ALM_3V101 and in the Value field type On. When the alarm is disabled, check that the alarm is not triggered. 1/8/07 185

186 Afcon Software and Electronics Ltd Chapter 15 Dynamic Display Use Dynamic Display to optimize your P-CIM project and to save time during project development and maintenance. Using the Dynamic Display, one generic object is defined to represent multiple similar devices. During runtime, the dynamic display is used as a template that has dynamic links that change when an object is selected. In this chapter you will learn about. * Creating.GRP files * Create a dynamic display * Create a main display Create the Notepad.GRP file Create a dynamic display Design a main display 1/8/07 186

187 P-CIM 7.70 Basic Training Manual 15.1 About Dynamic Displays The Product display in the Yogurt project has two tanks and their information. In reality, a plant will have any number of tanks. During development, to save time in display development and future maintenance, a single dynamic display can be created that is updated during runtime with the information of each individual tank. A Dynamic Display has three parts: *.GRP file, which is created in Notepad and built of groups representing the group s data. For example; a group for each device, where each group has a list of addresses of the device. * Dynamic display. * Main display. During runtime, the operator clicks on an object in the main display to open another display showing the data of the selected object. In the background, once the operator clicks the object in the main display, P-CIM searches the.grp file to find the object s group. It then links between the object and the group s address. When a different object is selected, the data s addresses change according to the selected object in the main display The.GRP File A.GRP file is created in Notepad in.ini format. It has the following structure: [ Group 1] 1=data 2=data... [ Group 2] 1=data 2=data 1/8/07 187

188 Afcon Software and Electronics Ltd Exercise creating the Tank.GRP file In this exercise you will create the Tank.GRP file holding information about two Yogurt tanks. 1. Open Notepad and create a new file named Tank.GRP. Save it in the Yogurt folder. 2. Create a group named 3TK1. 3. Under the group s name, add the group s data using the information in the Creating a.grp File table. Table 67: Creating a.grp File Table Field Description Group 1 3TK1 [3tk1] 1= 1:1:11 Mixer of Tank 3TK1 2= 1:1:40004 Tank 3TK1 level Group 2 3TK2 [3tk2] 1= 1:1:12 Mixer of Tank 3TK2 2= 1:1:40005 Tank 3TK2 level 4. Create the second group using the instructions above and the information in the Creating a.grp File table. 5. Save the Tank.GRP file in the project Creating a Dynamic Display A dynamic display is a graphic display used as a template. The objects in the display have aliases that are saved in the pfwalias.txt file. The first time the display is opened, the.grp file writes data from the selected group to the pfwalias.txt file. When the displayed is opened, it reads the addresses from the aliases in the pfwalias.txt file. 1/8/07 188

189 P-CIM 7.70 Basic Training Manual The name of the.grp file and the display must be identical. When working with sub folders, the.grp file is saved under the Display folder. Exercise creating the tank s dynamic display In this exercise you will create the Yogurt tank s dynamic display. In addition, you will also create the updates (that are linked to aliases) that display tank information. 1. In the Animation Editor create a new display and save it as Tank. 2. Copy the tank cell from the Product display and using the Paste Cell option paste it in to the Tank display. Copy a green and red button set from the Product display. Using the Paste Include Properties option, paste the buttons into the Tank display. Table 68: Creating a Dynamic Display Table Object Dialog Box Field Syntax Tank text Properties List, Output Text Symbol Id Server Tank.Group OWS Topic Pcim Item Tank circular window Properties List, Visibility Item Server: DBSR Topic: Pcim Item: &Tank.1& Tank bar Properties List, Fluid Fill Item Server: DBSR Topic: Pcim Item: &Tank.2& 1/8/07 189

190 Afcon Software and Electronics Ltd Table 68: Creating a Dynamic Display Table (Continued) Green and red buttons Properties List Symbol Id Set!&Tank.1& 1 Set!&Tank.1& 0 Close button Properties List Action Button Symbol Id Close ][ Action up 3. Using the Creating a Dynamic Display Table set the properties for the circular window, text and bar as follows: Press the Alt button and then select the object. Release the Alt button. Right click/ctrl P and open the Properties dialog box In the Tank Text object modify the Symbol Id, Server, Topic and Item fields to match those in the Creating a Dynamic Display table In the Tank Circular Window and Tank Bar modify the Item field only using the information in the Creating a Dynamic Display table. 4. Create the Close button. 5. Save the display in the project Creating the Main Display The main display refers to the display from which the dynamic display is opened. A display contains the graphical objects, which when clicked by the operator, open the dynamic display of the relevant group. The command that generates this operation is the Open by group command that has the following syntax: Open display -G:group Table 69: Action Command Legend Command Open Display Description The command that opens the display. This field is mandatory. The name of the dynamic display. -G The display that replaces the previously opened display each time it is opened. +G The display that is added to the previously opened display each time it is opened. :group Group name as written in the.grp file. 1/8/07 190

191 P-CIM 7.70 Basic Training Manual Exercise defining the main display In this exercise you will add the Open by Group command to both tanks. 1. Open the Product display and select the 3TK1 object. 2. Open the Properties List Action Button dialog box, and type the following in the Action Up field: Open tank G:3TK1 3. Repeat the above and define the 3TK2 object. 4. Save the display. 5. Jump to the Operator Workstation and open the Production display. 6. From the file menu select the Revert to Save option. 7. Click the 3TK1 and 3TK2 objects and check that the tank display opens with the relevant information. 1/8/07 191

192 Afcon Software and Electronics Ltd Chapter 16 Recipes A Recipe is a group of data items that sends and receives values to and from the PLC. During runtime, recipes are loaded or learned to or from the PLC. The result of a recipe may change values in the PLC or the recipe files. In this chapter you will learn about. How to define recipes in the Recipe Editor How recipes are used during runtime Create a recipe in the Recipe Editor In the Animation Editor, define recipe commands to load/learn the recipe During runtime, run recipes 1/8/07 192

193 P-CIM 7.70 Basic Training Manual 16.1 About Recipes A recipe is held in a recipe file and contains groups of addresses and different sets of values. Each set of values holds different instructions. The same group of addresses can receive many sets of values to perform different tasks. Recipes can be defined to run automatically, or by an operator by clicking an action button. For example, Yogurt can have three flavors, pineapple, strawberry and plain. On the day that pineapple flavored Yogurt is made, the operator clicks the Pineapple button. This sends the Pineapple recipe to the PLC, which then triggers the pineapple flavor to be added to the Yogurt mixture Defining Recipes Recipes are created in the Recipe Editor dialog box and saved in the Recipe file, from/to they can be exported/imported in CSV format. Accessing the Recipe Editor 1. To access the Recipe Editor dialog box either: 2. Click the Recipe Editor icon in the P-CIM Development Group. Or, in the Animation Editor, Database Editor or Report Editor, Tools menu select the Recipe Editor option. 1/8/07 193

194 Afcon Software and Electronics Ltd To edit Group parameters, type in your modifications and then click the Change button. To edit Settings, type in your modifications and then click the Change button. Exercise defining a recipe In this exercise you will create a recipe that has two groups of addresses, one for each Yogurt type. Each group has a set of addresses representing the products and their quantities required to make Yogurt. During runtime, a recipe can be loaded/learned to generate the production of a Yogurt flavor. 1. In the Recipe Editor Description field type Yogurt Dept. Table 70: Groups Table Group Name I/O Wait Time-out Addresses Load Source Note Actions Strawberry 3 10!&Tank.3& 10 Milk Success Set!$Lastevent!&Tank.4& 20 Flavor Strawberry Recipe Success!&Tank.5& 5 Fat Pineapple 3 10!&Tank.3& 10 Milk Success Set!$Lastevent!&Tank.4& 20 Flavor Pineapple Recipe Success!&Tank.5& 1 Fat In the Group section define the first group s parameters: In the Name field type Strawberry. 2. In the I/O Wait field type in 3 to define the time that the recipe waits until a value is requested from the PLC. 3. In the Time-out field, typein 10 to define the time that the recipe waits for a response from the PLC before declaring timeout. 4. Define the message that will appear in the Alarm Summary after the recipe is successfully generated. In the Action On section Success field write the following: 5. Set!$lastevent Strawberry Recipe Success. 6. Click the Add button. 7. In the Address field type the following:!&tank.3&. 8. In the Load Source field type 10. Click the Add button. 9. Complete the recipe using the information in the Groups table. 10. Save the Recipe as Yogurt. 1/8/07 194

195 P-CIM 7.70 Basic Training Manual Using Recipes during Runtime During runtime there are four recipe operations: Load Learn Read, not covered in this manual. Save, not covered in this manual. The results of a recipe can be successful, failed or time-out, and can generate actions. A recipe will only run when all item values and addresses are correct and there are no communication problems. Loading Recipes When a recipe is loaded a set of values is sent from the recipe file to the PLC. The following action command LoadRcp [Recipe [fromgroup]] is used to generate a recipe and is used when defining Action buttons or an AutoAction. Remember: The [] are not part of the syntax. Table 71: Command Legend LoadRcp The command used to load a recipe. Recipe Recipe name These fields are optional. fromgroup Group name When these fields are not filled, the recipe and groups are manually selected by the operator during runtime. When a recipe is processed an indicator can be displayed using the Gdisplay Server recipebusy item. Learning Recipes When a recipe is learned a set of values is sent from the PLC to the Recipe file. The following action command LearnRcp [Recipe [fromgroup][togroup]] is used to learn a recipe and is used when defining Action buttons or an AutoAction. 1/8/07 195

196 Afcon Software and Electronics Ltd Remember: The [] are not part of the syntax. Table 72: Command Legend Command Description LearnRcp The command used to learn a recipe Recipe Recipe name These fields are optional. FromGroup Group name When these fields are not filled the recipe and groups are manually selected by the operator during runtime. ToGroup Group name Writing the FromGroup and ToGroup functions indicate that the recipe is copied from the first group into the second group. If the ToGroup is not defined in the recipe file, a new group is automatically created. In this exercise you will create two action buttons that when clicked open a dialog box where the Yogurt Exercise adding action buttons to load and learn a recipe recipe can be selected and loaded/learned to/from the PLC. 1/8/07 196

197 P-CIM 7.70 Basic Training Manual Table 73: Load/learn Recipe Table Field Description Field Description Field Description Load recipe button Action Button Properties Symbol Id LoadRcp Button text Load Recipe Action up Learn recipe button Action Button Properties Symbol Id LearnRcp Button text Learn Recipe Action up 1/8/07 197

198 Afcon Software and Electronics Ltd Displaying the Recipe s Information in the Dynamic Display Before doing the actual exercise build the recipe s display, and add the following recipe addresses to the Tank.GRP file. [3tk1] 3=1:1: =1:1: =1:1:40302 [3tk2] 3=1:1: =1:1: =1:1: Draw the graphical objects using the information in the Dynamic Display table. Table 74: Dynamic Display Table Graphical Object Description Address 3 input text objects Milk &tank.3& Flavor Fat &tank.4& &tank.5& 3 fluid fill bars Milk &tank.3& Flavor Fat &tank.4& &tank.5& 3 slider objects Milk &tank.3& Flavor Fat &tank.4& &tank.5& 1. In the Animation Editor draw two buttons with the following text: Load Recipe and Learn Recipe. 2. In the Action Button Properties dialog box define the Load Recipe command as follows: LoadRcp. 3. Create an indicator and in the Item field (Table 2) type RecipeBusy. 4. Save the display. 5. Move to the Operator Workstation, open the Product display and click on a tank s button. 6. Click the Load/Learn Recipe button to load/learn the recipe to/from the PLC. 1/8/07 198

199 P-CIM 7.70 Basic Training Manual Chapter 17 Reports Use the Reports module to create and display customized reports. In this chapter you will learn about. The different report formats Building a report template Generating and viewing reports during runtime Create a report in the Report Editor Create an action button to generate the report Create an action button to display the report Create the report s progress indicator 1/8/07 199

200 Afcon Software and Electronics Ltd 17.1 About Reports Reports display information about the plant and its processes. During runtime, reports can be generated periodically at set times, triggered by an event, or produced by demand when an action button is pressed. A report is generated in two stages: Data collection, where data is gathered and saved into files. Data display, where the data is displayed as a report. Reports can be generated in four formats: TXT, where the report is displayed in a TXT file such as Notepad. DBF, where reports are displayed in Excel or Crystal Reports. Any database that has an ODBC driver, for example in Excel, Access, SQL. This format is not discussed in this manual. Supreme Report, where the report is designed and generated in the Supreme Report Studio and displayed in PDF format. After a report is displayed, different actions can be triggered according to the results received. Crystal Reports is an external reports generator software Defining and Formatting Report Templates Reports are defined in the Report Data Editor dialog box. Accessing the Reports Editor 1. In the P-CIM Development Group click the Reports Editor icon. 1/8/07 200

201 P-CIM 7.70 Basic Training Manual You can also open this module through the Animation Editor or Database Editor modules Defining a TXT Report The TXT report option is used to generate a report in.txt format. This type of report is easy to generate and is used for documenting logs. Exercise defining a temperature and PH level text report In this exercise you will create a TXT report that displays status information about temperature and PH level of the yogurt tanks. 1. From the Reports menu, select the Text option to open the Report Data Editor TXT dialog box. 1/8/07 201

202 Afcon Software and Electronics Ltd 2. Click the Date and Time buttons to add the DDE items $Date and $Time. 3. From the Edit menu, select the Insert Field option to open the Insert Field dialog box. 4. Enter the parameters appearing in the Status Information Report table. 5. Repeat these instructions and add the DDE addresses using the information in the Status Information Report table. Table 75: Status Information Report Table Field Description Tank 3TK1 Temperature {!TANK3TK1_PH ####.##} PH {!TANK3TK1_TEMPERATURE ####.##} Tank 3TK2 Temperature {!TANK3TK2_PH ####.##} PH {!TANK3TK2_TEMPERATURE ####.##} 6. From the Reports menu, select the Configure option to open the Configure TXT dialog box. 1/8/07 202

203 P-CIM 7.70 Basic Training Manual 7. Define the Time Out field as Define the I/O Wait field as Define the message that will appear in the Alarm Summary after the report is successfully generated. In the Action On section Success field write the following: 10. Set!$lastevent Pasteurization Report generated successfully. 11. Save the Report as Status Running and Viewing Reports The following command is used to generate a report. RepData {txt dbf odbc} inrep {outrep odbc-table} [-P] [-S] Remember: The [] and {} are not part of the syntax. Table 76: Command Legend Command RepData {txt dbf odbc} inrep {outrep odbctable} Description The command that generates the report. Select the type of report that is generated, TXT, DBF or ODBC. The name of the report template without the path file name and its extension. The name of a report in a TXT template with/without a path and without an extension. A report name can have up to 8 characters. When an ODBC report is defined, it defines the name of the table. 1/8/07 203

204 Afcon Software and Electronics Ltd Table 76: Command Legend [-P] [-S] Defines that after the report is generated it is automatically printed. Optional and used only in a TXT report. Defines that the report template and argument are not saved to memory. Optional. The above commands can be used for action buttons and AutoActions. When a report is processed, an indicator can be displayed using the Gdisplay Server ReportBusy item. 1/8/07 204

205 P-CIM 7.70 Basic Training Manual Exercise generating a txt report In this exercise you will create two action buttons: A button that generates a text report. A button that opens Notepad where the report can be viewed. You will also create an indicator object that blinks when the report is generated. 1. Open the Manage display in the Animation Editor, and create two actions buttons with the parameters from Text Report Table 1. Table 77: Text Report Object Symbol Id Action Up Command Button 1 RepData txt status Report1 Button 2 Run notepad &pcimutil&report1 2. To create the indicator, create a text object with the following text: Report in process. Follow instructions on page 96. 1/8/07 205

206 Afcon Software and Electronics Ltd Table 78: Text Report Field Server Topic Item When off When on Description Gdisplay Pcim Reportbusy Invisible Blink 3. Set Visibility parameters using the information in Text Report Table Save the display as Manage. 5. Open the Operator Workstation and the Manage display. Click the Revert to Save option to update the display. 6. Click Button 1 to generate the report. The indicator blinks. 7. Wait until the report is processed. The indicator is no longer displayed. 8. Click Button 2 to view the report in Notepad. The next time that a report is generated it is displayed in the same TXT file under the last generated report Defining a DBF Report A DBF report has a heading under which data is displayed. Each time a report is generated a new line is added under the last reported (recorded) line. Exercise creating and generating a DBF report In this exercise you will create a DBF report that displays status information about the temperature and PH level of the Yogurt tanks. Two buttons are created: A button to generate the report. A button to display the report in Excel. 1. From the Reports menu select the dbase option. 1/8/07 206

207 P-CIM 7.70 Basic Training Manual 2. Define the DDE items using the information in the DBF Report table. Table 79: DBF Report Column DDE Address Field Type Width Decimal 1!$DataStr XDATE Character 8 0 2!$TimeStr XTIME Character TANK3TK1_TEMPERATURE Tank1_TMP Numeric TANK3TK2_TEMPERATURE Tank2_TMP Numeric TANK3TK1_PH Tank1_PH Numeric TANK3TK2_PH Tank2_PH Numeric Add the information in the DBF Report Table 2 table to the report. After each entry click the Add button. 4. From the Reports menu select the Configure option to open the Configure dialog box. Define the Time Out field as 30. Define the IO Wait field as Define the message that will appear in the Alarm Summary after the report is successfully generated. In the Action on section, Success field write the following: Set!$lastevent Status Report generated successfully. 1/8/07 207

208 Afcon Software and Electronics Ltd 6. Save the report as Status. 7. Open the Animation Editor and using the information on page 105, create the action buttons that will run and display the report during runtime. Table 80: DBF Report Object Symbol Id Action Up Command Button 1 RepData dbf status Report2 Button 2 Run C:\Program Files\Microsoft Office\Office\excel.exe &pcimutil&report2.dbf. This path depends on where the Excel program is installed on your computer. 8. Save the display. 9. Open the Operator Workstation and click the Revert to Save option to update the display. 10. Press Button 1 to run the report. 11. Press Button 2 to open the report in Excel Defining the Supreme Report The Supreme Report reporting program generates content-rich reports using an user-friendly interface. For more information about using the Supreme Report program, refer to the Supreme Report User Guide found on the Afcon CD or download the document from the Afcon web site. Exercise creating and generating a Supreme Report report In this exercise you will create a Supreme Report report that displays status information about the temperature of the Yogurt tanks. 1 Open the Supreme Report Studio from the P-CIM Development group. 2 Select the New Project option and click on the New button. Type in the name of the project. You can also add a free text description of the project and the author s name. Click OK. Make sure to use the exact same name as the P-CIM project. For example, Yogurt_Project. 3 The Supreme Report Studio interface opens. From the Logger menu, select the Driver Configuration option to setup the connection to the P-CIM project. The following window opens: 1/8/07 208

209 P-CIM 7.70 Basic Training Manual 4 In the Source Name field type P-CIM. From the Data Driver pull-down menu, select the driver named P-CIM Native Driver. Repeat this procedure in both the Alarm and History drivers menus 5 Click the Add Definition button to add the new entry to the list. Click OK to close the window. 6 From the Supreme Report main window, click on the Logger Studio tab. From the Logger menu, select the Add Group option and click on the Add Item Group entry. 7 The Logger Group configuration window opens. Type in the group name Yogurt. From the Group Source pull-down menu, choose the driver you have configured in step 4. 8 Click the Add Items button to add items to the group. The following window opens: 1/8/07 209

210 Afcon Software and Electronics Ltd 9 Expend the DBSR group, click on the P-CIM folder to view the list of database blocks. From the AV block s list, highlight the following items: Tank3TK1_TEMPERATURE, TanK3TK2_TEMPERATURE and Tank3TK1_PH. 10 Click the Add button to add the items to the list. Click OK when finished. The items appear in the logger s main window. 11 From the Logger main, click the Add Group option and select the Add Alarm Group entry. Typein the group s name: Temperature_Alarms in the group name filed. 12 Select the P-CIM driver from the pull-down menu and set the Priority Filter to the range of between You have completed setting up the communication and database settings for the Yogurt project.move to the Report Designer Studio, by clicking on the tab on the left side of the screen, to design your report. 13 From the File menu, select the New\New Report option. Type in the report s name Temperature. 1/8/07 210

211 P-CIM 7.70 Basic Training Manual 14 Click on the Report Name Format tab and change the report s name to the name of the project you have previously created. Click OK and save the project. 15 Click the Text box item from the tool-bar and draw a rectangle anywhere on the right-hand side of the screen. Type in the report s title. 16 From the Supreme Report Elements tools-bar, click on the Item Table button. Draw a rectangle anywhere in the right-hand side of the screen. The Item Table properties window opens. 17 Fill-in the information from the table below: Table 81: Supreme Report report settings Field Name Table 82: Value Get Data From Edit List Value Range Define Time Period Start of report period End of report period Appearance Tab Use default settings Select P-CIM data source and add existing items from the list Use default settings Use default settings Use default settings Use default settings Check Display Table Name. Type in Tank3TK1_TEMPERATURE 18 From the Run Time menu select the Run Project option. The following window opens: 1/8/07 211

212 Afcon Software and Electronics Ltd 19 Check the Activate check box next to the Temperature report. Click the Generate button to generate the report. To view the report, click on the Open Report File button. Reports are stored in the following location: \Pcim32\SupremeR\Projects\Project_Name\Reports. Whenever changes are made to the project, press the Reload Project button to load the most updated version of the project. Make sure to save the project after every change you make. 1/8/07 212

213 P-CIM 7.70 Basic Training Manual Chapter 18 Text File Server The P-CIM Text File Server is a P-CIM server that can be used to access data over DDE protocol in the following format: Text files. INI files. Dbase files (DBF). Any database format supported by ODBC. This chapter discusses Text and INI files. In this chapter you will learn about. Accessing the text file data Accessing the INI file data Adding P-CIM INI file addresses to text files Defining P-CIM addresses in INI files 1/8/07 213

214 Afcon Software and Electronics Ltd 18.1 About the Text File Server The Text File Server, using DDE protocol, enables access to the following file formats: Text, to a string specified by row, column and length. Windows INI, to a single token value specified by section and token name. The Text File Server can be used to access data in text files: File format, a text file can be created in Notepad or any other text editor. It is built of rows of text containing printable characters and spaces. Each row ends with CR-LF. (Carriage Return, Line Feed). Accessing file data, the data in the file is accessed by calling the following: Row number. Column number. Number of characters. Reading text file data, when the Text File Server and text file are referenced through a DDE address, a string from the row and column is returned to the application: String length, indicating either the number of characters specified in the location or, the actual number of characters to the end of the row. If the column position is specified beyond the actual row, an error message is displayed. Writing to text file data, when the client writes to the DDE address, text is inserted into the location in the client application: When a row is specified as a positive/negative number it overwrites the text in the designated location. When the row is specified as A, it appends a row to the end of the file. When using the Text File Server in the database or in basic scripts, run the TXTSRV during P-CIM start up. For further information see page 248. If the Text File Server is used in the Operator Workstation, it runs automatically Defining the DDE Address to the Text File The table below displays the DDE address syntax used for the Text File Server. This syntax is not case sensitive. 1/8/07 214

215 P-CIM 7.70 Basic Training Manual Table 83: Defining a DDE Address in the text file Field Server Name Topic Item Description TXTSRV Specifying the file path. For example: C:\Notes\Texts.TXT Specified as follows: TXT (row, column, length [,writemode]) Where: Row Column Length WriteMode Specifies the row number within the file relative to the file s start or end. A positive number is used for the beginning of the file, where row 1 is the first row. A negative number is used for the end of the file, where row 1 is the last row. The letter A is used to append the row to the end of the file. Specifies the column number in the row. Column 1 is the first column. Specifies the number of characters to access. Specifies the justification and padding for writing to the file: L = left justification. LP = left justification and padded (default). R = right justification. RP = right justification and padded Reading INI File Data When data is read from a file its location in the file is specified as section name, token name and default value. An INI file can contain several sections, where each section has a group of settings. The sections and settings are listed in the INI file in the following format: Table 84: INI File Formats Field [Section Name] Description Indicating the name of the section. 1/8/07 215

216 Afcon Software and Electronics Ltd Table 84: INI File Formats Token String Indicating the name of each setting: The token name must be unique in each section and can have up to 32 characters. Any combination of characters/digits can be used in either upper or lower case. The = (equals) sign cannot be used. Either an integer or string, depending on the setting. If comments are used in INI files, each line must begin with a semi colon (;). The minimum requirement is that the file exists; even it is of zero length. Do not access the same file in INI format or text format at the same time. Below is an example of an INI file: [ Section1] Token 1= String 1 Token 2= String 2... [ Section2] Token 1= String 1 Token 2= String Defining the DDE Link to the INI File Server, Topic and Item syntax is described in the table below: Table 85: Defining DDE Link in INI file Field Description Server Name TXTSRV Topic Indicating the file specification, including path and extension. For example: C:\Notes\Texts.INI 1/8/07 216

217 P-CIM 7.70 Basic Training Manual Table 85: Defining DDE Link in INI file Item Specified in the following format: INI (section,token[,default]) Where: Section Indicates the section name (no brackets []). Token Default Indicates the token name in the section. Indicates the default value to be returned to the client if the section/ token do not exist. Exercise reading and writing from a file in INI file format In this exercise you will create a text object that is used to change the name of the Quality Test Manager performing the quality control test. This exercise has two stages, editing an INI file in the INI File Editor, and creating two text objects. The INI file is created in Notepad. When text is updated in the text object, the INI file is also modified. 1. Open the INI File Editor and edit the INI file using the information in the INI File Format table. See page 65. 1/8/07 217

218 Afcon Software and Electronics Ltd Table 86: INI File Format Table Field INI file name Section name Token name String name Text 1 Description C/PCIM32/Yogurt/PFWAlias.txt Managers Name David B Quality Test Manager Text 2 Input text Symbol Id ini(managers,name) Server Topic TxtSrv &PcimUtil&PfwAlias.txt Item Mode Free formatted 2. Open the Product display and create Text 1. This text is for display only and therefore has no properties. Position the text in a colored square next to tank 3TK2. 3. Create Text 2 using the information in the INI File Format table. Position it under Text Save the display and open it in the Operator Workstation. Select Revert to Save and then enter new text in the input text box. 5. Open the INI file in the INI File Editor. Check that the new name is entered in the String Name field. 1/8/07 218

219 P-CIM 7.70 Basic Training Manual Chapter 19 Security P-CIM controls and runs all plant s processes. During runtime, these processes are viewed in the Operator Workstation where the operator can activate commands and actions by clicking different buttons. There may be activities that are restricted and are only available to certain operators, who have specialized knowledge and responsibilities. In P-CIM passwords and access levels are used to restrict operator access. This could be access to a display, where a password is required to login, or access to an object in a display. IF SECURITY IS NOT DEFINED FOR A DISPLAY OR OBJECT, IT CAN BE ACCESSED BY ALL OPERATORS. In this chapter you will learn about. Passwords Creating passwords Checking that passwords work Using Windows Authentication Using Modules Security Using Audit Trail 1/8/07 219

220 Afcon Software and Electronics Ltd 19.1 Security Privileges We recommend that when you start designing your project you define its security requirements, for example; operator access, restrictions and so on. During project development, add security privileges whilst you create the project. This will save you a lot of time later on. Operator access can be limited to the following: Operator Workstation menu commands. Opening specific displays. Operating specific controls in a specific display. Viewing specific controls in a specific display. Runtime keyboard and mouse security Defining Users and Passwords During development, a list of users is created and given authorization to run and view processes. Each user has a username and password. In runtime these usernames and passwords are used to login. User authorization is assigned in levels: 0 99 The highest level is 0 allowing the user full control to all areas of the project. The lowest level is 99, whereby the user has restricted authorization. There are two default levels: Username = P-CIM, Password = P-CIM, Level = 0. Username = Null, Password = Null, Level = 99, indicating a blank login. NULL definitions are hard coded and cannot be deleted or modified. Exercise defining security privileges In this exercise you will define security privileges for three users: Manager, the person in charge of the plant. Engineer, the person who developed the Yogurt project. Operator, the person operating the machinery. 1/8/07 220

221 P-CIM 7.70 Basic Training Manual 1. In the Animation Editor, Tools menu select the Password Editor option to open the Password Editor dialog box. This dialog box can also be accessed through the Database Editor and the Reports Editor dialog boxes, Tools option. Table 87: Security Privileges Table User Level Username Password Manager 0 MNG MNG Engineer 50 ENG ENG Operator 99 OPR OPR 2. Create security permission for the three users by completing the Level, Username and Password fields using the information in the Security Privileges table. 3. Click the Add button to add this information to the list and then click the Save button Logging In During Runtime During runtime when users log in to the system, they receive the security privileges that have been defined for them. If users do not login, they receive minimal security privileges. Users can either login: Using the Operator Workstation Login option. 1/8/07 221

222 Afcon Software and Electronics Ltd Pressing a Login button. Through an AutoAction. The Login Action command is: Login [username password] The Login command can also be used for automatic login, when using a specified username and password. Table 88: Action Command Legend Field Login Description The command that logs in the user. This field is mandatory. Username The given username These fields are optional. Password The password of the user When these fields are filled a user is automatically logged in. Remember: The [] are not part of the syntax 1/8/07 222

223 P-CIM 7.70 Basic Training Manual Exercise creating a login button In this exercise you will create a Login button using the information in the Login table. 1. Open the Product display in the Animation Editor. Draw a square. 2. Create the text and then group the square and the text into one object. 3. Select the object and open the Properties List dialog box. 4. Click the Action Button option and complete the dialog box using the information in the Login table. 5. Click OK and save. Table 89: Login Table Object Symbol Id Action Up Command Button 1 Login Text Prompt Login Login 6. Open the Operator Workstation and then login using the user names that you defined. After logging in the name of the user appears in the title bar Logging Out During Runtime Logging in at a lower authorization level: Disables features that are not authorized for the level. Prevents opening displays that are not authorized. The command login null null logs in with the lowest security privileges. 1/8/07 223

224 Afcon Software and Electronics Ltd Exercise creating a logout button In this exercise you will create a log out button using the information in the Logout table. 1. Open the Product display in the Animation Editor and draw a square. Table 90: Logout Table Object Symbol Id Action Up Command Button 1 Login null null Text Prompt Logout Logout 2. Add the text. 3. Group the square and the text into one object. 4. Select the logout object and then open the Properties List dialog box. 5. Click the Action Button option and complete the dialog box fields using the information in the Logout table. 6. Click OK and save. 7. Open the Operator Workstation and then click the Logout button. After logging out the name of the user appears in the title bar Security for Operator Workstation Menu Commands Denie access from users to menu commands that are above their authorization level. This includes: Control menu, for example: Restore, Minimize, Close, and so on. Menu bar options. 1/8/07 224

225 P-CIM 7.70 Basic Training Manual Exercise creating access restrictions for the exit command In this exercise you will create access restrictions for the Exit command menu, whereby a user cannot close the Operator Workstation during runtime. 1. In the Operator Workstation log in using the highest level which is: PCIM PCIM. 2. Open the Options menu and check the Menu Authorization option. The title bar displays the Menu Authorization mode. 3. In the File menu select the Exit command. 4. Type 0 in the Level field and click OK. 5. To exit the Menu Authorization mode, in the Options menu check Menu Authorization. 6. Check that the Menu Authorization mode is not displayed in the title bar. 7. Login to the Operator Workstation using the following username and password: OPR and OPR. The Exit command is disabled. 8. Check that the OPR username is displayed in the title bar. The Menu Authorization option is only available at the highest security level, which is Security for Opening a Display Users can be denied access to specific displays that are above their authorization level. In addition, data entry level can be defined for users that have access to the display. Exercise restricting users from opening a display 1/8/07 225

226 Afcon Software and Electronics Ltd In this exercise you will define restrictions for opening the Manage display, whereby only authorized users can access it. For example; ENG and MNG. If users defined as OPR attempt to access the display, a message will open informing them that they do not have authorization to open the display. 1. In the Animation Editor, open the Manage display. 2. From the Display menu, select Password to open the Password Level dialog box. Table 91: Display Password Level Table Open display level 0 Data entry level 0 3. Complete the dialog box using the information in the Restricted Users table. 4. Save the display and then open the Operator Workstation. 5. Login as the Operator: OPR OPR 6. From the File menu select Open and then select the Manage display. A message will open on your screen informing you that access is denied Adding Authorization to Specific Controls in a Specific Display Access to specific controls in a display can be denied to users if the password level of the control is above their authorized level. Exercise restricting access to controls In this exercise you will create the Quality Test Controls panel, which can be used during runtime to 1/8/07 226

227 P-CIM 7.70 Basic Training Manual run the quality test. The Manager will be authorized to enter the quality tester s name, perform the test and to confirm the results. The Engineer will be authorized run the test. The Operator will not see the Quality Test Controls panel. 1/8/07 227

228 Afcon Software and Electronics Ltd 1. Open the Product display, and in the Quality Manager Test panel create two action buttons and their text. 2. Group each action button and its text so that you have two objects. 3. Add properties to the action buttons using the information in the Restricting Access to Controls table. Table 92: Restricting Access to Controls Table Field Input text Description Quality Test Manager Properties Password Level 99 Input Text Password Level 0 Rectangle 1 Property Action Button Symbol Id Set!d:100 1 Properties password level 50 Action up Prompt Mouse operations Start Quality Test Click Action password level 50 Text for rectangle 1 Text Start Quality Test Rectangle 2 Property Action Button Symbol Id Set!d:100 0 Properties password level 50 Action up Prompt Mouse operations Confirm Quality Test Click Action password level 0 Text for rectangle 2 Text Confirm Quality Test 4. Add the password levels to the Quality Test Manager s input text properties. 5. Save the display and open the Operator Workstation. From the File menu select the Revert to Save option. 6. Login using the MNG, ENG or OPR usernames to test panel s security. 1/8/07 228

229 P-CIM 7.70 Basic Training Manual Runtime Keyboard and Mouse Security P-CIM runs in a Windows environment where several applications can run at the same time. To prevent users exiting P-CIM during runtime you can lock the Windows combination keys, for example ALT SHIFT, CTRL ALT DEL and more. Displaying Windows Keyboard Combination Commands Windows has keyboard combinations that can be used to switch between applications. During runtime these options can be disabled using the following commands: Run &PcimPath&&disenbalt.exe D, disables the keyboard. Run &PcimPath&&disenbalt.exe, enables the keyboard. Displaying Secure Windows The Operator Workstation window can be displayed without a title bar, menu bar and resizing options. This is useful for preventing the operator from shutting down P-CIM during runtime or resizing the window. These options can be defined in the Animation Editor by selecting Operator Workstation Setup in the Options menu, and then checking/unchecking the required option. 1/8/07 229

230 Afcon Software and Electronics Ltd 19.4 Password Editor The P-CIM Authentication module has been significantly improved in P-CIM 7.50 to interact with Windows' Security mechanism. The user authentication process has been improved to include Windows user accounts and not only P-CIM user accounts. Operators use their Windows log-in accounts to log-in to P-CIM various modules and displays. Working in Simple Password Mode 1. From the Administrative Tools group, open the Password Editor module. The default mode is set to Simple Password Mode. 2. To change the user name, password or user level click once on each entry. 3. To remove a user from the list, highlight the username and click Remove 4. To add a new user type in the name in the User Name list. Continue to set the user's password and access level. 5. Click close to save the settings and exit the editor Working in Advanced Password Mode To work in advanced password mode, check the Advanced Password Mode check box. 1/8/07 230

231 P-CIM 7.70 Basic Training Manual In Advanced Password mode you can use locks, keys, operators and areas and set expiration dates to user's accounts. Using the Windows Authentication security mode enables enforcing a security policy based on the domain's access levels. Each P-CIM operator log-in to the program using their individual network log-in account. User's access level is assigned by the Password Editor and the log-in authentication is done by the domain's server. Working with Windows Authentication To use Windows Authentication as the chosen security mechanism, click the Windows Authentication check box. 1/8/07 231

232 Afcon Software and Electronics Ltd 1. Add domain users by clicking the Add button. Select the domain from the pull-down menu and the domain users from the list. Assign a security level for each user. 2. Click OK to add the user. 3. To remove a user, highlight the user's name and click Remove. To change the user's access level click the user's level once. Note that you cannot add or change the user's password because it is set by the domain administrator. 4. To verify the domain account, highlight the user's name and click Check. On successful check the following message appears: 5. Click Save to save the settings. 1/8/07 232

233 P-CIM 7.70 Basic Training Manual 19.5 Modules Security Use the Modules Security module to assign a security level to each P-CIM editor module. 1. Open the Modules Security module from the P-CIM Administrative Tools Group. 2. To enable Modules Security check the Enable Modules Security check box. To enable this module your user account must be assigned with the highest security access privileges (0) Working with the Modules Security By default, the security level assigned to all modules is set to 99, the lowest security level. 1. Highlight an entry to change the security level. Type in a new security level and click Change to set the new security level. 2 Click Reset Lock to negate the new security level and to set it to None. 1/8/07 233

234 Afcon Software and Electronics Ltd File Security File Security adds an extra security layer in addition to the password protection build-in to P-CIM. Using the File Security feature ensures that P-CIM is activated in the most secured environment possible. The File Security relies on the domain s user accounts list, based up on which permission to both activate P-CIM (start, stop, read from and write to file, etc.) and grant direct access to the project s files is restricted only to the assigned user account. 1 Check the Enable Files Security. The following window opens 2 Type in a user name and password of a domain user account used for granting access to P-CIM. This user account is used for running P-CIM and executing commands (read, write etc.) regardless of the currently logged-in user. Click OK. Using this option ensures that P-CIM will be able to run properly whether the logged-in user has sufficient privileges for running P-CIM or not. 3 Navigate to the P-CIM installation folder (for example: C:\PCIM32) and locate the default project s folder. (For example: PcimPath). 4 Right-click the folder and select the Sharing and Security option. Move to the Security tab. The 1/8/07 234

235 P-CIM 7.70 Basic Training Manual following window opens: 5 For P-CIM to run using the user account you have chosen to use in the Files Security option, you should either grant full control privileges to this folder to the individual user account (for example: the user account Ariel) or, grant full control privileges the entire group to which the user is assigned to (for example, Administrators) By granting access to the project s folder to a group of users you grant access to this folder to all members of the group. Granting access to a single user account guaranties that only this user is assigned full control over the P-CIM project s folder, thus enabling tighter control over users actions. 1/8/07 235

236 Afcon Software and Electronics Ltd 19.6 Audit Trail The Audit Trail utility records changes made to various modules of P-CIM. When enabled, the Audit Trail utility records actions taken by every P-CIM user, starting from the time the user log-in and until the user log-out. To enable the Audit Trail, access the Modules Security and check the Enable Audit Trail check box. Working with Audit Trail Open the Audit Trail module from the Tools group. Table 93: Audit Trail Settings FIELD Date Time Module name Description User name DESCRIPTION The date the user accessed the module The time the user accessed the module The name of the module the user accessed A description of the module The name of the user that accessed the module To filter the Audit Trail view 1. From the File menu select the Filter option. The following window opens: 1/8/07 236

237 P-CIM 7.70 Basic Training Manual 2. To filter by date and time, set the time frame by selecting the date and time from the From and To menus. 3. To filter by user, type in the user's name in the User Name field. 4. To filter by module, either highlight a module or several module's names, by holding down the Shift button while clicking on the module's name, or select all modules by clicking the Select All button. Click the Clear All button to clear all selection. 5. To filter according to description, type in the description in the Description contains field. 6. To load a saved audit trail file, click the Browse button. Audit Trail data is saved in a.aud file. Find the saved file and click OK to view the saved data. 1/8/07 237

238 Afcon Software and Electronics Ltd 1/8/07 238

239 P-CIM 7.70 Basic Training Manual Chapter 20 Toolbar When working on large projects a tool bar can be used as a menu that enables movement between displays and modules and to perform P-CIM actions. In this chapter you will learn about. Creating a tool bar Viewing the tool bar in the Operator Workstation 1/8/07 239

240 Afcon Software and Electronics Ltd 20.1 About the Toolbar Editor The operator s tool bar is created in the Toolbar Editor and displayed during runtime in the Operator Workstation. In a project any number of toolbars can be created, where each tool bar has any number of buttons with actions, hotkeys and tooltips for the operator. Accessing the Toolbar Editor In the P-CIM Development Group, click the Or, Toolbar Editor icon. In the Animation Editor Options menu select Operator Workstation Setup and then select Toolbar Editor. Select File/Preview to display a preview of the tool bar. Select Edit/Copy As to copy the toolbar. Select Edit/Customize to modify the height/width of a tool. 1/8/07 240

241 P-CIM 7.70 Basic Training Manual Exercise - creating the Yogurt tool bar and displaying it in the Operator Workstation In this exercise you will create the Yogurt tool bar and its four tools using the information in the Yogurt Toolbar table below. Open the Toolbar Editor and add a new tool bar branch by either: Right clicking on Yogurt and selecting New Toolbar. From the File menu selecting New and then select Toolbar. Clicking the New Toolbar icon. Table 94: Yogurt Toolbar Tool Tool name Key Icon Icon Path Tooltip Action Pa ss wo rd Le vel Tool 1 Login F8 &PcimPath&PfwPass.exe Enter your user name & password login 99 Tool 2 Production F9 &PcimPath&mntview.exe Move to the Production Display Tool 3 Management F10 &PcimPath&editrpt.exe Move to Management Display Open Product Open Manage 99 0 Tool 4 Alarm_ Summary Shift + F2 &PcimPath&ALMH.EX E Open Alarm Summary Run &pcimp ath&al MH.EXE S 99 Keys such as F8 indicate the key on the shortcut key row of the keyboard. 1. In the branch, type Yogurt, which is the name of the tool bar. 1/8/07 241

242 Afcon Software and Electronics Ltd 2. Click the Yogurt tool bar branch and then add a tool branch by either: From the File menu selecting New and then selecting Tool. Clicking the New Tool icon. 3. To define properties for the tool either: From the Edit menu select Properties. Double click on the branch. Click the Properties icon. 4. Complete this dialog box using the information in the Yogurt Toolbar table. 5. Create three more tool bar buttons using the information above and the information in the Arrival Toolbar table. 6. From the Edit menu, select the Set as Default option. 7. Save the toolbar. Displaying the Yogurt tool bar in the Operator Workstation 1. Move to the Arrival display in the Operator Workstation. 2. In the Operator Workstation View menu, select Toolbar. The Yogurt tool bar is displayed. 1/8/07 242

243 P-CIM 7.70 Basic Training Manual 1/8/07 243

244 Afcon Software and Electronics Ltd Appendix 1 Shortcuts, Tips & Recommendations Shortcut Keys Table 95: Animation Editor Key Ctrl + X Ctrl + C Ctrl + V Ctrl + Z Ctrl + P Ctrl + - Ctrl + + Ctrl + S Ctrl + W Ctrl + F Ctrl + T Alt + F + T Alt + Ctrl + W Description Cuts graphical objects from a display. Copies graphical objects from a display. Pastes graphical objects into a display. Undoes the last graphical action. Opens the Properties List dialog box of a selected object. Moves a graphical object to the back (use keypad minus key). Moves a graphical object to the front (use keypad + plus key). Saves the current display. Jumps to the Operator Workstation. Opens the Fonts dialog box. Opens the Change Text dialog box. Reverts to the saved display. Switches to Operator Workstation preview mode (What You See Is What You Get). 1/8/07 244

245 P-CIM 7.70 Basic Training Manual Table 96: Advanced Alarm Handler Key Ctrl + L Ctrl + W Ctrl + C Ctrl + A Description Moves to the Alarm Log window. Moves to the Operator Workstation. Moves to the Current Alarm window. Moves to the Alarm Archive window. Table 97: Operator Workstation Key Alt + F + T Alt + F4 Description Reverts to the saved display. Closes the Operator Workstation. Table 98: Alarm Handler Key Ctrl + D Ctrl + O Ctrl + P Ctrl + A Ctrl + W Ctrl + X Ctrl + K Ctrl + M Ctrl + R Ctrl + E Ctrl + L Ctrl + G Ctrl + S Description Shows the Daily Log. Closes the Daily Log. Prints the Daily Log. Moves to the Alarm Summary window. Moves to the Operator Workstation. Exits the Alarm Summary. Acknowledges a selected alarm. Marks a selected alarm. Clears a selected alarm. Clears all alarms. Acknowledges all alarms. Acknowledges a message. Opens the Window Style dialog box. 1/8/07 245

246 Afcon Software and Electronics Ltd Tips Table 99: Syntax Manager Tip Accessing the Syntax Manager Opening P-CIM Help for a specific field in the Syntax Manager Description Clicking the F2 key in any module opens the Syntax Manager. You can access P-CIM Help by selecting a field, pressing the Shift key, and then clicking the Syntax Manager dialog box Help button. Table 100: Advanced Alarm Handler Tip Setting the Advanced Alarm Handler window size Hiding the Advanced Alarm Handler menu bar Description To set that this window will always open in a defined size. Change the window s size and press the Shift button on your keyboard. From the File menu select Exit, and then close this window. The following string can be added in the INI File Editor to define that the menu bar is not displayed in this module: File: PfwAlarm.Ini Section: StateCurAlarmWindow Token: Menubar String: 0 To display the menu change the String to 1. Table 101: Animation Editor Tip Copying/pasting an object shortcut Duplicating objects Moving objects Description Select the object, press the Shift button and drag the object to another location where it is automatically pasted in. Click an updated object and press the ctrl button. The Edit Symbol Id dialog box opens. Complete this dialog box and click OK. Click in the middle of an object and press the Shift key. Your mouse curser changes into a cross. Keep pressing the Shift key and then press the relevant direction arrows on your keyboard. Resizing objects Select an object and then place the cursor on the relevant surrounding square. Press the keypad + and/or keys to resize. 1/8/07 246

247 P-CIM 7.70 Basic Training Manual Table 101: Animation Editor (Continued) MYDID token MYSID token The MYDID (My Display ID) token][can be used instead of writing the name of the display in the Properties dialog box. The MYSID (My Symbol Id) token is used to reference the object name that is defined in the Symbol Id field in the following property types: ß In a control - in the prompt. ß ß In an action button - in the action definition. In any other animation property - in the server, topic or item. To type this character: press and hold the Shift button and then press this key on your keyboard. Selecting objects with updates using the space bar Option Mode - moving a display window Drawing objects with straight lines This tip is useful when working in a display that has overlapping objects with updates. Position the cursor in the area of the objects and then press the space bar. An object is selected. Continue pressing the space bar until the required object is selected. Notes: Objects are selected in order of sequence. The space bar is used instead of the mouse. This mode is used after displays have been created. It enables you to move displays and to piece them together into a bigger display. Unchecked the Object Mode option in the Windows menu. The curser changes into two thick lines. Select a display, press the Shift button and then press the relevant keyboard arrow button. This option is used when drawing with the toolbox tools. Select an object, press the Ctrl button and then resize the object. The lines of the object become straight. When using the circle tool the object becomes a circle. Table 102: General Tip Accessing the Operator Workstation Description Use the Ctrl + W shortcut key in most modules to open the Operator Workstation. 1/8/07 247

248 Afcon Software and Electronics Ltd Table 102: General Defining additional P-CIM modules to run during P-CIM Startup To define that a module runs during P-CIM Startup, in the Project Setup expand the Startup folder and double-click the Startup Modules subfolder: Click Browse to select the program's file, add an argument and select the operational mode (max, min., normal) For example, to run the Text File Server, enter the following: Program=TXTSRV Argument= Mode=,normal Note: To locate a module s file name, in the P-CIM Group right click on a module s icon and select Properties/Target field. Alarm Handler display fonts If the font size of the text in these windows is too large, it will not be fully displayed. In the Alarm Summary Options menu, select Font to open the Fonts dialog box and change the font size to 10 or to a smaller/higher font size.! Use the! as a shortcut for DBSR PCIM! throughout the application. For example when adding properties to objects. To type this character: press and hold the Shift button and then press this key on your keyboard. 1/8/07 248

249 P-CIM 7.70 Basic Training Manual Recommendations Since the Action Down option immediately performs the defined action after a button is pressed, we recommend using the Action Up option only. This gives operators more control over the system and enable them to prevent unwanted actions if the button is accidentally pressed. To enhance application performance use the AV, DV, CL, BL, and Alarm database blocks only for alarms and history collection. Scan time should be taken into consideration when designing a database block. A scan time value can be more than one second if the block s value changes once every few minutes, and if the updated accuracy is not important. 1/8/07 249

250 Afcon Software and Electronics Ltd Appendix 2 Glossary Table 103: Glossary Term Action Button Alarms Aliases AutoActions Cells DBSR Default Project Driver Digital Block Dynamic Display Display DDE Format (items) Description A button that when clicked and/or released by the operator performs predefined actions. P-CIM alarms are used to warn the operator about different occurrences in the system or plant devices. Alarms are defined in the Database Editor in the AV, DV, CL, BL and Alarm blocks. Aliases are text names used as shortcuts for addresses and are defined during project design. AutoActions trigger action commands that are performed according to predefined conditions. During runtime, AutoActions run automatically and without operator interference. AutoActions are triggered by events or at a predefined time. A cell is a collection of objects and their properties that are grouped into one entity. The P-CIM database server. The project that is automatically opened during P-CIM Startup. The default project is defined in the Project Setup dialog box. Software that connects the PC to any device such as a PLC. This block is used for digital variables. Digital values are constantly scanned. Alarms can be generated. Using the Dynamic Display, one generic object can be defined to represent multiple similar objects. During runtime, the dynamic display is used as a template that has dynamic links, which change when an object is selected. A display is a collection of graphical objects illustrating the plant floor and its devices. A display can show data and can also receive operator input. P-CIM addressing syntax, that has the following format: Server=servername Topic=topicname Item=itemname 1/8/07 250

251 P-CIM 7.70 Basic Training Manual Table 103: Glossary (Continued) Data Blocks $Variables Emulation Mode (Graphical) Object Properties A data block is a database element used for processing data. It has the following functionalities: Providing an operator interface. Generating alarms. Collecting history. Exchanging data with external devices and internal variables. Exchanging data between blocks. Converting raw data. $Variables are built in internal variables that provide information about the DBSR. $Variables are DDE items and are added during project development to the Item field. They are used in displays to show graphic objects, reports, database blocks, AutoAction triggers and more. Whereby the driver does not communicate with field devices, but reads/ writes internally. This mode is used during project design. Its setting is saved in the DRVRPORT.INI file. The image that is created in the Animation Editor interface. Properties define how an object is displayed and acts during runtime. There are three types of Properties: Indicator properties, defining how an object is displayed. Control properties, defining how an object acts during runtime. Special properties, defining trends, history and deviation meters. The object s properties are linked to the communication address of the device. During runtime the object is displayed according to the assigned property and to the device s value. Updates/updated object P-CIM Group Addressing Syntax An object that has added properties. The container for P-CIM modules, usually saved on the Desktop. The format in which external addresses are specified in P-CIM is driver dependant. P-CIM modules can through direct access, retrieve raw data directly from communication drivers. Direct access addresses are referenced through DDE (Dynamic Data Exchange) by specifying the Server, Topic and Item. 1/8/07 251

252 Afcon Software and Electronics Ltd Contact Information Afcon Software and Electronics Ltd. 1/8/07 252

253 P-CIM 7.70 Basic Training Manual 1/8/07 253

254 Afcon Software and Electronics Ltd Index Symbols.ACK ALM.Status ALMEnable HT Factor , 183 A AAH - Toolbar About AutoActions About P-CIM Installing P-CIM Requirements Uninstalling P-CIM About Recipes About the Advanced Alarm Handler About the Database Editor About the Text File Server Accelerator Key Accessing and Working with DOT Fields Accessing the Advanced Alarm Handler Accessing the Recipe Editor Accessing the Toolbar Editor Acknowledging Alarms Action Buttons Accelerator Key Basic P-CIM Action Commands INVERT Command Key Press Attributes Mouse Operations SET Command Adding Authorization to Specific Controls in a Specific Display 226 Adding DOT Fields Adding text to a display Advanced Alarm Handler About the Advanced Alarm Handler /8/07 245

255 P-CIM 7.70 Basic Training Manual Accessing the Advanced Alarm Handler Advanced Alarm Zones Building an Advanced Alarms System Creating a New Advanced Alarm Category Data Blocks Advanced Parameters Defining Advanced Alarms Functional Tree Location Tree Viewing Alarms Advanced Alarm Zones Alarm Field Columns Alarm Message Colors Definition Alarm Status Alarm Summary - System Messages Alarms Alarm Status Alarm Summary and Current Alarm Windows Defining Alarms Defining an Analog Alarm Aliases Aliases Table Aligning objects Animation Editor Accessing the Animation Editor Accessing the Properties List Dialog Box Action Buttons Adding text to a display Aligning objects Cells Copying, cutting and pasting objects Creating a New Display Creating a simple display Creating Graphical Objects DBSR Functions Drawing a Graphical Object Fill Color Fluid Fill Grouping and ungrouping graphical objects Input Text /8/07 246

256 Afcon Software and Electronics Ltd Move to front and move to back Moving objects Orientation Output Text Properties Resizing objects Rotating an Object Saved Objects Selected Object Signs Selecting an Object Selecting Multiple Objects Shortcut Keys Slider Properties Status bar Undoing Commands Viewing/searching and replacing objects Visibility Animation Interface Accessing the Animation Interface Toolbox Application Layer Application Layer Architecture Application Layer... 30, 31 Communications Layer Assigning a Port AutoActions About AutoActions Defining AutoOpen/AutoClose Actions Startup and Shutdown AutoActions B Backup Project Basic P-CIM Action Commands Building an Advanced Alarms System C Cells Communication Layer... 28, 46 1/8/07 247

257 P-CIM 7.70 Basic Training Manual Communication Layer Parameters Accessing Polling Configurations Alarm Summary System Messages Assigning a Port Communications Layer Troubleshooting Data Scope Driver Addresses Syntax Driver Parameters Definition Fine Tuning Parameters Installing the Modbus Driver Introduction to the Communications Layer P-CIM Drivers Polling Configurations Definition Verifying Communications Viewing System Messages Communications Layer Communications Layer Architecture Communications Layer TroubleShooting Copying, cutting and pasting objects Creating a Backup Project... 40, 41 Creating a Dynamic Display Creating a Funtional tree Creating a Location tree Creating a Login Button Creating a Logout Button Creating a New Advanced Alarm Category Creating a New Display Creating a Realtime Trend Creating a simple display Creating a Toolbar Creating a TXT Report Creating an Historical Trend Creating Graphical Objects Creating Projects Creating the Yogurt project D Data Block Parameters Data Blocks /8/07 248

258 Afcon Software and Electronics Ltd Data Blocks Advanced Parameters Database Configuration Dialog Box Database Editor About the Database Editor Data Block Parameters Data Blocks Database Configuration Dialog Box Database Layer DBSR Functions Default Project... 36, 250 Defining a DBF Report Defining a recipe that is loaded/learned Defining a TXT Report Defining Advanced Alarms Defining Alarms Defining an Analog Alarm Defining and Formatting Report Templates Defining AutoOpen/Autoclose Actions Defining Data Items INI File Editor Syntax Manager Viewing the Alias List in the Syntax Manager Defining Driver Parameters Defining History Collection Defining Recipes Defining the DDE Address to the Text File Server Defining the DDE Link to the INI File Defining Users and Passwords Designing the Yogurt Project Workflow for the Yogurt Project Displaying Alarms Displaying an Historical Trend Displaying Runtime Keyboard Combination Commands Displaying Secure Windows Displaying the Toolbar in the Operator Workstation DOT Fields....ACK ALMEnable ALMStatus /8/07 249

259 P-CIM 7.70 Basic Training Manual.HT Factor , 183 Accessing and Working with DOT Fields Adding DOT Fields Drawing a Graphical Object Dynamic Display Creating Dynamic Display Creating the Main Display Introduction to the Dynamic Display E Problems during initialization of the driver Problems indicating communication failure Problems writing to an undefined memory range in the PLC F Fill Color Filtering Views in the Advanced Alarm Handler window Fluid Fill G Generating a TXT Report Grouping and ungrouping graphical objects H Handling Alarms... Acknowledging Alarms Purging Alarms History Collection I INI File Editor Aliases Table Input Text... 99, 102 Installing P-CIM Introducing P-CIM Introduction to the Communications Layer Introduction to the Dynamic Display INVERT Command /8/07 250

260 Afcon Software and Electronics Ltd K Key Press Attributes L Learning Recipes Loading Recipes Logging In During Runtime Logging Out During Runtime M Modifying a directory path Mouse Operations Move to front and move to back Moving objects O Options Menu in the Advanced Alarm Handler Orientation Output Text P P-CIM Drivers P-CIM Group Modules Advanced Alarm Handler Alarm Handler Animation Editor... 21, 22 Data Scope Database Editor INI File Editor P-CIM Network Setup P-CIM Setup P-CIM Shutdown P-CIM Startup Recipe Editor Report Editor Syntax Manager Toolbar Editor Uninstall P-CIM /8/07 251

261 P-CIM 7.70 Basic Training Manual P-CIM Group of Icons... 20, 251 Creating P-CIM Group shortcut... 17, 20 P-CIM Interface P-CIM Syntax for Driver Addresses Planning Alarm Categories Project Project Architecture Project Architecure Project Management Backup Project Creating a Backup Project... 40, 41 Creating the Yogurt project Default Project... 36, 250 Modifying a directory path Restoring Project Workflow for Creating a Project Properties Action Buttons Fill Color Fluid Fill Input Text Orientation Output Text Slider Visibility Purging Alarms R Reading INI File Data Realtime Trends Recipes About Recipes Accessing the Recipe Editor Defining a recipe that is loaded/learned Defining Recipes Learning Recipes Loading Recipes Using Recipes during Runtime Reports /8/07 252

262 Afcon Software and Electronics Ltd Creating and Generating a TXT Report Defining a DBF Report Defining a TXT Report Defining and Formatting Report Templates Generating a TXT Report Running and Viewing Reports Requirements Requirements for Building an Automation System Resizing objects Restoring a Project Rotating an Object Running and Viewing Reports Runtime Keyboard and Mouse Security S Saved Objects Security... About Security Privileges Adding Authorization to Specific Controls in a Specific Display 226 Creating a Login Button Creating a Logout Button Defining Users and Passwords Displaying Secure Windows Displaying Windows Keyboard Combination Commands Logging In During Runtime Logging Out During Runtime Runtime Keyboard and Mouse Security Security for Opening a Display Security for Operator Workstation Menu Commands Security for Opening a Display Security for Operator Workstation Menu Commands Security Privileges Selected Object Signs Selecting an Object Selecting Multiple Objects SET Command Set Criteria Dialog Box Shortcut Keys Sorting Alarms /8/07 253

263 P-CIM 7.70 Basic Training Manual Startup and Shutdown AutoActions Status Bar Syntax Manager T Text File Server About the Text File Server Defining the DDE Address to the Text File Server Defining the DDE Link to the INI File Reading INI File Data Tooltips... Accessing the Toolbar Editor Creating a Toolbar Displaying the Toolbar in the Operator Workstation Trends... Creating a Realtime Trend Creating an Historical Trend Defining History Collection Displaying an Historical Trend History Collection Realtime Trends U Undoing Commands Uninstalling P-CIM Using Recipes during Runtime V View Menu View Top Options Viewing Alarms Viewing the Alias List in the Syntax Manager Viewing/searching and replacing objects Visibility W Workflow for Creating a Project Working in the Advanced Alarm Handler... Alarm Field Columns /8/07 254

264 Afcon Software and Electronics Ltd Alarm Message Colors Customizing the Toolbar Filtering Views in the Advanced Alarm Handler window Options Menu in the Advanced Alarm Handler Set Criteria Sorting Alarms View Menu View Top Options Zones in the Advanced Alarm Handler window Working with projects Z Zones in the Advanced Alarm Handler window /8/07 255

265 P-CIM 7.70 Basic Training Manual 1/8/07 256

266 Afcon Software and Electronics Ltd List of Tables P-CIM Modules P-CIM Modules Table...23 New Project Table Communication Setup...49 New Port Settings Fine Tuning Settings...52 Polling Configuration...53 Addresses Syntax Item Addresses Table Aliases Table Syntax Manager Module Syntax Legend...70 Animation Editor Tools...73 Working in a Display Table Arrival Display Properties...83 Visibility Table Fill Color Property Table...89 Fluid Fill Property Table Orientation Property Table...96 Output Text Property Table...97 Input Text Table Slider Property Table Basic Action Commands SET Command Table INVERT Command Table Production/Arrival Buttons Table $Variables Table Information Bar Table Dummy Variable Syntax DBSR Functions... Function Table Conversions Syntax LIN Syntax Automatic Cleaning Settings Creating an AutoAction Table

267 P-CIM 7.70 Basic Training Manual Database Blocks Types Data Block Parameters Data Blocks Parameters Alarm 1 TANK3TK1_PH Table Alarm 2 TANK3TK1_TEMPERATURE Table Alarm 3 TANK3TK2_PH Table Alarm 4 TANK3TK2_TEMPERATURE Table Entry Valve of Tank 3TK1 Table Souring Agent Valve of Tank 3TK1 Table Fruit Valve of Tank 3TK1 Table Alarm Status Colors Functional Hierarchy Tree Table Location Tree Table Defining Advanced Alarm Parameters Table Set Criteria Dialog Box Options Customize List Options Customize Toolbar Options Alarms Messages Colors Archive Settings Purging Alarms Pen Dialog Box Parameters Table Time X Axis Dialog Box Table Value Y Axis Dialog Box Table Panel Layout Table Pen Dialog Box Parameters Table Time X Axis Dialog Box Table Time Y Axis Dialog Box Table Dot Fields Properties ALMHigh ALMLow ALMEnable Valve Alarm Table Creating a.grp File Table Creating a Dynamic Display Table Action Command Legend Groups Table Command Legend Command Legend Load/learn Recipe Table /8/07 256

268 Afcon Software and Electronics Ltd Dynamic Display Table Status Information Report Table Command Legend Text Report Text Report DBF Report DBF Report Supreme Report report settings Value Defining a DDE Address in the text file INI File Formats Defining DDE Link in INI file INI File Format Table Security Privileges Table Action Command Legend Login Table Logout Table Display Password Level Table Restricting Access to Controls Table Audit Trail Settings Yogurt Toolbar Animation Editor Advanced Alarm Handler Operator Workstation Alarm Handler Syntax Manager Advanced Alarm Handler Animation Editor General Glossary