Академический Документы
Профессиональный Документы
Культура Документы
CIMPLICITY HMI
Base System
Users Manual
Warning
Warning notices are used in this publication to emphasize that hazardous voltages, currents, temperatures, or other
conditions that could cause personal injury exist in the equipment or may be associated with its use.
In situations where inattention could cause either personal injury or damage to equipment, a Warning notice is used.
Caution
Caution notices are used where equipment might be damaged if care is not taken.
Note
Notes merely call attention to information that is especially significant to understanding and operating the equipment.
This document is based on information available at the time of publication. While efforts have been made to be accurate,
the information contained herein does not purport to cover all details or variations in hardware or software, not to provide
for every possible contingency in connection with installation, operation, or maintenance. Features may be described
herein which are not present in all hardware and software systems. GE Fanuc Automation assumes no obligation of
notice to holders of this document with respect to changes subsequently made.
GE Fanuc Automation makes no representation of warranty, expressed, implied, or statutory with respect to, and assumes
no responsibility for the accuracy, completeness, sufficiency, or usefulness of the information contained herein. No
warranties of merchantability or fitness for purpose shall apply.
GFK-1180H iii
Chapter 9: Changing the Workbench Point Display: Describes the many ways to
change the point information displayed in the Workbench
Chapter 10: Using System Points: Describes the several points that are included in
CIMPLICITY HMI and can be used to display system information, including dates
and time.
Chapter 11: Point Cross Reference: Describes the CIMPLICITY HMI tool that
facilitates keeping track of where and how points are used.
Chapter 12. Device Configuration: Explains how to configure devices.
Chapter 13. Resource Configuration: Explains how to configure resources.
Chapter 14. Port Configuration: Explains how to configure ports.
Chapter 15. Alarm Class Configuration: Explains how to configure alarm classes.
Chapter 16. Alarm String Configuration: Explains how to configure alarm strings.
Chapter 17. Alarm Configuration: Explains how to configure alarms.
Chapter 18 Alarm Audio Support: Shows you how to configure audible alarms.
Chapter 19 Alarm Blocking: Shows you how to implement hierarchical alarm
blocking.
Chapter 20. Alarm Printer Configuration: Shows you how to configure a printer
to record alarm messages.
Chapter 21. Role Configuration: Explains how to configure roles.
Chapter 22. User Configuration: Explains how to configure users.
Chapter 23. Database Logger: Discusses the Database Logger option and how to
configure tables and reports.
Chapter 24. Managing Database Logging: Discusses the installation of ODBC and
Oracle drivers and data sources, how to manage the database for SQL Server, how to
control database disconnect recovery, and how to use the global parameters for the
Database Logger
Chapter 25. Client Configuration: Shows you how to configure default logins for
CIMPLICITY HMI Viewers on client computers.
Chapter 26: Using CIMPLICITY HMI with CIMPLICITY Control: Shows you
how to import variables from a Control folder into points in an HMI project.
Chapter 27. Configuration Import/Export: Documents the Import/Export utility.
Chapter 28. Using the Alarm Viewer OCX: Documents how to use the Alarm
Viewer OCX in CimView to display alarm information.
Chapter 29. Alarm Viewer OCX Methods: Documents the methods you can use in
CimEdit and CimView in conjunction with the Alarm Viewer OCX.
Chapter 30. Using the Stand-Alone Alarm Viewer: Shows you how to use the
stand-alone Alarm Viewer to display alarm information.
Chapter 31. Using CimView: Explains the features of the graphic screen viewer.
Chapter 32. Using the Point Control Panel Shows you how to use the Point
Control Panel to display point information.
Chapter 33. Using the CIMPLICITY to Windows Server (DDE): Discusses how
to use CWSERV with third-party software such as Microsoft Excel spreadsheets.
Chapter 37. Using CIMPLICITY HMI with Remote Access: Shows you how to
use the Remote Access features of Windows NT and Windows 95 to let users with
CIMPLICITY HMI Viewer software access project data through modems.
Chapter 38. CIMPLICITY HMI Web Gateway: Shows you how to use this
feature to let users access your CIMPLICITY HMI data over the Internet.
Appendix A. System Administrative Issues: Describes how to transfer
CIMPLICITY HMI licenses from one computer to another, do a floppy disk
installation and remove CIMPLICITY HMI from a system.
Appendix B. Resolving Problems: Discusses how to use the Status Log Viewer and
system log files to find an resolve problems.
GFK-1180H Preface v
Contents
Welcome to CIMPLICITY HMI 1-1
Welcome ................................................................................................................................ 1-1
Distributor Telephone Numbers............................................................................................. 1-1
Customer Support................................................................................................................... 1-2
GFK-1180H vii
CIMPLICITY Project Wizard Step 2 of 3 ............................................................... 3-8
CIMPLICITY Project Wizard Step 3 of 3 ............................................................. 3-10
Installing A Project............................................................................................................... 3-11
Setting CIMPLICITY Options ............................................................................................. 3-12
Setting CIMPLICITY Project Options................................................................... 3-12
Setting Startup Options .......................................................................................... 3-14
Starting CimView Screens Automatically on Windows 98/95............................... 3-16
Whats Running .................................................................................................................... 3-21
How Configuration Updates Are Handled............................................................................ 3-22
Dynamic Update..................................................................................................... 3-22
Logging In ............................................................................................................................ 3-24
Copying A Project to Diskette.............................................................................................. 3-25
CIMPLICITY Command Line Options................................................................................ 3-26
GFK-1180H Contents ix
$PROJECT.DATE.WEEKDAY ............................................................................ 10-4
$PROJECT.DATE.DAYOFYEAR........................................................................ 10-4
$PROJECT.DATE.WEEK .................................................................................... 10-4
$PROJECT.DATE.HOUR..................................................................................... 10-4
$PROJECT.DATE.HOUR12................................................................................. 10-4
$PROJECT.DATE.MINUTE ................................................................................ 10-5
$PROJECT.DATE.SECOND ................................................................................ 10-5
$PROJECT.DATE.SECOFDAY ........................................................................... 10-5
$PROJECT.DATE.AMPM.................................................................................... 10-5
$LOCAL.DATETIME ........................................................................................... 10-5
$LOCAL.DATE.YEAR ......................................................................................... 10-6
$LOCAL.DATE.MONTH ..................................................................................... 10-6
$LOCAL.DATE.DAY ........................................................................................... 10-6
$LOCAL.DATE.WEEKDAY................................................................................ 10-6
$LOCAL.DATE.DAYOFYEAR ........................................................................... 10-6
$LOCAL.DATE.WEEK ........................................................................................ 10-7
$LOCAL.DATE.HOUR......................................................................................... 10-7
$LOCAL.DATE.HOUR12..................................................................................... 10-7
$LOCAL.DATE.MINUTE .................................................................................... 10-7
$LOCAL.DATE.SECOND.................................................................................... 10-7
$LOCAL.DATE.SECOFDAY............................................................................... 10-8
$LOCAL.DATE.AMPM........................................................................................ 10-8
$USER.ALARMS.................................................................................................. 10-8
$ALARM.TOTAL ................................................................................................. 10-8
$ALARM.ACKED................................................................................................. 10-8
$ALARM.UNACKED........................................................................................... 10-9
$ALARM.ACTIVE................................................................................................ 10-9
$CLASS_<Alarm class name>.ALARMS ............................................................. 10-9
$CLASS_<Alarm class name>.UNACKED .......................................................... 10-9
GFK-1180H Contents xi
Alarm Blocking Configuration 19-1
About Alarm Blocking ......................................................................................................... 19-1
Assigning Alarms ................................................................................................... 19-2
Choosing Blocking Modes ..................................................................................... 19-2
Assigning Alarm Priorities..................................................................................... 19-2
Alarm Blocking Rules............................................................................................ 19-3
Configuring Alarm Blocking ................................................................................................ 19-4
Creating an Alarm Block Group ............................................................................ 19-5
Adding an Alarm.................................................................................................... 19-6
Removing an Alarm ............................................................................................... 19-6
Modifying an Alarm............................................................................................... 19-7
Modifying an Alarm Block Group ......................................................................... 19-7
GFK-1180H Contents xv
Using the Alarm Viewer OCX 28-1
About the Alarm Viewer OCX ............................................................................................. 28-1
Configuration Overview......................................................................................... 28-1
Run-Time Overview............................................................................................... 28-2
Configuring an Alarm Viewer OCX in CimEdit .................................................................. 28-3
Configuring Alarm Viewer Control Properties..................................................................... 28-4
Fields...................................................................................................................... 28- 5
Buttons ................................................................................................................... 28-7
Projects ................................................................................................................ 28-10
Sort/Display ......................................................................................................... 28-11
Count Layout........................................................................................................ 28-15
Date Format ......................................................................................................... 28-16
Fonts..................................................................................................................... 28-18
Colors................................................................................................................... 28-19
Creating Custom Buttons.................................................................................................... 28-20
Example ............................................................................................................... 28-21
Viewing the Alarm List ...................................................................................................... 28-22
Selecting Alarms from the List............................................................................. 28-22
Using the Alarm List Buttons ............................................................................................. 28-23
Changing the Setup Parameters............................................................................ 28-23
Refreshing the Alarm List .................................................................................... 28-23
Toggling Between Lists ....................................................................................... 28-23
Displaying User Help ........................................................................................... 28-23
Viewing the Alarm Stack ..................................................................................... 28-24
Viewing Alarm Comments................................................................................... 28-24
Viewing the Alarms CimView Screen................................................................. 28-25
Acknowledging an Alarm..................................................................................... 28-25
Resetting an Alarm............................................................................................... 28-26
Deleting an Alarm ................................................................................................ 28-26
Acknowledging and Resetting an Alarm .............................................................. 28-26
Acknowledging the First Alarm ........................................................................... 28-27
Acknowledging All Alarms.................................................................................. 28-27
Filtering Alarms.................................................................................................................. 28-28
Specifying a Default Setup for a Project .............................................................. 28-29
Loading an Alarm Setup ...................................................................................... 28-29
Modifying the Current Alarm Setup..................................................................... 28-30
Saving the Current Setup...................................................................................... 28-33
Creating A New Alarm Setup............................................................................... 28-33
Deleting an Alarm Setup ...................................................................................... 28-34
Declaring a Default Alarm Setup ......................................................................... 28-34
Using Default Alarm Setups............................................................................................... 28-35
Index i
Welcome
Congratulations for selecting GE Fanuc Automations CIMPLICITY HMI product.
CIMPLICITY HMI provides you with an extraordinary number of tools that enable
you to configure the product precisely to your system requirements.
If you are a new user, take advantage of this Base System User'sOperation Manual
to familiarize yourself with the basic configuration steps. The chapters are ordered
according to how someone would set up a standard system. They begin with opening
the Workbench, which is at the center of CIMPLICITY HMI configuration
If you are an experienced user, check the manual to find out about the new
CIMPLICITY HMI features.
Read the Getting Started Manual to find out about all the CIMPLICITY HMI
documentation that GE Fanuc Automation offers.
GFK-1180H 1-1
Customer Support
GE Fanuc takes pride in the high quality of CIMPLICITY HMI software. Great
emphasis has been placed on ensuring the quality of this system throughout
development and testing. However, the tremendous power that the software offers
may cause you to encounter problems or questions for your specific configuration.
If your CIMPLICITY software system is under warranty or is covered by a valid
support contract, you may obtain assistance and report problems to the CIMPLICITY
Technical Support Hotline at one of the following numbers:
USA and Canada (800) GE-FANUC or (800) 433-2682
All others (804) 978-6036
The CIMPLICITY HMI Hotline is available from 8 A.M. to 8 P.M. Eastern Time,
Monday through Friday, except for regularly scheduled USA holidays.
GFK-1180H 2-1
Workbench at a Glance
Within the Windows NT and 95/98 familiar environment, CIMPLICITY HMIs
Workbench provides you with all the unique CIMPLICITY HMI Power Tools you
need to create and manage your project with maximum efficiency.
First Opened
Expanded to view all points
Screens
Points
Application Folder
Objects in application
Status bar
The status bar provides you with information that includes how many records are
retrieved, if the project is running, and if a specified task has been completed.
When the Workbench is open on more than one screen you can keep your screen up-
to-date by refreshing the window.
Click to
expand the tree
Click to
collapse the tree
List
Detail
Large Icon
Tree
Note: Whether you view a list of records or of files depends on the icon you select in
the left pane.
For example, if you select Points in the left pane, you will view a list of records in
the right. If you select Screens in the left, you will view a list of files in the right.
Note: Whether you view a list of records or of files depends on the icon you select in
the left pane.
For example, if you select Points in the left pane, you will view a list of records in
the right. If you select Screens in the left, you will view a list of files in the right.
3. Enter the name or associated information for the record(s) or file that you
want to display. What format the information (records, files) is in depends
on what you select in the left pane.
The records or files you specify will display in the right pane until you change
your specifications.
Throughout CIMPLICITY HMI you will find browse buttons to open browsers
that help you find names or categories of records that are associated with a selected
icon. They all appear in the Workbench when you need them.
A Windows NT and 95/98 Explorer window opens and displays the open
projects directory.
Popup
Method 3
Step 2: Select the fields to display (or remove from display) in the
Workbench right pane.
Users
Devices
Points
Note: The Remove button will be disabled if the field is required. The Move
Down or Move Up button will be disabled if a field that will be affected by the
move has to appear in the furthest left position.
2. Select New.
3. Select Project.
Enter a unique
project name
Selected options
display in the
Configuration
Cabinet
2. Select Open.
3. Select Project.
Method 2
1. Make sure nothing is selected in the right pane.
2. Press Ctrl+O on the keyboard.
An Open dialog box opens when you use either method.
1. Select the
project folder
2. Select the
.GEF file
1. Select the folder that contains the project you want to open.
2. Select the .GEF file.
3. CIMPLICITY HMI opens the project. If the project needs to be updated, a
message box will display. The project will be updated and display once you
press OK. See Updating a CIMPLICITY HMI Project in this chapter.
Method 2
Press Ctrl+W on the keyboard.
The Project Wizard opens when you use either method. Follow the steps you need
to configure. At any point when you are finished, press Finish.
Select a project
To do a configuration update:
Method 1
1. Select Project on the Workbench menu bar.
Dynamic Configuration
If your user role has been assigned the option, dynamic update option is an efficient
way to make certain changes in project and have the project automatically updated.
The Workbench provides you with:
Some restrictions in dynamic configuration functionality, which you should
be aware of.
Easy procedures for dynamic configuration.
To do dynamic configuration:
Method 1
Method 3
A. Press ALT+F.
The drop down File menu opens.
B. Press N.
C. Press O.
Method 3
Tip: If you want to use only the keyboard, you can also press the Arrow Up and/or
Arrow Down key to select the icon in the left pane of the Workbench.
Open
Script Script window
Project status log Notepad
System status log Microsoft Excel
Database Logger Microsoft Access
Action Calendar Action Calendar
Popups
Quick Trend
CimView
To view runtime data by dragging and dropping points into the Point
Control Panel:
1. Select Points in the Workbenchs left pane.
2. Select the points you want to monitor in the right pane.
3. Open a runtime window. See Opening a CimView Screen.
4. Hold the mouse button down and drag the selected items into the blank
window.
If any of the dragged items already exist in the open window, the Workbench
displays a message and does not duplicate them.
5. Release the mouse button.
CIMPLICITY HMI displays runtime information for the selected points.
2
Select points in the Configuration Cabinet.
Drag them into the Point Control panel
The project creation procedure displays a series of dialog boxes that let you:
Select the project type, name, and path.
Set project properties.
Use the project wizard to do initial configuration of ports, devices, and
points for the new project.
When the creation procedure is complete, select Install from the File menu to install
the project in a folder.
New Project Options
When you create a new project, the New Project dialog box opens.
GFK-1180H 3-1
Enter information in the following fields to create a new project:
Project Type Select the type of project you want to create.
The type of project you can create is controlled by the
product option you have installed. For example, if you
have installed the HMI Server option, then you can only
create HMI Server base projects.
Project Name Enter the project name in this field.
New Subdirectory The project name you enter will also be used as the
default subdirectory name for the project.
If you want to use another name for your subdirectory,
enter it in this field.
Options You can select the options you want to be available in
this project from the list of all installed options. Set the
check box for each option you want to select.
Protocols You can select the protocols you want to be available in
this project from the list of all installed protocols. Set
the check box for each protocol you want to select.
Project Path Use the Drives and Directory input fields to select a
directory path for the project directory you are creating.
If you want to create the project on another disk in your
network, select Network... to define the network path.
When you have entered your information, select Create... to create the new project or
select Cancel to cancel the create request.
When you select Create..., the Workbench for the project is created, and the Project
Properties dialog box opens to display the Options properties.
You can use the menu options in the Workbench to create a new project, open a
project, delete a project, display project settings, start/stop a project, update project
configuration, open the Project Wizard, enable/disable the Toolbar and Status bar,
enable/disable dynamic configuration update, open an MS-DOS window, display
status logs, start configuration functions, and display Help information.
General Properties
Modifying A Port
To modify a currently configured port:
1. Select the port you want to modify from the Configured Ports list.
2. Select Modify.
The Port Properties dialog box for the selected port opens. For more information on
modifying port properties, see the Port Properties for the particular protocol you
selected.
Removing A Device
Note
You will not be allowed to delete a device unless all points for that device have been
deleted.
To remove a currently configured device from the project configuration:
1. Select the device you want to delete from the Configured Devices list.
2. Select Remove. You will be asked if you want to delete the selected
object.
3. Select Yes to delete the device.
Modifying A Device
To modify a currently configured device for the project:
1. Select the port you want to modify from the Configured Ports list.
2. Select Modify.
The Device Properties dialog box for the selected device opens. For more
information on modifying device properties, see the Device Properties for the
particular protocol you selected.
Select the folder where you want to place the shortcut. You can also use the New
Folder... button to create a new folder for the shortcut.
Use the Projects property page to display, start, and stop projects on a computer.
Start as a Viewer
To start as a Viewer, select Start Viewer.
You can display the projects currently running on any Server in your network. To do
this:
1. Click the drop-down list button to the right of the Computer Name
field.
2. Select the computer you want to connect to from the list of computers
that are currently running CIMPLICITY software.
If the computer name does not appear in the list, you can type it in the
Computer Name field (the computer name is not visible if no projects
are running).
3. Select Connect.
The projects that are currently running on that computer are displayed in the Running
Projects field.
Use this dialog box to browse for projects to add to the list of projects to be started at
system boot. When you locate a project, select OK to add it to the list and close the
CIMPLICITY Default Project dialog box. Select Cancel to close the dialog box
without selecting a project.
To delete a project from the list, select the project, and then select Delete. The
project is removed from the list.
You can also select the one of the following:
None Select this option if you do not want any of the projects in the
list to start at system boot.
Start as viewer Select this option if you want to start a Viewer (that is, only
start the Router) on this computer when the computer reboots.
Start at boot Select this option if you want to projects in the list to start
when the computer boots. If there are no projects in the list,
only the Router starts.
4. Enter the old Password (or leave it blank if you never entered a
password). Leave the New Password and Confirm New Password
fields blank, and select OK. The Change Windows Password dialog
box closes.
5. Select OK to close the Passwords Properties dialog box.
6. Select the Network icon in the Control Panel. The Network properties
dialog box opens.
2. In the Network Options box, select whether you want to start a stand-
alone project, or accept connections from other projects in your
enterprise.
3. In the System boot options box:
A. Make sure the project(s) you want to start at system boot are listed.
Select Add to browse for projects and add them to the list.
B. On Windows 98/95 computers, you can select CimView to set a
default CimView screen that opens at startup and define its display
options.
Note
On Windows NT computers, put a shortcut to the CimView screen
in your Start Menu folder for each screen you want to open at
startup. You can enter the startup options for the screen in the
shortcuts command line.
C. Enter the starting CimView screen in the Screen field. You can
also select Browse to the right of this field to search for the screen
you want.
D. Set the Start at boot field if you want the CimView screen to be
started automatically when the system boots.
E. Set the following check boxes as needed to define the screens
startup options:
Always Maximized
This option always maximizes the initial window to fill
the users terminal screen.
The user cannot resize the primary window, and the
window will not rise to the top when a user clicks on it
(this prevents it from obscuring other windows on the
terminal screen).
No Exit
This option does not let the user exit the primary
CimView window.
The Exit menu item is removed from the File menu, and
the Close menu item and Alt+F4 shortcut key are
removed from the Control menu. In addition, the Close
Screen action is ignored in the primary window.
Keypad
This option opens the popup keypad whenever the user
needs to enter data for Variable setpoints.
This option is required for systems with no keyboard or
keypad.
Zoom to Best Fit
This option sizes the CimView screen to best fit the
window in which it is displayed.
No Menu/Title
This option removes the Menu and Title bars from the
primary CimView window and all subsequent windows.
Dynamic Update
The Dynamic Update option is available only if your user role has been assigned that
option.
If you have permission to use Dynamic Update, you can enable or disable Dynamic
Update from your project, or from individual configuration functions by either of the
following methods:
Clicking the Dynamic toolbar button.
Selecting Dynamic from the Tools menu.
In addition, when you enable Dynamic Update, "DYNAMIC" is displayed on the
Status Bar so that you are aware that it is enabled. Once you enable Dynamic
Update, changes made by configuration functions that support this option are put into
effect immediately. Any changes made to configuration data while Dynamic Mode
was disabled are not put into effect until the Configuration Update procedure is
invoked.
You should also be aware that the configuration procedures listed below have
restricted functionality in Dynamic Update mode.
Port Configuration
In Dynamic Update mode, you may only modify:
Base scan rate
Enable/Disable state of the port
Retry count
Remote Projects
You cannot create or modify remote projects in Dynamic Update mode.
If you are backing up a running project, there is a file that is locked when the project
is running. This file will not be copied, and an error message to that effect will be
displayed. You may ignore the message and continue the backup, as the file is
created whenever a CIMPLICITY HMI project is started.
1. Using the Windows Explorer, locate the project directory for the
project you want to back up.
2. To save space on your diskette, you should delete all log files from the
projects \log directory before making the backup.
If the project is running, some files in this directory may be locked and
will not be deleted.
3. Copy the projects directory to the diskette.
This method works well for small projects. For large projects, consider zipping the
project and saving the zipped file or backing up the project directories to tape rather
than diskette.
About Points
CIMPLICTIY HMI collects or calculates point data which it distributes to:
CimView screens
Alarm Viewer screens
Alarm printers
Logging tables
Other CIMPLICITY HMI software options
The collection and distribution of point data is handled by the Point Management subsystem.
Its primary functions are to:
Update the point database as point values change.
Generate point alarms when limits are exceeded.
Make point data available to CIMPLICITY HMI software applications.
Synthesize new point values by arithmetically combining other points.
Note: You can limit a users ability to set point to only those points whose resources are in
the users view. See "Setpoint Security" in this chapter for more information.
GFK-1180H 4-1
Categorizing Points
CIMPLICITY HMI provides you with the tools to configure any point to exactly your
specifications. Even though there are several options during configuration, your starting
choices for any given point are very simple.
The point value:
Comes from one of two Point (Source) Types
Is classified as one of three Point Classes
Point Class
Points can be one of three classifications. You select the class based on how the point will be
used. The point classes are:
Analog integer or floating points
Boolean
Text
Do not use | $
Brackets ( [ ] )
Avoid using +- * ? \ / [ ] < > " :
The Expression Editor and other software can
misinterpret these
Use carefully Any other special character (such as @, #, %,
etc.) on the keyboard
A Point ID started with a number (0-9).
You must enclose the Point ID in single quotes when
used in a point expression or equation..
Use freely The underscore character ( _ )
The period (.)
Enter a password
Example
RESOURCE_1 is an authorized resource for USER_X.
If: POINT_A has been defined for RESOURCE_1 and Set
Point Security is enabled.
Then: USER_X can perform setpoints on POINT_A.
If : RESOURCE_1 is not an authorized resource for USER_X
and Set Point Security is enabled.
Then: USER_X cannot perform setpoints on POINT_A.
2. (Optional) Configure Enable Setpoint Password to restrict access to the setpoint
functions. The CIMPLICITY HMI default is unrestricted access.
A. Select Set Point Password.
B. Enter the password that will be used to perform setpoint
actions in the Password input field.
C. Re-enter the password in the Confirm Password input field
to confirm it.
Note: These procedures are meant to help you quickly set up a device. Other chapters in the
CIMPLICITY HMI Base Users Manual provide depth descriptions of each part of the
process.
GFK-1180H 5-1
Quick Install for a Device Point 2. Enable the devices protocol.
.
1. Connect a device to a server.
OPERATOR INTERFACE
F1 F2
BATT. M SG .
F1
F2
ESC ^ v SW1 SW 2
RUN I O SW 5 SW 6
STO P
SET C R SW 7 SW 8
7 8 9
ABC DEF G HI SW 9 SW 10
4 5 6
JKL M NO PQ R SW 1 1 SW 12
1 2 3
STU VWX YZ-
SW13 SW14
0 ENTER O N / O FF
+/
IBM Compatible
4. Configure a
device point.
Note: If the protocol does not appear in the Protocol box, use the CIMPLICITY HMI
installation CD to add the protocol.
3. Open the New Device dialog box. Two of the several methods are:
Method 1Using the mouse
Double click the left mouse button.
Method 2Using the keyboard
Click Ctrl+N on the keyboard.
The New Device dialog box opens.
4. Enter a unique name in the Device field.
5. Click OK.
The Port Properties dialog box opens.
2. Enter the interval length between scans in the Scan Rate field. The time type options
are:
Seconds
Minutes
Hours
3. Enter the number of times CIMPLICITY HMI should retry scanning the device if a
communications error is encountered in the Retry Count field.
If communications cannot be established, devices on this port are considered to be
down, and a $DEVICE_DOWN alarm is generated for each device.
Once a device is down, periodic attempts are made to resume communications to the
device.
4. Check the Enable checkbox to enable communications on this port.
5. Click OK.
A filled in New Device dialog box appears.
1. Click OK when the New Device dialog box has the device and port filled in.
The Device dialog box appears.
Example: Device PropertiesDialog Box with TCP/IP Protocol
$SYSTEM
$MAC_FR
$PTM_FR
Included in
CIMPLICITY HMI
Note: CIMPLICITY HMI provides you with a Manual Mode feature that enables a user to
disconnect a points values from a device and set them manually. See the "Device Point Quality
Support at Runtime" section in this chapter for details about this feature.
GFK-1180H 6-1
New Device Points
When you create a new device point you select the:
Point type
Device for the point
Classification of the point
Note: Values read from or written to a device point will be forced into the specified type.
Example
Reading an SINT point value, which is 8-bits, from a 16-bit register will truncate the high
order byte, and the sign will not be maintained.
Writing an INT point, which is 16-bits, to an 8-bit register will do the same.
w DINT
w INT
w REAL Array= Check to prohibit
w SINT More than 1 setpoint use
w UDINT
w UINT
w USINT
w 3D_BCD
w 4D_BCD
Important: Configure a 3D_BCD or 4D_BCD Point Bridge type point as a UINT point. The
BCD data types are used by the devcom to convert binary data coming from a PLC. When the
Point Bridge receives data from the source system, BCD conversion has already occurred.
Performing BCD conversion again on data will cause it to be converted twice, and, as a result,
give incorrect values.
Text Points
General TabBasic ViewText Point
w STRING
w STRING_20
w STRING_8 Array= Check to prohibit
w STRING_80 More than 1 setpoint use
Note: You specify an array in the Point Properties dialog box, General tab, Element field.
Important: Array points are not supported by all CIMPLICITY software functions. Support
for array points is as follows:
The Smarteye and DDE Client protocols do not support array points.
Values read from or written to a device point are forced into the correct type of the point.
This may affect the array size. For example, if you have defined an analog point with type
INT for a point on a CCM2 device in Register memory, the maximum array size will be 125
elements because each point in the array is put into a separate 16-bit register. Check the
appropriate Device Communications documentation for further information.
Note: Addressing is used for most GE Fanuc device communications options, and for devices
created via the Device Communications Toolkit API that use custom addressing.
This section describes criteria for customized addressing. There is another type of addressing,
standard addressing. However, it is rarely used. For further information on addressing for the
protocol and device, see the CIMPLICITY HMI for Windows NT and Windows 95 Device
Communications Manual (GFK-1181).
Availability depends on
protocol:
On Change
On Scan
On Demand On Scan
On Demand On Change
Unsolicited
Poll Once
2. Enter the Address that is consistent with the selected protocol. For further
information on addressing for the protocol and device, see the CIMPLICITY HMI for
Windows NT and Windows 95 Device Communications Manual (GFK-1181).
Example
A digital point is located in the third (3rd) bit of Register 5 on a Series 90-70
The Address is "%R5"
The Address Offset is "2".
4. Choose one of the following (The Addressing box displays one or all choices
depending on the device you select):
A. Device Dataif the address you enter is for a device point.
B. Diagnostic Dataif the address you enter is for a diagnostic
point
See "Entries for Diagnostic Points Used with Devices".
C. Ethernet Global Dataif the address you enter is for
Ethernet global data.
5. Specify the Update Criteria when data for the point is passed from the device
communications processor to the point database. Available selections depend on the
protocol you are using.
Note: Diagnostic points are not available for the Point Bridge.
To view diagnostic data, configure device points that correspond to the diagnostic locations in
the enabler. These diagnostic points are like device data points in all ways, except that they
are always available when the enabler is running (points containing device data are
unavailable if communication with the device fails). Diagnostic points may be scanned at any
appropriate multiple of the ports base scan rate, displayed in CimView screens, trended,
logged, alarmed, etc.
Important: You cannot write to diagnostic points. Always configure them for Read access.
Note: Standard addressing is very rarely used. However, if it is the Addressing box changes
to the Domain Address box.
To put the General tab of the Point Properties dialog box in advanced mode:
Press the Advanced button on the basic General tab. If the tab is in
advanced view, the Basic button will display.
Advanced Device tab on Point Properties dialog box
The available selections on the General tab depend on what point type you are configuring.
The following procedure begins with entries for any point type and continues through entries
for the analog/Boolean point types only.
Safety Points
The status of a safety point controls whether or not a setpoint is permitted. You can select a
safety point on the advanced General tab of the Point Properties dialog box.
At runtime if the:
Safety Point is Setpoint on the Point is
Available and
evaluates to a non-zero value Permitted
Available and
evaluates to zero Not permitted
Unavailable Not permitted
At runtime if the:
Availability Trigger Configured Point is
Evaluates to a non-zero value Available
Evaluates to zero Unavailable
Trend History
For Analog and Boolean points on the General tab of the Point Properties dialog box
CIMPLICITY HMI can compile a trend history for analog and Boolean points. All you have
to do is specify the amount of time that data should be retained and the maximum number of
samples that should be included.
Example:
Point ABC is scanned every 5 seconds
If you define a:
Max Duration of 1 minute, the buffer contains the 12 most recent values for
ABC at any given time.
Max Count of 10, the buffer contains the 10 most recent values (that is, the
values for the last 50 seconds).
Max Duration and Max Count, the buffer contains the 10 most recent values.
3. Select the table to which the data will be logged. See the "Database Logger" chapter in
this manual for information about configuring log tables.
Important: Domains for programmable controllers in CIMPLICITY HMI software are sized
when the project starts. If you dynamically reconfigure domain sizes on the programmable
controller, you must restart the project to access points at the new domain offsets.
To put the Device tab of the Point Properties dialog box in advanced mode:
Press the Advanced button on the basic Device tab. If the tab is in
advanced view, the Basic button will display.
Advanced Device tab on Point Properties dialog box
Example
You are configuring a point that requires an update for logging purposes.
If the update needs to be hourly, but the device is being scanned every quarter hour
for other purposes:
Use a device Trigger Point that is configured with a one-hour scan rate. See "On
Scan" in the "Configuring Device Points" chapter in this manual.
None
Equal
Greater Than
Greater Than Equal
Less Than Equal
Less Than
On Change
2. Select, in the Relation field, how the trigger point will be evaluated.
Your choices are:
Scan Rate
Enter the frequency at which the CIMPLICITY device communications option will read this
points data, based on the ports Base Rate.
The Base Rate is the minimum rate at which device points can be polled on the port. The
Scan Rate is a multiple of the Base Rate.
Example
The Base Rate is 5 seconds
The Scan Rate is set to "3"
The point is scanned every 15 seconds.
When you define Trigger Settings for a point, enter 0 (zero) in the Scan Rate field.
Analog Deadband
An Analog Deadband filters out changes in the raw value of this point. The raw value must
change by at least this value before the point value is updated in the CIMPLICITY point
database.
Therefore, the Analog Deadband can make CIMPLICITY software ignore small fluctuations
in the value of a point. For example, if you have a point ranging from 0 to 10,000, and you
enter 5 in this field, any point fluctuations of less than 5 are ignored.
Check box status CIMPLICITY HMI will read the points value
Check Immediately after a Setpoint is done to it.
Clear On the next scan or when the trigger condition for the
point is set to "TRUE".
Important: The Point Bridge does not support Poll After Set. If you are defining a Point
Bridge point, clear this check box.
In other words, CIMPLICITY HMI reads A1 at the 3, 6, 15, 18, and 24 second marks because
the value of D1 was HIGH at those times.
In other words, CIMPLICITY HMI reads A1 at the 3, 15, and 24 second marks, because they
are the only places where the scanned value of D1 transitions from LOW to HIGH. Note that
any transitions that occur between scans (such as those between the 15 and 18 second marks)
do not count.
At run-time, PLC1 will only be updated while the point PLC1_READY is equal to 1.
The trigger settings and scan rate for each of the digital points should be configured as
follows:
If the trigger point (ANA_INP_20) does not change frequently, this gives a performance
benefit, because the digital points will only be updated when the analog point changes.
2. Select the name of the base engineering units from the list of available measurement
units. When you do this, the label for the unit is automatically put in the Label field.
Method 2
Click the Browser button to the right of the Unit field to find the measurement unit in the
Select A Measurement Unit Browser
Note: If you select a unit of measurement on the Conversion tab, and the project has an active
measurement system at runtime, the base engineering units for the point are automatically
converted to the corresponding units in the active measurement system.
If there is no active measurement system, the base engineering units are used. If the project
has an active measurement system at runtime, no further point conversion takes place.
Example
The point's value represents degrees F.
You leave the Unit field blank.
The active measurement system uses metric units.
No conversion from degrees F to degrees C takes place at runtime.
CIMPLICITY HMI supports the following types of Engineering Unit (EU) conversions for
analog points.
None No conversion is performed.
Linear The point is converted according to the high and low Raw
Limits you specify on the Conversion page.
Custom The point is converted according to the Custom
Expressions you specify on the Conversion page
When you specify Linear or Custom conversion, you must enter the values for the Raw and
Converted Limits.
Linear Conversion
When you use linear conversion, you specify base and converted values that CIMPLICITY
HMI uses to calculate runtime conversions..
4. Enter two Converted values in the First and Second fields. These are engineering
unit values that correspond to the first and second raw values you entered.
CIMPLICITY HMI uses these four values to calculate the linear conversion for the point. The
conversion formula is:
where:
EU value = the Engineering Units value
R1 = First raw value
R2 = Second raw value
C1 = First converted value
C2 = Second converted value
Raw value = the value read from the device.
CIMPLICITY HMI uses the inverse of this expression to convert Setpoint values entered by
users to raw values for downloading to the device.
Important: The numeric operands you use in the Forward expression are assumed to be
integers unless you include decimal points in them. Once the expression processor sees an
operand with a decimal point, it will process the rest of the expression using floating-point
arithmetic
Because integer arithmetic was used in the first operation of these two
expressions, the operation (3/2) gives the result 1 instead of 1.5.
(%P/2.0)*10 (3/2.0)*10 = (1.5)*10 = 15.0
GFK-1180H 7-1
New Virtual Points
When you create a new virtual point you select the:
Point type
Classification of the point
w DINT
w INT Array= Check to prohibit
w REAL More than 1 setpoint use
w SINT
w UDINT
w UINT
w USINT
Boolean Points
General TabBasic ViewBoolean Point
BOOL
BYTE
WORD Array= Check to prohibit
DWORD More than 1 setpoint use
STRING
STRING_20
STRING_8 Array= Check to prohibit
STRING_80 More than 1 setpoint use
Using Arrays
CIMPLICITY software lets you define single points and array points. Using array points is
one way to provide more efficient data collection. An array point can represent one instance
of several process variables, or several instances of one process variable.
A point contains one (1) element.
An array contains more than one element.
Note: You specify an array in the Point Properties dialog box, General tab, Element field.
Important: Array points are not supported by all CIMPLICITY software functions. Support
for array points is as follows:
None
Initialized
Saved
Saved or Initialized
Basic selection
2. Specify the source for the initial value of this point when the software is started up or
reset. Choices include:
2. Specify the source for the initial value of this point when the software is started up or
reset. Choices include:
Note: When working with initialization values for string arrays, if:
Too many elements are given in Initial Value, the string truncates at the number of
elements.
The Initial Value does not specify enough elements, the remaining elements of the
string are initialize to the Null character.
Configure alarms
To put the General tab of the Point Properties dialog box in advanced mode:
Press the Advanced button on the basic General tab. If the tab is in advanced
view, the Basic button will display.
Safety Points
The status of a safety point controls whether or not a setpoint is permitted. You can select a
safety point on the advanced General tab of the Point Properties dialog box.
At runtime if the:
Safety Point is Setpoint on the Point is
Available and
evaluates to a non-zero value Permitted
Available and
evaluates to zero Not permitted
Unavailable Not permitted
Availability Triggers
An Availability Trigger determines the validity of the point you are configuring and provides
a "device healthy" signal for points that are tied to intermediate devices during runtime.
At runtime if the:
Availability Trigger Configured Point is
Evaluates to a non-zero value Available
Evaluates to zero Unavailable
Example:
Point ABC is scanned every 5 seconds
If you define a:
Max Duration of 1 minute, the buffer contains the 12 most
recent values for ABC at any given time.
Max Count of 10, the buffer contains the 10 most recent
values (that is, the values for the last 50 seconds).
Max Duration and Max Count, the buffer contains the 10
most recent values.
3. Select the table to which the data will be logged. See the "Database Logger" chapter in
this manual for information about configuring log tables.
Tip: A Local checkbox displays on the advanced Virtual tab for every calculation choice
except none. Check the Local check box to tell CIMPLICITY HMI not to report the value of
the point to the Point Management process. This is useful for points that are only used to hold
intermediate values in calculations. For such points, setting the Local flag eliminates the
overhead of reporting to the Point Management process. Local points cannot be shared with
other applications.
Notes: Almost all of the calculations allow you to enter a trigger point.
For Equation points, you only need Saved and Initial values for Delta Accum and Delta
Value points. This is because all other Equation points are validated at startup and any
saved or initial value is immediately overwritten.
A Trigger point minimizes the system resources that are required for calculating virtual points
when it is not necessary to keep virtual points current with the points used to calculate their
values.
Example
You are configuring a point that requires an update for logging purposes.
Equation Points
Equation points are available for both analog and Boolean virtual points.
CIMPLICITY HMI uses the expression you specify in the Expression field to
update the points value.
3. Enter an Expression that calculates the value of the Equation point. The
expression may contain one or more Point IDs as well as constant values, operations
and functions.
If : And: Then:
The Current
An Initial Equation value of the The Equation point
Point value is Expression is value is reset to the:
When the Trigger Point is not defined
1 Not defined Available Current value
2 Defined Unavailable Initial value
3 Defined Available Current value
4 Not defined Unavailable Zero (0)
When the Trigger Point is defined
1 Defined Initial value
2 Not defined Zero (0)
2. (Required) Enter an expression that calculates the value of the Delta Accum point.
The expression may contain one Point ID along with constant values, operations, and
functions.
Note: When the expression for a Delta Accum point goes unavailable, and then
comes back as available, the delta between the value right before the point went
unavailable and the value right after it comes back as available is not accumulated.
3. (Required) Enter the maximum acceptable delta value that can be added to the Delta
Accum point value in the Variance field.
If the delta value is greater than the Variance value, the:
A. Delta Accum point continues counting.
B. Current delta value is not added.
C. System logs the following message to the Status Log with
Success status:
Variance value exceeded for accumulator point :
<point_id>
4. Enter the maximum acceptable delta value that can be added to the virtual point in
the Variance field. Values greater than this number will not be added to the
accumulator point, and the system will log a message to the Status Log.
Element Description
COUNTS[0] Shift total production count
COUNTS[1] First hour production count
COUNTS[2] Second hour production count
COUNTS[3] Third hour production count
COUNTS[4] Fourth hour production count
COUNTS[5] Fifth hour production count
COUNTS[6] Sixth hour production count
COUNTS[7] Seventh hour production count
COUNTS[8] Eighth hour production count
A Safety Point called HOUR:
Varies from 1 to 8, depending on the hour of the shift.
Determines which subgroup element gets updated along with COUNTS[0]. For
example, if HOUR=4, COUNTS[0] and COUNTS[4] are updated.
If HOUR is less than 1 or greater than 8, no elements in the array are updated.
2. Enter an Expression that calculates the value of the Value Accum point. The
expression may contain one or more Point IDs along with constant values,
operations, and functions.
3. Enter the Point ID of a Trigger Point that will cause the Value Accum point to be
updated at run-time.
The Value Accum point updates whenever the Trigger Point is updated.
If you do not define a Trigger Point, the Value Accum point updates whenever
the value of the source point in the Expression field changes.
4. (Optional) Enter the Point Id of a Reset Point.
Updating a Reset point causes the Value Accum point to be reset.
At runtime, the value of the Value Accum point is reset as follows:
Note: For integer type points, the resulting data is rounded. This may result in a loss of
accuracy. It is suggested that you use the Real point type for your Average point.
2. Enter an expression that calculates the value of the Average point. The expression
may contain one or more Point IDs as well as constant values, operations, and
functions.
(Optional) Enter a Point ID for a Trigger Point.
2. (Required) Enter an expression that calculates the value of the Max Capture point.
The expression may contain one or more Point IDs along with constant values,
operations, and functions.
Note: When a
2. (Required) Enter an expression that calculates the value of the Min Capture point.
The expression may contain one or more Point IDs as well as constant values,
operations, and functions.
3. (Optional) Enter a Point ID for a Trigger Point.
Histogram Points
A Histogram point records the frequency at which the value of the source point, identified in
the Expression field, occurs within specified range intervals. This information is typically
displayed graphically as a histogram.
Each time the source point is updated, the counter whose range encompasses the source point
value is incremented.
You must configure a Histogram point as an array point. The number of elements in the
array will be:
the number of range intervals you desire + 6
The extra six elements are used to maintain the:
Minimum of the point values received
Maximum of the point values received
Total number of samples received
Sum of the values of all samples received
Number of sample values that were less than the lower limit of the point range
(underflow bucket)
Number of sample values that were greater than the upper limit of the point range
(overflow bucket)
Use the Display Limits fields to specify the lower and upper range values within which the
point values are expected to occur. The range intervals are automatically calculated based on
the Display High and Display Low limits and the number of Elements you specify.
To configure a Histogram:
1. Select Histogram in the Calculation Type field on the Virtual tab.
2. (Required) Enter an expression that calculates the value of the Histogram point.
The expression may contain one or more Point IDs along with constant values,
operations, and functions.
Example
VIRTUAL_PT1 = DEVICE_PT[0] / 2.0
C. Use proper formatting for Point IDs with reserved words.
Point IDs that are reserved words, or contain spaces, arithmetic operators,
parentheses, or that begin with a non-alphabetic character must be placed in
single quotes when used in an Expression.
Example
VIRTUAL_PT2 = DEVICE_PT:0 * WARNING_LOW
3. (Optional) Enter a Point ID for a Trigger point.
2. Select the name of the base engineering units from the list of available measurement
units. When you do this, the label for the unit is automatically put in the Label field.
Method 3
1. Click the Pop-up Menu button to the right of the Unit field.
2. Select New.
The New Measurement dialog box opens.
Note: If you select a unit of measurement on the Conversion tab, and the project has an active
measurement system at runtime, the base engineering units for the point are automatically
converted to the corresponding units in the active measurement system.
If there is no active measurement system, the base engineering units are used. If the project
has an active measurement system at runtime, no further point conversion takes place.
Example
The point's value represents degrees F.
You leave the Unit field blank.
The active measurement system uses metric units.
No conversion from degrees F to degrees C takes place at runtime.
CIMPLICITY HMI supports the following types of Engineering Unit (EU) conversions for
analog points.
None No conversion is performed.
Linear The point is converted according to the high and low Raw
Limits you specify on the Conversion page.
Custom The point is converted according to the Custom
Expressions you specify on the Conversion page.
When you specify Linear or Custom conversion, you must enter the values for the Raw and
Converted Limits.
To create an expression:
Method 1
Click the button to the right of an Expression input field
Method 2
Select Edit Expression from the Pop-up menu
Either method opens the Edit Expression dialog box.
Continue
1. Double click an operation to select it.
The operation is put at the current cursor position in the input box. If the operation
requires an argument, the cursor is positioned for you to type the argument.
2. Insert a Point ID or variable either after the operator or between parentheses, if they
appear with an operator.
Points
Configuration
dialog box
New Point
dialog box
Double click an
available
operator
Alarm Functions
Alarm functions supported by the Expression Editor are:
AL Returns True if the point is in any Alarm or Warning state.
Format is AL(<point id>)
A1 or WARNING Returns True if the point is in a Warning High or Warning
Low state.
Format is A1(<point id>)
A2 or ALARM Returns True if the point is in an Alarm High or Alarm
Low state.
Format is A2(<point id>)
AH1 or WARNING_HIGH Returns True if the point is in a Warning High state.
Format is AH1(<point id>)
AH2 or ALARM_HIGH Returns True if the point is in an Alarm High state.
Format is AH2(<point id>)
AL1or WARNING_LOW Returns True if the point is in a Warning Low state.
Format is AL1(<point id>)
AL2 or ALARM_LOW Returns True if the point is in an Alarm Low state.
Format is AL2(<point id>)
ANA or ALARM_NOT_ACKED Returns True if the point is in alarm and the alarm has not
been acknowledged.
Format is ANA(<point id>)
Bitwise Operations
You can use Boolean, integer or floating point number for bitwise operations. If a
number/expression is in floating point, it is rounded off to the nearest integer for these
operations.
Bitwise operations supported by the Expression Editor are:
BAND Performs a bitwise AND of two expressions.
Format is <expr1> AND <expr2>.
BOR Performs a bitwise OR of two expressions.
Format is <expr1> OR <expr2>.
BNOT Performs a bitwise NOT of an expression.
Format is NOT <expr>.
BXOR Performs a bitwise XOR of two expressions.
Format is <expr1> XOR <expr2>.
SHL Performs a binary left shift on an expression.
Format is (expr1) SHL (expr2).
For example, 2 SHL 1 returns a value of 4.
SHR Performs a binary right shift on an expression.
Format is (expr1) SHR (expr2).
For example, 2 SHR 1 returns a value of 1.
Logical Operations
You can use Boolean, integer or floating point numbers for logical operations. If an
expression has a non-zero value, it is TRUE; if the value is zero (0), it is FALSE.
Logical operations supported by the Expression Editor are:
AND Performs a logical AND of two expressions.
Format is <expr1> AND <expr2>.
OR Performs a logical OR of two expressions.
Format is <expr1> OR <expr2>.
NOT Performs a logical NOT of an expression.
Format is NOT <expr>.
XOR Performs a logical XOR of two expressions.
Format is <expr1> XOR <expr2>.
IF (expr1) THEN (expr2) ELSE (expr3) or
(expr1) ? (expr2) : (expr3)
Performs a logical If A is TRUE, then B, else C.
Relational Operations
Relational operations supported by the Expression Editor are:
LT Less Than or Below
Format is (expr1) LT (expr2).
GT Greater Than or Above.
Format is (expr1) GT (expr2).
EQ Equal To
Format is (expr1) EQ (expr2).
LE Less Than or Equal To
Format is (expr1) LE (expr2).
GE Greater Than or Equal To
Format is (expr1) GE (expr2).
NE Not Equal To
Format is (expr1) NE (expr2).
GFK-1180H 8-1
Point View
For any point that you configure, you can select a CimView screen name that will appear on
that points popup menu in the Workbench.
You can also configure analog point display characteristics for CIMPLICITY HMI
application such as CimView.
You do this on the View tab of the Point Properties dialog box.
Boolean, text
analog
3. Select a Screen from the selection in the drop down menu. Your options include
CimView screens that are in the project directory.
The name of the screen you select will appear on the points
popup menu in the Workbench. The screen will appear when it
is selected.
The screen will display when a user selects this point in the
Alarm Viewer and clicks Screen.
You can specify an analog points justification when it displays in standard CIMPLICITY
HMI software, such as CimView.
The width specification never causes a value to be truncated. If the number of characters in the
output value is greater than the specified width, or if a width is not given, all characters of the
value are printed (subject to the precision specification).
If the number of characters in the output value is less than the specified width, blanks are
added to the left or right of the values, depending on whether the flag (for left alignment) is
specified, until the minimum width is reached.
If the width is prefixed with 0, zeros are added until the minimum width is reached.
For analog real points and points with Engineering Units conversion
1. Enter the PRECISION number of digits to be displayed to the right of the decimal
point in field.
2. Select Fixed, Scientific or Compact for the format TYPE. The result of your
choice is as follows:
Guide for enabling analog display configuration: When you configure an object that
uses the point in CimView, you have to enable the Justification and Width configuration in
CimEdit. You do this on the Text tab of the Object Properties dialog box in CimEdit, in the
Display Format field. See "CIMPLICITY HMI CimEdit Manual" GFK-1396 for more information.
Important: Make sure the display limits are within range limits that you set. See "Range
Limits" in this chapter.
Point Limits
You can specify range and setpoint limits for both device and virtual analog points on the
Limits tab that appears in the Advanced General tab group.
1. Press the Advanced button on the General tab of the Point Properties
dialog box.
2. Select the Limits tab that appears if you are configuring an analog point.
Limits Tab
Exclude
meaningless data
Values below the low range limit and above the high range limit will display as the
point unavailable value.
Example
A PLC gives raw data in counts from 0 to 1000.
The raw data represents temperatures between -500 C and +500 C.
Values above 200 C or below -200 C are considered to be out of range.
If a user enters a value below the low setpoint limit or above the high setpoint limit, the value
will not be accepted.
2. Enter a basic Alarm Message. See "Basic Alarm Message" in this section.
3. Specify Alarm Limits. See "Specifying Alarm Limits" in this section.
Note: Using several of the available variables can involve advanced configuration.
You can type in the variables or select them from the fields popup menu. See "Alarm Definition"
in this chapter.
Boolean point
A detailed alarm definition can be entered or changed and be given an assigned Alarm Class
and string index.
Alarm Definition
You can configure a basic I/O alarm message in the Alarm tabs basic view. It is in the
advanced view that you enter a definition that CIMPLICITY HMI uses to trigger exactly the
alarm message you want based on calculated criteria. The Definition box includes specifying
an alarm:
Message with optional variables
Class
String
Entries
%ID
%VAL
%EU
%STATE
%LIMIT
%DEV_ID
%DEV_VAL
%DEV_AMT
You can type in the variables or select them from the fields popup menu. Type them all as
capital letters (CAPS).
2. The associated
text appears
as the Alarm
Limits
1. Press the Popup button to the right of the Alarm Class field on the Alarm tab of
the Properties dialog box.
2. Select New on the popup menu.
3. Select the Alarm Class tab.
The Alarm Class Configuration dialog box appears.
Beep
specifications
Test
Alarm Criteria
You can select one of the following methods for evaluating the alarm values:
2. Enter at least one and up to four values in the Alarm Limits fields.
Each time the points value is updated, its current value is compared with the alarm
values. An alarm is generated when the points value transitions from one alarm state
to another.
The transitions are:
State Description
Alarm High Point value Alarm High value.
Warning High Alarm High value > Point value Warning High
value
Normal Warning High value > Point value > Warning Low
value
Warning Low Warning Low value Point value > Alarm Low value
Alarm Low Point value Alarm Low value
If the point is in normal state, the Point Manager resets alarms for the point.
2. Define the values in the Alarm Limits fields based on the deviation from the norm:
The text definition depends on the string you select in the String Index field on the
same tab. Make sure that:
High (Full) is larger than Warning High (Almost Full)
Low (Empty) is larger than .Warning Low (Almost)
Empty is larger
than Almost
The point is scanned at its normal Scan Rate, but is evaluated for alarming at the Alarm
Delay rate (also known as the sample interval).
An alarm is generated when the difference between the current value of the point and the
current value of the Deviation Point exceeds an alarm limit. This difference is calculated
whenever the value of the point or the Deviation Point changes.
On Update Alarming
On Update alarming is used to generate an alarm whenever the points value is updated.
If you choose the On Update alarm criteria, you cannot define Alarm Values. Each time the
points value is updated, an alarm is generated.
Help File
Enter the name of a text file that users can display when they click the Help button in the
Alarm Viewer. You can enter a filename of up to 8 characters.
The actual file is in the ALARM_HELP directory in your project. The actual filename is the
name given in this field, followed by ".HLP".
Alarm Help files are ASCII text files of up to sixty (60) lines. Each line can have a maximum
of 70 characters. Files are located in the %SITE_ROOT%\alarm_help directory.
If you wish, you may use the same Help File for several points.
2. Select a user role in the Available Roles column that can view the alarms.
3. Press Add. The role will move over to Configured Roles For Alarm column.
4. Select any roles in the Configured Roles for Alarm column that should not view the
alarms.
Important: If you have not defined an alarm for the point, any information you enter on this
page is not saved when you select OK.
Automatic Actions
Automatic actions on the Alarm Options tab include:
Alarm Repeats
Automatic acknowledgements
Automatic reset
Alarm Repeats
Auto repeat, on the Alarm Options tab, is the time (in minutes) that the Alarm Manager waits
before repeating the alarm to all interested processes. The alarm will continue to be repeated
until it is acknowledged, reset, or deleted.
In particular, the Alarm Line Printer (AMLP) is an interested process. Setting a repeat
timeout will cause the points alarm to be reprinted on the Alarm Line Printer until it is
cleared.
Note: The actual number of minutes that the Alarm Manager will wait before repeating the
alarm may be greater than this number. The maximum time will be the number you enter in
this field plus the number of minutes configured for the timer for processing automatic alarms
in the Alarm Manager configuration file (alarm_mgr.dat). The default for this timer is 5
minutes.
Alarm Acknowledgements
An alarm can be acknowledged manually or automatically
Alarm acknowledgement is configured on the Alarm Options tab of the points Properties
dialog box.
Note: The actual number of minutes that the Alarm Manager will wait before acknowledging
the alarm may be greater than this number. The maximum time will be the number you enter
in this field plus the number of minutes configured for the timer for processing automatic
alarms in the Alarm Manager configuration file (alarm_mgr.dat). The default for this timer
is 5 minutes.
Alarm Deletion
The Deletion Requirements are the conditions that must exist in order for an alarm to be
deleted (removed from the system).
If you select both check boxes on the Alarm Options tab of the points Properties dialog box,
the alarm will not be deleted until it is acknowledged and reset (these actions may occur in
any order).
Note: You can also use the Workbench to monitor runtime behavior, including:
Open the Point Control Panel to monitor and control runtime point behavior
Display a Quick Trend chart for a selected point
GFK-1180H 9-1
Method 2
A. Place the cursor in the right pane.
B. Click the right mouse button.
C. Select Autofill from the popup menu if there is no check mark
on its left side.
CIMPLICITY HMI displays a list of all the existing points when you use either method.
Note: Points with a $ as the first character in the name are system points and cannot be
changed or removed.
Specify what
point to list Use wild cards for any
entry:
?one character
*multiple characters
Wild cards can help you filter your display even if you do not know the exact name for the
criteria you are using. Use either a * or a ?.
Enter a * in the following positions: when you enter any search criteria:
*Position Relative
to Entered Characters To Display Any Points that:
After Begin with the entered characters, e.g. F_ Tank*
Before End with the entered characters, e.g. *Tank
Between Begin and end with the entered characters, e.g. F*1
Enter a ? to display any points that contain the characters you enter, in addition to one
character per ?, in the position that the ? is entered, e.g. ?_Tank?
The point or points you specify will display in the right pane until you change your
specifications.
Enter criteria to
filter the display
Note: Two useful fields that display the point status are:
Field Selection
Use the Field Chooser dialog box to select the point fields that will display in the right pane of
the Workbench.
Popup
Method 3
3. Select a field in the Available field column that you want to add to your display.
4. Press Add. The field will move over to the Display Fields column.
5. Select any field in the Display fields column that you do not want to display.
6. Press Remove. The field will move over to the Available field column.
Field Definitions
Most of the field names state exactly what the field is. However, for reference, following is a
brief explanation of all the fields available for display.
Field To Display
Access Filter "E" if the point is an Enterprise point.
Address Actual-starting address of the point within a device (for
device points)
See the CIMPLICITY HMI for Windows NT and Windows 95
Device Communications Manual (GFK-1181) for details on the
addressing supported for your particular device and protocol.
Address Offset Offset in memory from the first bit of the point Address
that marks the start of the point data (for device points).
Alarm High High alarm value for the point
Alarm Low Low alarm value for the point
Data Length Data length associated with the data type chosen.
Data Type ID Point type used for the point from one of the following
values:
0Boolean type point
1Integer type point
2APPL type point
3Text type point
4Unsigned 8-bit integer type point
5Unsigned 16-bit integer type point
6Unsigned 32-bit integer type point
7Signed 8-bit integer type point
8Signed 16-bit integer type point
9Signed 32-bit integer type point
10Floating point type point
Description Brief information about the point.
Device ID Source of the point data with one of the following values:
<device name>The name of the device that is
supplying the point data.
$GLOBALIndicates that the point is a Global derived
point.
$DERIVEDIndicates that the point is a Calculated
derived point.
Note: The Remove button will be disabled if the field is required. The Move Down or
Move Up button will be disabled if a field that will be affected by the move has to appear in
the furthest left position.
$LOCAL.COMPUTER
Point Type Local Point
Data Type STRING (15)
Access Read Only
Description Local Computer Name
$LOCAL.WINUSER
Point Type Local Point
Data Type STRING (20)
Access Read Only
Description Windows user name
GFK-1180H 10-1
$PROJECT.COMPUTER
Point Type Server Point
Data Type STRING (15)
Access Read Only
Description Server Computer Name
$PROJECT
Point Type Server Point
Data Type STRING (20)
Access Read Only
Description Project name
$PROJECT.AVAILABLE
Point Type Local Point
Data Type BOOL
Access Read Only
Description Project availability (0-Not Available,1-Available)
$PROJECT.LOGGEDIN
Point Type Local Point
Data Type BOOL
Access Read Write
Description Login status
0: Logged out || !$PROJECT.AVAILABLE
1: Logged in && $PROJECT.AVAILABLE
$PROJECT.DEVICES
Point Type Server Point
Data Type Integer
Access Read Only
Description Number of devices online
$PROJECT.DATETIME
Point Type Server Point
Data Type Integer
Access Read Only
Description Server Date and Time in seconds from 1/1/1970
$PROJECT.DATE.YEAR
Point Type Server Point
Data Type Integer
Access Read Only
Description Current year (1970-2039)
$PROJECT.DATE.MONTH
Point Type Server Point
Data Type Integer
Access Read Only
Description Current month (1-12)
$PROJECT.DATE.DAY
Point Type Server Point
Data Type Integer
Access Read Only
Description Current day in the month (1-31)
$PROJECT.DATE.DAYOFYEAR
Point Type Server Point
Data Type Integer
Access Read Only
Description Current day in the year (1-366)
$PROJECT.DATE.WEEK
Point Type Server Point
Data Type Integer
Access Read Only
Description Current week in the year (1-52)
$PROJECT.DATE.HOUR
Point Type Server Point
Data Type Integer
Access Read Only
Description Current hour in the day (0-23)
$PROJECT.DATE.HOUR12
Point Type Server Point
Data Type Integer
Access Read Only
Description Current hour in the day (1-12)
$PROJECT.DATE.SECOND
Point Type Server Point
Data Type Integer
Access Read Only
Description Second past the minute (0-59)
$PROJECT.DATE.SECOFDAY
Point Type Server Point
Data Type Integer
Access Read Only
Description Second past midnight (0-86399)
$PROJECT.DATE.AMPM
Point Type Server Point
Data Type Integer
Access Read Only
Description 0- AM, 1- PM
$LOCAL.DATETIME
Point Type Local Point
Data Type Integer
Access Read Only
Description Local Date and Time in seconds from 1/1/1970
$LOCAL.DATE.MONTH
Point Type Local Point
Data Type Integer
Access Read Only
Description Current month (1-12)
$LOCAL.DATE.DAY
Point Type Local Point
Data Type Integer
Access Read Only
Description Current day in the month (1-31)
$LOCAL.DATE.WEEKDAY
Point Type Local Point
Data Type Integer
Access Read Only
Description Current day in the week (1-7)
$LOCAL.DATE.DAYOFYEAR
Point Type Local Point
Data Type Integer
Access Read Only
Description Current day in the year (1-366)
$LOCAL.DATE.HOUR
Point Type Local Point
Data Type Integer
Access Read Only
Description Current hour in the day (0-23)
$LOCAL.DATE.HOUR12
Point Type Local Point
Data Type Integer
Access Read Only
Description Current hour in the day (1-12)
$LOCAL.DATE.MINUTE
Point Type Local Point
Data Type Integer
Access Read Only
Description Minutes past the hour (0-59)
$LOCAL.DATE.SECOND
Point Type Local Point
Data Type Integer
Access Read Only
Description Second past the minute (0-59)
$LOCAL.DATE.AMPM
Point Type Local Point
Data Type Integer
Access Read Only
Description 0- AM, 1- PM
$USER.ALARMS
Point Type Local Point
Data Type Integer
Access Read Only
Description Alarm count by user
$ALARM.TOTAL
Point Type Server Point
Data Type Integer
Access Read Only
Description Alarm count
$ALARM.ACKED
Point Type Server Point
Data Type Integer
Access Read Only
Description Alarms acknowledged
$ALARM.ACTIVE
Point Type Server Point
Data Type Integer
Access Read Only
Description Active Alarm count
GFK-1180H 11-1
Opening the Point Cross Reference Window
The Point Cross Reference window has its own icon in the Workbench.
1. Press the Build button on the Point Cross Reference tool bar.
Method 2
1. Select PtXRef on the Point Cross Reference menu bar.
2. Select Build.
Both Methods Continued
A list of subsystems (areas) in you project appears, when you use either method.
Selections in this list can be changed at any time.
1. Select the subsystems to be included in the PtXRef database.
2. Press OK.
Selected substystems
selected
List of points
Text only
Full view
Tree view
Note: A list of points displays in the left pane for all views.
Valid point
Point ID
type
Point count
To re-sort the lists in the left pane of the Point Cross Reference window:
Click the title bar on top of the list that you want as the primary sort.
The list you select will be sorted in ascending order. Information on the other two lists will
stay with the associated items in the primary sort.
Click the View Options button on the Point Cross Reference toolbar.
Method 2
1. Select View on the Point Cross Reference menu bar.
2. Select Options.
In either case, the Views tab of the Options dialog box appears.
Views Tab in Options Dialog Box Tree view enabled
Select how you want the Point Cross Reference window to display information.
The options are:
Sort on When checked sorts by the checked option:
Point TypeWhether the point is valid (included in the
Points database) or invalid (appears in the system but is
not included in the Points database that appears in the
Point Configuration window).
Ref CountNumeric order based on how many times the
point appears in the PtXRef database
Point IDAlphabetical order
Show only used points When checked, the left pane displays only the points that
are currently being used in your project
Enable Tree /Text View CIMPLICITY HMI displays either or both views,
whatever is checked.
To change the subsystems that are included in the Point Cross Reference
display:
1. Select View on the Point Cross Reference menu bar.
2. Select Options. The Options dialog box appears.
3. Select the Subsystems tab.
4. Check the check box to the left of each subsystem you want to include.
Build PtXRef Database Dialog Box
Event Manager
selected
Scripts not selected
Screen Refresh
If more than one location can make changes to points, these changes may be made when you
are using the Point Cross Reference window. You can refresh the view periodically to keep it
up to date.
Point Review
Once you have selected which views (Tree and/or text) in which you want information
displayed in the Point Cross Reference dialog box, you can easily review that information by
simply selecting the appropriate Point ID.
Views Tab in Options Dialog Box Tree view Subsystem Point use
Note: If the object you select has no properties, that selection will not be available when you
click the right mouse button.
1. Press the Build button on the Point Cross Reference tool bar.
2. The Build PtXRef Database dialog box appears.
3. Check the subsystems you want to include in the database.
Selected substystems
selected
Note: You can find and open a CIMPLICITY HMI project from the last databases you
opened listed on the Project drop menu.
About Devices
A device is anything that can communicate point data to CIMPLICITY HMI
software. CIMPLICITY HMI software can read data from and write data to devices.
Examples of devices are programmable controllers such as the GE Fanuc Series 90.
Use this function to configure devices and specify their characteristics.
Configuration requirements for devices vary depending on the type of device and
communications protocol being used. See the CIMPLICITY HMI Device
Communications Manual (GFK-1181) for detailed information on configuring a
device for a particular protocol.
Configuring Devices
To configure devices, double-click the Devices icon in your projects Workbench.
If you have selected the Display search criteria at startup option, the Device
Search dialog box opens. Select the filtering criteria you want and then select OK to
open the Configuration - Device window with the filtered list of devices.
If you have not selected the Display search criteria at startup option, the
Configuration - Device window opens with a list of all configured devices.
GFK-1180H 12-1
When you select Devices the Configuration - Device window opens.
The Configuration - Device window always displays the following attribute for each
device:
Device ID The physical device identifier
In addition to Device, you can choose to display the following attributes:
Port The port to which the device is connected
Resource A configured resource
Only users that are assigned this resource can view alarms for
this device.
Note
Alarms for points on the device may or may not use the same
resource as the device.
Description Up to 40 characters of text that describes the device
The list of devices is initially sorted by Device ID. You may click on any of the
other attribute buttons at the top of the list to sort the list by that attribute.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new device.
Change the window display attributes.
Change startup options.
Modify a device.
Copy the information for a selected device to a new device.
Delete a device.
Display a filtered list of devices
The General properties let you define the following for a new device:
Port The port you selected in the New Device dialog box is
displayed in this field.
Modifying A Device
To modify a device, you can double-click the Device you want to modify.
Alternatively, you can select the Device you want to modify, then do one of the
following:
Select Modify from the Edit menu.
Click the Modify Item button on the Toolbar.
Press Ctrl+M.
After you initiate the request, the Device Properties dialog box opens. The
properties contain the devices current configuration information. You can modify
any of these properties.
Select OK to close the Device Properties dialog box and modify the information for
the selected Device.
Select Cancel to close the Device Properties dialog box without modifying the
Device.
About Resources
Resources are the physical or conceptual units that comprise your facility. They can
be devices, machines, or stations where work is performed, or areas where several
tasks are carried out. Resource configuration plays an important role in your
CIMPLICITY HMI project by routing alarms to specific users and filtering the data
users receive.
CIMPLICITY HMI software uses resources in the following ways:
Each CIMPLICITY HMI device and point is associated with a
resource.
Each user has a view of the facility. The view is defined by the
resources configured for that user. CIMPLICITY HMI software alarms
are generated against resources and routed (displayed) to users who
have those resources in their view.
Many base system functions (such as Alarm Viewer) and product
option functions filter data by resource. For example, a user can create
an Alarm Viewer display that only contains alarm data for a specific
resource.
Configuring Resources
To configure resources, double-click the Resources icon from your projects
Workbench.
If you have selected the Display search criteria at startup option, the Resource Search
dialog box opens. Select the filtering criteria you want, then select OK to open the
Configuration - Resource window with the filtered list of resources.
If you have not selected the Display search criteria at startup option, the
Configuration - Resource window opens with a list of all configured resources.
GFK-1180H 13-1
The Configuration - Resource window always displays the following attribute for
each resource:
Resource A name that uniquely identifies each resource.
In addition to Resource, you can choose to display the following attributes:
Description Text that gives users more information about the resource.
Resource Type Identifies the type of resource. CIMPLICITY HMI software
currently supports two resource types: SYSTEM, and
RESOURCE. This is a display-only field and cannot be
modified.
Any resources you create are automatically given a Resource
Type of RESOURCE
Alarm Mgr Identifies the Alarm Manager process that receives alarms for
this resource. This is a display-only field and cannot be
modified.
The list of resources is initially sorted by Resource. You may click any of the other
attribute buttons at the top of the list to sort the list by that attribute.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new resource.
Change the window display attributes.
Change startup options.
Modify a resource.
Copy the information for a selected resource to a new resource.
Delete a resource.
Display a filtered list of resources
Enter the name of the new resource in the Resource ID field and select OK. The
system verifies that the Resource ID does not already exist, and that no invalid
characters have been used.
If the Resource ID you entered is valid, the Resource Definition dialog box for the
new resource opens.
Resource Definition
The Resource Definition dialog box lets you define the following for a new resource:
Description Up to 40 characters of explanatory text describing the
resource.
Note that you cannot use the $ or | characters in a resource
name.
Users for this The list of users that can view alarm or point information for
Resource this resource.
About Ports
A port is a communication "socket" that connects one or more factory devices such
as PLCs to the computer.
Use this function to configure ports and specify their characteristics. Configuration
requirements for ports vary depending on the type of port and communications
protocol being used. See the CIMPLICITY HMI Device Communications Manual
(GFK-1181) for detailed information on configuring ports for your specific device.
Configuring Ports
You can create a maximum of sixteen (16) ports per project. If you attempt to create
more ports after that, the following message displays:
To configure ports, double-click the Ports icon from your projects Workbench.
If you have selected the Display search criteria at startup option, the Port Search
dialog box opens. Select the filtering criteria you want, then select OK to open the
Configuration - Port window with the filtered list of ports.
GFK-1180H 14-1
If you have not selected the Display search criteria at startup option, the
Configuration - Port window opens with a list of all configured ports.
The Configuration - Port window always displays the following attribute for each
port:
Port The physical port identifier.
In addition to Port you can choose to display the following attributes:
Protocol ID The protocol used for device communications.
Description Text that gives users more information about the port.
The list of ports is initially sorted by Port. You may click on any of the other
attribute buttons at the top of the list to sort the list by that attribute.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new port.
Change the window display attributes.
Change startup options.
Modify a port.
Delete a port.
Display a filtered list of ports
The General properties let you define the following for a new port:
Description Up to 40 characters of explanatory text about the port.
Scan Rate The basic timer for points monitored from this port. The rate at
which points are polled is a multiple of this scan rate. The scan
rate includes configurable units that may be set in units of
Ticks (hundredths of seconds), Seconds, Minutes or
Hours.
Retry Count The number of times to retry communications to devices on this
port after a communications error is encountered
If communications cannot be established, devices on this port
are considered to be down, and a $DEVICE_DOWN alarm is
generated for each device.
Once a device is down, periodic attempts are made to resume
communications to the device.
Enable Set this check box to enable communications on this port. The
port.
Clear this check box to disable communications on this port.
Note
If you dynamically disable a port, polling stops. However,
setpoints and unsolicited data will still be processed.
Port-Specific Properties
The port-specific properties depend on the type of port you are configuring. See the
CIMPLICITY MMI and MES/SCADA Products Device Communications Manual
(GFK-1181) for detailed information.
GFK-1180H 15-1
If you have not selected the Display search criteria at startup option, the
Configuration - Alarm Class window opens with a list of all configured alarm
classes.
The Configuration - Alarm Class window always displays the following attribute for
each Alarm Class:
Class ID The identifier for the class
In addition to Class ID, you can choose to display:
Class Description Order Alarm State BG
Alarm State FG Normal State BG Normal State FG
Ack State BG Ack State FG
The list of classes is initially sorted by Class ID. You may click any of the other
title buttons at the top of the list to sort the list by that attribute.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new alarm class.
Change the window display attributes.
Change startup options.
Modify an alarm class.
Copy the information for a selected alarm class to a new alarm class.
Delete an alarm class.
Display a filtered list of alarm classes
Note that the colors are displayed by number rather than name in this window.
Select OK to close the Alarm Class dialog box and create the new Alarm Class.
Select Cancel to close the Alarm Class dialog box without creating a new Alarm
Class.
Enter the following information to create a new Alarm Class:
Class ID
Enter the name of the new Alarm Class. The class name can be up to five (5)
characters in length. Each class name must be unique.
Note that you cannot use the $ or | characters in a Class ID.
Description
Enter a description of the Alarm Class. The description can be up to 64 characters in
length.
Order
Enter the Alarm Class order (priority). This must be a number between 0 and 99.
The lower the number you enter, the higher the priority of the class.
Alarm State
You can select the foreground (text) and background colors for displaying alarms in
this class in Alarm Viewer that are in the Alarm state.
Default colors are White for the text and Black for the background.
Acknowledged State
You can select the foreground (text) and background colors for displaying alarms in
this class in Alarm Viewer that are in the Acknowledged state.
Default colors are White for the text and Black for the background
Audio Support
You can configure an alarm class to use audio alarming whenever an alarm in that
class is generated.
For details on configuring and using this feature, see Using Alarm Audio Support.
GFK-1180H 16-1
For example, the following alarm message has been configured for an analog point:
Temp Alarm - Temp: %STATE
Each set of alarm strings is identified by an index number that is specified when the
set is defined. Up to 99 sets, numbered 1 through 99, can be configured. When a
point is configured, an appropriate set of alarm strings may be selected for inclusion
in the alarm message.
The default configuration includes a set of alarm strings for Index number 1. This is
the default Alarm String Index that is used when you add a device point. This string
may be modified but should never be deleted.
Alarm High
Enter the alarm string to be displayed when a point using this Alarm String is in the
Alarm High state. The string can contain up to 16 characters.
Warning High
Enter the alarm string to be displayed when a point using this Alarm String is in the
Warning High state. The string can contain up to 16 characters.
Warning Low
Enter the alarm string to be displayed when a point using this Alarm String is in the
Warning Low state. The string can contain up to 16 characters.
Alarm Low
Enter the alarm string to be displayed when a point using this Alarm String is in the
Alarm Low state. The string can contain up to 16 characters.
About Alarms
CIMPLICITY HMI software generates alarms for points that are in an alarm state. It
also generates alarm messages about system events, such as device failures, program
terminations, system startups, and system shutdowns.
To configure or modify alarms for Use Configure Alarm Definitions to configure alarm definitions for alarms generated
points, use the Configure Points
by custom software or to modify alarms for CIMPLICITY HMI system events or
function.
product options.
GFK-1180H 17-1
Standard Alarms
A set of standard event alarms is included in your base configuration. These alarms
are not associated with any CIMPLICITY Point IDs. They may be modified, but
they should never be deleted. They are:
$ALARM_DISABLED
Alarm is disabled for the specified point.
$ALARM_ENABLED
Alarm is enabled for the specified point
$ALARM_MODIFIED
Alarm is modified for the specified point.
$ALARM_RAWLIM
Alarm raw limits modified for the specified point.
$ALARM_RESTORED
Alarm limits restored for the specified point.
$AM_STATUS
Alarm Management status message used to analyze system performance. This
message is issued every half-hour and shows the number of alarms generated, the
count of alarms acknowledged, reset and deleted, and the average number of
seconds required to log an alarm.
$DEVICE
Alarm message for specified device.
$DEVICE_DOWN
Device failure message for specified device.
$DEVICE_FAILOVER
Reserved for future use.
$DL_FILE_FULL
Log file full message for specified log file.
$DOWNLOAD
Setpoint was downloaded to specified device.
$DYN_CFG
The specified entity has been changed dynamically
$GMR_DEV_DOWN
Device down message for Series 90 TCP/IP PLC redundancy.
$GMR_POINT_DISCREPANCY
Point discrepancy alarm for Series 90 TCP/IP PLC redundancy.
The Store alarm comments option lets you enable or disable the saving of alarm
comments beyond the actual life of the alarm. If you want to save alarm comments
beyond the actual life of alarms, select the Store alarm comments check box. If
you do not want to save alarm comments, clear the check box.
Click OK to close the dialog box and save your changes, or click Cancel to close
the dialog box without implementing any changes.
The Configuration - Alarm Definitions window always displays the following for
each alarm:
Alarm ID The unique Alarm identifier for each alarm in your
configuration.
In addition to Alarm ID, you can choose to display:
Class ID The Alarm Class in which this alarm will be grouped.
Alarm Type The type of alarm format used for this alarm. This field is
display only. An Alarm Type will be assigned by
CIMPLICITY HMI software to an alarm if it contains variable
run-time parameters (see page 17-1).
Description A description of the alarm.
Message Fixed text and run-time parameters that are displayed when the
alarm is generated.
You can control the amount of data presented, and the order in which it is presented.
Select Attributes... from the View menu, or click Attributes on the Toolbar to
open the Configure Display Attributes dialog box and make your changes.
Enter the name of the new alarm in the Alarm ID field and click OK. The system
verifies that the Alarm ID does not already exist, and that no invalid characters have
been used.
If the Alarm ID you entered is valid, the Alarm Definition dialog box for the new
alarm opens. You will need to enter information on the following property pages:
Alarm Definition Defines what the alarm will look like.
Alarm Routing Defines what Roles will see the alarm.
Alarm Options Defines the Repeat, Acknowledge, Reset, and Delete attributes
for the alarm.
The Alarm Definition properties for a non-point alarm let you define the following
for an alarm:
Description
Enter an optional description of the alarm.
Alarm Class
Enter a valid Alarm Class ID in this field. Alarms with similar characteristics can be
grouped by class and classes can be prioritized. When a user sorts alarms by Class in
the Alarm Viewer, the alarms class determines the order in which this alarm appears
relative to other alarms.
You can click the Browser button - - to the right of the input field to
use the Select an Alarm Class Browser to select the Class ID.
You can click the Pop-up menu button - - to browse for an Alarm
Class, edit an existing Alarm Class or create a new Alarm Class for the
alarm.
Alarm Type
Select a valid alarm type from the drop-down list. The alarm type you select
determines the alarm message format.
For detailed information on Alarm Types, see the CIMPLICITY HMI Integrators
Toolkit Operation Manual (GFK-1461).
Alarm Message
Enter the text of the alarm message in this field. An alarm message consists of any
combination of fixed text, and variable run-time parameters (see page 17-1). The
total display length for all fixed text and variable parameters is 80 characters.
Logging
If Database Logging is installed on your computer, you can select the Log Alarm
check box to enable logging for this alarm. If you enable logging, you can then click
Settings... to define the logging parameters for the alarm. Clear the Log Alarm
check box to disable logging for this alarm.
The Alarm Definition properties for point alarms let you define the following for an
alarm:
Definition
This input box lets you define the alarm class and message that will be used when
this points value goes into an alarm state.
Alarm Class An alarms class determines the order in which it appears
relative to other alarms in Alarm Viewer. You can group
alarms with similar characteristics by class. You can also
prioritize classes so that all the alarms in the highest priority
class appear first in a users Alarm Viewer.
Enter an Alarm Class in this field. You can also:
Adding A Role
To add a role to the Configured Roles for Alarms list:
1. Select the role in the Available Roles box.
2. Click Add.
Removing A Role
To remove a role from the Configured Roles for Alarms list:
1. Select the role in the Configured Roles for Alarms list.
2. Click Remove.
Modifying A Role
To view (and possibly modify) the properties for a particular role:
1. Select the role.
2. Click Properties. The Role Properties dialog box for the selected
role opens.
The Alarm Options properties let you define the Repeat, Acknowledge, Delete, and
Reset requirements for the alarm.
Use Repeat Timeout to control how often the alarm will be re-sent to
alarm printers.
Use Acknowledge Timeout to control whether or not the alarm will
be automatically acknowledged.
Use Deletion Requirements to determine when the alarm is deleted.
Use Reset Timeout to control whether or not the alarm will be
automatically reset.
Use Max Number Stacked to define the number of occurrences to
retain when this alarm is generated more than once before being
deleted. After the Max Number Stacked is reached, the oldest alarm
occurrence is deleted as each new occurrence is generated.
Select the Manual Reset Allowed check box if you want to let users
manually reset the alarm. The alarm can also be reset by the
application that detected the alarm condition and by the Alarm Manager
when an Automatic Reset is defined.
If you clear the Manual Reset Allowed check box, the alarm can
only be reset by the application detecting the alarm condition or by the
Alarm Manager when an Automatic Reset is defined.
Deletion Requirements
The Deletion Requirements determine the conditions under which the alarm may be
deleted from the system. You can choose one or both of the following:
Acknowledge Select this check box to delete the alarm when it is
acknowledged.
Reset Select this check box to delete the alarm when it is reset.
If you select both check boxes, the alarm will not be deleted until it has been
acknowledged and reset.
Immediate Select this radio button if you want the Alarm Manager to
automatically acknowledge the alarm when it is generated.
Never Select this radio button if the alarm is never to be
automatically acknowledged.
Reset Timeout
Use these fields to control how the alarm will be reset.
Time Select this radio button and enter the number of minutes in the
Minutes input field for the Alarm Manager to wait before
automatically resetting the alarm.
The alarm may also be reset by the application detecting the
alarm condition or manually by a user (if manual reset is
allowed) before the time interval expires.
Note
The actual number of minutes that the Alarm Manager will wait before automatically
resetting the alarm may be greater than this number. The maximum time will be the
number you enter in this field plus the number of minutes configured for the timer for
processing automatic alarms in the Alarm Manager configuration file
(alarm_mgr.dat). The default for this timer is 5 minutes.
Immediate Select this radio button if you want the Alarm Manager to
automatically reset the alarm when it is generated.
Never Select this radio button if the alarm is never to be
automatically reset.
GFK-1180H 18-1
If more than one project has the highest priority, then the order in which
the projects are displayed in the Alarm Sound Manager window
determines the project priority.
When you prioritize alarms by Project priority, the determination of the highest
priority alarm is:
The sound for the alarm with highest priority Alarm Class in the highest
priority project is played first.
If more than one project has the highest priority, then the order in which
the projects are displayed in the Alarm Sound Manager window
determines the project priority.
Examples
Suppose you have three projects, each with two Alarm Classes as follows:
Project Priority Alarm Class Priority Alarm Class Priority
PROJ1 3 ALM1A 1 ALM1B 2
PROJ2 2 ALM2A 1 ALM2B 2
PROJ3 1 ALM3A 1 ALM3B 2
In addition, you currently have one alarm generated for each class in each project.
If you prioritize audio alarms by Alarm Class, the alarm order is:
ALM3A, ALM2A, ALM1A, ALM3B, ALM2B, ALM1B
If you prioritize audio alarms by Project priority, the alarm order is:
ALM3A, ALM3B, ALM2A, ALM2B, ALM1A, ALM1B
Set the Audio support check box if you want audio support for the alarm class.
You can configure two types of sounds:
Wave file
Beep
You can now do one of the following:
Select OK to save all changes made and close the Alarm Class
Configuration dialog box.
Select Apply to save all changes made and leave the dialog box open.
Select Cancel to close the Alarm Class dialog box without saving
changes.
Beep Configuration
To configure a beep for audio alarming:
1. Click the Beep radio button if you want to use a beep sound.
On computers with sound cards, this is the default sound event.
On computers without sound card, this is the default system beep.
2. Specify the following information for the beep sound:
For Windows NT, or if you are generating the beep through the sound
card on Windows 98/95:
Enter the Frequency of the sound. Select a value between 37 and
32767 Hertz.
Remember, 1000 milliseconds equals 1 Enter the Duration of the sound in milliseconds. Select a value
second.
between 1 and 10000 milliseconds.
For both Windows NT and Windows 98/95.
Enter the Number of beeps to play when the alarm is generated.
Select a value between 1 and 10.
If you enter a value greater than 1, the Delay field is enabled.
Use the Delay field to enter the delay between the beeps in
milliseconds. Select a value between 0 and 10000 milliseconds.
You can click on the icon to open the Alarm Sound Manager window.
They include:
The current alarm being played
The Mute check box
The Load profile... and Save profile buttons
The Minimize, Exit, and Help buttons
You can use the Projects, Options, and Startup pages to select the projects whose
alarms you want to display, the priority of concurrent alarms, start the Alarm Sound
Manager at startup and select a default profile file.
While you are displaying this property page, you still have access to the alarm
information at the bottom of the window.
Adding a project
To add a project, click on the Add button. The Add Project dialog box opens.
Use the drop-down list button to the right of the Project field to select a project to
add.
Select the project priority by specifying a number greater or equal to zero (0). The
higher the number, the lower the priority (which means that zero (0) is the highest
priority).
The project is placed in the list of projects according to its priority. If more than one
project has the same priority, then they are displayed in the order that they were
added to the list.
Deleting a project
To delete a project, select it and click on the Delete button.
Startup Properties
The Startup page lets you configure the Alarm Sound Manager to start up at boot
time, and specify a default profile to use whenever the Alarm Sound Manager starts.
While you are displaying this property page, you still have access to the alarm
information at the bottom of the window.
To start the Alarm Sound Manager at boot, set the Start at Windows startup
check box.
To specify a profile file to be used by the Alarm Sound Manager when it starts, enter
the name of the file in the Use profile field. You can use the browser button to the
right of the input field to search for a profile file.
GFK-1180H 19-1
Assigning Alarms
CIMPLICITY HMI software generates two types of alarms; point alarms and system
alarms. Each point alarm is uniquely identified by its Alarm ID. Each system alarm
is uniquely identified by its Alarm ID and Resource ID.
For example:
For point XYZ, the unique Alarm ID is XYZ.
Each unique instance of the $DEVICE_DOWN system alarm is
identified by the Alarm ID and the Resource ID of the affected device.
For Alarm Blocking, you can assign a uniquely identified alarm to only one group.
This means:
You can assign a point alarm to only one blocking group.
You can assign a uniquely identified system alarm to only one blocking
group.
This means that you can have more than one instance of a system alarm
in a blocking group or you may have system alarms in more than one
blocking group, provided that the Resource ID you assign to each
instance is unique across all Alarm Blocking groups.
The Alarm Blocking Group - Configuration window always displays the following
attribute for each Alarm Class:
Group ID The identifier for the class
In addition to Group ID, you can choose to display:
Group Description Optional description of the group
Peer block Identifies whether Peer Blocking is enabled or
disabled.
The list of groups is initially sorted by Group ID. You may click any of the other
title buttons at the top of the list to sort the list by that attribute.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new Alarm block group.
Add alarms to the groups.
Remove alarms from the groups.
Modify alarm information in the groups.
Change the window display attributes.
Change startup options.
Delete an alarm block group.
Display a filtered list of alarm block groups.
You can resize the width of the Alarm ID, Priority and Resource ID fields to suit
your needs.
Enter the following information to create a new Alarm block group:
Group ID Enter a new, unique Alarm group name. The group
name can be up to 32 characters long.
Description Enter a description of the Alarm group. The
description can be up to 64 characters long.
Peer block Set this check box to enforce Peer Blocking Mode for
this group. Clear this check box if you want to use
Non-Peer Blocking Mode.
The Blocking Mode and alarm priorities determine the
alarm blocking hierarchy at run-time
Adding an Alarm
You can enter the name of an Alarm ID in the Alarm ID field in any of the following
ways:
You can select Add to open the Browser dialog box and browse for the
Alarm ID you want.
You can click the Browser button to the right of the input field to open
the Browser dialog box and browse for the Alarm ID you want.
You can click the Pop-up menu button to the right of the input field to
create a new Alarm ID, modify the current Alarm ID or browse for an
Alarm ID.
Enter the priority of the Alarm ID in the Priority field. This can be a number from 0
to 32767. The higher the number you enter, the higher the blocking priority for the
alarm. For example, if you have alarm XXX with priority set to 10 and alarm YYY
with priority set to 100 in the same group, when alarm YYY generates, it blocks
alarm XXX.
If the Alarm ID does not have a Point ID, you must assign a Resource ID to the
alarm. You can click the Browser button to the right of the input field to open the
Browser dialog box and browse for the Resource ID you want. You can also use the
Pop-up menu button to create a new Resource ID, modify the current Resource ID or
browse for a Resource ID. Remember that each Alarm ID/Resource ID combination
must be unique within a group and across all groups.
Removing an Alarm
To remove an alarm from an Alarm block group:
1. Select the alarm from the list.
2. Press Delete.
The list of alarms in the window updates immediately.
3. Enter the new priority and/or Resource ID for the alarms and select
OK. All the selected alarms will be assigned the new priority. Non-
point alarms will be assigned the new Resource ID.
GFK-1180H 20-1
The Alarm Log Printer - Configuration window always displays the following for
each printer:
Name The name of the alarm printer.
In addition to Name, you can choose to display:
Node ID The node to which the alarm printer is connected.
Destination The actual device or file name of the printer (like LPT1: or
amlp.fil).
Enter the name of the new alarm printer, or the name of the file you want to write
alarms to in the Name field and select OK. You may enter a maximum of 16
characters. The system verifies that the alarm printer name does not already exist,
and that no invalid characters have been used.
If the alarm printer name you entered is valid, the Alarm Printer properties dialog
box for the new alarm printer opens.
General Properties
The AMLP Configuration property page let you define the following for a new alarm
printer:
Log Events
Select this check box if you want to log events to the printer.
Log Alarms
Select this check box if you want to log alarms to the printer.
If you clear this check box, the Alarm logging options are grayed out.
Click the Browser button - - to the right of the input field to display
the Select Alarm Class browser and use it to select the Alarm Class.
Click the Pop-up Menu button - - to create a new Alarm Class, edit
the current Alarm Class, or browse for an Alarm Class.
Enter a file name to write alarms to a file. If you wish, you may also
enter a period followed by a three character file extension (for example,
alarms.fil).
If you do not enter a file extension, none is automatically provided.
The file is placed in the projects \log directory.
Enter the path for a network printer (for example,
\\M_005ad4\d5prn1).
Note
If the printer is connected locally on your computer, use the local port name instead
of the network path.
Enter the path for a file on a network disk (for example,
\\nt001\proj1\alarms).
You can associate more than one alarm printer with a network printer or file on a
network disk. If you use a network printer or file, you should clear the Print
header field in the Layout property page.
The Layout property page lets you determine whether a header should be printed at
the top of a page. Enter information in the following fields:
Print Headers
Set this check box if you want to print a header at the top of each page.
If you have more than one alarm printer process sending messages to the same printer
or file, clear this check box. When you clear the check box, the Page length field
is disabled.
Page Width
Enter the number of characters that can be printed on a line. The number must be an
integer between 80 and 132.
Date/Time Format
Use the Date/Time Format properties to choose how the alarm printer will print the
date and time.
You can define the following:
Header Date
Select the format you want to use to print the date on the alarm printer page header.
This field is not available if you are not printing a page header. A sample for the
format you choose displays in the Sample field in this box. You may select one of
the formats from the list, or construct your own format.
If you enter LPT1 in the Output field and select the Redundant
alarm printing check box, the Master project on COMP1 sends alarm
messages to LPT1 on COMP1 and the Slave project on COMP2 sends
alarm messages that it generates while in standby mode to LPT1 on
COMP2.
When the project on COMP2 becomes the Master project, it continues
to send alarm printer messages to LPT1 on COMP2.
If you enter LPT1 in the Output field and clear the Redundant
alarm printing check box, the Master project on COMP1 sends
alarms to LPT1 on COMP1. The Slave project on COMP2 sends no
alarms until it becomes the Master project.
When the project on COMP2 becomes the Master project, it sends
alarm messages to LPT1 on COMP2.
Now, lets look at a redundant configuration with a network line printer
(\\ABC\NET1). The primary computer is COMP1 and the secondary computer is
COMP2.
About Roles
In CIMPLICITY HMI software, a role is the mechanism for granting users access to
privileged functions. Each user is assigned one role. Conversely, one role may be
assigned to several users.
The default configuration includes the following three roles:
SYSMGR
USER
OPER
For each role defined in CIMPLICITY HMI project, you can specify whether users
assigned that role can:
Perform Setpoints from CimView screens that contain Setpoint
actions.
Enable dynamic configuration.
Delete alarms from Alarm Viewer windows.
Access the CPC (CIMPLICITY Process Control) utility.
Modify alarm setups on Alarm Viewer windows.
Generate a Setpoint audit trail.
Use Point by Address points in CimView screens.
Trigger events in the Basic Control Engine user interface.
Stop, pause or resume scripts in the Basic Control Engine user
interface.
GFK-1180H 21-1
Configuring Roles
To configure a role, double-click the Roles icon in your projects Workbench.
If you have selected the Display search criteria at startup option, the Role
Search dialog box opens. Select the filtering criteria you want, and then select OK
to open the Configuration - Role window with the filtered list of roles.
If you have not selected the Display search criteria at startup option, the
Configuration - Role window opens with a list of all configured roles.
The Configuration - Role window always displays the following attribute for each
role:
Role ID A name that uniquely identifies each role.
The list of Roles is sorted by Role ID. You may click on the title button to sort the
list.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new role.
Change the window display attributes.
Change startup options.
Modify a role.
Copy the information for a selected role to a new role.
Delete a role.
Display a filtered list of roles
Enter the name of the new role in the Role ID field and select OK. The system
verifies that the Role ID does not already exist, and that no invalid characters have
been used.
If the Role ID you entered is valid, the Role Properties dialog box for the new role
will be displayed. You will need to enter information in the following categories:
Privileges Defines the privileges for the role.
When you are finished defining the roles properties, select OK to close the dialog
box and create the new role, or select Cancel to close the dialog box without
creating the new role.
Role Properties
The Privileges properties let you define the privileges for a new role. Check the
check box for each privilege you want to assign to a role.
About Users
The Users function lets you configure users for your CIMPLICITY HMI project. A
user is an individual person working with a CIMPLICITY HMI project. Each
CIMPLICITY HMI user has the following attributes:
Security A user may be assigned a Password. If a Password is configured
and enabled, then a user cannot access CIMPLICITY HMI project
functions without entering both the User ID and Password.
Roles and A user is assigned a role. Each role in your CIMPLICITY HMI
Privileges project has certain privileges assigned to it. The privileges define
the functions the user can access. If a user lacks the privilege to
access a secure function, an error message is displayed and access is
denied.
View of A users view determines the resource data to which the user has
Resources access. Alarms for resources outside a users view will not appear
on the users Alarm Viewer window.
The default configuration includes:
ADMINISTRATOR (role: SYSMGR)
The default user does not require a password to access CIMPLICITY HMI project
functions.
Configuring Users
To configure a user, double-click the Users icon in your projects Workbench.
If you have selected the Display search criteria at startup option, the User
Search dialog box opens. Select the filtering criteria you want, and then select OK
to open the Configuration - User window with the filtered list of alarms.
If you have not selected the Display search criteria at startup option, the
Configuration - User window opens with a list of all configured alarms.
GFK-1180H 22-1
The Configuration - User window always displays the following attribute for each
user:
User ID A name that uniquely identifies each user.
In addition to User ID, you can choose to display the following attributes for each
user:
Enabled Indicates if the account is enabled or disabled.
Password If a password is defined, it is displayed in this field.
Role ID The role assigned to the user. This determines the privileges
assigned to the user.
User Name The users name.
The list of Users is initially sorted by User ID. You may click on any of the other
attribute buttons at the top of the list to sort the list by that attribute.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new user.
Change the window display attributes.
Change startup options.
Modify a user.
Copy the information for a selected user to a new user.
Delete a user.
Display a filtered list of users
Enter the name of the new user in the User ID field and select OK. The system
verifies that the User ID does not already exist, and that no invalid characters have
been used.
If the User ID you entered is valid, the User Properties dialog box for the new user
opens. You will need to enter information in the following categories:
General Defines the password and role for the user.
Resources Defines the resources for which the user can view data.
When you are finished defining the users properties, select OK to close the dialog
box and create the new user, or select Cancel to close the dialog box without
creating the new user.
The General properties let you define the following for a new user.
Note
If you change a users configuration dynamically, the user must log out then log back
in for the changes to take effect.
Role
Enter the users role in this field.
You can click the Browser button - - to the right of the input field to display the
Select A Role Browser and use it to select the role.
You can also use the Pop-up Menu button - - to create a new role, edit the current
role, or Browser for another role.
Password Needed
Set this check box to require the user to enter a password at login. Clear this check
box if the user does not need to enter a password.
User Name
Enter the users name or descriptive text about the user.
Enabled
Set this check box to enable the user account.
If you clear this check box, the account is disabled and is not available for user login.
If you disable an account dynamically, currently logged in users will not be logged
out; however, new login attempts will be rejected.
Password Expires
Enter the number of days until the users password expires or enter zero if the
password never expires.
After the elapsed number of days, the user will be required to change the password
prior to logging in.
In s Server Redundancy configuration, Automatic Password Expiration is not
supported.
The Resources properties let you define the resources for which the user can view
alarms. The resources currently assigned to the user are displayed in the
Resources box. You can add or delete resources.
Note
If you change a users resources dynamically, the user must log out then log back in
to access the changed resources.
GFK-1180H 23-1
Alarm Logging
Alarm Logging lets you log alarm information in the Alarm Log table. You can
specify alarms to be logged as they are generated, cleared, acknowledged, and/or
deleted.
The following system alarms are recorded in the Alarm Log table:
Alarm ID Description
$DEVICE Specified device has a problem.
$DEVICE_DOWN Specified device has failed.
$DEVICE_FAILOVER Device failover for Server Redundancy.
$GMR_DEV_DOWN Specified Series 90 TCP/IP redundant
device is down.
$GMR_POINT_DISCREPANCY Specified Series 90 TCP/IP redundant point
has discrepancy.
$REDUND_DEV_DOWN Redundant device down for Server
Redundancy.
AMSI_ALARM Reserved for future use.
DB_CONN_DOWN Connection lost to specified database for
Database Logger.
DB_START_FORWARD Forwarding files found for Database Logger
Store and Forward.
MCP_PROC_DOWN Specified CIMPLICITY process has
terminated unexpectedly.
Data Logging
Data logging lets you log point data in a variety of ways.
You can log points:
At a specified time of day.
Periodically at a specified time interval.
Periodically at a specified time interval while a digital point is HIGH or
LOW.
When the alarm state on the point changes.
Whenever the points value is updated.
Whenever point data is logged, the entry in the log file includes the Point ID, a
timestamp, and other optional attributes that you select.
Application Logging
Certain CIMPLICITY HMI applications, such as the Basic Control Engine, allow
you to log actions. To take advantage this feature, you must configure an
Application Table for the product option.
The application chooses what data to log and when to log it.
Column Definitions
A table can have, at most, 250 columns. The following columns are defined for each
type of log file:
Data logging tables contain a timestamp and Point ID column, plus an
additional column for each table and point attribute you have selected.
The number of columns is independent of the number of points in the
table. For example, if you have a table that logs the point value and
previous value for all points configured for data logging, the table will
have four columns.
Alarm, Event, and Application logging tables have columns that are
specific to that table, plus an additional column for each table attribute
you have selected. All table rows include a timestamp column and an
autoincrement sequence number that ensures that each row is unique.
Group logging tables contain a timestamp column, plus an additional
column for each table and point attribute you have selected. For
example, if you have a table logging the value and alarm state of five
points, the table will have eleven columns.
The number of columns you can actually have in a group table depends on the type
of data you are storing. A record being added to the database can have at most 2 KB
of data. With overhead, 2 KB amounts to approximately 222 8-byte floating-point
numbers. (Points with Engineering Units conversion are stored in floating point
format.)
If you are storing a number of floating-point numbers or long text strings in a group
record, it is recommended that you verify that the 2 KB limit is not being exceeded.
Point Logging
When you select Settings... for Log Data, the Point Logging dialog box opens.
This dialog box lists the tables where the point you selected is currently being
logged. If the list is empty, the point is not being logged in any table.
Use this dialog box to add the point to logging tables, modify logging tables, or
remove the point from one or more logging tables.
The Alarm Logging dialog box shows you the table the point alarm is being currently
logged to along with the states that are being logged.
If the alarm is not currently being logged, the default setting is ALARM_LOG and
the default ALARM_LOG point properties are selected.
If the alarm is currently being logged, the initial settings will indicate which table is
being used, and which states are being logged.
You can log an alarm to the ALARM_LOG table or to the EVENT_LOG table. An
alarm can only be logged to one of these tables, not both. If, for example, an alarm
is currently being logged to the EVENT_LOG table, and you select the
ALARM_LOG table in this dialog box, the alarm is automatically removed from the
EVENT_LOG table when you select OK.
Logging an Alarm
To log an alarm:
1. Select the ALARM_LOG table or the EVENT_LOG table.
2. If you have selected the ALARM_LOG table, select the alarm events to
log. You may choose any combination of events.
3. Select OK to confirm your changes and close the dialog box, or select
Cancel to cancel your proposed changes and close the dialog box.
Use the Table Browser dialog box to select a table to display a filtered list of logging
tables, add a point to one or more tables, create a new logging table, or modify the
properties of an existing table.
You can set the Auto Browse check box to have the current list of tables displayed
automatically when you open the browser.
The CIMPLICITY Database Logger Configuration window displays a list of all the
currently configured group and data tables, as well as the Alarm Log and Event Log
tables. The icon to the left of each table indicates its type as follows:
Alarm Log table or Event Log table
Data Log table
Group Log table
Application table
You can use the Menu functions, Toolbar buttons and shortcut keys to:
Add a new Group or Data table.
Copy the information for a selected table to a new table.
Delete a table.
Modify a tables properties.
Open a table.
Add points to a table.
Modify logging properties.
Display a filtered list of tables.
The Default Logging Conditions property page for the ALARM_LOG table displays
the current default logging criteria for alarms being logged into the table. These
criteria are:
Generate Information about the alarm is logged when the alarm
occurs.
Acknowledge Information about the alarm is logged when the alarm is
acknowledged by the operator or the system.
Reset Information about the alarm is logged when the alarm is
reset by the operator or the system.
Delete Information about the alarm is logged when the alarm is
manually deleted from the system.
The Logging Conditions property page for a group or data table displays the current
logging conditions for the table. You can have logging to the table occur under any
combination of the following:
Data triggered logging
Alarm triggered logging
Timed/gated logging
Select Use Defaults to reset the Logging Conditions to their default values. The
default is to log data periodically every 5 minutes.
The Point and Point Alarm fields have a Browser button and a Pop-up Menu
button.
Use the Browser button - - to open the Select A Point Browser and
search for a Point ID.
Combining Triggers
You can combine triggers. When you combine triggers, logging occurs when either
of the triggers occurs. For example, if you want to log a set of points when
POINT_A is updated or when POINT_B is in Alarm High state:
1. Set the On point value update check box.
2. Enter POINT_A in the Point field.
3. Set the On point alarm state check box.
4. Set the Alarm High check box.
5. Enter POINT_B in the Point field.
Synchronized Set this check box when you want to log data at a
particular time of day.
Enter the time in the input field, and select AM or PM.
On digital point state Set this check box if you want to log data while a digital
point is in a certain state.
Select the state to check for and enter the digital Point ID
in the input field. Valid states are HIGH, LOW, and
TRANSITION
You can combine timed events. For example, if you want to log a set of points every
hour on the half-hour, do the following:
1. Set the Periodic check box, and enter 1 HOUR in the data fields.
2. Set the Synchronized check box and enter 12:30 AM in the data
fields.
If you select a TRANSITION point state, together with a periodic or synchronized
time, the gate will be ignored.
If you select or unselect the project name table attribute you must drop
the table so that it is properly recreated with or without the new project
field as part of the primary key. Failing to do so can cause the
database logger to fail to log data into the table.
The Logging Attributes property page for a group or data table displays the current
point attributes that will be logged to the table. You can define the following
attributes to be logged:
Point attributes
Table Attributes
Select Use Defaults to reset the Logging Attributes to their default values. The
default is to log Point Value and the Project Name.
If you select or unselect the project name table attribute you must drop
the table so that it is properly recreated with or without the new project
field as part of the primary key. Failing to do so can cause the
database logger to fail to log data into the table.
The Maintenance Events property page for a table displays the current maintenance
events for the table. Maintenance actions will occur when any of the events that you
configure on this property sheet occur. You can select:
Triggered maintenance
Timed/gated maintenance
Select Use Defaults to reset the Maintenance Events to their default values. The
default is to perform maintenance actions every day at midnight.
The Point field has a Browser button and a Pop-up Menu button.
Use the Browser button - - to open the Select A Point Browser and
search for a Point ID.
Timed/gated events for both maintenance and logging contain three options that can
be used either separately or combined. The following is a summary of the behavior
for each possible combination.
The Maintenance Actions property page for a table displays the current maintenance
actions for a table. Every maintenance action for a table will be performed whenever
any of its maintenance events occurs. You can select:
Export actions
Purge actions
Command actions
Select Use Defaults to reset the Maintenance Actions to their default values. The
default maintenance action is to purge all records except for those entered in the
table for the last day.
Export Actions
Export actions let you export data from the table to a CSV (Comma Separated
Value) format file when a maintenance event occurs.
To select this option:
1. Set the Export records check box.
2. Select the type of export you want to perform.
You can choose to export one of the following:
All All records in the table are exported.
By Count The last (most current) <n> records in the table are
exported.
By Time Data entered in the table for the last <n> days, hours, or
minutes is exported.
Command Actions
Command actions let you perform more complicated actions when maintenance
events occur. You can select one or both of these actions:
Execute SQL command Lets you execute a SQL command on the table.
Enter the command in the input field.
Run program Lets you run a program. Enter the program
pathname in the input field. You may include
command-line arguments for the program.
Compact database Use this action to compact the Microsoft Access
database where the table resides during a
maintenance event.
Use the Compact database action with great caution. Compacting a Microsoft
Access database requires the database file not be used by any process, otherwise the
action fails and waits to be executed during the next maintenance event. Due to this
restriction, the Database Logger terminates all communication with the Microsoft
Access database while the compact action occurs. This means that the logger queues
may overflow depending on how fast items are being logged and the size of the
logger queue.
The Logging Properties property page for a table displays the current database
connection and the parameters used by Store and Forward for the table.
Connect Information
You can select an ODBC data source for each table that you create in the Database
Logger. To connect to a table, enter the following information:
ODBC data source Select the data source to receive logged data for this table.
This field displays the list of currently configured ODBC
data sources. In general, it will consist of a list of one or
more Microsoft Access or SQL Servers.
The default data sources are:
CIMPLICITY Alarm Logging
A Microsoft Access data source that logs data to the
CIMPLOG.MDB file in the ARC directory of your
CIMPLICITY HMI project.
CIMPLICITY Point Logging
A Microsoft Access data source that logs data to the
POINTLOG.MDB file in the ARC directory of your
CIMPLICITY HMI project.
Use this dialog box to filter the list of logging tables by Table Identifier and/or Table
Type.
To filter the table list:
1. Enter a full or partial Table ID in the Table Identifier input field. You
can use the ? and * wildcards to perform partial string searches.
2. Select the Table Type you want to filter for. Valid selections are
ALARM, ALL, DATA, EXTERNAL, or GROUP.
3. Select OK to filter the list according to the information youve entered,
or select Cancel to cancel the filter function.
To display all the tables, put an asterisk (*) in the Table Identifier field, and select
ALL for the Table Type.
Enter the new table name in the input field. You must enter a new name. The Data
Logger will not let you use a current table name for a new table.
Select OK to create the table, or select Cancel to cancel the copy function.
Renaming A Table
To rename a data or group table, select the table, and then do one of the following:
Select Rename... from the File menu.
Select Rename... from the window pop-up menu.
Press Ctrl+R.
The Rename table dialog box opens
Enter the new table name in the input field. You must enter a new name. The
Database Logger will not let you use a current table name when you rename a table.
Select OK to create the table, or select Cancel to cancel the rename function.
Note
You cannot rename the Alarm (ALARM_LOG), Event (EVENT_LOG) or External
tables.
The dialog box lists all the fields in the table configuration, and any fields in the
table in the database that are not in the configuration. Each field has one of the
following icons:
Note
Smaller groups log faster than larger groups. However, one large group logs faster
than two that are half as big do.
Parameters
The Alarm Logging page shows the ODBC configuration that will be used when
logging data to the ALARM_LOG, EVENT_LOG and Application tables. The Point
Logging page shows the ODBC configuration that will be used when logging data to
Data and Group tables.
You can define the following parameters:
Connect information, including ODBC Data Source, Database User,
Password, and Reconnect Wait Period.
Store and forward information, including Enable Store and Forward
and the maximum number of stored records.
Connect Information
Enter information in the following fields:
ODBC Data Source Select the data source to receive logged data.
This field displays a current list of ODBC data
sources. In general, it consists of a list of one or
more Microsoft Access or SQL Servers. The
default data sources are:
CIMPLICITY Alarm Logging
A Microsoft Access data source that logs
data to the CIMPLOG.MDB file in the ARC
directory of your CIMPLICITY installation.
CIMPLICITY Point Logging
A Microsoft Access data source that logs
data to the POINTLOG.MDB file in the
ARC directory of your CIMPLICITY
installation.
Note
The CIMPLOG.MDB and POINTLOG.MDB
files are compatible with Microsoft Access
version 7.0.
CIMPLICITY SQL Server Logging
A Microsoft SQL Server data source that
logs data to an on-node SQL Server
database. You must install SQL Server
(sold separately) to use this data source.
If you are using an Oracle Database, you may
see the ODBC data source that you created for
Oracle.
If you are using Microsoft Access, you need to
be aware that there are file locking issues for
both logging and reporting if you select the same
Microsoft Access data source for both the Alarm
and Point logging pages. To avoid these
problems, always select separate data sources for
Alarm and Point logging pages.
You can use the Menu functions, Toolbar buttons and shortcut keys to:
Add new points to the table.
Delete points from the table.
Display and modify point or alarm logging properties.
Display and modify table properties.
Display a filtered list of points.
Close the table and return to the main Data Logging window.
The Logging Attributes property page for a point in a group table displays the current
attributes assigned to the point. You can have point logging occur under any
combination of the following:
Point Attributes
Array Attributes (array points only)
Select Use Defaults to reset the Logging Attributes to their default values. The
default is to log point values.
The Logging Conditions property page for a point displays the current logging
conditions for that point. You can have point logging occur under any combination
of the following:
Data triggered logging
Alarm triggered logging
Timed/gated logging
Note
If device point is configured as OnScan, point value is updated on every scan even
though its value remains unchanged.
Combining Triggers
You can combine triggers. When you combine triggers, logging occurs when either
of the triggers occurs. For example, if you want to log a set of points when
POINT_A updates or while POINT_B is in Alarm High state, do the following:
1. Set the On point value update check box.
2. Enter POINT_A in the Point field.
3. Set the On point alarm state check box.
4. Set the Alarm High check box
5. Enter POINT_B in the Point field.
Synchronized Set this check box when you want to log point
data at a particular time of day.
Enter the time in the input field, and select AM
or PM.
On digital point state Set this check box if you want to log data while a
digital point is in a certain state.
Select the state to check for and enter the digital
Point ID in the input field. Valid states are
HIGH, LOW, and TRANSITION
You can combine timed events. For example, if you want to log a set of points every
hour on the half-hour, do the following:
1. Set the Periodic check box, and enter 1 HOUR in the data fields.
2. Set the Synchronized check box and enter 12:30 AM in the data
fields.
The Logging Conditions property sheet for an alarm in the ALARM_LOG table
displays the current default logging criteria for that alarm. These criteria are:
Generate Information about the alarm is logged when the alarm
occurs.
Acknowledge Information about the alarm is logged when the alarm is
acknowledged by the operator or the system.
Reset Information about the alarm is logged when the
alarm is reset by the operator or the system.
Delete Information about the alarm is logged when the
alarm is deleted from the system.
The Filter Points dialog box lets you filter the list of points in a data or group table
by Point ID and/or Point Type.
To filter the point list:
1. Enter a full or partial Point ID in the Point Identifier input field. You
can use the ? and * wildcards to perform partial string searches.
2. Select the Point Type you want to filter for. Valid selections are ALL,
ANALOG, APPL, DIGITAL, or TEXT.
3. Select OK to filter the list according to the information youve entered.
Select Cancel to cancel the filter function.
To display all the points in the table, put an asterisk (*) in the Point Identifier field,
and select ALL for the Point Type.
The Filter Alarms dialog box lets you filter the list of alarms in the alarm or event
table by Alarm ID.
To filter the alarm list:
1. Enter a full or partial Alarm ID in the Alarm Identifier input field. You
can use the ? and * wildcards to perform partial string searches.
2. Select OK to filter the list according to the information youve entered.
Select Cancel to cancel the filter function.
To display all the alarms in the table, put an asterisk (*) in the Alarm Identifier
field.
This worksheet displays the current report parameters and status. From this
worksheet, you can:
Set parameters.
Generate the report.
Clear the error log.
This worksheet displays the current report parameters and status. From this
worksheet, you can:
Set parameters.
Generate the report.
Clear the error log.
This worksheet displays the current report parameters and status. From this
worksheet, you can:
Set parameters.
Generate the report.
Clear the error log.
To create a script:
1. Select Program Editor from your CIMPLICITY HMI menu.
2. Create the script to run the report and print it. You can use the sample
script as a template.
3. Compile the script and create an executable.
GFK-1180H 24-1
ODBC Configuration
By default, the CIMPLICITY HMI Database Logger uses the Microsoft Access
ODBC driver to write to Access format (.MDB) files. This is automatically
configured during CIMPLICITY HMI installation. You do not need to purchase or
configure additional software to use this driver.
For improved performance and network extensibility, you may wish to log to a third-
party database product such as Microsoft SQL Server or Oracle.
ODBC Drivers
ODBC Applications use an ODBC driver to communicate with database
applications. The drivers supported for use with the CIMPLICITY HMI Database
Logger are:
Microsoft Access An entry-level database which requires no additional
software to use.
Microsoft Access is currently supported only for Intel-
based computers using Windows NT or Windows
98/95.
Microsoft SQL Server A high-performance database for larger applications.
You must purchase SQL Server to use this driver. In
addition, you must license your CIMPLICITY HMI
Database Logger option for use with SQL Server.
Microsoft SQL Server is currently supported for Intel-
based and DEC Alpha computers
Oracle A high-performance database for large applications.
You must purchase Oracle and INTERSOLV
DataDirect ODBC Driver for Oracle to use this driver.
Oracle is currently supported for Intel-based
computers running Windows NT or Windows 98/95.
Moving Projects
If you copy a project to another computer, the ODBC configuration associated with
that project will not be automatically copied.
If the project uses the default Microsoft Access data sources, you do
not need to make any changes to your configuration.
If the project uses the SQL Server data source, you must configure a
new database and user account on the new target computer, then re-
open the Database Logger to rewrite the connect string.
If the project uses custom data sources, these must be reconfigured on
the target machine.
Requirements
You must purchase the INTERSOLV DataDirect ODBC driver for Oracle.
Oracle databases can be supported on Intel-compatible computers with Microsoft
Windows NT v4.0 or Microsoft Windows 98/95.
The INTERSOLV ODBC driver and Oracle client software must be installed in the
same computer as the CIMPLICITY HMI software.
For Microsoft Windows NT v4.0, you must have the Allow Service to Interact
with Desktop option turned on for the CIMPLICITY HMI service. If you do not,
logging to the Oracle database will not work. To enable this option:
1. Open the Control Panel.
2. Open Services.
3. Double-click on CIMPLICITY Service from the list of services or
select Startup.... The Service dialog box opens.
4. In the Service dialog box, make sure that the System Account and
Allow Service to Interact with Desktop options are selected.
Table Characteristics
The Database Logger tables have the following characteristics:
Column Definitions
A table can have, at most, 250 columns. The following columns are defined for each
type of log file:
Data logging tables contain a timestamp and Point ID column, plus an
additional column for each table and point attribute you have selected.
The number of columns is independent of the number of points in the
table. For example, if you have a table that logs the point value and
previous value for all points configured for data logging, the table will
have four columns.
Alarm, Event, and Application logging tables have columns that are
specific to that table, plus an additional column for each table attribute
you have selected. All table rows include a timestamp column and an
autoincrement sequence number that ensures that each row is unique.
Group logging tables contain a timestamp column, plus an additional
column for each table and point attribute you have selected. For
example, if you have a table logging the value and alarm state of five
points, the table will have eleven columns.
Key Definitions
The following keys are defined for each type of log file:
Group logging tables have a unique primary key index on the
timestamp column. If you have selected the project name table
attribute, the primary key index also includes the project name column.
Data logging tables have a primary key index on the joined timestamp
and Point ID columns, and a secondary index on the timestamp alone.
If you have selected the project name table attribute, the primary key
index also includes the project name column.
Alarm, Event, and Application logging tables have a primary key index
on the joined timestamp and sequence number columns, and a
secondary index on the timestamp alone. If you have selected the
project name table attribute, the primary key index also includes the
project name column.
Important
Since the Microsoft Access format does not support subsecond
timestamp data, you cannot log points to a Data or Group table at
subsecond rates. Attempting to do so will cause the duplicate-keyed
records to be dropped from the database.
Note that the Alarm Logging and Point Logging databases have
separate records.
DB_ENABLE_TRANSACTIONS
If specified, this global parameter overrides the default database functionality as
requested by ODBC.
The record format is:
DB_ENABLE_TRANSACTIONS|1|<flag>
where <flag> is Y if you want to force logging to use transactions, or N if you want
to force logging to not use them.
If you are using SQL Server and have configured an Insert Trigger on a database
table, you will need to set this value to N.
DB_TIME_FORMAT
CIMPLICITY software uses the default Microsoft Access and SQL Server
timestamp format for your locale when it writes SQL statements.
If you are using Store and Forward and your database does not use the default
timestamp format, you need to define this global parameter. Enter the timestamp
format for your database so that time and date fields will be written correctly in the
Store and Forward files.
The record format is:
DB_TIMESTAMP_FIELD
By default, all database logger tables have a timestamp field, which specifies the date
and time of each logged transaction. This field is unique, as it is part of the tables
primary key. The name of this field defaults to timestamp for all database logger
tables.
timestamp is a lower case string.
Certain database client applications have problems accessing lowercase field names
from an Oracle DBMS. The DB_TIMESTAMP_FIELD global parameter can be used in
a CIMPLICITY HMI project to override the default timestamp field name used by
the database logger. This allows you to specify an uppercase field name for the
timestamp field.
Since DB_TIMESTAMP_FIELD is a global parameter, it only affects the HMI project
where it is configured.
When you use the DB_TIMESTAMP_FIELD global parameter, make sure that you
drop all affected tables before running the HMI project. Otherwise, the database
logger will not be able to recreate them with the new timestamp field name specified
by the DB_TIMESTAMP_FIELD global parameter.
Using DB_TIMESTAMP_FIELD modifies the timestamp field in the following tables
for the project where DB_TIMESTAMP_FIELD is used:
1. Alarm Management tables (ALARM_LOG and EVENT_LOG)
2. Event manager table EM_LOG
3. Point management tables (both data and group log tables)
4. SPC tables
5. HDA tables
6. Tracker tables
The format for the DB_TIMESTAMP is:
DB_TIMESTAMP_FIELD|1|field name
where field name is the name you want to give to the timestamp field
(e.g. DATETIME if you want the field to be uppercase).
GFK-1180H 25-1
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Create a new client.
Change the window display attributes.
Change startup options.
Modify a client.
Copy the information for a selected client to a new client.
Delete a client.
Display a filtered list of clients
Enter the name of the computer for the new client, then select OK. The Client
Properties dialog box opens.
Default User ID
Enter the optional default username for users on the Client computer. Users on the
Client computer will automatically be logged in to the CIMPLICITY HMI project
with this User ID.
You can click the Browser button - - to the right of the input field to open the
Select A User Browser and use it to select the User ID.
You can also use the Window Pop-up menu or the Pop-up menu button - - to
create a new user or browse for an existing user.
Trusted
Set this check box if you want the project to accept the Windows Logon Username
on the Client computer as the CIMPLICITY User ID and automatically log the user
into the project. The project must have a CIMPLICITY User ID configured that
matches the Windows Logon Username.
Clear this check box if you want users on the Client computer to manually log in to
CIMPLICITY HMI project.
GFK-1180H 26-1
Supported Device Protocols
Any device protocol that supports Series 90 PLCs includes Control configuration
options when the software is properly installed. These protocols are:
Series 90 TCP/IP
Series 90 TCP/IP Redundancy
SNP
Device Properties
To import variables as device points into a project, you must create an association
between the projects devices and Control folders. A device can have associations
with multiple folders. However, a folder can only be associated with one of the
projects devices because a folder is seen by the project as being a device itself.
When you create a new device that is supported by CIMPLICITY Control, a property
page called Control is displayed in the device properties. Use this property page to
configure and control imports from CIMPLICITY Control for that device.
Actions
Select Import now to perform an exchange of data. The import is performed
regardless of whether it is needed. See Import Rules for a detailed explanation of
how imports are performed.
Select Associate with folders... to associate CIMPLICITY Control folders with
CIMPLICITY HMI devices. When you select this option the CIMPLICITY
Association Server dialog box opens.
This dialog box shows you the current associations and lets you:
Create new associations
Edit existing associations
Delete associations
Enter the CIMPLICITY HMI project path name in the PROJECT PATH field.
Enter the CIMPLICITY Control folder path name in the FOLDER PATH field.
Enter the CIMPLICITY HMI device name in the DEVICE NAME field.
Remember that a device can have associations with multiple folders, but a folder can
only be associated with one of the projects devices.
Editing an Association
To edit an association:
1. Select the association in the CIMPLICITY Association Server dialog
box.
2. Select EDIT.
The Edit Association dialog box opens
Use this dialog box to change the project path, folder path, or device name.
Deleting an Association
To edit an association:
1. Select the association in the CIMPLICITY Association Server dialog
box.
2. Select DELETE.
The Delete Association dialog box opens, prompting you to confirm your request.
Select Yes to delete the association, or select No to cancel the delete request.
Import Rules
CIMPLICITY HMI always assumes that the information in a Control folder is the
most up to date. During a configuration update, all devices with Control
configuration that have the On Configuration Update option selected are verified to
see if they need an import. An import is needed for those folders that have changed
since their last import.
There are three categories used to classify points during import:
New A point is considered new if it does not exist in the project.
Modifiable A point is considered modifiable if it exists in the project and it
belongs to the device associated with the folder being imported.
Removable A point is considered removable if it exists in the project and it
belongs to the device associated with the folder being imported but
was not imported during the current import session.
The import process retrieves exportable information from each association and uses
the following algorithm to import the points:
1. If a point is new and the configuration of the device associated with the
folder being imported has the new option selected, it is added into the
project.
Further imports will then consider this point modifiable unless its
device is changed through point configuration.
2. If a point is modifiable and the device configuration has the modify
option selected, the point is modified using the imported information.
If the device configuration has the use common properties on modify
option selected, common properties are also modified. Any other point
property is left intact (for example, alarm, display, engineering units,
etc.)
3. If a point is removable and the device configuration has the delete
option selected, it is deleted from the project.
To solve the conflict, you can take one of the following actions:
Dont import the point
Rename it using a Point ID considered new or modifiable.
The action always defaults to Do not import.
Previously imported points with new point conflicts will always have new point
conflicts unless the point is renamed using the CIMPLICITY Control Workbench.
To solve the conflict, you can take one of the following actions:
Dont import the point.
Correct the points information.
If you rename the point you must use a Point ID considered new or modifiable. The
dialog box ensures that you do so.
The conflict action normally defaults to Do not import. However, for previously
imported points with incorrect information, their last imported information is placed
in the conflict correction dialog and the conflict action defaults to Correct.
Example
For example, given the following two computers:
ComputerA HMI and Control installed
Drive E: mapped to \\ComputerB\C$
Contains C:\project\project.gef
Configured associations:
C:\project\project.gef with
E:\folder\folder.ef7
the import will be performed but it will end up assuming that the folder is a different
folder.
Introduction
You can use the Import/Export Utility to:
Write existing CIMPLICITY HMI point data in to a file.
Create and modify CIMPLICITY HMI point data using third party
software.
Import point data into CIMPLICITY HMI software to update the
database.
Update the configuration of multiple points at a time.
Delete CIMPLICITY HMI point data from CIMPLICITY HMI
software.
You can use the same point information to configure more than one system. For
example, you can use a spreadsheet to create and modify point data, then import the
data into both the CIMPLICITY HMI database and Logicmaster 90 software.
The following is a quick overview of how Import/Export passes data between the
CIMPLICITY HMI point database and third party applications.
Point/Alarm
Third Party Import/Export Configuration
Applications
Files
Import/Export
Configuration
Files
CSV Files in
Log File
SNF format
GFK-1180H 27-1
Import/Export Data File Format
The file and record formats used by the Import/Export Utility give you the ability to
transfer configuration data between the CIMPLICITY HMI point database and third-
party software.
Import/Export reads and writes text files that use the CSV (Comma Separated Value)
format. Each record in a CSV file begins on a new line and continues until the next
newline character is encountered. Each field in a record is separated by a comma.
You can process CIMPLICITY HMI point configuration data in any third-party
application that can read or write files in CSV format.
The CSV files used by Import/Export consist of a number of records. These records
use the SNF (Shared Name File) format. In an SNF file, the first record, called the
Field Names record, lists of the names of all the variables contained in each
subsequent record.
In addition, the SNF format used by Import/Export has the following conventions:
For import, if a field is empty, and the point already exists, the current
value of the field is preserved.
For import, if a field is empty, the point is a new point and a default is
defined in ie_deflds.cfg, the default is entered in the field in the
database.
Comment lines are indicated by two pound signs at the beginning of the
line.
The field names must be from the list of supported fields and are
case-insensitive. Any invalid fields will be identified as an error and
ignored.
You must enclose between double quotes any fields that contain a
comma as part of the data. For example:
...,"Comma, example",...
You must enter two double quotes if you want a double quote to be part
of a data string. For example
...,"Quotes ""example"" ",...
You do not need to enter two double quotes if you want a double quote
to be a part of a data string. For example:
The ie_deflds.cfg file defines default values for selected fields based on point
of origin and point type. You may configure default information for analog, digital
and text point types for both device and virtual (derived) points.
Important
Do not change information in the PT_ID, PT_ORIGIN, or PT_TYPE fields
of records in this file.
When you import data into the CIMPLICITY HMI point configuration, any fields in
an import record that do not contain data, and that correspond to default fields in
ie_deflds.cfg, will have their values set to the default values contained in
ie_deflds.cfg. For example, if a new digital device point is being imported,
and the ACCESS field in the import file is left blank, the import function will
substitute the default ACCESS value used for IE_DEV_DIGITAL.
The default file contains two formats: Full Set and Logicmaster Export.
The Full Set format contains all fields supported by Import/Export.
The Logicmaster Export format contains the four fields of interest to the
Logicmaster 90 (LM90).
The internal format contains all the Select one of the formats in this file when you export data. If you do not select a
fields in the Full Set plus additional
format, an internal format is used.
unsupported fields.
Import Procedure
To import data, do the following:
1. Log in and start up a command shell in the project where you want to
import data.
2. At the system prompt, invoke the following command:
$ clie import <file> [-D <device_id>] [-R <resource_id>]
[-Pa <prefix>] [-y]
where:
<file> is a required argument, and is the full path of import file to be read. The
file may be in any directory, but the projects data subdirectory is recommended.
You should always use the .csv extension with this filename.
Export Procedure
To export configuration data, do the following:
1. Log in and start a command shell in the project from which you want to
export data.
2. At the system prompt, invoke the following command:
$ clie export <file> [-Pr] [-Ef <format>]
[-Sp<point_id>] [-Sd <device_id>] [-So <origin_id>]
[-St <type>] [-Sr <resource_id>]
where:
<file> is a required argument, and is the full path of export file to be written. The
file may be in any directory, but the projects data subdirectory is recommended.
You should always use the .csv extension with this filename.
Option names are case sensitive and The optional arguments for the export command are:
must be entered as defined.
Argument Description
-Pr Remove all prefixes from Point IDs (up to and including
the underscore), before exporting.
-Ef <format> The type of file format to use.
Specify one of the formats, found in the projects
ie_formats.cfg format configuration file.
Default formats in the file are:
Full Set - all supported fields will be exported
Logicmaster Export - only 4 fields will be
exported.
If no format name is specified, the internal format is used.
This format includes all of the fields in the Full Set,
plus additional unsupported fields.
-Sp <point_id> A full or partial Point ID.
Export data for Point IDs that match the string you
specify.
>
Required Fields
The PT_ID field is required in every file. This should preferably be the first field in
the record.
Here is some more detailed information about the field:
Maximum Field Length 32 characters
CIMPLICITY Field Name Point ID
Description Unique name for a point
Optional Fields
Any of the fields listed below may be specified in a data file for Import/Export.
None are absolutely required, but, when specifying new points to be imported into
the CIMPLICITY database, certain fields may be required.
Points are device points, derived points, or global points.
A device point gets its data directly from a device or PLC.
A derived point gets its data from an equation, and cannot be set with a
setpoint.
A global point can be updated either by an application or through
standard setpoint functions. An equation cannot be specified when the
point is defined.
Some of the optional fields are specific to points of a particular origin. The Point
Origin column identifies the type of point defined by the record. The point types
are:
All
Device
Global (virtual)
Derived (virtual)
All field names and enumerated data are case-insensitive.
ACCESS_FILTER
Point Type All
Maximum Field Length Byte
CIMPLICITY Field Name Enterprise Point
Description Indicates whether the Enterprise Server has
access to the point. Valid values are:
E = Enterprise Server can access
B or blank = Enterprise Server cannot access
ACK_TIMEOUT
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Acknowledge Timeout
Description Time in minutes before the points alarm is
automatically acknowledged. Valid values are:
-1 = No auto acknowledge
0 = Acknowledge immediately
>0 = Minutes to wait for automatic acknowledge
ADDR
Point Type Device
Maximum Field Length 32 characters
CIMPLICITY Field Name Memory Type or Address
Description Actual address of the point within the device.
For devices with memory types, this field
contains the memory type. Otherwise, the actual
point address is used.
ADDR_TYPE
Point Type Device
Maximum Field Length 2 characters
CIMPLICITY Field Name Address Type
Description For MMS Ethernet devices only. The type of
address. Valid values are:
VN = Variable Name
FQ = Fully qualified
LG = Logical
UC = Unconstrained
AI = Array Index
SI = String Index
ALM_CLASS
Point Type All
Maximum Field Length 5 characters
CIMPLICITY Field Name Alarm Class
Description The Alarm Class ID to be used for the points
alarms. The Alarm Class ID must already be
defined in the CIMPLICITY database.
ALM_CRITERIA
Point Type All
Maximum Field Length 3 characters
CIMPLICITY Field Name Alarm Criteria
Description Method to be used for evaluating alarm
conditions. Valid options are:
ABS = Absolute
DEV = Deviation
ROC = Rate of Change
ONU = On Update
ALM_DELAY
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Delay Alarms
Description Determine if the generation of alarms by the
point should be delayed. Valid values are:
0 = Alarms are not delayed
1 = Alarms are delayed by the length of time
specified by SAMPLE_INTV and
SAMPLE_INTV_UNIT.
ALM_HIGH_1
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Warning High
Description High warning limit
ALM_HIGH_2
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Alarm High
Description High alarm limit
ALM_HLP_FILE
Point Type All
Maximum Field Length 10 characters
CIMPLICITY Field Name Help File
Description Name of the help text file. ".HLP" will be added
to the name. Help files are located in
%SITE_ROOT%\am_help
ALM_LOW_2
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Alarm Low
Description Low alarm limit
ALM_MSG
Point Type All
Maximum Field Length 54 characters
CIMPLICITY Field Name Alarm message
Description Text displayed when the alarm is set. See Alarm
Message Variables for the list of variable
information that can be used in the text.
ALM_ROUTE_OPER
Point Type All
Maximum Field Length Boolean
CIMPLICITY Field Name Alarm Routing: OPER
Description Determines if alarm information is sent to users
with OPER role. Valid values are:
0 = Do not sent alarm to OPER role
1 = OPER role can display the alarm.
ALM_ROUTE_SYSMGR
Point Type All
Maximum Field Length Boolean
CIMPLICITY Field Name Alarm Routing: SYSMGR
Description Determines if alarm information is sent to users
with SYSMGR role. Valid values are:
0 = Do not sent alarm to SYSMGR role
1 = SYSMGR role can display the alarm.
ALM_STR
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Alarm String Index
Description Alarm string index to be applied for alarms.
Must be a valid index.
ALM_TYPE
Point Type All
Maximum Field Length 2 characters
CIMPLICITY Field Name Alarm Type
Description Determines which log is written to. Valid values
are:
AL = Alarm Log
EV = Event Log
ANALOG_DEADBAND
Point Type Device
Maximum Field Length Integer
CIMPLICITY Field Name Analog Deadband
Description Used to filter changes in raw value of point. The
raw value must change at least this much to
update the value of the point.
BFR_COUNT
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Point Buffering Max Count
Description The maximum number of point values to buffer
for Trending. If left zero, then the number of
values is not used as a limiting factor when
buffering data.
BFR_EVENT_PERIOD
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name
Description Not currently implemented
BFR_EVENT_PT_ID
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name
Description Not currently implemented.
BFR_EVENT_TYPE
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name
Description Not currently implemented.
BFR_EVENT_UNITS
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name
Description Not currently implemented.
BFR_GATE_COND
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name
Description Not currently implemented.
CALC_TYPE
Point Type Derived (virtual)
Maximum Field Length 3 characters
CIMPLICITY Field Name Calc Types
Description Method for determining the derived point value.
Valid values are:
EQU = Equation
DAC = Delta Accumulator
VAC = Value Accumulator
AVG = Average
MAX = Maximum
MIN = Minimum
T_C = Timer/Counter
HST = Histogram
T_H = Transition High Accumulator
EWO = Equation with Override
CONV_LIM_HIGH
Point Type Device
Maximum Field Length Integer
CIMPLICITY Field Name Converted Value (second)
Description Second converted value used for linear
conversion.
CONV_LIM_LOW
Point Type Device
Maximum Field Length Integer
CIMPLICITY Field Name Converted Value (first)
Description First converted value used for linear conversion.
DELETE_REQ
Point Type All
Maximum Field Length 2 characters
CIMPLICITY Field Name Deletion Requirement
Description Determines when alarm occurrence should be
deleted. Valid values are:
A = Acknowledge only
R = Reset only
AR = Acknowledge and Reset
DESC
Point Type All
Maximum Field Length 40 characters
CIMPLICITY Field Name Description
Description Description of point
DEVIATION_PT
Point Type All
Maximum Field Length 32 characters
CIMPLICITY Field Name Deviation Point
Description Point that current point will be compared to when
checking for deviation alarm. Must be a
configured Point ID.
DEVICE_ID
Point Type Device
Maximum Field Length 32 characters
CIMPLICITY Field Name Device ID
Description Device where the point data originates. Must be
a configured Device ID.
DISP_LIM_LOW
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Disp. Limit (low)
Description Smallest value to display in CimView screens.
DISP_WIDTH
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Display Width
Description Number of spaces for display of point value in
CimView.
ELEMENTS
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Elements
Description Number of discrete elements in the points data
array. This is determined by the points
configured data type.
ENG_UNITS
Point Type All
Maximum Field Length 8 characters
CIMPLICITY Field Name Eng. Units
Description Units that the data represents.
FW_CONV_EQ
Point Type Device
Maximum Field Length 72 characters
CIMPLICITY Field Name Eng. Conversion Expression
Description Arithmetic expression used to convert raw data
to engineering units value. See Equation
Operations for the list of valid operators.
GR_SCREEN
Point Type All
Maximum Field Length 16 characters
CIMPLICITY Field Name Graphic Screen
Description CimView screen to display when the Get Screen
Hot Key is pressed for this point on the Point
List or Alarm Page.
INIT_VAL
Point Type Derived (virtual)/Global (virtual)
Maximum Field Length Number
CIMPLICITY Field Name Initial Value
Description Value for point at initialization before any data is
generated by its component point(s). Use if
PT_TYPE is G, or PT_TYPE is D and
CALC_TYPE is ACC, MIN, or MAX.
LOCAL
Point Type Derived (virtual)/Global (virtual)
Maximum Field Length Boolean
CIMPLICITY Field Name Local Value
Description Determines if value is reported to Point Manager.
Valid values are:
0 = Report value
1 = Do not report value
MAX_STACKED
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Max Number Stacked
Description Maximum number of alarm occurrences tracked.
Valid values are:
0 = Alarm is not stacked
1 to 19 = Number of alarms stacked
MEASUREMENT_UNIT_ID
Point Type All
Maximum Field Length 32 characters
CIMPLICITY Field Name Measurement Unit ID
Description The base measurement unit ID configured for the
point.
PRECISION
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Precision
Description Number of decimal places in display.
PROC_ID
Point Type Derived (virtual)/Global (virtual)
Maximum Field Length 14 characters
CIMPLICITY Field Name Virtual Proc ID
Description The Derived Point process that will calculate the
value of this point. Must be a valid PTDP_RP
Process ID.
Format is: <node_id>_PTDP_RP
PTMGMT_PROC_ID
Point Type Derived (virtual)/Global (virtual)
Maximum Field Length 14 characters
CIMPLICITY Field Name Point Manager
Description The Point Management process that will manage
this point. Must be a valid PTM_RP Process ID.
Format is: <node_id>_PTM<n>_RP
PT_ENABLED
Point Type Device
Maximum Field Length Boolean
CIMPLICITY Field Name Enabled
Description Determines if the point is enabled or disabled.
Valid values are:
0 = Disabled
1 = Enabled
PT_SET_INTERVAL
Point Type Device
Maximum Field Length Time.
The format is HH:MM:SS for the interval,
where:
HH=Hour
MM=Minutes
SS=Seconds
CIMPLICITY Field Name Interval
Description The interval at which the Timer/Counter point
will be updated while the Expression value
remains HIGH.
PT_SET_TIME
Point Type Derived (virtual)
Maximum Field Length Time.
The format is HH:MM:SS for the base start time,
where:
HH=Hour
MM=Minutes
SS=Seconds
CIMPLICITY Field Name Set Time
Description Base start time for the Timer/Counter point
interval.
RANGE_HIGH
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Range Limit (hi)
Description The maximum value allowed for this point.
RANGE_LOW
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Range Limit (low)
Description The minimum value allowed for this point.
RAW_LIM_HIGH
Point Type Device
Maximum Field Length Integer
CIMPLICITY Field Name Raw Value (second)
Description Second raw value used for linear conversion.
RAW_LIM_LOW
Point Type Device
Maximum Field Length Integer
CIMPLICITY Field Name Raw Value (first)
Description First raw value used for linear conversion.
RESET_ALLOWED
Point Type All
Maximum Field Length Boolean
CIMPLICITY Field Name Reset Allowed
Description Determines if a user can reset the points alarm.
Valid values are:
0 = User cannot reset the alarm
1 = User can reset the alarm
RESET_COND
Point Type Derived (virtual)/Global (virtual)
Maximum Field Length 2 characters
CIMPLICITY Field Name Reset/Startup Cond
Description Search sequence for source of initial value.
Valid values are:
N = Unavailable
N = Use INIT_VAL
A = Use saved value
I = Saved and init
RESET_PT
Point Type Derived (virtual)
Maximum Field Length 32 characters
CIMPLICITY Field Name Reset Point
Description Point that will cause this derived point to reset.
Must be a configured Point ID.
RESOURCE_ID
Point Type All
Maximum Field Length 16 characters
CIMPLICITY Field Name Resource ID
Description Resource ID for this point. Must be a configured
Resource ID.
REV_CONV_EQ
Point Type Device
Maximum Field Length 72 characters
CIMPLICITY Field Name Reverse Engineering Expression
Description Arithmetic expression used to convert
engineering units value to raw data for setpoints.
See Equation Operations for the list of valid
operators.
ROLLOVER_VAL
Point Type Derived (virtual)
Maximum Field Length Integer
CIMPLICITY Field Name Rollover
Description For Delta Accumulator virtual points, the value
of a point at which it rolls over to a zero value
when incremented by one unit.
SAMPLE_INTV
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Alarm Delay Interval (value)
Description For Rate of Change alarms, the frequency with
which the point will be sampled for Rate of
Change alarming.
For Absolute alarms, the length of delay before
the alarm is reported if Delay Alarms is set to
"Y".
SAMPLE_INTV_UNIT
Point Type All
Maximum Field Length 3 characters
CIMPLICITY Field Name Alarm Delay Interval (units)
Description The type of units for SAMPLE_INTV.
Valid values are:
SEC = Seconds
MIN = Minutes
HR = Hours
SCAN_RATE
Point Type Device
Maximum Field Length Integer
CIMPLICITY Field Name Scan Rate
Description Frequency of point sampling. This is a multiple
of the base scan rate set for the system.
SETPOINT_LOW
Point Type All
Maximum Field Length Integer
CIMPLICITY Field Name Setpoint Limit (low)
Description The minimum value a point is allowed to be set.
TRIG_CK_PT
Point Type All
Maximum Field Length 32 characters
CIMPLICITY Field Name Availability Trigger
Description The point serving as the availability trigger for
this point.
If the Availability Trigger is TRUE (non-zero)
this point value is available.
If the Availability Trigger is FALSE (zero), this
point value is unavailable.
TRIG_PT
Point Type Device/Derived (virtual)
Maximum Field Length 32 characters
CIMPLICITY Field Name Trigger
Description The point serving as the trigger for this point.
Use differs if device or derived point. Must be a
configured Point ID.
For device points the trigger point must be on the
same device as the points it triggers.
For derived points, the trigger point must be
processed by the same Derived Point Process as
the points it triggers.
TRIG_VAL
Point Type Device
Maximum Field Length 16 characters
CIMPLICITY Field Name Value
Description Value the trigger is compared with to determine
if the TRIG_REL condition is met.
UPDATE_CRITERIA
Point Type Device
Maximum Field Length 2 characters
CIMPLICITY Field Name Update Criteria
Description Value determining when point data is passed to
the CIMPLICITY point database after the device
is read. Valid values are:
UN = Unsolicited
OC = On Change
OS = On Scan
DS = On Demand On Scan
DC = On Demand On Change
PO = Poll Once
VARIANCE_VAL
Point Type Derived (virtual)
Maximum Field Length Number
CIMPLICITY Field Name Variance value
Description Accumulator variance value.
Logicmaster 90 Support
Logicmaster fields map to the following field names in the Shared Name File:
Logicmaster Field Name
Field
reference ADDR
nickname PT_ID
description DESC
length ELEMENTS
type PT_TYPE
blockname => add to ADDR string (for example: %Lxxxxx,block).
timer and pid are not supported by CIMPLICITY HMI software at this time.
}
BSO_PB,%I00001,Boiler shutoff pushbutton ,bool
OVRTMP,%Q00001,Boiler overtemp warning ,bool
STEMP,%R00001,Scaled boiler temperature ,real
TEMP1,%A00001,Boiler temp thermocouple #1 ,int Records
TEMP2,%A00002,Boiler temp thermocouple #2 ,int
Configuration Overview
When you configure Alarm Viewer OCX controls in CimEdit you can:
Determine the fields to be displayed.
Configure the button layout and captions.
Create custom buttons and specify their command strings.
Select the projects from which you want users to view alarms.
Determine the initial sort order for the alarm display.
Specify the alarm count layout, date format, fonts, and colors to be
used.
Implement Alarm Viewer methods on the CimEdit screen for the
Alarm Viewer OCX control.
Specify whether the control starts in Static or Dynamic mode.
GFK-1180H 28-1
Run-Time Overview
At run-time, you can open a CimView screen containing an Alarm Viewer OCX
and:
Display the list in Static or Dynamic mode.
Modify the state of existing alarms.
Record comments about alarm conditions.
View the help files for existing alarms.
Filter the alarm list to display only those alarms that have certain
characteristics.
The list of fields depends on whether you are configuring a Static Alarm List or a
Dynamic Alarm List.
Select Static to configure a Static Alarm List. The list of fields
changes to show you the ones available for the Static Alarm List.
Select Dynamic to configure a Dynamic Alarm List. The list of fields
changes to show you the ones available for the Dynamic Alarm List.
If any field titles have been modified, the modified title appears in parentheses to the
right of the field name (for example, "(Ack)" appears to the right of "Ack State").
Select the check box for each field you want to display.
Once you select a field, you can:
Use Row Up and Row Down to configure its row in the alarm
message.
Use Position Left and Position Right to configure its column
position in the row.
Use Modify to configure its length and title in the Alarm Viewer OCX.
Position Left
Select the Alarm List field you want to move, then click Position Left to move it
toward the front of the current message row.
Position Right
Select the Alarm List field you want to move, then click Position Right to move it
toward the end of the current message row.
Row Down
Maximum row number is 10. Select the Alarm List field you want to move, then click Row Down to move it
down a row in the message. The field will be placed at the start of the message row.
Modify
Select the Alarm List field you want to modify, then click Modify. The Field
Properties dialog box opens.
The current field length is displayed in the Length input field. To change the length
of a field:
1. Enter the new field length in the Length input field.
2. Click OK.
Note
Field length is based on the average size of characters in the font you have chosen.
Thus, a length of 6 may be sufficient to display the string "IIIIII", but may be too
short to display "WWWWWW". To ensure that the length is always adequate, select
a fixed pitch font (such as Courier New) for your alarm page display.
The current field title is displayed in the Title input field. To change the title of a
field:
1. Enter the new field title in the Title field.
2. Click OK.
When you change the title of a field, its original title appears next to the check box in
the Fields list, and the modified title appears to the right in parentheses.
The list of buttons depends on whether you are configuring a Static Alarm List or a
Dynamic Alarm List.
Select Static to configure a Static Alarm List. The list of buttons
changes to show you the ones available for the Static Alarm List.
Select Dynamic to configure a Dynamic Alarm List. The list of
buttons changes to show you the ones available for the Dynamic Alarm
List.
Select the check box for each button you want to use.
You may need to use the vertical scroll bar to the right of the list to see all of the
buttons. The following is a complete list:
Button Description
Help Displays the help file for an alarm. See page 28-23 for more
information.
Setup Displays the Alarm Setup dialog. See page 28-23 for more
information.
Refresh Updates the alarm list. See page 28-23 for more information.
View Stack Displays the stacked alarms for the selected alarm. See page
28-24 for more information.
Comments Displays the Alarm Comments dialog. See page 28-24 for
more information.
Toggle Toggles the display between the Static and Dynamic alarm
lists. See page 28-23 for more information.
Ack Acknowledges the currently selected alarms. See page 28-25
for more information.
Position Left
Select the Alarm List button you want to move, then click Position Left to move it
toward the front of the current row.
Position Right
Select the Alarm List button you want to move, then click Position Right to move
it toward the end of the current row.
Row Up
Minimum row number is 1 Select the Alarm List button you want to move, then click Row Up to move it up a
row. The button will be placed at the start of the row.
Row Down
Maximum row number is 10 Select the Alarm List button you want to move, then click Row Down to move it
down a row. The button will be placed at the start of the row.
To modify a button:
1. Enter the new caption in the Button Caption input field. You may
enter up to 100 characters.
2. Enter a description in the Description field.
3. If you have selected a custom button, enter the command string you
want to be executed when the button is selected in the Command
String field (this field is not available for the standard buttons).
4. Click OK.
For standard buttons, the button name in the Buttons field of the Button Layout
window does not change - just the caption that is displayed in the button at run-time.
For custom buttons, the caption displayed in the button at run-time changes, and
when a user clicks the button, the command string you specified will be executed.
You can add projects to the list, remove projects from the list, connect to the local
project and specify the alarm setup for each project in the list.
Adding a Project
To add a project to the list:
1. Click Add Project. The Select Project dialog box open.
2. In the Select Project dialog box opens, select the project you want from
the list of available projects.
3. Click OK. The Select Project dialog box closes and the project is
added to the list in the Projects properties.
Deleting a Project
To delete a project from the list:
1. Select the project from the list.
2. Click Delete Project.
3. When you are asked to verify the deletion, click OK.
2. Enter the Alarm Setup filter name you want to use in the Alarm setup
field.
3. Click OK to close the Project Settings dialog box and return to the
Projects properties.
Sort/Display
Use the Sort/Display properties to define the sort order of alarms, and toggle the
display of the field titles, status box, and beginning display mode. You can also
enable/disable access to the popup runtime context menu via the right mouse button,
and enable/disable primary sort key changes with the left mouse button in the title bar
area.
Sort Alarms
You can use these fields to select the primary and secondary sort parameters for the
Alarm List.
For the primary sort key:
By Click the drop-down list button to the right of the input field
and select the primary sort key.
Ascending Select this option button if you want to sort the primary key in
ascending order.
Descending Select this option button if you want to sort the primary key in
descending order.
For the secondary sort key:
Then Click the drop-down list button to the right of the input field
and select the secondary sort key.
Ascending Select this option button if you want to sort the primary key in
ascending order.
Descending Select this option button if you want to sort the primary key in
descending order.
Position
Use these check boxes to position the alarm count information:
Clear both check boxes to position the alarm count on the lower left-
hand corner of the Alarm Viewer.
Select the Top of Screen check box to display the alarm information
in the upper left corner of the Alarm Viewer.
Select the Top of Screen and Center Count check boxes to display
the alarm information centered at the top of the Alarm Viewer.
Orientation
You can choose to display the alarm count information fields horizontally or
vertically.
Select the Horizontal option button to display the alarm count
information fields side by side in the order you specify.
Select the Vertical option button to display the alarm count
information fields one on top of the other in the order you specify.
Fields
You can choose whether or not to display:
Alarm count
Alarm date
Alarm time
Use the Move Up and Move Down buttons in this area to order the count, date,
and time display to your liking.
Date
Select the format you want to use to display the date of an alarm on the list. A
sample for the format you choose displays in the Sample field in this box. You may
select one of the formats from the list, or construct your own format using the
following information:
m Numeric month with no leading zero.
mm Numeric month with leading zero.
mmm Short text month.
mmmm Long Text month.
d Numeric day with no leading zero.
dd Numeric day with leading zero.
ddd Short text day of the week.
dddd Long text day of the week.
y Last two digits of year. For digits 00 through 09, only the last
digit is displayed.
yy Last two digits of year. For digits 00 through 09, both digits
are displayed.
yyyy All four digits of year
For example, if you enter dddd dd mmmm yyyy, the sample date will be
Saturday 05 March 1994.
You may use spaces, dashes, slashes or any other delimiter of your choice to separate
the date fields.
All of the text fields are shown in the list box, along with their current font types and
sizes.
To change the font information for a text field:
1. Select the text you want to change.
2. Click Font.
3. The Font dialog box opens and shows you the current attributes for the
font in the Font, Font style, Size, Effects, and Script fields.
4. Change the font properties for the text.
5. Click OK to save your changes or click Close to close the Font dialog
box and return to the CIMPLICITY AMV Control Properties dialog
box.
First, select the property you want to change in the Property Name field. You can
change the color of any of the following:
Alarm list background
Button background
Alarm count text
Count background
Normal count text
Status background
Status text
To select a color for the property, you can choose a default system color from the
System Color list, or select one of the 16 colors from the palette.
When a user clicks this button, a new Notepad window opens for a file in the NOTES
subdirectory of the CIMPLICITY HMI project directory. The filename is
determined by the Alarm ID of the selected alarm.
Acknowledging an Alarm
You can acknowledge an alarm to inform other users that you have seen the alarm
and, if necessary, are working on resolving the condition that set off the alarm.
If an alarm is not listed as acknowledged, the condition may still exist and should be
investigated.
To acknowledge an alarm (or a group of alarms):
1. Select the alarm(s).
2. Click Ack.
When you acknowledge an alarm, its acknowledge state changes from N to Y. The
alarm remains in the alarm list until its deletion requirements have been met.
Deleting an Alarm
Deletion requirements are defined Normally, alarms are automatically deleted when their deletion requirements have
during alarm configuration.
been met. An alarm will have one of the following deletion requirements:
Acknowledge
Reset
Acknowledge and Reset
If your CIMPLICITY User role has been given the Alarm Delete privilege, you can
force alarms to be deleted without the deletion requirements being met.
To delete an alarm (or a group of alarms):
1. Select the alarm.
2. Click Delete.
When you delete an alarm, it will be removed from the alarm list.
When the Alarm Setups dialog box opens, the first project in the list of projects
whose alarms you are monitoring displays in the Project field, and its current setup
displays in the Setup field.
Note
After you open the CimView screen containing the Alarm Viewer OCX control, the
first time you open the Alarm Setups dialog box, the current Setup for each project
is the default setup.
The Classes properties displays the list of current alarm classes and indicates which
ones are used in the alarm setup.
Select the check box to the left of a class to include alarms for that class in the Alarm
List. Clear the check box to exclude alarms for that class from the Alarm List. You
can also:
Click Add All to select all classes.
Click Remove All to clear all classes.
The Resources properties displays the list of current resources, and indicates which
ones are used in the alarm setup.
Select the check box to the left of a resource to include alarms for that resource in the
Alarm List. Clear the check box to exclude alarms for that resource from the Alarm
List. You can also:
Click Add All to select all resources.
Click Remove All to clear all resources.
The Time and State filter properties display the current status of the Time and State
filters for the alarm setup.
Filter by Time
You can use this option to display all alarms that have occurred since a certain time.
To do this, set the Use Time Filter check box to enable this filter, then enter the
starting date and time for the filter in the Select Alarms Since input fields.
The time and date when you opened the Modify Setup dialog box are used as the
default time and date.
Filter by State
You can use this option to limit the alarms displayed on the Alarm List to only those
that occur in the state you select. The choices are:
State Ack Description
Status
Alarm N Display points in alarm state that have not been acknowledged.
Alarm Y Display points in alarm state that have been acknowledged.
Normal N Display points that have returned to a normal state, but have
not been acknowledged.
Select the check box for each state you want to include in the alarm setup.
GFK-1180H 29-1
Creating an Invoke Method Action
You can create an Invoke Method action for any object or group for which you can
define procedures in your CimEdit screen.
When you select the Invoke Method action, the center of the dialog box changes to
look like this:
DoAckAll Method
This method acknowledges all alarms in the CIMPLICITY Alarm Viewer controls
alarm list. It is equivalent to the Ack All button in the Alarm Viewer control.
When you configure the DoAckAll method, the Advanced... button is not activated
because no further parameters are required for the method.
DoAckFirst Method
This method acknowledges the first alarm in CIMPLICITY Alarm Viewer controls
alarm list. It is equivalent to the Ack First button in the Alarm Viewer control.
When you configure the DoAckFirst method, the Advanced... button is not
activated because no further parameters are required for this method.
DoAcknowledge Method
This method acknowledges the currently selected alarm(s) in the alarm list on the
CIMPLICITY Alarm Viewer control. It is equivalent to the Ack button in the Alarm
Viewer control.
When you configure the DoAcknowledge method, the Advanced... button is not
activated because no further parameters are required for this method.
DoAckReset Method
This method acknowledges and resets the currently selected alarm(s) in the alarm list
on the CIMPLICITY Alarm Viewer control. It is equivalent to the Ack and Reset
button in the Alarm Viewer control.
When you configure the DoAckReset method, the Advanced... button is not
activated because no further parameters are required for this method.
DoCimviewScreen Method
This method displays the CimView screen configured for the currently selected
alarm in the alarm list on the CIMPLICITY Alarm Viewer control. It is equivalent to
the CimView Screen button in the Alarm Viewer control.
At run-time, the user must select only one alarm for this method to work. If the user
selects more than one alarm, the method will not execute.
When you configure the DoCimviewScreen method, the Advanced... button is
not activated because no further parameters are required for this method.
DoCustom<n> Method
These methods launch user-defined applications from the CIMPLICITY Alarm
Viewer control. They are equivalent to the Custom1 through Custom8 buttons in
the Alarm Viewer control.
When you configure the DoCustom<n> method, the Advanced... button is not
activated because no further parameters are required for this method.
DoDelete Method
If users have the Alarm Delete privilege, this method deletes the currently selected
alarm(s) in the alarm list on the CIMPLICITY Alarm Viewer control. It is equivalent
to the Delete button in the Alarm Viewer control.
When you configure the DoDelete method, the Advanced... button is not activated
because no further parameters are required for this method.
DoHelp Method
This method opens the Alarm Operator Help dialog for the currently selected alarm
in the CIMPLICITY Alarm Viewer controls alarm list. It is equivalent to the Help
button in the Alarm Viewer control.
At run-time, the user must select only one alarm for this method to work. If the user
selects more than one alarm, the method will not execute.
When you configure the DoHelp method, the Advanced... button is not activated
because no further parameters are required for this method.
Important: The DoHelp Method only works in static mode. It does not work in
dynamic mode.
DoRefresh Method
This method refreshes Static Alarm list in the CIMPLICITY Alarm Viewer control
with the latest alarms. It is equivalent to the Refresh button in the Alarm Viewer
control.
When you configure the DoRefresh method, the Advanced... button is not
activated because no further parameters are required for this method.
DoSetup Method
This method opens the Alarm Setups dialog so that users can select the filtering they
want when viewing alarms in the CIMPLICITY Alarm Viewer control. It is
equivalent to the Setup button in the Alarm Viewer control.
When you configure the DoSetup method, the Advanced... button is not activated
because no further parameters are required for this method.
DoToggle Method
This method toggles the CIMPLICITY Alarm Viewer control between the Static
Alarm list and the Dynamic Alarm list. It is equivalent to the Toggle button in the
Alarm Viewer control.
When you configure the DoToggle method, the Advanced... button is not
activated because no further parameters are required for this method.
DoViewStack Method
This method opens the Stacked Alarms dialog for the selected alarm in the
CIMPLICITY Alarm Viewer control. It is equivalent to the View Stack button in
the Alarm Viewer control.
At run-time, the user must select only one alarm for this method to work. If the user
selects more than one alarm, the method will not execute.
When you configure the DoViewStack method, the Advanced... button is not
activated because no further parameters are required for this method.
MoveDownOneAlarm Method
This method highlights the next alarm in the CIMPLICITY Alarm Viewer controls
alarm list. If the current alarm is the last alarm on the page but not the last in the list,
this method moves the list up to highlight the next alarm. It is equivalent to the down
arrow on a users keyboard.
When you configure the MoveDownOneAlarm method, the Advanced... button
is not activated because no further parameters are required for this method.
PageDownAlarms Method
If there is more than one page of alarms in the CIMPLICITY Alarm Viewer controls
alarm list, this method displays the next page of alarms. It is equivalent to the Page
Down button on the users keyboard.
When you configure the PageDownAlarms method, the Advanced... button is
not activated because no further parameters are required for this method.
PageUpAlarms Method
If there is more than one page of alarms in the CIMPLICITY Alarm Viewer controls
alarm list, this method displays the previous page of alarms. It is equivalent to the
Page Up button on the users keyboard.
When you configure the PageUpAlarms method, the Advanced... button is not
activated because no further parameters are required for this method.
SelectAllAlarms Method
This method selects all alarms in the CIMPLICITY Alarm Viewer controls alarm
list.
When you configure the SelectAllAlarms method, the Advanced... button is not
activated because no further parameters are required for this method.
SelectPageAlarms Method
This method selects all alarms displayed on the current page in the CIMPLICITY
Alarm Viewer control.
When you configure the SelectPageAlarms method, the Advanced... button is
not activated because no further parameters are required for this method.
SelectTopAlarm Method
This method selects the first alarm from the current page displayed in the
CIMPLICITY Alarm Viewer control and deselects all other selected alarms.
When you configure the SelectTopAlarm method, the Advanced... button is not
activated because no further parameters are required for this method.
GFK-1180H 30-1
Configuring a Stand-Alone Alarm Viewer
To display alarms, double-click the Alarm Viewer icon from your projects cabinet.
When you select the Alarm Viewer icon, the initial CIMPLICITY Alarm Viewer
window opens.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Log in as a particular CIMPLICITY HMI user.
Select an Alarm Viewer file to display.
Save the Alarm View you have just configured.
Print the current list of alarms.
Configure the count display.
Configure the list display.
You can define the following colors for the alarm count display:
Unseen Alarm Count The color of the alarm count when new alarms are
generated and you have not yet viewed them.
Seen Alarm Count The color of the alarm count after you have viewed the
current set of alarms.
Background The background color for the alarm count display.
Click Color... to use the Color dialog box to select the color you want for the
display.
Note
If you select a dithered color, its solid component will be used, not the color you
selected. To see the components of a dithered color, click Define Custom
Colors>> in the Colors dialog box.
The list of fields will depend on whether you are configuring a Static Alarm List or a
Dynamic Alarm List.
Select Static to configure a Static Alarm List.
Select Dynamic to configure a Dynamic Alarm List.
If any field titles have been modified, the modified title appears in parentheses to the
right of the field name (for example, "(Ack)" appears to the right of "Ack State").
You can select one or more of the fields in this list. To select a field, set its check
box.
Dynamic Alarm Fields
After you select Dynamic, the list of alarm fields looks like this:
You can select one or more of the fields in this list. To select a field, set its check
box.
Once you have selected a field for display in the alarm list, you can configure which
row of the alarm message the field will be placed in, where in the row it will be
placed, and the length of the display.
Position Left
Select the Alarm List field you want to move, then click Position Left to move it
toward the front of the current message row.
Position Right
Select the Alarm List field you want to move, then click Position Right to move it
toward the end of the current message row.
Row Up
Minimum row number is 1. Select the Alarm List field you want to move, then click Row Up to move it up a
row in the message. The field will be placed at the start of the message row.
Row Down
Maximum row number is 10. Select the Alarm List field you want to move, then click Row Down to move it
down a row in the message. The field will be placed at the start of the message row.
The current field length is displayed in the Length input field. To change the length
of a field:
1. Enter the new field length in the Length input field.
2. Click OK.
Note
Field length is based on the average size of characters in the font you have chosen.
Thus, a length of 6 may be sufficient to display the string "IIIIII", but may be too
short to display "WWWWWW". To ensure that the length is always adequate, select
a fixed pitch font (such as Courier New) for your alarm page display.
The current field title is displayed in the Title input field. To change the title of a
field:
1. Enter the new field title in the Title field.
2. Click OK.
When you change the title of a field, its original title appears next to the check box in
the Fields list, and the modified title appears to the right in parentheses.
Font
The current font name and size are displayed. To change the alarm list font, click
Font... to display the Font dialog box. Use the dialog box to configure the font
type, style, and size to be used for the alarm list.
Background Color
The current background color for the screen is displayed. To change the background
color, click Color... to display the Color dialog box. Use the dialog box to
configure the background color you want for the alarm list.
The list of buttons will depend on whether you are configuring a Static Alarm List or
a Dynamic Alarm List.
Select Static to configure a Static Alarm List.
Select Dynamic to configure a Dynamic Alarm List.
Static Alarm List Buttons
After you select Static, the list of alarm buttons looks like this:
You can select one or more of these buttons. To select a button, set its check box.
You can select one or more of these buttons. To select a button, set its check box.
Toggle Displays the Static Alarm list. See page 30-24 for more
information.
Setup Displays the Alarm Setups dialog box. See page 30-24 for
more information.
Once you have selected the buttons for display in the alarm list, you can configure
which button row the button will be placed in, where in the row it will be placed, and
what caption will be displayed.
Position Left
Select the Alarm List button you want to move, then click Position Left to move it
toward the front of the current row.
Position Right
Select the Alarm List button you want to move, then click Position Right to move
it toward the end of the current row.
Row Up
Minimum row number is 1 Select the Alarm List button you want to move, then click Row Up to move it up a
row. The button will be placed at the start of the row.
Row Down
Maximum row number is 10 Select the Alarm List button you want to move, then click Row Down to move it
down a row. The button will be placed at the start of the row.
To modify a button:
1. Enter the new caption in the Button Caption field. You may enter up
to 100 characters.
2. Enter a description in the Description field.
3. If you have selected a custom button, enter the command string you
want to be executed when the button is selected in the Command
String field (this field is not available for the standard buttons).
4. Click OK.
For standard buttons, the button name in the Buttons field of the Button Layout
window will not change - just the caption that is displayed in the button at run-time.
For custom buttons, the caption displayed in the button at run-time will be changed,
and when a user clicks the button, the command string you specified will be
executed.
Background Color
The current background color for the screen is displayed. To change the background
color, click Color... to display the Color dialog box. Use the dialog box to
configure the background color you want for the alarm list.
When a user selects this button, a new Notepad will be executed for a file in the
NOTES subdirectory of the CIMPLICITY HMI project directory. The Alarm ID of
the selected alarm determines the filename.
Enter your CIMPLICITY HMI username in the Username field, and enter your
CIMPLICITY HMI user password (if you have one) in the Password field.
You can also:
Click on the Reconnect at Startup check box to automatically login
each time you start up Alarm Viewer.
Click on the Save Username + Password check box to save your
username and password. They will automatically be entered in their
fields the next time you log in using this dialog box.
When you select the Login! menu option, you may see the Select Project dialog
box. Use this dialog box to select a remote project to log in to.
Selecting Alarms
A number of the functions you can perform require you to select one or more alarms
from the alarm list. There are several ways to do this:
To select a single alarm, move the mouse to the alarm and click on it.
To select a series of individual alarms, hold down the Ctrl key, then
move to each alarm in turn and click on it.
To select a group of alarms, click on the first alarm in the group, then
hold down the Shift key, move the mouse to the last alarm in the group
and click on it. All alarms in the list between the first alarm and last
alarm will be selected.
You may select one or more of these options to filter the alarm list. When you click
Setup, the Alarm Setups dialog box opens. For more information, see page 30-27.
When you click Toggle on the Static Alarm list, the Dynamic Alarm list displays.
When you click Toggle on the Dynamic Alarm list, the Static Alarm list displays.
Acknowledging an Alarm
You can acknowledge an alarm to inform other users that you have seen the alarm
and, if necessary, are working on resolving the condition that set off the alarm.
If an alarm is not listed as acknowledged, the condition may still exist and should be
investigated.
To acknowledge an alarm (or a group of alarms):
1. Select the alarm(s).
2. Click Ack.
Resetting an Alarm
You can manually reset an alarm to indicate to the system that you are manually
overriding the alarm condition. If you do this, the alarm will not be triggered again
until the situation returns to the configured acceptable range and then goes back out
of the acceptable range.
The system automatically resets an alarm if the condition that triggered the alarm
returns to within acceptable limits.
To reset an alarm (or a group of alarms):
1. Select the alarm.
2. Click Reset.
When you reset an alarm, its state changes from ALARM to NORMAL.
Deleting an Alarm
Deletion requirements are defined Normally, alarms are automatically deleted once they have been successfully
during alarm configuration.
acknowledged and/or reset as long as their deletion requirements have been met.
If you have been given the Alarm Delete privilege, you can force alarms to be
deleted without the deletion requirements being met.
To delete an alarm (or a group of alarms):
1. Select the alarm.
2. Click Delete.
When you delete an alarm, it will be removed from the alarm list.
When the Alarm Setups dialog box opens, the current setup displays in the Setup
field.
The Classes properties displays the list of current alarm classes and indicates which
ones are used in the setup. Set the check box to the left of a class to include alarms
for that class in the Alarm List. Clear the check box to exclude alarms for that class
from the Alarm List.
Click Add All to select all classes.
Click Remove All to clear all classes.
The Resources properties displays the list of current resources, and indicates which
ones are used in the setup. Set the check box to the left of a resource to include
alarms for that resource in the Alarm List. Clear the check box to exclude alarms for
that resource from the Alarm List.
Click Add All to select all resources.
Click Remove All to clear all resources.
Copying Alarms
The Copy function on the Edit menu lets you copy selected alarms to the clipboard.
Once the alarm is on the clipboard, you can paste it in another window.
For example, if there is an alarm on the list that you want to include in an e-mail
message:
1. Select the alarm.
2. Select Copy from the Edit menu.
3. Go to the e-mail message you are creating.
4. Position the cursor in the message.
5. Select Paste from the Edit menu.
/noconfig
Does not allow the user to configure the count and list layouts on the screen.
The Count Layout and List Layout menu items are disabled on the Configure
menu.
Example:
amv.exe /noconfig C:\myproj\view.amv
About CimView
CimView is an interactive graphical user interface to help you monitor and control
your facility. It displays the screens that were created with CimEdit.
Your data can be displayed and monitored as text or a variety of graphic objects.
Both text and graphic objects can automatically change color, move, and rotate based
on the data collected.
CimView screens can also have a variety of interactive control functions that let you
set point values, display other graphic screens, initiate custom software routines and
start other Windows applications.
Getting Started
There are many ways to start a CimView session. Here are some:
Your CimView session may be configured by your System Manager to
automatically start when you login.
You can select a CimView icon that is in your project folder or on the
desktop.
GFK-1180H 31-1
Window Components
The CimView window has several components that have been labeled in the above
figure.
You can use the Menu functions, Toolbar buttons, and shortcut keys to:
Open a CimView screen in the current or a new window.
Print the current screen.
Flush cached screens.
Enable/disable the Toolbar, Status Bar, and Menu/Title Bar.
Toggle and zoom the screen size.
Display help.
Depending on the configuration set up by your System Manager, you may not see all
of these window components, and you may not have access to all of these functions.
For example, in many installations the title bar, menu bar, toolbar, and status bar will
be hidden, and the CimView window will occupy the entire terminal screen.
Title Bar
The Title Bar displays the filename of the screen you are currently displaying. You
can also use it to move the CimView window.
When you click the right mouse button in the Title bar, a menu of standard window
functions is displayed. You can use these functions to move, resize, lower, or close
the window.
Window Buttons
When you click on the Minimize button, you will minimize the window.
The minimized window is hidden. To restore the window, click on its button in the
task bar.
When you click on the Maximize button, the window will be resized to take up the
entire terminal screen. When the window is maximized, the Maximize button is
replaced by the Restore button.
When you click on the Restore button, the window will be restored back to its old
size.
Scroll Bars
Use the vertical scroll bar to move the screen up and down if it doesnt fit in the
window.
Use the horizontal scroll bar to move the screen back and forth if it doesnt fit in the
window.
Status Bar
The Status Bar displays information about your current viewing operation, and is
divided into four areas:
Message Area Displays informational messages about options that you
select or about operations that you perform.
Cursor Location Displays the X,Y coordinates of the current cursor
location in points.
Toolbars
A toolbar is a frame containing a set of controls. Generally, toolbars are used to
provide quick access to specific commands or options. These commands or options
are usually also available in the menus. CimView uses a Standard toolbar.
Print Prints the screen. Unlike the Print menu item, it does
not display a dialog box first. The screen is
immediately printed.
Help Changes your cursor and allows you display Help for
selected objects, groups, buttons, menus, and screens.
Previous Displays the previous screen in this window.
When you look at a screen in CimView, it consists of a set of objects. There are
many types of objects. Among them are:
Text objects that display text information or point values.
Graphic objects that represent facility resources and conditions.
ActiveX controls.
Objects can be static, or they can be animated. CimView can display objects with
movement, rotation, fill, size, or color change animation.
Use the Toolbars properties to select the toolbar to be displayed in your CimView
window. You can also toggle the display of color buttons and ToolTips.
The Toolbars input box shows you the special toolbars available for CimView, and
lets you select the ones to display. Note that the only toolbar currently available is
the Standard toolbar.
The Color Buttons check box lets you enable or disable the display of toolbar
buttons in color.
The Show ToolTips check box lets you enable or disable the display of ToolTips
on the toolbars. When ToolTips are enabled and you move the cursor into a button
on the Toolbar, you will see the button name in a box next to the cursor, and a
description of the button in the Status Bar at the bottom of the window.
For example, if you want to display your CimView screens in a window without a
Menu Bar and Title Bar, the command line would look like this:
cimview.exe /nomenutitle c:\cimplicity\projects\proj\ini.cim
If multiple CimView screens are launched from a single command line and
command line options are used, the first screen in the list is the primary window. For
example, if /alwaysmaximized is used, the first screen in the list will be
maximized, and all other screens will be displayed in their normal windows.
The following command line options can be associated with a CimView icon:
/alwaysmaximized
Displays the primary CimView window in a maximized state. You will not be
allowed to resize the primary window. The window will not rise to the top when you
click on it (this prevents it from obscuring other windows on your terminal screen).
This option is only applied if it is used with the first CimView window opened. This
window is known as the primary window. If used with subsequent open commands,
it will be ignored.
/geometry <width>x<height><xoff><yoff>
Sizes and positions the CimView window when it opens. The screen is sized to fit
the window. All fields are in pixels.
The arguments for this command line option are:
<width> specifies the window width.
<height> specifies the window height.
<+xoff> specifies the offset from the left edge of the terminal screen and
<-xoff> specifies the offset from the right edge of the terminal screen.
<+yoff> specifies the offset from the top edge of the terminal screen and
<-yoff> specifies the offset from the bottom of the terminal screen.
Example:
cimview.exe /geometry 200x200+100+200 C:\myproj\scr.cim
opens the screen in a 200x200 window that is 100 pixels from the left side of the
terminal screen and 200 pixels from the top edge of the terminal screen
/keypad
Displays a keypad window on the users screen whenever the user has to perform a
Variable Setpoint action in a procedure. To enter a new setpoint value, the user
clicks on the appropriate keys in the keypad window rather than entering them from a
keyboard.
This option is only applied if it is used with the first CimView window opened. This
window is known as the primary window. If used with subsequent open commands,
it will be ignored.
Example
cimview.exe /keypad C:\myproj\scr.cim
/LoadScript
Enables a common script file to be shared among all screens loaded in CimView.
Functions that are included in this common file will be loaded when CimView is first
run, and will be callable as if they were included in the Basic code for the local
screen.
If the /LoadScript argument is specified for a file after CimView is already
running, its contents will be appended to the list of common functions with the lowest
precedence.
Example:
/LoadScript scriptFileName
where
scriptFileName is a file specification) to specify a common script file. (Multiple
/LoadScript options can be given on the command line.)
See the "Using CimEdit Scripts" chapter in the CIMPLICITY HMI CimEdit
Operation ManualGFK1396 for more information about /LoadScript.
/nomenutitle
Removes the Menu Bar and Title Bar from the primary CimView window and all
subsequent windows that you open.
This option is applied to the new windows and also any windows that are opened
from within CimView. If a later CimView command is executed without the
option, the option is disabled for those windows and any new windows opened from
within CimView.
Example:
cimview.exe /nomenutitle C:\myproj\scr.cim
/noPointTargets
Prevents the point targets, e.g. Point Control Panel and quick trends, from being
available from Point View or the right mouse menu.
/noopen
Lets you open only the CimView screens that are explicitly mentioned in Open
Screen and Overlay Screen actions. Open Screen and Overlay Screen actions that do
not specify a screen are ignored.
In addition, the Open and Open Window menu items and the file list are removed
from the File menu, and the File Open Toolbar button is disabled.
This option is applied to the new windows and also any windows that are opened
from within CimView. If a later CimView command is executed without the
option, the option is disabled for those windows and any new windows opened from
within CimView.
Example:
cimview.exe /noopen C:\myproj\scr.cim
/noresize
Prevents you from resizing any CimView windows that you display.
This option is applied to the new windows and also any windows that are opened
from within CimView. If a later CimView command is executed without the
option, the option is disabled for those windows and any new windows opened from
within CimView.
Example:
cimview.exe /noresize C:\myproj\scr.cim
/wait [<time>]
Makes CimView wait for the Router to start before opening the screen. Note that
CimView does not try to start the Router. The Router must be started by another
method. Typically this option is used when configuring CimView to start at boot or
when the user logs in to Windows.
You can specify a time, in seconds, to wait. The screen opens at the end of the time,
regardless of the state of the router. If you do not specify a time, CimView waits
forever.
Example:
/waitforproject <name>
Makes CimView wait for the project to start before opening the window
Example:
cimview.exe /waitforproject myproj C:\myproj
\scr.cim
/zoomtobestfit
Initially places the primary CimView window in Zoom To Best Fit mode. All
subsequent windows are also displayed in this mode.
This option is applied to the new windows and also any windows that are opened
from within CimView.
Example:
cimview.exe /zoomtobestfit C:\myproj\scr.cim
Getting Started
To open the Point Control Panel:
1. Expand the Runtime folder in the CIMPLICITY HMI Workebench.
2. Double click Point Control Panel in the left pane or right pane
(when the Point Control Panel is selected in the left pane).
The Point Control Panel opens.
GFK-1180H 32-1
To display a new, empty list, select New from the File menu.
To display a saved Point Control Panel document, select Open from the File menu,
or, if the document is in the list of recent files, just click on the file name in the list.
To print the current state of the Point Control Panel, select Print from the File
menu. If you want to see what your printout will look like, select Print Preview. If
you need to change the printer, paper type or page orientation, select Print Setup.
Point Control Panel To save a Point Control Panel document, select Save from the File menu. When
documents are saved with the the Save As dialog box opens, enter a file name for the file and select OK. By
extension .PPL default, Point Control Panel documents are placed in the main CIMPLICITY HMI
directory, but you can select another directory.
To exit the Point Control Panel, select Exit from the File menu.
To add points to the list, select Add from the Edit menu.
To display the properties of a point, select it, then select Properties from the Edit
menu.
To delete a point from the list, select it and press Delete or select Delete from the
Edit menu.
To change the font colors for point alarming, select Colors from the Font menu.
You may see the following icons displayed next to points in the Point Control Panel:
This icon is displayed if the point is not valid.
This icon is displayed after you successfully disable alarming for a point.
This icon is displayed after you change the current alarms limits for a point.
Displaying Points
When you select Add from the Edit menu or press Ctrl+A, the Select a Point
browser opens.
Select the project from which you want to display points. To request a list of all
points, just select Browse. To refine the list, you can enter search strings for Point
ID, Device ID, Resource, Point Type or Description, then select Browse.
When the list of points displays in the list box, select the ones you want to display,
then select OK.
The Select a Point browser closes and the Point Control Panel redisplays with the
points you selected. All the points you requested are automatically selected in the
Point Control Panel so that you can just look at them, and then delete them from the
view if you wish.
The current value, units and timestamp for each point are displayed in the Point
Control Panel. If a point is in an alarm condition, its text is displayed in the
appropriate color.
You can display point properties for each point in the list. You can also perform a
setpoint, enable/disable alarming and set new alarm limits for each point in the list.
If the point has no alarming or has On update alarming, the Alarm property page
does not appear in the dialog box.
Details
This property page shows you the Point Type and Resource for the point, its access,
display limits, current value and units and password.
Use this property page to perform a setpoint on the points value. To do this, enter
the new value in the Set Value field and select Apply or OK. If you select Apply,
the dialog remains open. If you select OK, the dialog closes. In either case, the
Point Control Panel is updated to reflect your changes.
The contents of this property page depend on whether you are viewing an Analog or
Boolean point type.
For Analog point types, this property page shows you whether alarming
is enabled for the point and the configured and current alarm and
warning limits.
For Boolean point types, this property page shows you whether
alarming is enabled for this point and the configured alarm state.
Use the Alarm Enabled field to enable or disable alarming for the point. If you
disable alarming, the Disabled icon - - displays next to the point in the Point
Control Panel main window. If the point is already in an Alarm state and you disable
it, the state is reset to Normal. If you enable alarming for a point that is already in an
Alarm state, the alarm is generated.
Use the Current fields in the Alarm Limits section to change alarm limits. If you
change alarm limits, the Modified icon - - displays next to the point in the Point
Control Panel main window.
After you change alarm information on this page, you can select Apply or OK to
have the changes take place. If you select Apply, the dialog box remains open. If
you select OK, the dialog box closes. In either case, the Point Control Panel updates
to reflect your changes.
To return to configured alarm limits, select Restore Alarm Limits.
You can set the foreground (text) and background colors for the following states:
Normal Points that are in normal state display with these colors
Warning Points that are in Warning High or Warning Low state
display with these colors
Alarm Points that are in Alarm High or Alarm Low state display
with these colors
Wait for response Points for which the Point Control Panel is waiting for a
response display with these colors.
To change a color, click the drop-down list button to the right of the color you want
to change. When the palette opens, select the basic color or custom color you want,
and then select OK.
After you have defined your display colors, select OK to close the Font Color dialog
box closes and redisplay the Point Control Panel in the colors you have selected.
Select Cancel to close the dialog box without making any changes.
Point Control Panel Enter the file name you want in the File name field, then select the full path name
documents are saved with the for the document. Select Save to save the document. The document is saved in the
extension .PPL directory you specify.
You can then select the document and create a shortcut for it on your desktop or in a
start menu.
GFK-1180H 33-1
Microsoft Excel Example
The syntax for a CWSERV command in a Microsoft Excel spreadsheet, is:
=cwserv|point!<point_id>.<attribute>[n:mD]
where:
<point_id> is the CIMPLICITY Point ID whose data is being retrieved.
You may enter an unqualified or fully qualified (by project or
node name) Point ID.
<attribute> is the point attribute of interest. If you do not enter an attribute,
CWSERV uses "VALUE" as the default.
n:m is the range of array elements desired . If you do not enter a
range, CWSERV uses "[0]" as the default.
Enter "[n]" to specify a single element of an array.
D If you have requested a range of elements, use this field to
specify the display format. Enter "C" to display the elements in
a column, or "R" to display the elements in a row. If you do
not enter a display format, CWSERV uses "C" as the default.
VALUE
Displays the converted (EU) value of the point. If there is no conversion, the raw
value is displayed. If you do not enter an attribute in the CWSERV command, this is
the default attribute that is displayed.
RAW_VALUE
Displays the raw value of the point.
STATE
Displays the current state of the point.
The points current state depends on its point class and alarm conditions.
For all point classes, the states that can be displayed are:
NORMAL The points value is within normal limits, and no alarms
are outstanding.
UNAVAILABLE If the point is a device point, communications with the
device have failed, and the point can no longer be read.
If the point is a virtual point, one or more of the source
points that comprise this point is unavailable.
For Analog and APPL point classes, the additional states that can be displayed are:
ALARM HIGH The points value is greater than the high alarm limit.
ALARM LOW The points value is less than the low alarm limit.
WARNING HIGH The points value is greater than the warning high limit
and less than the alarm high limit.
TYPE
Displays the points type. You will see one of the following:
BOOLEAN
BITSTRING
OCTETSTRING
CHARACTERSTRING
UNSIGNED INTEGER 1
UNSIGNED INTEGER 2
UNSIGNED INTEGER 4
INTEGER 1
INTEGER 2
INTEGER 4
FLOATING POINT
STRUCTURE
Note
OCTETSTRING points are not currently supported by CWSERV. If you try to
display such a points VALUE or RAW_VALUE attribute, "#NAME?" will be
displayed on the Excel spreadsheet.
LENGTH
Displays the length of the point. This field is only meaningful for the following point
types:
BITSTRING
OCTETSTRING
ELEMENTS
Displays the number of elements contained in the point.
SIZE
Displays the size of the data.
DISP_FORMAT
Displays the format used when displaying the points value in Alarm Viewer, Status
Log messages, or CimView.
ALARM_HIGH
Displays the Alarm High value for the point. This field is only valid for the
following point types:
ANALOG
APPL
If the points value exceeds this number, the point is in ALARM HIGH state.
ALARM_LOW
Displays the Alarm Low value for the point. This field is only valid for the
following point types:
ANALOG
APPL
If the points value is less than this number, the point is in ALARM LOW state.
WARN_HIGH
Displays the Warning High value for the point. This field is only valid for the
following point types:
ANALOG
APPL
If the points value is greater than this number, but less than the Alarm High
number, the point is in WARNING HIGH state.
WARN_LOW
Displays the Warning Low value for the point. This field is only valid for the
following point types:
ANALOG
APPL
If the points value is less than this number, but greater than the Alarm Low number,
the point is in WARNING LOW state.
DISP_HIGH
Displays the high limit for the display value for this point. This field is only valid for
the following point types:
ANALOG
APPL
DISP_LOW
Displays the low limit for the display value for this point. This field is only valid for
the following point types:
ANALOG
APPL
ALARM_ENABLED
Indicates whether high/low alarms are enabled or disabled for this point. You will
see one of the following values:
0 High/Low alarm messages are disabled for the point.
1 High/Low alarm messages are enabled for the point.
WARN_ENABLED
Indicates whether high/low warnings are enabled or disabled for this point.
0 High/Low warning messages are disabled for the point
1 High/Low warning messages are enabled for the point.
This dialog box will also be displayed if you open a spreadsheet that contains
CWSERV commands and the CWSERV server is not active.
Click Yes to start CWSERV.
This dialog box will appear every time you open the spreadsheet:
Click Yes to reconnect to CWSERV to access data. If CWSERV is not running, you
will be asked if you want to start it. Click Yes to start CWSERV.
If you are connecting to the project for the first time, or your login timeout has
expired, the CIMPLICITY Login dialog box for the project is displayed.
Enter your CIMPLICITY username and password and click OK. Your spreadsheet
will now start to display the CIMPLICITY data you requested in the CWSERV
commands.
CWSERV Icon
While the server is active, you will see this icon on your terminal screen:
Macro Format
The format for a Microsoft Excel macro that performs a setpoint is:
Enter the macro name on the first line.
Enter channel=INITIATE("cwserv","point") on the second
line to open the CWSERV channel.
Enter =POKE(channel, "<point_id>.<attribute>",
<sheet location> for each setpoint you want to perform.
Enter =TERMINATE(channel) to close the channel.
Enter =RETURN() to terminate the macro.
An example of such a macro is:
set_point
channel=INITIATE("cwserv","point")
=POKE(channel,"cwserv_virt.value",Sheet1!R17C3)
=TERMINATE(channel)
=RETURN()
Performance Considerations
When you perform a large number of DDE POKE requests from an application such
as Microsoft Excel, the DDE server application may fall behind. Under Excel, this
will cause some requests to timeout and fail.
To change the setpoint, enter the new point value in cell R19C3, then click Set.
Array Point Example
The following spreadsheet was configured to display the raw values for
CWSERV_ARRAY, an array point with ten (10) elements, and to let a user perform
a setpoint on the array:
To create the display, cells R5C3 through R14C3 were selected, and the following
formula was entered:
=cwserv|point!cwserv_array.raw_value[0:9c]
To change the setpoint, enter the new values in R5C4 through R14C4, and click Set.
Formats
CWSERV currently supports the CF_TEXT format.
To display format information on a Microsoft Excel spreadsheet:
1. Select one (1) cell in the spreadsheet.
2. Type the following formula in the cell and press Enter:
=cwserv|system!formats
The resulting display should look like this:
CF_TEXT
System Items
CWSERV currently supports four system items - Formats, Help, SysItems, and
Topics.
To display system item information on a Microsoft Excel spreadsheet:
1. Select four (4) rows in one column in the spreadsheet.
2. Type the following formula in the first cell and press
Ctrl+Shift+Enter.
=cwserv|system!sysitems
The resulting display should look like this:
Formats
Help
SysItems
Topics
Topics
CWSERV currently supports two topics - Point and System.
To display topic information on a Microsoft Excel spreadsheet:
1. Select two (2) rows in one column in the spreadsheet.
2. Type the following formula in the first cell and press
Ctrl+Shift+Enter.
=cwserv|system!topics
The resulting display should look like this:
System
POINT
GFK-1180H 34-1
Using Show Users
Show Users is an interactive process that lets you show the users on the various
CIMPLICITY HMI projects running on your network.
The subwindow for the project displays the User ID, Role, Node and Process ID of
every CIMPLICITY user that is logged in to that project. The information in the
subwindow updates as users log in and out of the project.
For each project that users are logged into on this computer, the Node ID for the
project, Project ID, user name, login status, and type are displayed.
From this window, you can:
Select a logged in project and log out.
Select a logged out project and log in.
Use the Edit menu to manage your saved logins.
Logging in to a Project
To log in to a project:
1. Select the project from the list of projects (its status must be "Logged
out").
2. Select Login from the Project menu or click the Login button -
- on the Toolbar. The CIMPLICITY Login dialog box opens.
3. Enter the Username and Password for the user you want to be when
viewing screens for the project.
CIMPLICITY HMI software logs you in to the project as the user you designate. All
CimView screens connected to this project will now have their animation objects
enabled.
Note
The screen itself may change if visibility animation has been enabled for objects and
keyed to User ID and Role ID information.
The dialog box displays the current project and your User ID.
To change the password:
1. Enter the current password in the Old password field. As you type,
asterisks will display.
2. Enter the new password in the New Password field. As you type,
asterisks will display.
3. Enter the new password again in the Confirm field. As you type,
asterisks will display.
4. Select OK to accept the new password or select Cancel to not change
the password.
When you are through with this dialog box, select Close to close it and return to the
Login Panel window.
2. Select the project you want to apply the login to in the Project field.
Use the drop-down list button to display the list of available projects in
your enterprise.
3. Enter the username for the login in the User field.
4. Enter the password in the Password field and confirm it in the
Confirm field.
5. Select OK to activate the new saved login, or select Cancel to exit this
dialog box without saving the information you entered.
After you activate the new saved login, whenever you open a screen in this project,
you are automatically logged in to the project.
You can use the Browse button to search for a project to start. Once you have
selected a project, you can:
Select OK to start the project.
Select Start as Viewer to start the project as a Viewer project.
When you start the project, the normal startup dialogs are displayed.
You can also select Cancel to close the dialog box without starting a project. When
the dialog box closes, the Program Control process terminates.
To connect to a project:
1. Click the drop-down list button to the right of the System input field.
A list of currently running projects that are broadcasting is displayed.
2. Select the project you want to connect to.
3. Select Connect.
4. If you are not currently logged in to the project, you are prompted for a
Username and Password.
The CIMPLICITY Program Control window redisplays with the list of process names
and statuses for the project you selected.
If the process starts successfully, its status in the process list changes from "Halted"
to "Running".
If the process stops successfully, its status in the process list changes from "Running"
to "Halted".
If the processes start successfully, their status in the process list changes from
"Halted" to "Running".
If the processes halt successfully, their status in the process list changes from
"Running" to "Halted".
GFK-1180H 35-1
If the same PLC configuration needs to be used in a country that measures
temperature in Centigrade, every Fahrenheit measurement must be
converted. In this situation, the system engineer uses the Measurement
Units feature. The engineer specifies only one configuration in one window,
the Measurement Units window, to convert all five points from Fahrenheit
to Centigrade. In addition, this one configuration will convert any other
points in the project to which Fahrenheit is assigned.
2. Enter the name of your base unit in the Unit ID field and click OK.
The Measurement Unit Properties dialog box opens.
You can edit any of the following fields in the right pane or in the dialog box:
Forward Equation
Enter the equation to be used by Point Management to convert the base value to its
equivalent in this measurement system.
For example, if point XYZs base value is in inches and you want to display it in
centimeters, use the forward expression %P*2.54001.
If the points base value is the same as its converted value, just put %P in the field.
Reverse Equation
Enter the equation to be used by Point Management to convert the equivalent in this
measurement system to its base value.
For example, if point XYZs base value is in inches and its equivalent value is in
centimeters, use the reverse expression %P/2.54001.
If the points base value is the same as its converted value, just put %P in the field.
Justification
This field is used to align the display of point value.
By default, the project uses the justification you specify when you configure a point.
Select the justification you want to use when displaying the points value on
CimView screens when this measurement system is active, as long as the
Configured option is selected for the CimView object display properties. You can
select one of the following:
Left Left justifies the value display
Right Right justifies the value display
Zero Zero fills the value display
Width
This field represents the number of spaces you want to dedicate to the display of the
point value.
By default, the project uses the display width you specify when you configure a
point.
If you want to use a different display width for all points that use this Unit ID, enter
it in this field.
Precision
This field represents the number of digits to be displayed to the right of the decimal
point.
By default, the project uses the precision you specify when you configure a point.
If you want to use a different precision for all points that use this Unit ID, enter it in
this field.
4. Enter the name of the new measurement unit in the Destination field.
5. Click OK.
The Measurement Unit Properties dialog box opens.
6. Fill in the description label for the new measurement unit.
Click for details on using the Measurement Unit Properties dialog
box.
7. Click OK.
4. Enter the new name of the measurement unit in the Destination field.
5. Click OK
The measurement unit name in the left pane will change to the name you specify.
Guideline
For points that need to have the highest level of precision and use Measurement
Units conversion, use the floating point type instead of the integer point type.
Example
Point XYZ is a point with a base unit ID of inches that requires the highest level of
precision. Its initial value is 10 inches.
You use Metric as the active measurement system. As a result, XYZs value displays
as centimeters.
You want to perform a setpoint on XYZ.
Dont
Define XYZ as an integer.
If you then perform a setpoint on XYZ and set it to 26.924 cm.:
26.924 cm. is reverse converted to 10.60 inches.
Because XYZ is an integer, 10.60 is rounded up to 11 inches.
11 inches is forward converted to 27.94 cm.
The point value displays as 27.94 cm.
Do
Define XYZ as a floating-point type.
When you then perform a setpoint on XYZ and set it to 26.924 cm., the internal
conversion is able to store 10.6 inches. As a result, the point, which is the same value
it was set to, displays as 26.924 cm.
Guideline
Assign a base Unit ID for a derived point that is consistent with the base Unit IDs of
the points in its expression and use constants that are consistent with the base Unit
ID for the derived point.
If you are using Measurement Units and want your derived points to be calculated
correctly, you need to use the Engineering Units (EU) value for device points in your
derived point expressions. You can do this in one of two ways:
Set the PTMDP_DO_EU_CONV global parameter to one (1) to
automatically use the EU value of device points in all derived point
expressions.
Use the EU_CONV function for every device point you use in a
derived point expression to convert the device points to their EU
values.
Example
SOURCE is a device point with a Base Unit ID of inches.
DEST is a derived point with an expression: SOURCE+10.0 (inches).
The value of SOURCE is 1 inch.
You will use Measurement Units conversion to convert the project from inches to
centimeters.
Dont
Assign DEST a measurement unit of centimeters in the Point
Properties box Conversion tab, which is different from SOURCEs
assigned measurement unit, inches.
Leave DESTs measurement unit (in the Conversion tab) blank.
In either case you are creating an inconsistent condition which may produce
confusing results after conversion.
Do
Assign DEST a base measurement unit of inches in the Point Properties box
Conversion tab.
The expression, SOURCE+10.0, will be calculated as 1 inch +10 (inches) = 11
inches
Because DEST has a base measurement unit of inches, it will be included in the
Measurement Unit conversion and will display as 27.94 centimeters.
Example
Using the U.S. Customary system as the active measurement system, you want to
move an object from a lowest value (0 inches) on the left of the screen to a highest
value (100 inches) on the right of the screen, as the points value changes.
You then change the active measurement system from U.S. Customary to Metric. As
a result, the measurement units are converted from inches to centimeters
Dont
Specify 0 (inches) as the expression minimum value and 100 (inches) as the
expression maximum value in the objects configuration window.
If the point in the animation expression has a base value of 8 inches (displayed as
27.32 cm.), it will cause CimView to incorrectly place the animated object within
the 0-100 limits because it thinks the 0-100 limits are centimeters. Because the range
is incorrect, CimView will display the value too far to the right. (The range should
be 0-254 cm.)
Do
Leave the objects fields blank and enter 0 in the points Display low, 100 in its
Display high field in Point Configuration.
If the point in the animation expression has a value of 8 inches (displayed as 27.32
cm.), CimView will properly place the animated object within the limits, because
they are converted to centimeters. (0-100 is now 0-254.)
CimView Scripts
CimView uses Basic scripts, which can, among many other things, use the runtime
value of a point.
When you use point values within scripts, the values correspond to the active
measurement system. Therefore, if you compare or manipulate values with other
values that are constant, you will most likely run into trouble if you switch active
measurement systems. This is because your constant numbers will stay the same, but
the point values will most likely change due to unit equivalence.
Guidelines
You have to take into consideration that the point values will vary depending on the
active measurement system. Therefore, make sure that values in the script are all
relative; conversely, that there are no absolute values in the script.
Guidelines
When you specify point values in the Event Editor, enter them for the base
measurement unit. The actions you specify will occur when the point value for the
event, such as Point Equals, is reached.
Dont change anything in the Event Manager configuration if you are changing the
active measurement system.
Example
You have a point called WaterLevel and you have an action that gets triggered when
the level reaches 100 inches. Your base unit is inches and the project is converted to
centimeters.
Do
Dont do anything.
When you use the Metric system as the active measurement system, the event will
not get triggered until the level hits 254 centimeters, which is equivalent to 100
inches. The Event Manager internally sees the value as 100 inches and triggers the
event properly.
Global Parameters
The Global Parameters file is used to define parameters for the CIMPLICITY Base
System and options that override default parameters in the software.
Some global parameters can be changed through user interfaces in CIMPLICITY
HMI Configuration functions. You should not change these parameters manually.
Some global parameters can only be implemented or changed by editing the Global
Parameters file.
Of the global parameters that you implement manually, some are implemented for all
projects on the computer, and some are implemented for individual projects.
GFK-1180H 36-1
Editing the File
To change a global parameter, select Command Prompt from the Tools menu in
the Workbench for the project where you want to change the parameter, then do the
following:
1. Enter the following commands in the Command Prompt window:
cd <dir>
idtpop glb_parms
notepad glb_parms.idt
where <dir> is the directory where you need to make the changes.
For global parameters that apply to all projects, this will be
%BSM_ROOT%data. For all other global parameters, this will be
%SITE_ROOT%master.
2. Find the parameter you want to change, and make the change.
3. Save the modified file.
4. Exit the Notepad.
5. Type scpop glb_parms. A new binary version of the Global
Parameters file will be produced and put in the master directory.
6. Type exit to exit the Command Prompt window.
When you are ready to implement the change in the run-time system, you will have to
stop the project(s), perform a Configuration Update, and restart the project(s).
Note: the Global Parameters file that is used on a Viewer is located in the
CIMPLICITY installation directory in a subdirectory called data (e.g.,
c:\cimplicity\hni\data).
DBDL_DEVICE_CHECK_PERIOD
Use the Disk full scan rate (min) parameter in the Logging Properties dialog box
in Database Logging to change this parameter.
DOWNLD_PASSWD
Use the Set Point Password input area of the Point Properties dialog box in Point
Configuration to change this parameter.
DT_UPD_INTERVAL
Sets the interval in seconds to update a Projects Date & Time system points.
Record format is:
DT_UPD_INTERVAL|3|<seconds>
If you do not configure this parameter, the default timeout is 10 seconds.
FIRST_WEEK_DAYS
Sets the minimum number of days in a week in the current year required to qualify
for the first week of the year.
Record format is:
FIRST_WEEK_DAYS|3|<days>
If you do not configure this parameter, the default number of days is 1.
GMR_HRTBT_TIMER
Use the Heartbeat Timer field of the TCP/IP Port Properties for a redundant Series
90 TCP/IP port.
GMR_MODE_ADDR
Use the Mode Address field of the TCP/IP Port Properties for a redundant Series
90 TCP/IP port.
PTDL_QUANTIZATION
Use the Point data logging scan rate input area of the Logging Properties dialog
box in Database Logger to change this parameter.
RTR_ACCEPT_CONN
Use the Accept Connections field of the CIMPLICITY Options dialog in the
CIMPLICITY program group to change this parameter.
RTR_DISABLE_BCAST
Use the Enable Project Broadcast field of the Project Properties dialog box in
the Workbench to change this parameter.
SETPOINT_SECURITY
Use the Set Point Security field of the Point Properties dialog box in Point
Configuration to change this parameter.
STARTUP_TIMEOUT
Sets the number of minutes to wait before timing out when starting up a project.
Record format is:
STARTUP_TIMEOUT|3|<minutes>
SYSNAME
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
The parameter contains the project name.
Record format is:
SYSNAME|1|<project_name>
CONNECT_DROP_PERIOD
The time in seconds before an inactive login connection is dropped by the project.
The time starts when all CIMPLICITY application windows have been exited. A
user who opens a CIMPLICITY application window during this time period will not
be required to log in to CIMPLICITY software again.
Record format is:
CONNECT_DROP_PERIOD|3|<period>
The default time in the distributed Global Parameters file is 600 seconds (10
minutes).
CONNECT_RETRY_PERIOD
Time in seconds to retry connection to a remote project.
Record format is:
CONNECT_RETRY_PERIOD|3|<period>
IPC_BCAST_INTERVAL
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
The Router (IPC) System Name Broadcast Period in seconds.
Record format is:
IPC_BCAST_INTERVAL|1|<number>
REDUND_LINK_SLEEP
For Server Redundancy, you can use this parameter to make the Router wait a period
of time before creating the link to the slave node.
Record format is:
REDUND_LINK_SLEEP|3|<number>
RTR_MAX_OUTMESSAGE_COUNT
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
The maximum number of messages buffered by the Router for a Router to Router
link. If the queue overflows, the Router drops new messages. When it drops the first
message, it logs the following error to the Status Log:
Router dropped offnode message to <remote_node_name>
Further dropping of messages to the same node do not result in additional error
messages as long as the remote node stays active.
If the entry does not exist, a default value of 1000 is used.
Record format is:
RTR_MAX_OUTMESSAGE_COUNT|3|<number>
ACK_TOUT
The time in minutes before an alarm is automatically acknowledged by the Alarm
Management Resident Process. If this parameter is defined, it is the default used for
Acknowledge Timeout in the Point and Alarm Alarm Options properties. If this
parameter is not defined, zero is used for the default.
Record format is:
ACK_TOUT|3|<minutes>
The default timeout in the distributed Global Parameters file is 0 (no automatic
timeout).
AMLP_USE_GEN_TIME
For the Alarm Line Printer, when an alarm is acknowledged or deleted, this
parameter determines whether the generation time or the time of the acknowledge or
delete action is printer. If this parameter is not defined, the generation time is printed
by default.
Options are:
Y The generation time is printed.
N The time of the action (acknowledge or delete) is printed
Record format is:
AMLP_USE_GEN_TIME|1|<option>
CE_MAX_DELAY
For the Basic Control Engine, the maximum delay time in seconds after which a late
event will not be executed. For example, events may be delayed when there is a
heavy load on the system. If this parameter is not defined, the default is 60.
Record format is:
CE_MAX_DELAY|3|<time>
CE_MAX_THREADS
For the Basic Control Engine, the maximum number of simultaneous scripts. If this
parameter is not defined, the default is 30.
Record format is:
CE_MAX_THREADS|3|<number>
CE_THREAD_TIMEOUT
For the Basic Control Engine, the idle cache time in seconds before the threads are
freed. If this parameter is not defined, the default is 900 seconds.
Record format is:
CE_THREAD_TIMEOUT|3|<seconds>
The default timeout in the distributed Global Parameters file is 0 (no reset timeout).
DBDL_ABORT_TIMEOUT
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
The delay in ticks before abort drops table in shutdown for the Database Logger
option.
Record format is:
DBDL_ABORT_TIMEOUT|1|<period>
DB_DEBUG
Enables the dumping of diagnostic information for the Database Logger to the
MAC_DL.out and MAC_PTDL.out files in your projects log directory.
Record format is:
DB_DEBUG|1|<value>
DB_QUEUE_OVERFLOW_DELAY
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
The delay in minutes between logging overflow errors for the Database Logger
option.
Record format is:
DB_QUEUE_OVERFLOW_DELAY|1|<period>
DB_TIMESTAMP_PRECISION
For the Database Logger, specifies an alternate timestamp precision for ODBC data
sources that do not accept the default provided by the CIMPLICITY Database
Logger.
Important
Do not configure this option unless instructed to by GE Fanuc support
personnel.
Record format is:
DB_TIMESTAMP_PRECISION|1|<timestamp>
where <timestamp> is the timestamp for your database. The timestamp must be
enclosed in single quotes as shown above. The format is case sensitive.
For more information on this parameter, see the Database Logger documentation.
DEL_OPT
The default requirements for alarm deletion. The options are:
A Acknowledged only
R Reset only
AR Acknowledge and reset
Record format is:
DEL_OPT|1|<option>
EMEP_BUF_SIZE
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
For the Basic Control Engine, defines the communications buffer size. This indicates
the count of pending messages that the Basic Control Engine will hold.
Record format is:
EMEP_BUF_SIZE|3|<value>
GSM_ANNUN_DIG_OFF
The color and blink state to be displayed when a digital point is low for Alarm State
color animation.
Record format is:
GSM_ANNUN_DIG_OFF|1|<color_number><blink>
GSM_ANNUN_ALARM_H2
The color and blink state to be displayed when an analog point is in Alarm High state
for Alarm State color animation.
Record format is:
GSM_ANNUN_ALARM_H2|1|<color_number><blink>
GSM_ANNUN_ALARM_H1
The color and blink state to be displayed when an analog point is in Warning High
state for Alarm State color animation.
Record format is:
GSM_ANNUN_ALARM_H1|1|<color_number><blink>
GSM_ANNUN_ALARM_L1
The color and blink state to be displayed when an analog point is Warning Low state
for Alarm State color animation.
Record format is:
GSM_ANNUN_ALARM_L1|1|<color_number><blink>
GSM_ASC_FONT_NAME
The name of the font to use for text on an ASCII (.ASC) screen. This must be a
TrueType font.
Record format is:
GSM_ASC_FONT_NAME|1|<name>
GSM_ASC_FONT_SIZES
A list of the 16 point sizes to use for the 16 text sizes in an ASCII (.ASC) file (GRE
text sizes 0 to 15, which are stored in the .ASC file as -1 to 14).
Record format is:
GSM_ASC_FONT_SIZES|1|<list>
GSM_ASC_SCALE
A floating-point number that represents the number of document units per world
coordinates when converting ASCII (.ASC) screens to .CIM format.
ASC files store screen information in floating point "world coordinates". The
screens are 100.0 world coordinates wide by 60.0 world coordinates high. Document
units in .CIM files are integers in TWIPS (twentieth of a point, 1440 TWIPS/inch).
Thus, if you want your .ASC screens to be about six inches wide on the display, you
should use a scale factor of (1440 doc. units/inch)*(6 inches/screen)/(100 world
coord./screen) which equals 86.4 doc. units/world coord.
Record format is:
GSM_ASC_SCALE|1|<value>
If this parameter is not defined, the default value is 86.4 doc. units/world coord.
GSM_EXPONENT_PRECISION
If a Text object on a CimView screen has "General" format and the number of digits
exceeds this parameter, then the number is displayed in scientific notation with that
number of significant digits.
For example, if you set GSM_EXPONENT_PRECISION to 3, the number 1234
displays as 1.23e+3.
Record format is:
GSM_EXPONENT_PRECISION|1|<number>
If this parameter is not defined, the default number of digits is 6. That is, if the
number exceeds six digits, it is displayed in scientific notation with 6 significant
digits.
GSM_SPCONFIRM_DEFAULT
Procedure dialog boxes contain two buttons: OK and Cancel. Action dialog boxes
contain three buttons: OK, Skip, and Cancel. The default button for both dialog
boxes is the OK button.
You can use this global parameter to select one of the other buttons to be the default
button in procedure and actin dialog boxes.
Record format is:
GSM_SPCONFIRM_DEFAULT|1|<selection>
where <red>, <green>, and <blue> are the red, green, and blue color indices
from 0 to 255. For example, RGB(0,0,0) is black and RGB(255,255,255) is
white.
If this parameter is not defined, the Text object displays the default text when the
point is unavailable, regardless of whether a last available value exists or not.
GSM_UNAVAIL_COLOR_KEY
Color index number (0 to 255) used to indicate an unavailable point value on
CimView screens.
Record format is:
GSM_UNAVAIL_COLOR_KEY|1|<number>
where <number> is a number from 0 to 255. The color associated with each
number is defined in RGB.DAT.
If this parameter is not defined, the default is 0 (black).
LOGIN_NOSAVE
Disables the "Save Password" capability on the CIMPLICITY Login dialog.
Options are:
Y Disable the "Save Password" capability.
N Enable the "Save Password" capability.
Record format is:
LOGIN_NOSAVE|1|<option>
LOGIN_RETRY_PERIOD
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
Retry period in seconds for connecting to a project whose User Registration program
is down.
Record format is:
LOGIN_RETRY_PERIOD|3|<number>
MAX_STACKED
Use this parameter to define the default maximum number of occurrences of an alarm
that can be stacked in Alarm Viewer.
Record format is:
MAX_STACKED|3|<number>
MAX_TREND_BUF
Use this parameter to change the maximum number of point values a point buffers for
Trending. Point buffering is used when a chart is first displayed and there is some
initial data.
Note
Increasing this parameter will affect system performance.
Record format is:
MAX_TREND_BUF|3|<number>
where:
<num1> controls the amount/detail of diagnostic output. The value ranges from
0 to 9, where 0 means no debugging output, and 9 means the maximum amount
of debugging output.
<num2> is a value for NT operating systems that may handle output files in a
manner that prohibits multiple process access (as sometimes occurs with NT on
DEC Alpha platforms). This value controls approximately how often the output
file will actually be closed/re-opened, in seconds. A value of 0 (zero) means that
this period closing will not occur. Any non-zero value of less than 60 will be
forced to 60.
<num3> provides a number of seconds for an internal timer that rechecks the
parameters in the Global Parameters file. This value cannot be less than zero.
The default value is equivalent to five minutes.
DUMPPOINT initiates a one-shot dump of the Point Bridge internal information
regarding the state of points it is servicing. This parameter is only acted upon
once when any of the other arguments are changed, and the resulting change
leaves LEVEL with a non-zero value.
PROJECT_ID
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
This parameter is used by the Multiple Projects option and contains the one character
Project ID for the project.
Record format is:
PROJECT_ID|1|<name>
PTMRP
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
Defines the default Point Manager to be used for point processing.
Record format is:
PTMRP|1|<number>
RAW_LIMIT_ALARM
Use this parameter to enable or disable the generation of alarms for point values that
are outside their raw limits. The options are:
YES Raw limit alarms are enabled.
NO Raw limit alarms are disabled
Record format is:
RAW_LIMIT_ALARM|1|<number>
REPEAT_TOUT
The time in minutes before an alarm is automatically repeated to all interested
processes by the Alarm Management Resident Process. If this parameter is defined,
it is the default used for Repeat Timeout in the Point and Alarm Alarm Options
properties. If this parameter is not defined, zero is used for the default.
Record format is:
REPEAT_TOUT|3|<minutes>
The default timeout in the distributed Global Parameters file is 0 (alarms are not
repeated).
SVC_RETRY_COUNT
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
Sets the number of retries waiting for an external service to start up.
Record format is:
SVC_RETRY_COUNT|1|<number>
The default retry count in the distributed Global Parameters file is 30.
SVC_RETRY_DELAY
Important
Do not modify this option unless instructed to by GE Fanuc support
personnel.
Sets the delay in ticks between retries waiting for an external service to start up.
Record format is:
SVC_RETRY_DELAY|1|<number>
The default retry delay in the distributed Global Parameters file is 100 ticks.
Where:
<logical_name> is the name of the logical
<type> is the type of logical (usually set to P for project)
<length> is the number of characters in <value>
<value> is the value to be assigned to the logical name.
You may use Notepad to edit the file.
To change a logical name in the Logical Names file for a project, select Command
Prompt from the Tools menu in the Workbench for the project where you want to
change the parameter and do the following:
1. Type cd data.
2. Type notepad log_names.cfg.
3. Find the parameter you want to change, and make the change.
4. Exit the Notepad.
5. Type exit to exit the Command Prompt window.
When you are ready to implement the change in the run-time system, you will have to
stop and restart CIMPLICITY software.
.AMV
.cim
.CLG
.GEF
CFGCab Document
CimEdit
CimEdit.Documents
All file types starting with CIMPLICITY
CimView
CimView.Documents
Default Device Property Sheet
SNPDevice Property Sheet
TCP IP Device Property Sheet
VME Device Property Sheet
CFGCab Document
CimEdit
CimEdit.Documents
All file types starting with CIMPLICITY
CimView
CimView.Documents
Default Device Property Sheet
GE Fanuc CIMPLICITY 7.0 Screen
SNPDevice Property Sheet
TCP IP Device Property Sheet
VME Device Property Sheet
Once a package has been sent to a target site, the package is distributed to servers at
the target site. The SMS Despooler at the target site decompresses the compressed
package file into the package source directorys original files and directory structure,
and places these files on the distribution servers in a subdirectory of the
SMS\LOGON.SRV\PCMPKG.SRC directory. The package source directory is
shared so that the client can have access to the directory.
4. Select Import.
The File Browser dialog box opens.
Login Password
When you configure a User in a CIMPLICITY HMI project, you can:
Select whether the user needs to enter a password in the CIMPLICITY
Login dialog box.
Passwords are stored in an encoded format and are not directly readable
by users.
Set the password to expire after a given number of days.
When the password expires, the user will be required to change the
password on the next login to CIMPLICITY HMI.
Configure a number of consecutive login failures.
When this number is reached, the users account is disabled and a
$LOGIN_FAILURE alarm is generated.
For more information on User Configuration, see that chapter in the CIMPLICITY
HMI for Windows NT and Windows 95 Base System Users Manual (GFK-1180).
Role Privileges
You can assign one Role to each User in a CIMPLICITY HMI project. When you
configure a Role in a CIMPLICITY HMI project, you can grant users assigned the
Role permission to:
Perform setpoints on CimView or Point Control Panel screens.
Enable Dynamic Configuration for functions in the Workbench.
Delete alarms from the Alarm Viewer window.
Access the CIMPLICITY Program Control utility.
Modify alarm setups in the Alarm Viewer window.
Log setpoint events to the Event Log.
Create Point by Address points in CimEdit screens.
Trigger events in the Basic Control Engine User Interface (BCEUI).
Stop, pause or resume scripts in the BCEUI.
For more information on Role Configuration, see that chapter in the CIMPLICITY
HMI for Windows NT and Windows 95 Base System Users Manual (GFK-1180).
Setpoint Password
By default, run-time users have unrestricted access to the setpoint functions used by
CIMPLICITY HMI software. If you enable the Setpoint Password option and enter a
password, run-time users will be prompted for this password whenever they invoke a
setpoint function.
Setpoint functions include:
Setpoint entries from the Point Control Panel.
Absolute, Ramp, Relative, Toggle and Variable setpoint actions on
CimView screens.
If you include Setpoint functions in Basic Control Engine scripts, and you enable the
Setpoint Password option, you must include the password in the function call.
For more information on Point Configuration, see that chapter in the CIMPLICITY
HMI for Windows NT and Windows 95 Base System Users Manual (GFK-1180).
The $ALARM_MODIFIED alarm is generated when a user modifies the alarm limits
for a point. The alarm message contains the following information:
Alarm limits modified for: <point_id> by <user_id>
(<OS_user> @ <computer_name>)
The alarm records the entity type being changed, the entity name being changed, the
CIMPICITY login user name of the user and the computer login user name of the
user.
Project Login/Logout
The $LOGIN_FAILURE alarm is generated when a user fails to log in to a
CIMPLICITY HMI project correctly and the number of consecutive login errors has
been reached. The alarm message contains the following information:
User ID <user_id> disabled, computer <computer_name>
The $LOGOUT alarm is generated when a user logs out of a CIMPLICITY HMI
project. The alarm message contains the following information:
User ID <user_id> @ <computer_name> logged out
Select Cancel to exit OEM Key without stopping the running projects.
Select Stop CIMPLICITY HMI to terminate your running projects.
When the Next> button activates, select it to continue activating OEM Key. The
CIMPLICITY HMI OEM Key dialog box opens.
You can leave the dialog box open or minimize it while OEM Key is running.
You can select the Show status window check box to display the time left. This
status window displays on top of all the windows on your screen.
If you exit the dialog box or select Quit, the OEM Key terminates immediately.
Enter the name of the remote project in the Project Name field and select OK. The
Remote Project dialog box opens. This dialog box consists of two pages.
Use the General page to enter general information about the project.
Use the Enterprise page to configure data and alarm collection for an
enterprise project.
When you are through, select OK to save the information, or select Cancel to close
the dialog box without making any changes.
If you want to use your current project as an Enterprise Server, you must define a
remote project for each project in your enterprise from when you want to concentrate
data or alarm information.
In the Enterprise property page, the Resource and Device are pre-configured.
Users that want to view point and alarm information from a remote project on an
Enterprise Server must have the remote projects Resource configured in their view.
Enter the following information:
Collect points Set this check box to collect point information from the
provider project. All points on the remote project that have
been configured as Enterprise Points are available to the current
project.
Points from remote projects are identified by Remote ID and
Point ID as \\<remote_id>\<point_id> for CimView
and Point Control Panel windows.
Collect alarms Set this check box to collect alarm information from the
provider project.
Only one level of concentration is supported. In other words, if you are connecting
to a remote project that has local and concentrated points, you will only be able to
collect local points from the remote project.
GFK-1180H 37-1
About the Examples in this Document
The example in this document uses the following:
A Server computer, named ALNT32, with:
Microsoft Windows NT V4.0
CIMPLICITY HMI Server software
Modem
Ethernet IP address of 3.26.5.134
Two consecutive IP addresses - 3.26.5.143 and 3.26.5.144 - to be
used for the Remote Access Service configuration.
A Client computer, named ALW085, with:
Microsoft Windows 98/95
CIMPLICITY HMI Viewer software
Modem
Pictorially, the configuration looks like this:
For the Server, the minimum selection for Port Usage is Receive
calls only.
Select the port usage you want for the modem.
Click OK to return to the Remote Access Setup dialog box.
2. Click Network. The Network Configuration dialog box opens.
Make sure that NetBEUI and TCP/IP are selected for Server
Settings.
For the Client, the minimum selection for Port Usage is Dial out
only
Select the port usage you want for the modem.
Click OK to return to the Remote Access Setup dialog box.
2. Click Network. The Network Configuration dialog box opens.
Make sure that NetBEUI and TCP/IP are selected for Dial out
Protocols.
Note
If you selected Dial out and Receive calls in the Configure Port Usage dialog
box, make sure that NetBEUI and TCP/IP are also selected for Server Settings.
You will also need to configure the NetBEUI and TCP/IP configurations.
3. Click OK to close the Network Configuration dialog box and return to
the Remote Access Setup dialog box.
4. In the Remote Access Setup dialog box, click Continue... to return to
the Network dialog box.
5. Click OK to close the Network dialog box. The system will finish
configuring the Remote Access Server and reboot the computer.
Ping
After dialing in to the Server from the Client and establishing the connection, you
should be able to perform the following tests successfully.
Client Tests
You should be able to ping the Server computer by address from the Client computer.
For example:
C:\WINDOWS>ping 3.26.5.134
C:\WINDOWS>
C:\WINDOWS>
Networking Considerations
If the IP addresses used by the RAS server are for a different network than the one
for the server on which the CIMPLICITY HMI project is running, you may need to
establish routes from the CIMPLICITY HMI project computer to the RAS link
network. You can use the Windows NT route.exe program to do this. For more
information on using the Windows NT route.exe command, refer to the Windows
NT Command Reference section of the Windows NT Help file (WINHLP32.EXE).
You can create Web documents containing textual CIMPLICITY HMI data values.
Users accessing these documents can view data and perform setpoints. The security
features of CIMPLICITY HMI restrict access to data and to the setpoint capabilities
of Internet connections as they do with standard multi-user systems.
GFK-1180H 38-1
Web Server Requirements
Your Web Server computer must be an Intel Pentium PC and must have the
following installed:
Microsoft Windows NT Server operating system, version 4.0 or later
Microsoft Internet Information Server (IIS), version 3.0 or later
Microsoft Internet Explorer, version 4.0 or later; or Netscape
Navigator, version 4.04 or later
We strongly recommend that you install and configure the Microsoft Internet
Information Server before you install the CIMPLICITY HMI WebGateway.
Installation Procedure
To install the CIMPLICITY HMI WebGateway on your Web Server:
1. Shut down all active processes before starting.
2. Insert the CIMPLICITY HMI CD in your CD-ROM drive.
If you have AutoPlay configured, the CIMPLICITY HMI Installation
Setup screen opens automatically. When you are asked if you want to
continue or cancel the installation, select Cancel.
3. Open the Windows NT Explorer.
4. Open the main folder for the CD-ROM.
5. Double-click the websetup icon in the main CD-ROM folder. The
Setup screen for the CIMPLICITY HMI WebGateway installation
opens with the Welcome dialog box.
6. Select Next to continue. The Software Evaluation License Agreement
dialog box opens.
7. Select Yes to accept the terms and conditions of the software license.
The Choose Destination Location dialog box opens.
8. Select the directory where you want to install the CIMPLICITY HMI
WebGateway (IIS) software. You should accept the default directory.
Select Next.
9. If you have not installed CIMPLICITY HMI software, you will be
asked where you want to install your CIMPLICITY HMI Viewer
software.
10. In the Choose Program Group dialog box, select the program group for
the CIMPLICITY HMI WebGateway software, and then select Next.
The software begins to load.
When installation is complete, you are given an opportunity to register your
CIMPLICITY HMI WebGateway software.
For CIMPLICITY HMI WebGateway software to function correctly, you will need to
reboot your computer. The last dialog box gives you the opportunity to reboot your
computer immediately.
Project Setup
Before the WebGateway can communicate with a CIMPLICITY HMI project in your
enterprise, you must configure the project to permit access by the WebGateway. To
do this:
1. Open the projects Configuration cabinet.
2. Double-click on the Client icon.
3. Create a new client.
4. In the New Client dialog box, enter the name of the computer running
the Web Server, then select OK.
5. In the Client Properties dialog box,
Select a default User ID that will give the WebGateway appropriate
access to the project.
Set the Trusted check box.
Select OK.
Error Messages
The first part of the error string contains one of the following error codes.
#ERROR!ARRAYNOTALLOWED
This error is returned if you try to use an element of an array point with the PointSet
method.
#ERROR!ARRAYOUTOFBOUNDS
This error usually indicates that the index specified for an array point was not valid.
It will also be returned if you specify an index for a non-array point or if you fail to
specify an index for an array point. In some cases, additional information will be
available following this message.
#ERROR!BADSERVERRESPONSE
This error is returned if the CimData applet could not parse the response from the
CimGate extension. Examining the value of the DiagRawResponse property will
reveal the cause of the error.
#ERROR!CIMPLICITYNOTRUNNING
This error indicates that the CIMPLICITY HMI Viewer could not be started by the
CimGate extension.
#ERROR!NOTIMPLEMENTED
This error is returned by CimGate server when the PointMonitor method (which is
not implemented) is called.
#ERROR!NOTLICENSED
This error is returned when the CIMPLICITY HMI WebGateway is not licensed.
The CIMPLICITY HMI Gateway must be licensed to use it beyond the trial period.
Run the CIMPLICITY HMI Registration program.
#ERROR!POINTIDSYNTAX
This error is returned when the string passed to PointGet or PointSet could not be
properly parsed as a point ID.
#ERROR!POINTUNAVAILABLE
This error is returned when the point may be unavailable for any number of reasons.
Generally, there will be additional information following this message indicating why
the point is unavailable. You may also want to look at the CIMPLICITY HMI Status
Log on the Web Server computer to help understand why the point is unavailable.
#ERROR!SERVERNEEDSRESTART
This error indicates a condition in the CimGate server that requires the Web Server to
be restarted. Typically this occurs when the CIMPLICITY HMI Viewer (or project)
on the Web Server computer is shut down.
#ERROR!URLEXCEPTION
This error indicates a problem with the URL constructed from the Web Server name,
point IDs, and values supplied. One such problem might be that the Web Server
specified is not the same as the host from which the Java data applet was loaded,
which is a security requirement imposed by many web browsers.
setCaption (Method)
Syntax setCaption(String capString)
Description Places a specified string in the applets text area.
Parameters capString the string to display
Comments The caption is useful to display while testing pages.
Example Using JavaScript:
document.MyApplet.setCaption("Paint Shop Data")
getCaption (Method)
Syntax String getCaption()
Description Retrieves a string from the applet's text area.
Return Value The current contents of the applets caption text area.
Comments The raw input and output are displayed in the appets text area, and can be retrieved for diagnostic
purposes using this method.
Example Using JavaScript:
myText = document.MyApplet.getCaption()
appendCaption (Method)
Syntax appendCaption(String capString)
Description Adds a specified string to the end of the text in the applet's text area.
Parameters capString the string to display
Comments The caption is useful to display while testing pages. This method adds informative text without
removing any existing caption information.
Example Using JavaScript:
document.MyApplet.appendCaption("Paint Shop Data")
pointGet (Method)
Syntax pointGet(String cimGate) [buffered form]
document.MyApplet.clearPoints();
document.MyApplet.setPointID(0, \\\\proj\\temp)
document.MyApplet.setPointID(1, \\\\proj\\speed)
document.MyApplet.pointGet("mycomputer/Scripts")
if (getPointStatus(0) = E) {
alert Error: + document.MyApplet.getPointValue(0);
}
else {
document.MyForm.temp.value = document.MyApplet.getPointValue(0);
}
if (getPointStatus(1) = E) {
alert Error: + document.MyApplet.getPointValue(1);
}
else {
document.MyForm.speed.value = document.MyApplet.getPointValue(1);
}
pointSet (Method)
Syntax String pointSet(String cimGate, String pointID, String pointValue)
Description Sets the specified CIMPLICITY point to the specified value.
Parameters Parameter Description
cimGate A String containing the location of the CimGate extension. The format of this
string is "computer/directory". For example, mycomputer/Scripts.
pointID A String containing the Point ID.
pointValue The String representation of the value to be assigned.
Return Value The point status string generated by the operation.
Comments Since the CimGate extension only supports setting one point at a time, only a single-point form of
this method is required. Note that this method clears any proir content of the applets internal storage
before proceeding. See pointGet for error reporting information.
See Also pointGet
clearPoints (Method)
Syntax clearPoints()
Description Empties the applets internal point ID and value storage.
Comments The WebGateway Data Applets internal storage holds point IDs and values, allowing you to specify
more than one point before invoking a transaction with the WebGateway. Making one server
request for multiple values is generally more efficient than retrieving values with separate
transactions. Use this method to clear the applets storage before specifying point IDs to retrieve.
See Also setPointID, getPointID, setPointValue, getPointValue
setPointID (Method)
Syntax setPointID(int pointIndex, String pointID)
Description Stores a point ID for subsequent transaction(s).
Parameters Parameter Description
pointIndex the zero-based integer storage index at which to store the point ID
pointID the point ID to place in the applets internal storage
Comments Call this method repeatedly, with consecutive integer indices for each point ID, to load the applets
internal storage before making a transaction.
See Also pointGet
getPointStatus (Method)
Syntax String getPointStatus(int pointIndex)
Description Use this method to retrieves a status string from the applets internal storage after a transaction. The
status string for a point requested, referred to by pointIndex, contains E if the transaction was
unsuccessful for that point. See pointGet for more details.
Parameters Parameter Description
pointIndex the zero-based integer storage index of the point status string to retrieve
Return Value The status string corresponding to the supplied index.
See Also pointGet
.
The Registration Instructions dialog box opens.
4. Click Transfer Authorization.
5. Select Next to continue with registration.
GFK-1180H A-1
You may transfer CIMPLICITY HMI software licenses to another computer without
contacting GE Fanuc for a new System Authorization Code. The Registration program
provides utilities that let you transfer your system licenses, key code, and authorization codes
to another computer via diskette. If you are running Microsoft Windows NT on both
computers, you may transfer the licenses over the network
Important: You must transfer the entire registration (all licenses). Once you complete the
transfer, your source computer becomes an unauthorized system. If you wish to continue to
run fully functional CIMPLICITY software on the source computer, contact your distributor to
purchase additional licenses.
.
E. Proceed to the CIMPLICITY Registration Transfer dialog box.
F. Select Transfer via Network.
The Open dialog box opens.
G. Select the Cim.exe file from the WINNT40 directory,
H. Select OK.
When Registration completes, the target system is registered to run CIMPLICITY HMI
software, and the source system is no longer registered.
.
The Registration Instructions dialog box opens.
5. Proceed to the Registration Transfer Using Floppy Diskette dialog box.
5. Insert a formatted diskette into the floppy drive.
6. Select Register the Diskette in the Registration Transfer Using Floppy Diskette
dialog box
6. Select Next.
7. Remove the diskette from the target computer.
Continue on the source computer (the one that is authorized).
8. Insert the diskette into the floppy drive.
9. Run the Registration program.
10. Proceed to the Registration Transfer Using Floppy Diskette dialog box.
11. Select Authorize the Diskette in the CIMPLICITY Registration Transfer Using
Floppy Diskette dialog box.
12. Select Next.
13. Remove the diskette from the source computer.
Remember, at this point in the procedure, CIMPLICITY HMI software is no longer
registered on the source computer.
Continue on the target computer:
14. Insert the diskette in the floppy drive.
15. Run the Registration program.
16. Proceed to the Registration Transfer Using Floppy Diskette dialog box.
17. Select Authorize the system from the Authorized diskette.
18. Select Next.
When the utility completes, the target computer is registered to run CIMPLICITY
HMI software.
Important: You can only create distributions for the platform you are on. For example, if
you are on an Intel PC, you can only create Intel distributions.
Before you start, make sure that you have enough pre-formatted diskettes to create the
distribution. To find out how many you need:
1. Insert the CIMPLICITY HMI Distribution CD in its drive.
2. Use the File Manager to locate the I386 (if you are on an Intel PC) or ALPHA (if
you are on a DEC Alpha PC).
3. You will see a number of files named DISKn.ID. The number of files equals the
number of diskettes you will need to create the release (for example, if you see
DISK1.ID through DISK17.ID, you will need 17 diskettes for your floppy
distribution).
Note: If you think a diskette is not in the correct sequence, you can verify its order by
displaying the diskette contents in the File Manager. You should find a file named DISK<n>
where <n> is the sequence number of the diskette.
Note: Before you remove CIMPLICITY HMI software from your computer, you should save
any projects that you dont want to lose. You can save them on diskette, or in a non-
CIMPLICITY directory.
GFK-1180H B-1
Using the Status Log Viewer
To display a Status Log, you can do one of the following:
Select the Status Log icon from the CIMPLICITY HMI menu.
In a project cabinet, select Status Log from the Tools menu.
In a project cabinet, press Ctrl+L.
The CIMPLICITY Log Viewer window opens.
Remember that the Status Log file that is displayed depends on whether you initiated
the CIMPLICITY Log Viewer from a project or the CIMPLICITY HMI main menu.
The CIMPLICITY Log Viewer screen displays the following information for each
record that it finds in the status log file:
Date/Time The date and time the message was logged.
Status The type of message. This can be "Failure", "Warning" or
"Success".
Process The name of the process that generated the log message.
Procedure The name of the procedure that generated the log message.
Source A symbolic name for the error class.
Code The primary value used by software for expressing the type of error.
Reference A number (shown as a decimal integer) that can be used to
determine the location of the condition that caused the error.
Message An explanation of the condition that caused the log message.
Each entry in the list is preceded by a color-coded dot that corresponds to the Status
field entry. The correlations are:
Red - Failure
Yellow - Warning
Green - Success
The Status Log Viewer can display CIMPLICITY HMI Status Log files of type
.CLG. You can search the directory structure on any drive you are connected to for
log files.
The default Status Log file name is COR_RECSTAT.CLG. Status Log files are
generally found in the log file for your main CIMPLICITY HMI log directory, and in
each of your projects log directories.
To display a log file:
1. Locate the file in your CIMPLICITY HMI main log directory or a
project log directory.
2. Click OK.
3. The dialog box closes, and the file you selected is displayed in the
CIMPLICITY Log Viewer window.
To create a text file, select a pathname and file name for the text file and click OK.
The first line of the text file shows the computer name and the full path name for the
Status Log file.
For example, if you are searching Down and you are already at the end of the
message list, when you activate the search, you will not be asked if you wish to
continue from the beginning of the list.
To close the dialog box without finding a message, click Cancel.
To clear the filters, click Clear, and then click OK.
GFK-1180H i
/ Client configuration 25-1
Database logger 23-1
/alwaysmaximized Database logging, Managing 24-1
CimView command line option 31-17 Devices 12-1
/geometry Measurement units 35-1
CimView command line option 31-18 Microsoft System Management Server 36-28
/keypad Point control panel 32-1
CimView command line option 31-18 Ports 14-1
/LoadScript RAS 37-1
CimView command line option 31-18 Resources 13-1
/noconfig Roles 21-1
Alarm viewer command line options 30-37 Security features 36-36
/noexit Stand-alone alarm viewer 30-1
CimView command line option 31-19 System Utilities 34-1
/nomenutitle WebGateway 38-1
CimView command line option 31-19 About Alarm Strings 16-1
/noopen About CimView 31-1
Alarm viewer command line options 30-37 About System management 36-1
CimView command line option 31-19 About the CIMPLICITY To Windows Server 33-1
/noresize About Users 22-1
CimView command line option 31-19 AboutBox
/project <name> Alarm viewer method 29-3
CimView command line option 31-20 Absolute Alarming 8-18
/wait 31-20 Access
/waitforproject Runtime monitoring 2-28
CimView command line option 31-20 ACCESS 27-15
/zoomtobestfit Access to Manual Mode 6-33
CimView command line option 31-20 ACCESS_FILTER 27-15
ACK_TIMEOUT 27-15
{ ACK_TOUT 36-7
Acknowledgement
{Procedure
Automatic for alarms 8-27
Quick enable of a protocol for a project 5-2
Acknowledging all alarms
Alarm viewer 30-27
3 AMV OCX 28-27
Acknowledging an alarm
3D_BCD 6-4
Alarm viewer 30-26
AMV OCX 28-25
4 Acknowledging and resetting an alarm
Alarm viewer 30-27
4D_BCD
AMV OCX 28-26
Device point 6-4
Acknowledging the first alarm
Alarm viewer 30-27
A AMV OCX 28-27
About Action Object Selected With the Mouse 31-12
Alarm audio support 18-1 Actions
Alarm blocking 19-1 Device properties, CIMPLICITY HMI and Control
Alarm printer configuration 20-1 26-4
Alarm sound manager 18-5 Activate
Alarms 17-1 Dynamic configuration 23-18
AMV OCX 28-1 Dynamic configuration 2-23
AMV OCX methods 29-1 Active Measurement System
CIMPLICITY HMI and Control 26-1 About 35-11
CIMPLICITY HMI log files B-1 Defining in Measurement Units 35-11
Defining in Project Properties 35-12
GFK-1180H Index v
AMLP_MAX_QUEUE 20-11 Arithmetic
AMLP_USE_GEN_TIME 20-12, 36-8 Operators for expressions 7-41
AMSI_ALARM 17-3 Array
AMV OCX Limits for device points 6-7
About 28-1 Array Point Example - CWSERV 33-11
Acknowledging all alarms 28-27 Arrays 6-6
Acknowledging an alarm 28-25 And histogram points 7-30
Acknowledging and resetting an alarm 28-26 Device arrays in CimEdit 6-6
Acknowledging the first alarm 28-27 Device arrays in CimView 6-6
Adding alarm comments 28-25 Device arrays in database logger 6-6
Alarm setups 28-28 Using for device points 6-6
Buttons properties 28-7 Using for virtual points 7-5
Changing setup parameters 28-23 Virtual arrays in Alarm Viewer 7-5
Colors properties 28-19 Virtual arrays in CimView 7-5
Configuration overview 28-1 Virtual arrays in Database Logger 7-5
Configuring 28-3 Virtual arrays in kCimEdit 7-5
Configuring control properties 28-4 Associate
Count layout properties 28-15 CimView screen with a point 8-2
Creating a new alarm setup 28-33 Associating folders with devices
Creating custom buttons 28-20 CIMPLICITY HMI and Control 26-5
Creating custom buttons, Example 28-21 Association, Creating new
Date format properties 28-16 CIMPLICITY HMI and Control 26-5
Deleting alarm comments 28-25 Association, Deleting
Deleting an alarm 28-26 CIMPLICITY HMI and Control 26-6
Displaying user help 28-23 Association, Editing
Dynamic mode, About 28-2 CIMPLICITY HMI and Control 26-6
Fields properties 28-5 Automatic
Fonts properties 28-18 Reset for an alarm 8-28
Projects properties 28-10 Automatic Actions
Refreshing the alarm list 28-23 For alarms 8-26
Run-time overview 28-2 Availability Triggers
Selecting alarms from the list 28-22 For device points 6-16
Sort/display properties 28-11 For virtual points 7-12
Static mode, About 28-2 Average Points 7-22
Toggling between lists 28-23
Using the alarm list buttons 28-23 B
Viewing alarm comments 28-24
Viewing the alarm list 28-22 Base Engineering Units
Viewing the alarm stack 28-24 For a device point 6-27
AMV OCX methods For a virtual point 7-36
About 29-1 Base Rate
Configuring 29-2 And scan rate 6-20
AMV OCXViewing the alarms CimView screen 28-25 Basic
Analog Alarm limits 8-10
Virtual point initialization 7-6 Device custom addressing 6-8
Analog Deadband 6-20 Device point configuration 6-3
ANALOG_DEADBAND 27-19 Virtual point configuration 7-3
appendCaption (Method) Basic Control Engine
WebGateway, Web data applet 38-8, 38-10 Guideline for measurement units 35-18
Application logging Beep configuration
Overview 23-4 Alarm audio support 18-4
Application source directory, Creating Before you start
Site wide installation 36-31 RAS 37-3
Arithemtic Begin
Operators and custom conversion 6-31 Point cross reference 11-2
GFK-1180H Index ix
Configuring the count layout Creating a document shortcut
Alarm viewer 30-5 Alarm viewer 30-35
Connect Creating A New Alarm Definition 17-6
Quick device connect for a project 5-3 Creating a new alarm setup
Connect information AMV OCX 28-33
Database logger, Logging properties 23-33 Creating A New Alarm String 16-3
Database logger, Properties 23-43 Creating a new client 25-2
CONNECT_DROP_PERIOD 36-5 Creating a new device 12-3
CONNECT_RETRY_PERIOD 36-5 Creating a New Project 3-1
Connecting to a computer Options 3-1
CIMPLICITY options 3-13 Creating A New Remote Project 36-45
Contacting your distributor 1-1 Creating a new setup
Control Menu Alarm viewer 30-33
CimView 31-7 Creating a new table
Control properties Database logger, from point configuration 23-12
Actions 26-4 Creating a new user 22-4
Common point properties 26-4 Creating a resource 13-3
Device properties, CIMPLICITY HMI and Creating a shortcut, From file manager
Control 26-2 Alarm viewer 30-36
Import options 26-3 Creating a shortcut, While viewing document
CONV_LIM_HIGH 27-21 Alarm viewer 30-35
CONV_LIM_LOW 27-21 Creating a table
CONV_TYPE 27-22 Database logger 23-19
Conversion Creating an Invoke Method action 29-2
Custom for a device point 6-31 Creating custom buttons
Custom for a virtual point 7-36 Alarm viewer 30-20
Device points 6-26 AMV OCX 28-20
Linear for a device point 6-31 AMV OCX, Example 28-21
Linear for a virtual point 7-36 Creating custom buttons, Example
Operators for expressions 7-43 Alarm viewer 30-21
Tab for device points 6-26 Creating tables
Tab for virtual points 7-36 Database logger 23-5, 24-11
Converted values Database logger, Column definitions 23-6, 24-11
Linear device point conversion 6-30 Database logger, Key definitions 23-7, 24-12
Copying A Project to Diskette 3-25 Critera
Copying a table For an alarm 8-17
Database logger 23-36 Criteria
Copying alarms Update for a device point 6-9
Alarm viewer 30-34 CSV file format 27-2
Count layout properties Custom Conversion for a device point 6-31
AMV OCX 28-15 Custom Conversion for a virtual point 7-36
Create Custom HTML pages, Troubleshooting
Floppy disk distribution A-5 WebGateway 38-6
Floppy Disk Distribution A-4 Customer support 1-2
New device point 6-2 Customize
New project 2-14 Workbench point list 9-1
New record or file 2-25 CWSERV
New virtual point 7-2 Command Syntax 33-1
Replacement Floppy A-4 Command syntax for System topic 33-12
Creating Creating a DDE Share 33-14
Alarm block group 19-5 Displaying Point Data 33-6
Alarm class 15-3 Error Messages 33-14
Port 14-3 Formats command syntax 33-12
Role 21-3 Help command syntax 33-13
Creating a DDE Share 33-14 Icon 33-7
GFK-1180H Index xi
Data point, Combining triggers 23-52 Group point, Array attributes 23-51
Data point, Data tiggered logging 23-52 Group point, Point attributes 23-50
Data point, Point properties 23-51 Group point, Point properties 23-50
Data report 23-62 Help menu, Main window 23-15
Data report, Clearing error log 23-64 Help menu, Table window 23-47
Data report, Generating 23-64 Install Microsoft Excel from Excel CD 23-56
Data report, Setting parameters 23-63 Install Microsoft Excel from Microsoft Office for
Database disconnect recover, Enabling store and Windows 95 CD 23-57
forward 24-14 Install sample reports 23-58
Database disconnect recover, Reconnect Logging attributes for alarm event and application
wait period 24-13 tables 23-25
Database disconnect recover, Store and forward 24-13 Logging attributes, Group and data tables 23-26
Database disconnect recover, Store and forward - Logging attributes, Point attributes to be logged 23-26
changing defaults 24-15 Logging attributes, Table attributes to be
Database disconnect recover, Store and forward - logged 23-25, 23-27
maximum records 24-15 Logging conditions, Alarm triggered logging 23-23
Database disconnect recover, Store and forward Logging conditions, Data triggered logging 23-23
filenames 24-14 Logging conditions, Group and data tables 23-22
Database disconnect recovery 24-13 Logging conditions, Modify logging conditions 23-21
Default logging conditions, Alarm log table 23-21 Logging conditions, Timed/gated logging 23-24
Deleting a table 23-37 Logging properties, All tables 23-33
Displaying a table 23-45 Logging properties, Connect information 23-33
Edit menu, Main window 23-14 Logging properties, Store and forward 23-34
Edit menu, Table window 23-46 Maintenace actions, All tables 23-31
Entering from point configuration Maintenance actions, Command actions 23-32
Alarm logging 23-10 Maintenance actions, Export actions 23-31
Table Browser 23-11 Maintenance actions, Purge actions 23-32
Entering from point configuration, Adding the point to Maintenance events, All tables 23-27
a logging table 23-9 Maintenance events, Timed/gated maintenance
Entering from point configuration, Creating a new events 23-28
table 23-12 Maintenance events, Triggered maintenance
Entering from point configuration, Displaying a table events 23-28
list 23-11 Microsoft Access note 23-5
Entering from point configuration, Logging an Notes on installing Microsoft Excel 23-56
alarm 23-10 ODBC configuration 24-2
Entering from point configuration, Modifying the ODBC configuration, Custom data sources 24-3
logging properties for the point 23-9 ODBC configuration, Data sources 24-2
Entering from point configuration, Modifying the ODBC configuration, Drivers 24-2
properties of a table 23-12 ODBC configuration, Microsoft Access data
Entering from point configuration, Point logging sources 24-4
dialog box 23-8 ODBC configuration, Moving projects 24-3
Entering from point configuration, Removing the ODBC configuration, Remote SQL Server data
point from all logging tables 23-9 sources 24-6, 24-7
Entering from point configuration, Removing the ODBC configuration, SQL Server client utilities,
point from one or more logging tables 23-9 Installing 24-6
Event list, Filtering 23-55 ODBC configuration, SQL Server configuration 24-5
Event logging, Overview 23-3 ODBC configuration, SQL Server data source
File menu, Main window 23-14 configuration 24-6
File menu, Table window 23-46 ODBC configuration, SQL Server installation 24-4
Global parameters Oracle configuration 24-8
DB_DEBUG 24-17 Oracle requirements 24-8
DB_ENABLE_TRANSACTIONS 24-18 Point list, Filtering 23-55
DB_TIME_FORMAT 24-18 Point logging properties, Editing 23-49
Global parameters 24-16 Properties 23-40
Group logging, Overview 23-4 Properties, Alarm and point logging 23-42
GFK-1180H Index xv
WebGateway, #ERROR!POINTIDSYNTAX 38-7 Select in right pane 2-11
WebGateway, Field Chooser
#ERROR!POINTUNAVAILABLE 38-7 Open dialog box 2-11
WebGateway, Fields
#ERROR!SERVERNEEDSRESTART 38-7 Definitions for fields displayed in the Workbench 9-7
WebGateway, #ERROR!URLEXCEPTION 38-7 To display in the Workbench 9-5
Error Messages 33-14 Fields properties
EU AMV OCX 28-5
And linear conversion 6-30 File
EU_LABEL 33-5 Create new 2-25
Event list, Filtering Find 2-10
Database logger 23-55 Finding its name 2-9
Event logging Select for display 2-7
Overview 23-3 Select to edit 2-26
Event Manager File menu
Guideline for measurement units 35-18 Alarm viewer 30-3
In point cross reference 11-1 Login panel 34-11
Example, About File Menu
RAS 37-2 CimView 31-4
Example, Remote configuration Filtering alarms See Alarm setups under Alarm viewer.
CIMPLICITY HMI and Control 26-11 See Alarm setups
Examples, Adding a project Filtering status log messages B-11
Alarm sound manager 18-8 Filtering the table list
Examples, Prioritizing alarms Database logger 23-35
Alarm audio support 18-2 Find
Executing Actions A file 2-10
Object selected with the mouse 31-12 A record or file 2-8
Executing Setpoints Name of file or record 2-9
In-place edit 31-13 Finding status log messages B-12
Object Selected with keyboard 31-13 Finding the next status log message B-13
Object Selected With Mouse 31-12 First Converted Value
Executing Slider Setpoints 31-12 And linear conversion 6-30
Exiting program control 34-22 Fixed
Expand Width for an analog point 8-4
Left pane view 2-5 Floating A Toolbar
Explorer CimView 31-9
Use to find a file 2-10 Floating Point Vs. Integer
Export actions Guideline for measurement units 35-13
Database logger, Maintenance actions 23-31 Floppy Disk
Export procedure Distribution A-5
Import/Export 27-10 Installation A-4
Exporting configuration data 27-10 Installations A-4
Expression Replacement A-4
And timer/counter points 7-29 Floppy Diskette
Editor 7-39 Using to install CIMPLICITY A-5
For equation w/override points calculation 7-32 Flush
Rules for defining for an equation point 7-16 Alarms printed on network printer 20-11
Folder
F Expand in left pane 2-5
Fonts properties
Failures 6-11 AMV OCX 28-18
Field Formats - CWSERV System Topic 33-12
Chooser 2-11 Forward
Need update 2-21 Custom device point conversion 6-31
Select for display 2-13 Functions