WebCTRL v5 5 User Manual PDF
WebCTRL v5 5 User Manual PDF
WebCTRL v5 5 User Manual PDF
5
User Manual
Rev. 5/4/2012
Verify that you have the most current version of this document. Go to http://accounts.automatedlogic.com, then select Support >
Download > Documents > Manuals.
Contents
Chapter 1 What's new in v5.5 .................................................................................................. 7
What's new in the WebCTRL® application .................................................................... 7
What's new in the EIKON® LogicBuilder application ................................................... 11
What's new in the SiteBuilder application ................................................................... 13
What's new in the ViewBuilder application .................................................................. 15
What's new–Other tools ............................................................................................. 16
Chapter 2 What is a WebCTRL® system? ................................................................................ 17
A typical WebCTRL® system ....................................................................................... 18
WebCTRL® editions ................................................................................................... 19
WebCTRL® tools ........................................................................................................ 20
Chapter 3 Getting to know the interface .................................................................................. 23
Navigating the system ................................................................................................ 24
Tree icons and hover text ............................................................................................ 25
To show/hide the navigation pane .............................................................................. 26
Zooming and resizing in the action pane ..................................................................... 26
Using right-click menus .............................................................................................. 26
To print the action pane .............................................................................................. 26
Colors and status in the WebCTRL® interface ............................................................. 27
Colors and setpoints .................................................................................................. 27
Chapter 4 Running WebCTRL® Server .................................................................................... 29
To run a system .......................................................................................................... 29
To set up a computer and browser to view the WebCTRL® interface ............................. 29
To run without connecting to the controllers ................................................................ 31
To switch to a different system .................................................................................... 31
To send a message to logged in operators ................................................................... 32
To log off an operator.................................................................................................. 32
To shut down a system ................................................................................................ 32
Chapter 5 Working with equipment ......................................................................................... 33
Graphics pages .......................................................................................................... 35
To attach a graphic in the WebCTRL® interface ............................................ 35
To edit a graphic on a WebCTRL® client ....................................................... 36
To organize multiple graphics for a tree item ................................................ 37
To control equipment using an interactive zone sensor ................................. 38
Properties pages ........................................................................................................ 39
To view or edit properties ............................................................................. 39
Point types .................................................................................................. 40
Logic pages................................................................................................................ 42
To view a Logic page .................................................................................... 42
To locate a microblock, section, or label....................................................... 42
To change properties, alarms, or trends........................................................ 42
Using a Logic page to troubleshoot .............................................................. 43
Changing multiple microblock properties .................................................................... 44
To use Global Modify ................................................................................... 44
To use Global Copy ...................................................................................... 45
Downloading to controllers ......................................................................................... 46
Download Options ....................................................................................... 47
To download from the Downloads page ........................................................ 47
To download from a Properties page ............................................................ 48
If a controller fails to download .................................................................... 48
© 2012 Automated Logic Corporation. All rights reserved throughout the world. Automated Logic, WebCTRL, EIKON, and BACview are
registered trademarks, and EnergyReports, Environmental Index, and Eco-Screen are trademarks of Automated Logic Corporation.
BACnet is a registered trademark of ASHRAE. All other brand and product names are trademarked by their respective companies.
Checking controller status .......................................................................................... 49
Status messages ......................................................................................... 49
To resolve a mismatch ................................................................................. 51
Setpoints ................................................................................................................... 52
To change programmed setpoints ................................................................ 52
Optimal Start .............................................................................................. 52
Demand Control .......................................................................................... 55
Setpoint Optimization ................................................................................. 56
Chapter 6 Schedules............................................................................................................. 57
To view schedules ....................................................................................................... 58
Setting up schedules .................................................................................................. 58
To apply a schedule to equipment ................................................................ 58
To apply a schedule to a group of items ........................................................ 59
To edit or delete a schedule ......................................................................... 61
Effective Schedules ..................................................................................... 61
Using schedule categories .......................................................................................... 63
Creating a custom schedule category ........................................................... 63
To add a custom schedule category in the WebCTRL® interface.................... 64
To view, edit, or delete a schedule category .................................................. 65
Chapter 7 Trends .................................................................................................................. 66
To collect trend data for a point .................................................................................. 66
Graphing data for multiple points ............................................................................... 68
To create a comparison trend graph ............................................................. 69
To edit a comparison trend graph ................................................................. 69
To delete a comparison trend graph ............................................................. 70
Using trend graphs ..................................................................................................... 70
To view a trend graph ................................................................................... 70
Tools for viewing trends ............................................................................... 71
To print a trend graph .................................................................................. 71
To transfer trend data to a table format ........................................................ 72
Customizing graph appearance .................................................................................. 73
To edit graph properties............................................................................... 73
To edit colors, line styles, and marker types .................................................. 74
To copy a trend graph’s properties ............................................................... 76
To add, edit, or delete a trend category ........................................................ 76
Chapter 8 Alarms.................................................................................................................. 78
Viewing, acknowledging, and deleting alarms ............................................................. 79
To view alarms in the WebCTRL® interface................................................... 79
To acknowledge alarms ............................................................................... 81
To delete alarms .......................................................................................... 82
To receive audible notification of alarms ...................................................... 82
Setting up alarm actions............................................................................................. 83
To assign alarm actions to alarm sources ..................................................... 83
Alarm Popup ............................................................................................... 84
Print............................................................................................................ 87
Propagate To Server .................................................................................... 88
Run External Program .................................................................................. 88
Send Alphanumeric Page ............................................................................ 89
Send E-mail ................................................................................................ 91
Send SNMP Trap ......................................................................................... 93
Write Property ............................................................................................. 95
Write to Database ....................................................................................... 96
Write to File ................................................................................................. 99
Setting up an alarm source in the WebCTRL® interface ............................................. 101
To set up, edit, or disable alarm sources .................................................... 101
To simulate an alarm ................................................................................. 103
To view all instances of an alarm source ..................................................... 103
Customizing alarms .................................................................................................. 104
Alarm messages ........................................................................................ 104
Alarm categories ....................................................................................... 105
If you upgraded alarms from v2.0 or earlier ................................................ 106
Using field codes ...................................................................................................... 107
Format field codes..................................................................................... 108
Field Codes ............................................................................................... 109
Chapter 9 Time-lapse .......................................................................................................... 113
To play Time-lapse.................................................................................................... 113
To change polling interval or duration or to turn off color collection ............................ 114
Chapter 10 Reports ............................................................................................................ 115
To run a report .......................................................................................................... 117
To create an Equipment Summary report ................................................................... 118
To create an Equipment Values report ....................................................................... 119
To create an Trend Samples report ............................................................................ 121
To create a PDF, Excel spreadsheet, or CSV file.......................................................... 122
To edit or delete a custom report ............................................................................... 122
To organize custom reports ....................................................................................... 123
To use custom reports from v2.5 or earlier ................................................................. 123
Chapter 11 Operator access ................................................................................................ 125
Privilege sets ............................................................................................................ 125
Privileges .................................................................................................. 126
To add or edit a privilege set ...................................................................... 129
To delete a privilege set ............................................................................. 129
Operators and operator groups ................................................................................. 129
To add or edit an operator .......................................................................... 130
To delete an operator ................................................................................ 131
To add or edit an operator group ................................................................ 131
To delete an operator group ....................................................................... 131
To change My Settings .............................................................................................. 131
Chapter 12 Advanced security.............................................................................................. 133
Location-dependent operator access ........................................................................ 133
To switch to location-dependent access ..................................................... 133
Privileges and privilege sets ....................................................................... 134
To add a privilege set ................................................................................. 135
To assign privilege sets to an operator........................................................ 135
To delete a local privilege set assignment .................................................. 135
Restricting access in the system ................................................................ 135
Security Assignments Report ..................................................................... 136
Recording reasons for edits (21 CFR Part 11) ............................................................ 136
Advanced password policy ........................................................................................ 137
Chapter 13 Cost-saving strategies........................................................................................ 139
Chapter 1
What's new in v5.5
Feature Improvement
New in v5.5:
Time-lapse (page 113) You can replay up to 24 hours of Graphics, Alarms, or Trends pages
starting on a specified date and time. Time-lapse can be a helpful
troubleshooting tool.
System Settings > Web The Web Applications tab that was added in v5 has been redesigned
Applications tab (page 165) to improve usability.
The More tab If your browser is not wide enough to display all the tabs and location
text on a page, the last tab will be More. Click this tab to toggle
between the hidden tabs and the displayed tabs. You can also click a
link on the More tab to jump to any tab.
64-bit install support for 64-bit install that was added in v5 now includes support for Local
Local Access Access.
Support for new ZS New ZS Sensor control on equipment graphics
Sensors* The equipment Properties page has an Rnet Points tab showing
microblocks that have Rnet enabled.
Interactive Zone Sensor The new ZS Sensor Interactive Zone Sensor on an equipment graphic
control for ZS Sensors* allows setpoint adjustment and override of an unoccupied state.
* ZS Sensors will be released separately.
Feature Improvement
New in v5:
Downloading (page 46) The downloading interface and functionality has changed as follows:
• Downloading moved from the CFG tree to the NET tree. Click the
Downloads action button.
• The Downloads (page 47) page was redesigned to provide more
flexibility and more feedback on the download tasks.
• You can download up to 5 routers simultaneously.
• The Memory download option (page 47) is now called All Content
and includes the names of source files (.equipment, .view,
.bacview, and .driver). Using this information, the new Devices
page can show file discrepancies between the database and
controller. This feature also accommodates Field Assistant.
• You can see who downloaded a controller on the Controller Status
Report or on the controller's Properties page.
Improved download You can now perform a memory download to at least 5 controllers on
performance separate networks simultaneously and schedule downloads to at least
10 controllers on separate networks simultaneously.
Devices page (page 49) A new management tool that allows you to:
• View network/controller communication status
• Resolve database/controller mismatches
• View controller information such as model, address, driver, and
control program
• Find Automated Logic® devices on a network that are not in your
system database
Locked values (page 35) Locked values on Graphics and Properties pages have a yellow
dashed box around them.
Improved trend collection Trend services have been improved to allow concurrent data collection
through multiple BACnet routers.
Controller Status Report This report now includes a controller's download information, and, if
(page 115) the controller has the 4.x or later driver, the serial number and Local
Access port status.
Tree display options (page You can display icons in the GEO tree to denote locations where items
25) such as schedules or alarm actions were created or assigned. You can
also turn on hover text so that when you hold the cursor over a
system, area, or equipment icon, information about the tree item is
displayed.
Schedule Group folders You can create folders and sort your groups into them to organize the
(page 59) GRP tree.
WebCTRL® Design Server WebCTRL® Server no longer has a Normal mode and Design mode.
(page 31) WebCTRL Server and WebCTRL Design Server are now 2 separate
options on the Start Menu.
Email (page 91) and You can now set the mail host's port and security in the WebCTRL®
Alphanumeric Page (page interface.
89) alarm actions
Feature Improvement
Location Audit Log and The Audit Log report is now 2 reports, one with location-based
System Audit Log reports changes and one with system-wide changes.
(page 115)
Advanced Password Policy The System Settings > Security tab has 2 new options:
(page 137) • Cannot be changed more than once every__ days
• Force expiration button
System Settings > Security When control programs, views, and BACview® files are created by an
tab > Permissions (page original equipment manufacturer (OEM), they cannot be used in a
160) WebCTRL® system without the creator's permission. However, the
creator can produce a key for a system with a different license that will
grant permission to the key's recipient.
If you receive a key, you can activate it on the System Settings >
Security tab.
System Settings > Web You can deploy a web application from your WebCTRL® system.
Applications tab (page 165)
Alarm Notification Client It now has a continuous sound and silencing feature.
(page 84) You can now lock a client's Settings.
Enabling support for Alarm Popup clients moved from System Settings
> Other Applications tab to the General tab.
Edit Setpoint Tuning The permissions granted by the Edit Setpoint Parameters privilege
Parameters privilege (page were split between that privilege and the new Edit Setpoint Tuning
126) Parameters privilege.
Remotely change the IP You can now change the IP configuration of a device in the WebCTRL®
configuration of a BACnet IP interface.
controller
Disabling Local Access To limit access to your system, you can disable a controller's Local
Access port from communicating with the WebCTRL® application,
Field Assistant, or Test and Balance running on a laptop. Requires the
v4.x driver.
HTTP Proxy and HTTP Tunnel These options were removed. Use Field Assistant instead.
in System Settings
Feature Improvement
Download Source Files Available only with a v4.x or later driver.
If Field Assistant will be used with your WebCTRL® system, it needs
each controller's .equipment, .bacview, and .driver source files, plus
any .view files marked to be included in download.
• Select the new Download Source Files option on the controller's
Properties page to have the WebCTRL® application download the
source files so that Field Assistant can upload them. This option
depends on the controller's available memory.
• Do not select this option if you know the controller does not have
enough memory or you want faster uploads in Field Assistant. You
will need to export the files from the WebCTRL® or SiteBuilder
application so that they can be imported into Field Assistant.
NOTES
• If you select Download Source Files but the controller does not
have enough memory, the download will fail. You can then disable
this option and download again.
• You can exclude a .view file from being downloaded.
System Settings > General From the WebCTRL® or SiteBuilder application, you can export source
tab > Export All Source Files files to a .zip file that can be imported into Field Assistant. And, you
(page 159) can export source files from Field Assistant and import them into
WebCTRL® or SiteBuilder.
BACnet Discovery This feature is now a page under the Devices button on the NET tree.
And, you can now export the BACnet information to a .discovery file
that can be opened in the new Third-Party BACnet Utility or in the
EIKON® LogicBuilder application.
WAP pages The default WAP pages generated by the WebCTRL® application have
been redesigned to be more useful and easier to navigate.
Internet Explorer support The WebCTRL® application now supports IE9, but no longer supports
IE6.
NOTE If your system has legacy graphics and you are running IE9, you
may see a strange font on the Graphics pages. To correct, upgrade
your InterOp® graphics in SiteBuilder. This will change the font to
Courier New.
Reset to Defaults This menu option was removed from the right-click menu. You can use
the revert manual command instead.
64-bit operating system The WebCTRL® installation now has a 64-bit install for large systems
that can use the increased capability inherent in a 64-bit operating
system. However, the 64-bit install does not include Local Access
support. (Support for Local Access is included in v5.5.) The 32-bit
install that supports all connection types can be used on a 64-bit
operating system.
NOTE MS Access is not available on a 64-bit installation. If your
system uses an Access database and you want to upgrade to the
64-bit version of v5, you must migrate your Access database to a
different type of database before upgrading.
Feature Improvement
HyperTerminal replaced by Windows operating systems after XP do not include the HyperTerminal
PuTTY in Help application. You can download the external application PuTTY to
communicate locally with controllers. Most HyperTerminal instructions
in Help have been replaced with PuTTY instructions. For
HyperTerminal instructions, see Communicating using HyperTerminal.
Feature Improvement
New in v5.5:
EquipmentBuilder EquipmentBuilder is now installed with a WebCTRL® system as a
stand-alone application. The EIKON® LogicBuilder File >
EquipmentBuilder menu selection opens the application.
Revised ZN rules • The zone temp input to the Setpoint microblock can come from a
label to allow for smoothing algorithms.
• To indicate an alarm condition in a zone (for example, to turn the
zone coral due to an equipment failure) you may use 1 Set Color if
True microblock in addition to a Setpoint microblock. When true, the
Set Color if True microblock determines the equipment color but
does not overwrite the Setpoint microblock's color output.
Revised microblocks • BACnet Binary Value Parameter
• BACnet Analog Value Parameter
• BACnet Multi-State Value Parameter
• BACnet Binary Value Status
• BACnet Analog Value Status
• BACnet Multi-State Value Status
The above microblocks have been revised to support the new ZS
Sensors, which will be in a separate release.
The BACnet Multi-State Value Parameter and BACnet Multi-State Value
Status microblocks now support 20 states, retiring the following
microblocks.
Retired microblocks • BACnet Multi-State Value Parameter (20 state)
• BACnet Multi-State Value Status (20 state)
Support for new The new Sensor Display Order menu option lets you define the order that
ZS Sensors microblock values will be displayed on a Sensor.
(will be released The Microblock Common Properties Editor has a new Rnet tab.
separately)
The EIKON® LogicBuilder application has pre-defined Rnet tags that
identify system values. You can create custom Rnet tags if needed.
New in v5:
Microblock Common You can view or edit common properties for the I/O, Network, Display,
Properties Editor and BACnet microblocks in a control program.
Feature Improvement
ZN microblock rules A ZN control program can now have:
• A maximum of 350 microblocks (previously 200)
• Up to 2 PID microblocks in addition to the zone controller microblock
(previously 1 PID)
Integrator microblock is The integrator microblock now retains its output magnitude through a
non-volatile power loss, controller reset, or controller restart.
"Always upload" feature in Using a combination of logic that writes critical parameters within a
BACnet Analog Value control program to a BACnet Analog Value Parameter microblock and a
Parameter microblock new property of the BACnet Analog Value Parameter microblock, you can
retain critical values through a power loss, through a controller restart,
and (if the reference name of the microblock is unchanged) through a
memory download.
BACnet PID microblock This new microblock provides improved PID algorithm and BACnet
accessibility.
NOTE A control program with this microblock works only with v5.2 or
later WebCTRL® systems and v4.x or later drivers.
20-state BACnet These 2 new microblocks support up to 20 states.
Multi-state Value
Parameter and
20-state BACnet
Multi-state Value Status
microblocks
OCL microblock system To be consistent with the System Variable microblock, the weekday
variable for weekday system variable has changed to WKDAY, where Monday = 1 to Sunday =
7. The previous weekday system variable, WDAY, will continue to work in
existing control programs using Sunday = 1 to Saturday = 7.
Wildcard (*) instead of Use an * in a Network Input or Total Analog microblock's address to
Device ID in BACnet have the microblock automatically locate the nearest device that
addresses contains the object specified in the address. This feature eliminates the
need for specific device addresses when retrieving values from common
objects. For example, control programs on a campus that need oa_temp
can automatically retrieve the value from the nearest device that
contains that object name.
Edit > Third Party BACnet You can edit the addresses that you created with the Third-Party BACnet
Addresses Utility. Or, you can convert a control program into an integration program
by changing I/O microblocks to Network or Display microblocks and
setting the microblock addresses.
Device Alias microblock These allow the use of Network I/O and Display microblocks in the same
and Device Alias field in program, and efficient re-use of programs for multiple instances of
Display microblocks third-party equipment.
NOTE You must enable Use Static Bindings on the WebCTRL® System
Settings > Communications tab. For more information or alternatives,
see the BACnet Integration Guide
(http://accounts.automatedlogic.com/tilib.nsf/0/16B62CAA979B5D8A
8525717200678C60/$FILE/BACnet%20Integration%20Guide.pdf).
Feature Improvement
Mark certain properties as You can right-click some properties in the EIKON® LogicBuilder
Read-only application and select Make Editable or Make Read-Only to determine
that property's functionality in the WebCTRL® interface.
Remove all Property Page You can use this Tools menu add-on to remove property page text for all
Text microblocks in a control program.
Keep historical trends for You can now define this setting in the EIKON® LogicBuilder application
___days for I/O and Log microblocks. Previously, this setting was only in the
WebCTRL® interface.
Use unitary naming You can set your control program to use unitary naming to omit __# at
the end of BACnet object names.
Immediate Triggered Write The Immediate Triggered Write property was removed from ANO2 and
BNO2 microblocks. These microblocks automatically write their value as
soon as they are enabled.
Feature Improvement
New in v5.5:
Trend data in exported You now get the option of including historical trend data in an
clippings exported clipping.
NOTE Exporting and importing trend data can take a long time, and
the trend data can be imported only in SiteBuilder running in
non-concurrent mode.
Apache Derby database SiteBuilder now includes Apache Derby as a database option. Like MS
support Access, all files needed for Apache Derby are installed with your
system. Derby is a cross-platform database supported on both 32-bit
and 64-bit operating systems. It is more robust and stable than Access
and provides a support-friendly, easy installation option to transfer
system files across platforms.
v5.5 also includes a Derby compression tool (page 203) that you can
use to compact the database.
BACnet points SiteBuilder no longer includes BACnet points when calculating
integration points.
Java VM increase The default amount of computer memory that your WebCTRL® system
is permitted to use has been increased from 512 MB to 1024 MB.
This will increase the speed of memory-intensive tasks.
Database drivers Database drivers are now located in a new folder:
WebCTRLx.x\database-drivers. So, if using a MySQL database, move
the driver file to the new location.
Database driver file names are no longer limited to *-driver.jar.
Feature Improvement
New in v5:
Environmental Index source The new Environmental Index source tree allows you to drag and drop
tree zones that use standard reference names to calculate the
Environmental Index.
Use Server's Time Zone A site now defaults to the WebCTRL® server's time zone, but you can
select a different time zone if needed.
Find feature You can search your system database for any information that you can
access from an item's properties dialog box.
Replicate feature The Replicate dialog boxes were redesigned.
Synchronize views If multiple pieces of equipment use the same control program and you
change the attached view(s) for one, a Synchronize Views dialog box
appears showing all equipment using the same control program. You
can then easily select other equipment that requires the same view
change.
View Properties When you attach a view in SiteBuilder, you can edit the view's
navigation properties that were defined in ViewBuilder.
Custom source trees You can now create up to 20 custom source trees.
Connect strings for MySQL, The connect strings were broken into fields in SiteBuilder to simplify
Oracle, PostgreSQL, or setup of the databases.
SQLServer databases
Support for lighting control When adding an LX6 controller in SiteBuilder, a Panel Properties tab
appears where you select the lighting control panel's model.
Download Source Files Available only with a v4.x or later driver.
If Field Assistant will be used with your WebCTRL® system, it needs
each controller's .equipment, .bacview, and .driver source files, plus
any .view files marked to be included in download.
• Select the new Download Source Files option to have the
WebCTRL® application download the source files so that Field
Assistant can upload them. This option depends on the controller's
available memory.
• Do not select this option if you know the controller does not have
enough memory or you want faster uploads in Field Assistant. You
will need to export the files from the SiteBuilder or WebCTRL®
application so that they can be imported into Field Assistant.
NOTES
• You can set Download Source Files at the site level so that it is the
default for every new controller that you add. You can then change
the setting for individual controllers.
• If you select this field but the controller does not have enough
memory, the download will fail. You can then disable this option on
the controller's Properties page in the WebCTRL® interface and
download again.
Feature Improvement
Export and import source From the SiteBuilder or WebCTRL® application, you can export source
files files to a .zip file that can be imported into Field Assistant. And, you
can export source files from Field Assistant and import them into the
WebCTRL® or SiteBuilder application.
SSL certificate management SiteBuilder now has the ability to make and delete SSL certificates,
simplifying the process of certificate creation and deletion.
Apply Update The Apply Update menu command is now beneath the Help menu
command.
Feature Improvement
New in v5.5:
EquipmentBuilder EquipmentBuilder is now installed with a WebCTRL® system as a
stand-alone application. The ViewBuiilder File > EquipmentBuilder
menu selection opens the application.
WebApp Content control You can add content from a WebCTRL® add-on web application to a
WebCTRL® graphic.
Show/Hide expression To allow reuse of graphics, you can show or hide equipment-specific
using ?? objects based on the presence of a particular
microblock. For example, you can add a hot water valve image to an
AHU graphic and give it the show/hide expression
??hw_valve??. The image will appear on the graphic only if the
associated control program has a microblock called hw_valve.
Interactive Zone Sensor The Interactive Thermostat is now called the Interactive Zone Sensor
control control.
Support for new ZS ZS Sensor is now an option for the Interactive Zone Sensor control.
Sensors*
* ZS Sensors will be released separately.
New in v5: EquipmentBuilder is now installed with a WebCTRL® system as a
stand-alone application. EIKON® LogicBuilder's File >
EquipmentBuilder menu selection opens the stand-alone application.
Drawing tools New tools let you draw vector lines and shapes.
Lighting graphics The ViewBuilder library now has graphics for lighting.
Use... To...
New in v5.5:
EquipmentBuilder Generate the following files from a library of pre-defined
applications.
• Control program (.equipment)
• Graphic (.view)
• BACview® file (.bacview), if applicable to the equipment
• Sequence of operation (.odt)
• Visio schematic (.vdx)
New in v5:
Field Assistant Service or start up and commission a piece of equipment or a partial
network of controllers.
Third-Party BACnet Utility Use discovered BACnet information to choose and address
microblocks for third party BACnet integration.
Test & Balance Calibrate airflow in VAV zone controllers, commission air terminals,
(Redesigned) and override reheat and terminal fans.
Chapter 2
What is a WebCTRL® system?
A WebCTRL® system is a web-based building automation system that can be accessed from anywhere
in the world through Internet Explorer, without the need for special software on the workstation.
Through Internet Explorer, you can perform building management functions such as:
• adjust setpoints and other control parameters
• set and change schedules
• graphically trend important building conditions
• view and acknowledge alarms
• run preconfigured and custom reports on energy usage, occupant overrides, tenant billing, and
much more
The WebCTRL client uses Internet Explorer to access the WebCTRL® Server application as a website.
Access and security options may include:
WebCTRL® editions
A WebCTRL® system supports:
• Unlimited simultaneous users
• Multiple operating systems and databases
• Built-in alarming, trending, and reporting
• International languages (International English, Korean, Traditional and Simplified Chinese,
Spanish, French, German, Russian, Swedish, Thai)
• Third-party integration
• WAP-enabled devices
• Secure server access using TLS/SSL
• Optional WebCTRL® packages listed below
WebCTRL 500 supports all the same features and options in systems with fewer than 500 points.
NOTE Points include all input and output points tied into the system, regardless of vendor.
NOTE An optional package is enabled when you install the license (page 167) that provides the
optional package.
WebCTRL® tools
A WebCTRL® system includes the following tools.
Design Tools
Use... To...
EIKON® LogicBuilder Create control programs and Properties pages.
ViewBuilder Create graphics and BACview® screens.
ViewBuilder for WAP Customize pages for WAP-enabled devices.
SiteBuilder Create and modify the system database and associate control
programs and graphics with equipment.
Third-Party BACnet Utility Use discovered BACnet information to choose and address
microblocks for third party BACnet integration.
Use... To...
EquipmentBuilder Generate the following files from a library of pre-defined
applications.
• Control program (.equipment)
• Graphic (.view)
• BACview® file (.bacview), if applicable to the equipment
• Sequence of operation (.odt)
• Visio schematic (.vdx)
Chapter 3
Getting to know the interface
NOTES
• After you log in, you will see the page defined as your starting location on the My Settings page. To
change your opening page, see To change My Settings (page 131).
• Privileges control what an operator can see or do in the WebCTRL® system. If you cannot see or
do something that you read about in Help, ask your System Administrator to check your privileges.
Optional icons
You can display the following icons to denote locations in the GEO tree where items were created or
assigned.
gray 77° the zone is in optimal start and is ramping up to its an occupied
(unoccupied) occupied setpoint in the few hours before occupancy color
yellow 75° the zone’s electric meter is in demand level 2 with green
relaxed setpoints of 68 and 76°
green 73.5° cooling began when the temperature rose above 74° yellow
and the temperature has not yet dropped beyond the
1° hysteresis (to 73°)
Chapter 4
Running WebCTRL® Server
The WebCTRL Server application accesses and maintains the system database that is viewed and
edited from client browsers.
The application's Current Users, Connections, and Output tabs allow you to monitor the status of the
system. Output information is continually archived to WebCTRLx.x\logs\WEBSERVER.log.
To run a system
The WebCTRL® Server application must be running before operators can log in from client browsers.
1 Select Start > Programs > WebCTRL x.x > WebCTRL Server.
TIP If you run the WebCTRL® application as a Windows service, your computer can
automatically start the WebCTRL Server application every time the computer starts. See Running
WebCTRL Server as a Windows service (page 175).
2 Start the Internet browser on one or more client computers.
3 Verify that your browser is set up for displaying the WebCTRL® interface. See To set up a computer
and browser to view the WebCTRL® interface (page 29).
4 Type the WebCTRL® server's address in the browser's Address field.
NOTE You can type http://localhost if WebCTRL Server and the browser are running on
the same computer.
5 Enter a Name and Password.
• If you are using IE9 and do not see the menu bar, right-click on the window's header, and then
select Menu bar. You can then follow the instructions below.
NOTES
• Question marks and purple thermographic color indicates correct microblock paths. Missing data
or dark yellow thermographic color indicates errors.
• If the computer's Start menu does not show WebCTRL Design Server, you are using a Tools Only
installation.
2 Click the Notify button beside the user you want to send a message to. Or click Notify All
Users.
3 Type a Notification message.
4 Click OK.
NOTE You can also type notify [followed by the message] in the WebCTRL® manual
command dialog box to send a message to all logged in operators.
Chapter 5
Working with equipment
You can view and adjust equipment operation from the following pages:
Microblock pop-ups
To open a microblock pop-up where you can
view and change properties:
• Click a microblock on a Logic page.
• Click the bold, underlined microblock name
on a Properties page.
• Right-click a value and then select Details.
Graphics pages
You can view and adjust your system from Graphics pages, which include navigation maps, floor plans,
and equipment.
NOTES
• Right-click a value, then select Details to view and change properties in the microblock pop-up.
• Right-click a value, then select Global Modify (page 44) to view and change the property in other
control programs.
NOTES
○ If the control program is in an IP router, the second option will change the graphic for all
control programs of this type only on the IP network.
○ If the control program is on the network below an IP router, the second option will not change
the graphic for the router's control programs of this type.
NOTES
• Select a graphic in the Attached list to edit the graphic's:
○ Display Name–The name that appears in the Graphics button drop-down list
○ Category–The name of the category that multiple graphics may be sorted into in the Graphics
button drop-down list
NOTE Changes to Display Name or Category apply only in the WebCTRL® interface and are
not retained if you export source files.
○ Reference Name–The name that is used to create links to the graphic in ViewBuilder
○ Included in download–Equipment graphics only. Select to have the .view file included in an All
Content download so that it can be uploaded by Field Assistant. The graphic will have
beside it in the Attached list. Requires 4.x or later drivers.
• You can click Delete Unused at the bottom of the Views section to delete all unattached graphic
files from your system.
NOTE To delete a category, select the category, click Delete, then click OK.
RS Pro-F
• Click the WARMER or COOLER button to adjust the setpoint.
• Click the MANUAL button to override the schedule and put the
zone in an occupied state.
• Click the INFO button to cycle through information such as:
• Outside air temperature
• Override time remaining
• Heating setpoint
• Cooling setpoint
• Click the FAN button to adjust the fan speed.
• Click the MODE button to perform customer-specific functions.
• See the Occupied/Unoccupied state in the display.
Properties pages
Properties pages are automatically generated from control programs created in the EIKON®
LogicBuilder application. Use Properties pages to:
• View the status of a piece of equipment. See Colors and status in the WebCTRL® interface (page
27).
• View or change the equipment or microblock properties currently stored in the controller
• Commission equipment
3 Click OK.
NOTES
• Right-click a value, then select Details to view and change properties in the microblock pop-up.
• Right-click a value, then select Global Modify (page 44) to view and change the property in other
control programs.
Point types
A point name on the Properties page is followed by a code that tells you the point type. The table below
describes each code.
Logic pages
The Logic page shows the control program for a piece of equipment. The live data (yellow text) is
updated every few seconds and whenever you click the Logic button. The control program uses exact
property values for its calculations, but values are rounded to 2 decimal places when displayed on the
Logic page.
TIP Click anywhere on the Logic page, then use the Page Up, Page Down, and arrow keys to scroll
through the page.
NOTE If you find an unexpected value on a Properties page or a Logic page, you can use the Logic
page to troubleshoot.
NOTE You can also click a label on the full-size logic page to display the reduced logic page.
NOTE Right-click a value, then select Global Modify (page 44) to view and change the property in other
control programs.
CAUTION Global Modify and Global Copy are convenient for making widespread changes in your
system. But, because they do not take into account the operation of individual equipment, your
changes could produce undesired results in your equipment or system operation. Use with caution
because these features do not have an Undo function.
TIP Click to copy a microblock's reference path to the clipboard so you can paste it into
another field or application.
1 Browse to any page that displays the property you want to view or change.
2 Do one of the following to access Global Modify.
○ Right-click the property, then select Global Modify.
○ Alt+click the property.
3 Make changes to the Control Program field, if needed.
NOTES
○ Use wildcards in the Control Program field to broaden the search.
For example:
vav* matches vav, vav1, vavx, vav12345
vav*z matches vavz, vav1z, vavxz, vav12345z
vav*1*2 matches vav12, vavabc1xyz2
vav?? matches vav11, vav12, vavzz, but does not match vav, vav1, vav123
* matches any control program
○ Click Show Advanced to view the location, value, and privileges associated with this property.
4 Select the tree item under which you want to search for every occurrence of that microblock in
other control programs.
5 Click Find All.
6 Select the properties in the list that you want to change.
1 On the GEO or NET tree, right-click the piece of equipment that has the properties you want to
copy, then select Copy Control Program Properties.
2 In the Global Copy dialog box, select the items that you want to copy.
3 Select the area on the tree containing similar control programs that you may want to copy these
properties to, then click Search.
All instances at that level and below are listed in the expanded lower window.
4 Select or clear checkboxes as needed.
Downloading to controllers
If you make any of the following changes, you must download the new data from the WebCTRL®
application to the affected controllers.
The WebCTRL® application automatically marks the affected controllers as requiring a download. You
can download these controllers from the Downloads page (page 47) or Properties page (page 48) for
the controller, the equipment, or a microblock.
When the WebCTRL® application marks a controller for download, it determines what information
needs to be downloaded based on the type of information that changed. See Download Options (page
47).
NOTES
• A property change in the WebCTRL® interface is automatically downloaded to the controller. If the
download fails, the controller is added to the Downloads page with the reason for the failure.
• To see who downloaded a controller last, go to the NET tree, select the controller, then do one of
the following:
○ Go to Reports > Network > Controller Status, then click Run.
○ View Downloaded by on the Properties page.
○ Click Module Status on the Properties page.
Download Options
When the WebCTRL® application marks a controller for download, it determines what information
needs to be downloaded based on the type of information that changed. Below are the options that
can be downloaded.
NOTES
• An All Content download clears trend, history, and alarm data from the affected controllers. At the
beginning of the download process, trends that have the Trend Historian enabled are saved to the
system database.
• If Field Assistant will be used with your system, you can choose to have the All Content option
download the full source files instead of only their names. In the WebCTRL® NET tree, select a
controller, then enable Download Source Files on the Properties page. See Commissioning
equipment using Field Assistant.
To download:
1 On the NET tree, select an item to download controllers at and below that item.
2 Click Downloads.
3 Click to the left of a Location to see controllers that require a download.
4 Optional: To add controllers to the list:
a) Click Add.
b) Select the controller(s).
NOTE Use Ctrl+click or Shift+click to select multiple controllers.
c) Select a Download Option (page 47).
d) Click Add, then click Close.
NOTES
• Click Hold to stop pending downloads. Active downloads cannot be stopped.
• Up to 5 routers can download simultaneously.
• A controller is removed from the list when its download is complete.
• Icons in the Tasks column indicate the following:
• Click in the upper left-hand corner to view a log of download activity in the current session.
Copy to Clipboard lets you copy the text to paste it into another application.
• To remove an item from the download list, right-click the item, then select Remove selected tasks.
NOTES
• Use Ctrl+click, Shift+click, or the Select All checkbox to select multiple controllers.
• Click Hold to stop pending downloads or uploads. Active downloads or uploads cannot
be stopped.
• Icons in the Tasks column indicate the following:
• Click in the upper left-hand corner to view a log of activity on the Devices page in the current
session. Copy to Clipboard lets you copy the text to paste it into another application.
Status messages
On the WebCTRL® NET tree, you can select a router, network, site, or the system to view the status of
controllers. The Status column shows a description of the controller's current state. Hold your cursor
over that description to see hover text with a more detailed description.
If multiple conditions exist, WebCTRL® displays the message with the highest priority.
The table below shows all possible messages. The message color indicates the following:
Green—In process
Red—An error occurred
Blue—Requires action from the user
Green messages:
Red messages:
Connection Error The connection for this controller Occurs if the connection is
failed to start. misconfigured or failed to start.
Connection Disabled The connection for this controller has Occurs if someone stopped the
been disabled. connection. This includes stopping a
connection, using the No Connect
connection, or running WebCTRL
Design Server.
Out of Service This controller is out of service. The controller's Out of Service
checkbox on the Properties page is
enabled.
Communications Error Cannot communicate with this
controller.
Not Uploadable This controller is not configured for Occurs if you attempt to upload a
content upload. controller with a pre-4.x driver.
Download Failed (Message depends on the cause of
the failure.)
Error An unknown error has occurred.
Blue messages:
General messages:
To resolve a mismatch
A mismatch occurs when a value in a controller does not match the value in the WebCTRL® Server
application. Use either of the following methods to handle mismatches in your system.
• Select Always upload properties from controllers to WebCTRL Server on mismatch on the System
Settings > Communications page to have the WebCTRL® application upload automatically.
• Clear Always upload properties from controllers to WebCTRL Server on mismatch so that you can
evaluate every mismatch to determine the correct value. When a mismatch occurs:
1. On the NET tree, select the controller's network.
2. Click Devices.
3. On the Manage tab, select a controller with a mismatch.
4. Do one of the following:
• Click Upload to upload parameters from the controller to WebCTRL® Server.
• Click Download to download parameters from WebCTRL® Server to the controller.
NOTE Click the mismatch message in the Status column to view details.
Setpoints
Use setpoints to set temperature values that control the HVAC equipment. The WebCTRL® interface
shows the color green when a zone is within the desired temperature range determined by the heating
and cooling setpoints.
• Programmed setpoints are set and changed by operators. See To change programmed setpoints
(page 52).
• Effective setpoints reflect the impact of other system conditions on the programmed setpoints,
such as setpoint adjustments, demand reduction adjustments, and hysteresis. Effective setpoints
control the equipment.
Besides manually adjusting setpoints, you can use the following cost-saving strategies (page 139) to
adjust setpoints automatically:
• Optimal Start
• Demand Control
• Setpoint Optimization
TIP You can click and drag a segment or a gap between segments to change setpoints.
4 Click OK.
Optimal Start
Optimal Start gradually moves the unoccupied setpoints toward the occupied setpoints as the
occupied time approaches. The actual equation that a controller uses to calculate Optimal Start is
nonlinear. An approximation of the equation is shown below.
design temp – OAT
calculated capacity = x capacity at 65°
design temp – 65°
You can adjust the Optimal Start routine in the control program's setpoint microblock.
1 In the GEO tree, select the equipment that you want to change.
2 Click Properties.
3 Adjust the following fields located below the setpoint graph.
Field Notes
Heating Capacity The maximum rate (in °F/hr) that the zone temperature could be changed
Cooling Capacity by heating or cooling if the outside temperature were 65°F.
For example, if it takes 2 hours for a zone to warm up from 65°F to 72°F,
the heating capacity is 3.5°F/hr
NOTE Use 5°/hr as a starting point if you are unsure of actual capacities.
Heating Design Temp The most extreme outside winter and summer temperatures at which the
Cooling Design Temp equipment must run 100% of the time to maintain the zone temperature
at a comfortable level.
ASHRAE determines design temperatures based on the geographic
location of the building.
NOTE Setpoint microblocks with Learning Adaptive Optimal Start functionality automatically adjust the
heating and cooling capacities to optimize efficiency.
When the Learning Adaptive Optimal Start routine runs, adjustments are made based on the color that
is achieved when occupancy begins. Adjustment amounts are defined for thermographic colors in the
control program's setpoint microblock.
For example, the heating capacity for a zone is 5° per hour. When the zone becomes occupied, the
zone temperature is 1° below the occupied setpoint, indicating a need for additional heat. Because
the zone temperature was low by 1°, the learned heating capacity will be decreased by the Less than
Heating setpoint value. If the value is 0.06, the learned heating capacity will be adjusted to 4.94° for
the next optimal start period. The setpoint adjustment will begin sooner in the next unoccupied period.
If you need to change the adjustment values in the Learning Adaptive Optimal Start routine:
1 In the GEO tree, select the equipment that you want to change.
2 Click Properties.
3 Adjust the color fields between the Zone Set Points graph and the Effective Set Points graph.
CAUTION When using Learning Adaptive Optimal Start, be sure that all equipment is properly
maintained so that your system doesn’t “learn” to compensate for dirty filters or loose fan belts.
TIP After your system has run for at least a year, you may want to turn off learning in your control
program, and change the Heating Capacity and Cooling Capacity in your control program to match the
learned heating or cooling capacity shown on the Properties page.
Fields Notes
Color fields The amount of adjustment the system makes for the color that is
achieved at the beginning of occupancy.
Learned cooling and The rate (in °F/hr) that the zone temperature can change by heating or
heating capacity cooling at an outside temperature of 65°F.
Actual or The actual heating or cooling capacity of the equipment at an outside
adjusted capacity temperature of 65°F.
Demand Control
Demand Control is a cost-saving strategy that saves energy while maintaining comfort in the following
ways:
• Controlling energy use to avoid peak demand, ratchet, or time of use utility charges
• Maintaining ventilation at relaxed setpoints rather than shutting down equipment (as with load
shedding or duty cycling)
Before you can use Demand Control effectively, you must:
• Obtain details regarding past energy usage and peak demand, ratchet, and time of use charges
from your energy provider.
• Understand the demand profiles of the zones you are controlling.
Demand Control can be customized at the zone level. For example, you may relax the setpoints in
some zones, like break rooms and closets, by a few degrees, but you may not want to relax setpoints in
computer rooms at all.
Setpoint microblocks that have a Demand input use a demand control strategy to conserve energy by
relaxing setpoints as the demand level rises. In the EIKON® LogicBuilder application, you define the
amount that setpoints will be adjusted or relaxed based on the demand level.
exceeds 800 kW/hr, the WebCTRL® system will use Demand Level 1 setpoints. If the demand exceeds
1000 kW/hr, the WebCTRL® system will use Demand Level 2 level setpoints and so on.
Setpoint Optimization
Setpoint Optimization, also known as Trim and Respond, saves energy by calculating the setpoint of a
piece of equipment based on the number of heating or cooling requests it receives from other
equipment.
You must put a Setpoint Optimization microblock in a control program to receive Total, Average,
Minimum, or Maximum microblock outputs from linked equipment.
Chapter 6
Schedules
Using schedules, your equipment can maintain one set of setpoints during occupied periods to provide
comfort, and it can maintain a different set of setpoints during unoccupied periods to reduce energy
consumption. Schedules are a WebCTRL® system's most effective cost-saving strategy (page 139).
You can apply a schedule to a tree item or to a group of tree items.
When you apply a schedule to a tree item, the schedule affects
equipment at and below the area or equipment where the
schedule was added.
NOTES
• When multiple schedules affect a tree item, the combined result is the Effective Schedule (page
61).
• Do not include preheating or precooling time in your schedules. Optimal Start (page 52), another
cost-saving strategy, automatically calculates and controls precise preheating and precooling
routines.
• If you are using hierarchical servers, when you add or change a schedule on the parent server, the
schedule is automatically downloaded to the corresponding location on the child server(s).
To view schedules
1 Select a GEO tree item.
2 Click Schedules, then the View tab.
3 Optional: Click an Effective bar to view all the schedules that contribute to the resulting schedule.
If the item has multiple schedules, the schedule closest to the Effective bar has the highest
priority. You set a schedule's priority when you create the schedule.
NOTES
• You can display icons and hover text in the GEO tree that show where schedules have been
created. See Tree icons and hover text (page 25).
• You can also view schedules on the following detailed, printable schedule reports. These reports
are accessible from the Schedules page Reports tab or from the Reports button drop-down menu.
Setting up schedules
Select... For...
Normal A typical occupied period
Holiday An unoccupied period that overrides a Normal schedule
Override An occupied period that overrides a Holiday schedule
NOTES
• To have all new schedules and schedule changes in the system download automatically, click
Show Advanced under the Add button, then select Automatically Download Schedules. If you
want to manually download schedules, see Downloading system changes to controllers (page 46).
• When you apply a schedule to an item in the GEO tree, the schedule affects that item and all
children of that item. If you do not want an item to be affected by schedules from a higher level,
click Show Advanced under the Add button, then select Ignore Schedules above this level.
4 Optional: Change the default Reference name. A group's reference name must be unique
throughout the system.
5 Click OK.
6 Click Go.
7 On the Members page, select the areas, equipment, or other groups that you want to add to the
group from the tree on the right. Use Ctrl+click, Shift+click, or both to select multiple items.
8 Click Add.
TIP Use the Raise and Lower buttons to reorder items in the Members list. Changing the
order is for your viewing convenience and does not affect the system.
9 Click OK.
10 Click the Schedules button, then Configure.
11 Add a schedule to the group. See To apply a schedule to equipment (page 58).
NOTE When using hierarchical servers, you can place a server link in a schedule group on the parent
server. This automatically creates a schedule group with the same name on the child server(s). This
group includes only the top-most area node of the child server. However, from the child server you can
edit the group to add other members.
NOTE You can also add a folder to a folder, or drag and drop a folder into another folder.
Effective Schedules
The effective schedule that you see on the Schedules View tab can be the result of multiple
overlapping schedules.
Feature Description
Hierarchy A schedule applied to an item on the WebCTRL® tree affects that item and all of its
children. A child item's effective schedule could be the result of multiple schedules
applied at different levels above it. To change a child item's effective schedule:
• Add a schedule at the child that overrides the current schedule. See the Priority
feature below.
• Set the child to ignore the parent schedules. To do this, select the child item in the
tree, then go to Schedules > Configure. Select the schedule, click Show Advanced,
then select Ignore Schedules above this level. You can then add a different
schedule for the child.
Any schedule change that you make to an item affects it and all of its children.
Priority You must assign one of the following priorities to every schedule.
Use... For...
Normal A typical occupied period
Holiday An unoccupied period that overrides a Normal schedule
Override An occupied period that overrides a Holiday time
Feature Description
Type You must assign one of the following types to every schedule.*
Weekly Wildcard
Date Continuous
Date Range Dated Weekly
Date List
See To apply a schedule to equipment (page 58) for a description of each type.
EXAMPLE For a school, you define the following 3 schedules:
• Full calendar year: Normal, Weekly, Monday–Friday, 6am–5pm
• Summer months: Holiday, Continuous, 12am June 1st –11:59pm August 31st
• Work days in summer months: Override, Dated Weekly, Monday–Thursday,
9am–2pm
* If you do not see one of the types listed above, go to CFG > Categories > Schedule. Select
the Occupancy category, then the Priority. Under Schedule Types, select the missing type,
then click OK.
Using the Priority and Type options, you can often accomplish the effective schedule you need in
several different ways. For example, the effective schedule resulting from the 3 schedules described
above for Type could also be accomplished with the following schedules:
School year: Normal, Dated Weekly, Monday–Friday, September 1st–May 31st, 6am–5pm
Summer months: Normal, Dated Weekly, Monday–Thursday, June 1st–August 31st, 9am–2pm
PREREQUISITES
• Add the custom schedule category in the EIKON® LogicBuilder application. See "To use custom
alarm and schedule categories" in EIKON® LogicBuilder Help.
• In the EIKON® LogicBuilder application, select the new category from the Schedule Category
droplist in a Time Clock microblock.
1 On the WebCTRL® CFG tree, click the plus sign (+) to the left of the Categories folder, then click
Schedule.
2 Click Add Category.
3 Enter values or add items for the fields in each section of the page. See table below.
NOTE The fields that you see depend on selections you made in previous sections. Category
Details fields.
4 Click OK.
Field Notes
Reference Name • Must be unique in the database, be lowercase, and not
contain any spaces.
• This name must be identical to the name of the custom
schedule category that you added in the EIKON® LogicBuilder
application.
• Do not use occupancy as the reference name.
Schedule Category Description The name used in the WebCTRL® interface
Allowed Type Replace Undefined with one of the following:
• Boolean: binary (on/off, true/false) condition
• Multi State: list of integer-defined states. For example, 1=off,
2=on, 3=dim
Default Value Displays what schedule value is in effect for times not specified by
the schedule. To set this value, in the Allowed Values table, select
the value that you want to use as the default, then click the Make
Default OK button.
Allowed Values If you selected Boolean above, select True Value or False Value.
If you selected Multi State, click the Add Value button to create
each schedule state.
Allowed Value Description The name used in the WebCTRL® interface.
Field Notes
Pattern Type none, dark, or
/_common/lvl5/graphics/patterns/xxx.gif,
where xxx.gif is any .gif file in the
webroot\_common\lvl5\graphics\patterns folder.
Chapter 7
Trends
The WebCTRL® application can read and store equipment status values over time and then display
this information in a graph to help you monitor the equipment’s operation.
You can collect trend data for any BACnet input or output point in the WebCTRL® system. The
controller reads values for a point at intervals that you define and then stores that data in the
controller.
Because a controller has limited memory for storing trend data, you can set up historical trending to
archive the trend data from the controller to the WebCTRL® database. A trend graph can display data
from both the controller and the database.
Before you can look at a trend graph for a point, you must enable trending for that point and then
define how you want the controller to collect the point's data.
1 On the GEO tree, select the equipment that has the point you want to trend.
2 Click the Trends button drop-down arrow, select Disabled Points, then select the point.
3 Click the Enable/Disable tab, then select Enable Trend Log to have the controller collect trend
data.
4 Enter information in the appropriate fields. See table below.
5 Click OK.
TIP You can set up all trends for a piece of equipment at once on the Trend Sources tab of the
equipment's Properties page.
Field Notes
Sample every _:_:_ Records the point’s value at this interval.
(hh:mm:ss) NOTE Set trend intervals for U line controllers to one minute or
greater. U line controllers are designed to meet low end, high volume
terminal control applications and are not suited to very short trend
intervals.
Field Notes
Sample on COV Records the point’s value only when the value changes by at least the
(change of value) amount of the COV Increment.
NOTE Use this method for a binary point or for an analog point that
has infrequent changes in value.
Allocate memory for __ Type the maximum number of samples to be stored in the controller.
samples in the controller NOTES
• Trending consumes memory in the controller. The amount of
memory available depends on the type of controller. Each
trended point consumes 48 bytes of memory plus 10 bytes for
each trend sample. Each trend microblock consumes 416 bytes
of memory plus 10 bytes for each trend sample.
• Click Reset to delete all samples currently stored in the controller.
• Changing the value in Allocate memory for __ trend samples in
the controller will delete all of the point's trend samples currently
stored in the controller. Click the Store Trends Now button before
changing the value to transfer the trend data from the controller
to the system database.
The sample and memory allocation fields together define trend data
storage in the controller in terms of hours.
EXAMPLE If you set these fields so that samples are collected every
5 minutes for a maximum of 120 samples, the controller will store
600 minutes (5 x 120) or 10 hours of trend data.
Stop When Full Select this field to stop trend sampling when the maximum number
of samples is reached.
Enable trend log at specific Collects trend data for the specific period of time you define in the
times only? time and date fields.
Enable Trend Historian Archives trend data to the system database.
Store Trends Now Writes all trend data in the controller to the system database without
having to enable trend historian.
Every __ trend samples write Writes all trend data in the controller to the system database each
to historian time the controller collects the number of samples that you enter in
this field. This number must be greater than zero and less than the
number entered in the field Allocate memory for __ samples in the
controller. The number of trends specified must be accumulated at
least once before the historical trends can be viewed.
Trend samples accumulated Shows the number of samples stored in the controller since data was
since last notification last written to the database.
Last Record Written to Shows the number of trend samples that were last written to the
Historian database.
Keep historical trends This is based on the date that the sample was read. Set this field to 0
for __ days to use the system default value.
Delete Deletes all trend samples stored in the database for the item
selected in the GEO tree.
Field Notes
BACnet Configuration The Object Name is a unique alphanumeric string that defines the
BACnet object. Although the Object Name field can be edited, it is not
recommended. The Notification Class is set to 1 to receive alarms
generated by Automated Logic® controllers.
NOTES
• You can use Global Copy (page 44) to copy trend properties to other pieces of equipment that use
the same control program.
• Run a Trend Usage report (page 115) to view trend data.
A comparison trend graph can display up to 4 graphs on the page. Each graph can display up to 4
similar points—4 binary points or 4 analog points.
NOTES
• Before you create a comparison trend graph, you must enable trending for the individual points
you want to include in the graph. See To collect trend data for a point (page 66).
• You can display icons and hover text in the GEO tree that show where trend graphs for multiple
points have been created. See Tree icons and hover text (page 25).
NOTES
• A large marker indicates a point that is in alarm, in fault, out of service, or has been overridden.
Ctrl+click the marker to view details.
• A dotted vertical line indicates:
○ Trend Historian has been enabled or disabled.
○ The trend object ID of a third-party trend source has been changed. For information only, you
do not need to do anything.
○ Equipment received a time synchronization from its network router or from the WebCTRL®
application. Ctrl+click the line to view the time correction.
○ Trend Log has been enabled or disabled.
• Ctrl+click a dotted vertical line to view details.
7 Convert the trend data in the Time column to a readable date/time format using the spreadsheet
application’s formatting options. For example, in Microsoft Excel, highlight the cells you want to
format and choose Format > Cells. On the Number tab, choose Time from the Category list, and
select the type of format you want to see.
1 On the GEO tree, select the equipment that has the trend graph properties you want to configure.
2 Click the Trends button drop-down arrow, then select the trend you want to change.
3 Click the Configure tab.
4 Edit the graph properties as needed. See table below.
5 Click OK.
Field Notes
Font size Lets you change the font size of the graph's title and other text.
Enable Grid? Show or hide the graph's grid.
Autoscale x-axis Gathers the most recent 2000 data samples and then autoscales the x-axis
to include the complete time range of all the samples.
X initial range If you do not autoscale the x-axis, type in this field how far back in time you
want to display data. For example, if you want to see trend data from a
week ago, type 7 in the Days field.
Autoscale y-axis Gathers the trend data from the controller and then autoscales the y-axis to
include the complete range of values.
Y-axis minimum and If you do not autoscale the y-axis, type the minimum and maximum value
maximum that you want the graph to display.
Graphs* Add or delete graphs from the page.
Points* Add or delete points from the graph selected in the Graphs table.
* for custom graphs only
1 On the CFG tree, select Trends Display Setup to change the settings for displaying trend graphs or
select Trends Print Setup to change the settings for printing trend graphs.
2 Follow the appropriate instructions below.
3 Click OK.
To change a color
Click the colored box to the right of the graph element that you want to change, then select the new
color in the color palette. Or, you can type the hexadecimal value in the RGB field.
For a point trend graph, select the new line style and marker type under Graph 1, Data Series 1.
For a custom trend graph:
1 Click the plus sign (+) to the left of the graph you want to change.
2 The 4 Data Series refer to the 4 points that you can include on a custom trend graph. Under the
appropriate Data Series, select the new line style and marker style you want.
Default settings on Trends Display Setup and Trends Print Setup pages
If you make changes to the Trends Display Setup and Trends Print Setup pages and then find you
need to return them to their original settings, refer to the images below that show the default settings.
4 Select a privilege so that only operators with that privilege can access trends in the category.
5 Click OK.
NOTE To delete a category, select the category, click Delete, then click OK.
Chapter 8
Alarms
An alarm is a message sent from an alarm source (usually a microblock in a control program) to the
WebCTRL® application to notify you that certain conditions exist, such as a piece of equipment has
stopped running or a temperature is too high. When the WebCTRL® application receives an alarm, it
displays information about the alarm on the Alarms page. It can also perform alarm actions to inform
personnel of the condition and to record information about the alarm. An alarm source can also send a
return-to-normal message when the alarm condition returns to its normal state.
Alarm sources and the alarms they generate are assigned to categories, such as HVAC Critical or HVAC
Maintenance, to help you work with related alarms.
The application engineer usually sets up alarm sources in the EIKON® LogicBuilder application. In the
WebCTRL® interface, you can:
NOTE Besides the alarms that you set up, the WebCTRL® application has built-in system and
equipment alarms.
You must acknowledge alarms that have been set up to require acknowledgement.
The WebCTRL® application closes an alarm when all of the following have occurred:
• You acknowledge the alarm (if required)
• The WebCTRL® application receives a return-to-normal (if required)
• The WebCTRL® application performs all alarm actions
You should delete alarms from your system as they are closed because large quantities of stored
alarms can reduce the efficiency of your system. To save alarm information before deleting, select
Alarms > Reports tab > Alarms > click Run button.
NOTE This information includes a path to the alarm source. Each section of the path is a link to
that location. For example, in the path West Wing/RTU-1/SSP_LO, West Wing links to the West
Wing graphic, RTU-1 links to the equipment graphic, and SSP_LO links to microblock's Properties
page.
Item Notes
View By Select one of the following options to sort the alarms list:
Date Displays all alarms based on the time the alarm was generated
with the most recent alarm at the bottom of the list.
To Do Displays only alarms that are waiting on one or more actions to
complete before they are closed.
Incident Groups the alarms in an alarm incident group with a bracket to
Group the left of the icons.
Alarm incident group All alarms related to a particular incident.
For example, an alarm and its return-to-normal form an alarm
incident group.
Status table Gives the status of alarms at the current location (Here) and in the entire
system (Total). This table shows the number of alarms that need a
return-to-normal, need to be acknowledged, or are closed.
Item Notes
Details The alarm message.
NOTE An alarm that requires a return-to-normal appears in red text until the
alarm condition returns to normal.
Navigation buttons Use these buttons to move through the alarm list.
NOTES
• Alarms generated by the WebCTRL® application appear at the system level.
• Alarms generated by controllers appear at the system level on the GEO tree, but in the network
hierarchy on the NET tree.
To acknowledge alarms
TIP Acknowledging many alarms simultaneously can take a long time. Acknowledge alarms as
they occur to avoid long waits.
To delete alarms
NOTES
• To have the WebCTRL® application automatically delete alarm incident groups a specified number
of days after the groups close, select this option on the Scheduled Tasks tab in System Settings
(page 159).
• Also on the Scheduled Tasks tab in System Settings, you can set the WebCTRL® application to
archive alarm information to a text file as alarms are deleted.
• An alarm source may be set up to generate an alarm and a return-to-normal. If an alarm occurs
but the WebCTRL® application never receives the return-to-normal, you can click Force Normal so
that the alarm can be closed. Force Normal has no effect on the alarm condition that generated
the alarm.
Alarm Popup
The Alarm Popup alarm action pops up a message on any computer that is running the WebCTRL®
Alarm Notification Client application.
Field Notes
To Operator Select individual operators or operator groups who should receive alarm
To Group notification.
Generate alarm if Select this checkbox to generate a System Info alarm if the popup recipient is
delivery fails not currently running the Alarm Notification Client application.
Message text Use punctuation, spaces, or returns after the entries to format the text.
To add live data to the text, select field codes (page 107) from the Append
Field Code list.
Append Field Code Add field codes (page 107) to the message text if desired.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
Select an alarm message, then click to open a browser window displaying the piece of equipment
that generated the alarm. A grayed out alarm indicates that it was acknowledged in the WebCTRL®
interface.
If the Alarm Notification Client is set up to play a continuous alarm sound, you can silence an alarm by
clicking Silence!, by pressing Ctrl+S, or by acknowledging the alarm in the WebCTRL® interface.
Button Notes
Opens a browser window that displays the equipment that generated the alarm.
Removes the alarm information from the alarm popup list. Removing items from this list
has no effect on the alarms list in the WebCTRL® interface.
View information about the server connection.
Server The WebCTRL® server and port, and the WebCTRL® operator name
Connection and password
NOTE The default port is TCP 47806. If you change this, you must
also change the Port field in the WebCTRL® System Settings. See "To
set up the WebCTRL Server application to support Alarm Popup
clients" below.
Browse To The WebCTRL® page that you want to see first when browsing to the
equipment
Internet Explorer Whether or not browsing to the equipment opens a new browser
window
Notification • If you want to hear a sound when an alarm occurs
Sounds • Which sound you want to hear for each type of alarm.
NOTE A Connection Failure occurs when the Alarm Notification
Client loses communication with the WebCTRL Server application.
• Whether you want the sound to continue until silenced
NOTE If multiple types of alarms occur simultaneously, the
application plays the sound of the most critical alarm (Connection
Failure first, then Critical, then Normal).
4 In the Settings dialog box, enter appropriate values. You can also click to open this box. See
the table above for a description of each setting.
NOTE You can lock the Settings so that a user cannot edit them. See To lock a client's Settings
feature below.
5 Click OK.
6 Minimize the Alarm Notification Client window.
Print
The Print alarm action prints alarm information.
Field Notes
Text Printing Select to use the WebCTRL® server's local dot-matrix printer. Text Printing will
not print to a network printer.
In the Printer Name field, type the computer port that the printer is connected
to. In the Line Width field, type the number of characters to be printed per
line.
Prints multiple alarms per page.
Graphics Printing Select to use the WebCTRL® server's default printer (local or network printer).
Prints one alarm per page to the WebCTRL® server's default printer.
Text to Print Use punctuation, spaces, or returns after the entries to format the text.
To add live data to the text, select field codes (page 107) from the Append
Field Code list.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
Propagate To Server
The Propagate To Server alarm action sends the selected alarm to the parent server in a system with
hierarchical servers.
Field Notes
Message text The alarm message that is sent to the parent server.
Append Field Code Add field codes (page 107) to include live data in the Message text field.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
Field Notes
Command Line The path of the executable file on the WebCTRL® server followed by the path
of the output file.
EXAMPLE:
c:\windows\notepad.exe c:\WebCTRL\webroot\alarms.txt
Field Notes
Append Field Code Add field codes (page 107) to the Command Line field.
EXAMPLE:
c:\reports\run_report.bat $Generation_time$$To_State$
This starts a batch file on the server and uses the alarm’s generation time
and state as values.
Synchronize Tells the WebCTRL® application to wait for the external program to finish
running before initiating the next Run External Program alarm action.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
Field Notes
To Type the address(es) that you want to send the alarm to. To enter multiple
addresses, type a space or press Enter after each address.
From Enter a valid address if required by your mailserver.
Mail Host The mailserver's address. This can be an IP address or a system name,
such as mail.mycompany.com.
Mail Host Port Change this field if using a port other than the default port 25.
Field Notes
Mail Host Security Select the type of security the mailserver uses.
Options • Cleartext – Uses the SMTP protocol to send as clear text over TCP/IP
• Secure SSL – Uses SSL, a communication protocol that provides data
encryption
• Secure TLS – Uses SSL, but does not begin encryption until the
WebCTRL® application issues STARTTLS command
Specify Mail User For Select if your mailserver requires a username and password.
Mail Host
Authentication
Send mail as MIME Select if your mailserver allows only MIME attachments.
attachment
Message Text Use punctuation, spaces, or returns after the entries to format the text.
To add live data to the text, select field codes (page 107) from the Append
Field Code list.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
NOTE You should not assign this alarm action to frequently-occurring alarms as this may cause
problems on your network or the Internet.
1 Set up your modem to dial out to your Internet Service Provider. See your modem documentation.
2 On the WebCTRL® server, open Internet Explorer.
3 Select Tools > Internet Options.
4 On the Connections tab, click Setup.
5 Follow the instructions in the wizard. See Windows Help for assistance.
6 In a text editor such as Windows Notepad, open WebCTRLx.x\webroot\<system>\
system.properties.
7 At the end of the file, type the following line:
repactions.connection.name=<name of connection>
where <name of connection> is the ISP name you entered in the wizard in step 2.
8 Open Internet Explorer, then select Tools > Internet Options > Connections tab.
9 If the box under Dial-up and Virtual Private Network settings shows more than one connection,
select the connection that you just created, then click Set Default.
10 Select Always dial my default connection.
Send E-mail
The Send E-mail alarm action sends a message to one or more e-mail accounts. The alarm action can
also run a report and attach it to the e-mail as a PDF, HTML, or Excel file.
Field Notes
To Type the address(es) that you want to send the alarm to. To enter multiple
addresses, type a space or press Enter after each address.
From Enter a valid address if required by your mailserver.
Mail Host The mailserver's address. This can be an IP address or a system name,
such as mail.mycompany.com.
Mail Host Port Change this field if using a port other than the default port 25.
Mail Host Security Select the type of security the mailserver uses.
Options • Cleartext – Uses the SMTP protocol to send as clear text over TCP/IP
• Secure SSL – Uses SSL, a communication protocol that provides data
encryption
• Secure TLS – Uses SSL, but does not begin encryption until the
WebCTRL® application issues STARTTLS command
Specify Mail User For Select if your mailserver requires a username and password.
Mail Host
Authentication
Send mail as MIME Select if your mailserver allows only MIME attachments.
attachment
Message Text Use punctuation, spaces, or returns after the entries to format the text.
To add live data to the text, select field codes (page 107) from the Append
Field Code list.
Field Notes
Attach Report Select to attach a WebCTRL® report to the e-mail, then select the Report and
the Format.
NOTE The Report Name field shows a custom report only if it was created at
the current system level.
Run as shows the name and login name of the operator creating the alarm
action. The report will be run using the privileges and report options of this
operator.
TIP You may want to create a new operator with limited privileges for this
purpose.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
NOTE You should not assign this alarm action to frequently-occurring alarms as this may cause
problems on your network or the Internet.
C:\WebCTRL<x.x>\java\<operating_system>\jre\bin\keytool.exe -import
-trustcacerts -alias smtpserver -keystore webserver\keystores\certkeys
-file <file_path>
replacing:
<x.x> with the system's version number
<operating_system> with the WebCTRL folder name for the operating system you are running
<file_path> with the full path and file name of the certificate file
5 The information for the smtpserver key is displayed and you are prompted to trust this certificate.
Type yes.
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Alarming.
The Send SNMP Trap alarm action sends an SNMP trap in response to receiving an alarm. Traps
contain the text created in the Text to send as the SNMP Trap field in the alarm action dialog box. You
can configure up to five SNMP servers to receive traps.
NOTES
• WebCTRL® supports SNMP v1.
• Each SNMP server you want to receive these traps must have SNMP monitoring equipment
installed. If problems arise with your SNMP connection or receiving traps, contact your IS
department.
• This alarm action uses Port 162 to send SNMP traps. To use a different port, open
WebCTRLx.x\webroot\<system_name>\system.properties in a text editor such as Notepad. In
the line #snmp.trap.port = 162, delete # at the beginning of the line and change 162 to the port
you want to use. If you make this change while the WebCTRL® Server application is running, you
must restart it to have the change take effect.
Field Notes
Network Address* The network address of the SNMP server receiving the SNMP trap.
Community Name* The community name that the SNMP server belongs to.
Comment The physical location of the SNMP server. This field is optional.
Trap number* If the network administrator has configured trap numbers, type a unique
number from 1 to 127.
NOTE The same trap number is used for all messages from this alarm action.
Text to send as the 255 character limit. Type punctuation, spaces, or returns after the entries to
SNMP Trap format the message. You can customize this text by selecting field codes
(page 107) from the Append Field Code list.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
* Ask your network administrator for this information.
Write Property
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Alarming.
The Write Property alarm action writes a specified value to a BACnet property. You typically set up 2
alarm actions, the first writes a value when the alarm occurs and the other writes a value when the
return-to-normal occurs.
Field Notes
Expression Type the target property’s expression.
Value to Write Type the value you want to write to the microblock property. Type 0 or 1 for a
binary property.
Append field code to Select field codes (page 107) to add this information to the Value to Write
value field.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
Write to Database
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Alarming.
The Write to Database alarm action stores alarm information in a table in the WebCTRL® alarm
database or in a custom database. Third-party applications can access the alarm information for
building maintenance management or alarm analysis. For example, an application can perform actions
such as triggering a stored procedure or running a report.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for
a schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
NOTES
• To keep the database table from growing too large, you must delete old entries using a third-party
database application. You cannot view, edit, or delete entries in the WebCTRL® interface.
• If your system uses an Access or MSDE database, you cannot open the database in a third-party
application while the WebCTRL® or SiteBuilder application is running.
Field Notes
Text to write to the The text is made up of field codes (page 107) that add live data to the text.
database You can select additional field codes from the Append Field Code list.
NOTE To write the text in this field to the custom database, you must include
the Report Text field code ($report_text$) in the Database Insert String field
described below.
Database Connect For database type... The connect string format is...
String SQL Server jdbc:odbc:<odbc_alias>
MySQL jdbc:mysql://<host>:<port>/<instance>
PostgreSQL jdbc:postgresql://<host>:<port>/<instance>
Oracle jdbc:oracle:thin@<host>:<port>/<instance>
where:
<host> is the database server name/IP address
<port> is the port number for the database
<instance> is the database name in the database
server
<odbc_alias> is the name of the ODBC data source
Database Login and The login and password to connect to the database.
Password
Database Insert Use the following format:
String Insert into <TABLE_NAME> (<column1_name>, <column2_name> ...) values
(<$field_code1$>, <$field_code2$>, ...)
Example:
Insert into WebCTRL_ALARMS (TIME_, LOCATION_, TO_STATE_, TEXT_) values
($generation_time$, $location_path$, $to_state$, $report_text$)
NOTES
You can add field codes (page 107) to the Insert String using the Append
Field Code list.
If you add a timestamp type field code (for example, $generation_time$), you
should have the data go into a timestamp data type field in the custom
database. Otherwise, you must use field code formatting (page 107) to format
the time.
Field Notes
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged
or has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule
group or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the
same as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours.
Under Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
Write to File
The Write to File alarm action can do either of the following:
• Record alarm information in a standard ASCII text file that you can view and edit using a text editor
such as Windows® Notepad.
• Write a WebCTRL® report to a file.
Field Notes
File Name Path name for the file you want to write to such as
c:\WebCTRLx.x\webroot\alarms.txt.
• If you do not specify a path, the file is written to the system folder.
• If you type a path that does not exist, the WebCTRL® application will create
the necessary folders.
• You can write to one of the following:
- a file on the server
- a networked computer if you map the network drive. Use
the drive mapping in the path from the server to the computer.
• The path name may contain field codes (page 107).
Write as File Select to record alarm information in a text file.
Field Notes
Append Select to append new alarm information to the end of the file instead of writing
over existing data.
NOTE Because you can append new alarm information to the end of the file,
this file can become very large. You must back up and delete this file
frequently if you are using this alarm action with many alarms.
Text to write to the Use punctuation, spaces, or returns after the entries to format the text.
file To add live data to the text, select field codes (page 107) from the Append
Field Code list.
Write as Report Select to write a WebCTRL® report to a file, then select the Report and the
Format.
NOTE The Report Name field shows a custom report only if it was created at
the current system level.
Run as shows the name and login name of the operator creating the alarm
action. The report will be run using the privileges and report options of this
operator.
TIP You may want to create a new operator with limited privileges for this
purpose.
Perform Action By default, the WebCTRL® application performs an alarm action when the
alarm source generates an alarm and when it returns to normal. Under
Perform Action, you can choose to run the alarm action:
• Only when the alarm source generates an alarm or when it returns to
normal.
• After a specified amount of time if the alarm has not been acknowledged or
has not returned to normal. Use this option for alarm escalation. *
• If the alarm occurs during the occupied hours defined for a schedule group
or run if the alarm occurs during the unoccupied hours defined for a
schedule group. *
EXAMPLE To have one alarm action performed during work hours and a
different alarm action performed after work hours:
1. Create a schedule group (page 59), but do not assign members to it.
2. Create a schedule for the group. Set the occupied hours to be the same
as the work hours.
3. Create the alarm action that is to be performed during work hours.
Under Perform Action, select If schedule group <your new group> is
Occupied.
4. Create the alarm action that is to be performed after work hours. Under
Perform Action, select If schedule group <your new group> is
Unoccupied.
* Available only if you have the Advanced Alarming package.
TIP To set up all the alarms for a piece of equipment at once, click Properties, then select Alarm
Sources.
Field Notes
Potential alarm source Select the checkbox to enable the alarm source to generate alarms. Clear
the checkbox to disable the alarm source.
Field Notes
Alarm Select to have the alarm source generate an alarm when the specified
conditions occur.
• For a binary input, enter the conditions for generating an alarm.
• For an analog input, type the low and high limits that, when exceeded,
will generate an alarm.
= Critical = Non-critical
Event State The current state of the alarm source can be:
• Normal—value is normal
• Off normal—the value is not normal (binary only)
• Fault—the alarm source microblock may be misconfigured
• High Limit—the value exceeds the normal range (analog only)
• Low Limit—the value is below the normal range (analog only)
BACnet Configuration:
Dial on alarm Select to have this alarm immediately delivered through a modem
connection.
NOTE When monitoring your system through a modem connection,
non-critical alarms are stored in the gateway until one of the following
happens:
• a critical alarm occurs
• the gateway is contacted by the WebCTRL® application
• the gateway buffer is full, at which time all alarms are sent to the
WebCTRL® application
Field Notes
Notification Class Do not change this field.
To simulate an alarm
To test the setup of an alarm source and its alarm actions (page 83), you can simulate an alarm or its
return-to-normal.
1 On the GEO tree, select the alarm source ( , but not ) whose alarm you want to simulate.
2 Click Alarms, then select the Enable/Disable tab.
3 Select the Enable checkbox next to Alarm or Return to Normal.
4 Click Simulate next to Alarm or Return to Normal.
5 Select the equipment on the tree, then select the View tab to see the alarm.
Customizing alarms
Each alarm source has an alarm message, category, and template defined in the EIKON® LogicBuilder
application. You can change messages and categories in the WebCTRL® application.
Alarm messages
An alarm message is the information that appears on the Alarms page View tab for an alarm. An alarm
message can consist of 3 parts.
You can edit Text only at the alarm source in the EIKON® LogicBuilder application.
Prefix and Details are hierarchical. They apply at the location where they are added and to all its
children. For example, you could enter Details at the system level to show the acknowledge time for
alarms in the HVAC Critical category. The acknowledge time would then be in any HVAC critical alarm
message in the system.
NOTE An alarm action can have a different message from the alarm message seen on the View tab.
To edit the message for a particular alarm action, see Setting up alarm actions (page 83).
3 In step 1, select the categories that contain the alarm sources whose messages you want to edit.
NOTE In step 1 and step 2, Ctrl+click, Shift+click, or both to select multiple items, or select the
Select All checkbox.
4 In step 2, select the alarm sources.
5 In step 3, select Add new prefix to beginning of message or Add new details to end of message.
6 Click Add.
7 Type text and add field codes as needed.
8 Click OK.
Alarm categories
Alarm categories sort related alarm sources and their alarms into groups such as HVAC Critical and
Access Control General. Alarm categories let you:
• View, acknowledge, or delete selected categories of alarms (page 79) received by the WebCTRL®
application
• Assign alarm actions (page 83) to selected categories of alarm sources
• Set up alarm sources (page 101) in selected categories
Each alarm source is assigned to an alarm category in the EIKON® LogicBuilder application, but you
can change the category assignment in the WebCTRL® application.
The WebCTRL® application has a number of default alarm categories, but you can create custom
categories, if needed.
Field Notes
Reference Must be unique in the database, be lowercase, and not contain any spaces. This
Name name must be identical to the name of the custom alarm category that you added in
the EIKON® LogicBuilder application.
Icon 1 Find or create a 32 x 32 pixel icon (.gif file) that represents the new category. For
example,
2 Store the .gif file in the WebCTRLx.x\webroot\_common\lvl5\
graphics\event_categories folder.
3 Type
/_common/lvl5/graphics/event_categories/<file_name>.gif in
the Icon field.
TIP To change all alarms in the system simultaneously, go to the system level and then select all
categories and all alarm sources on the Templates tab.
Use the table below to determine the format_type and style for a formatting command.
Example
format_type style
To format a N The actual formatting, To always truncate an alarm
number such as ##.##. The basic value to two digits to the right
format uses the pound of the decimal, the field code
sign (#) to represent a is:
number. See Other $alarm_value%N:##.##$
numerical formatting For example, 78.9935
System Options becomes 78.99.
http://java.sun.com/j2se
/1.4.2/docs/api/java/te
xt/DecimalFormat.html.
To format D The actual formatting, To show the date and time
date/time such as MM/dd/yyyy when an alarm is generated in
hh:mm:ss. See Date time a format like 03/15/2004
formatting System 10:50:43, the field code is:
Options $generation_time%D:MM/dd/
http://java.sun.com/j2se yyyy hh:mm:ss$
/1.4.2/docs/api/java/te
xt/SimpleDateFormat.ht
ml.
To set alignment L for left align Indicate the field width by To left align the name of the
and field width R for right align number of characters. device that generated the
C for center align alarm and set the field width
to 15 characters, the field
code is:
$device%L:15$
NOTE You must enter the date/time or number formatting command before the alignment/field width
command.
Field Codes
Chapter 9
Time-lapse
You can replay up to 24 hours of Graphics, Alarms, or Trends pages starting on a specified date and
time. Time-lapse can be a helpful troubleshooting tool.
For Time-lapse to show thermographic colors, the WebCTRL® application polls each router in the
system at specified intervals and collects color. Color is collected for the router and its downstream
controllers only if their control program contains a Setpoint, Set Color, or Set Color If True microblock.
The Server then uses the collected colors to create a trend called Color Trend.
To play Time-lapse
1 Select the location in the tree where you want to see the time-lapse.
2 Click the menu button , then select Time-lapse.
3 In the Replay field, select the length of time that you want to replay. The replay will step through
the data at the interval shown.
4 In the Start field, select the date and time that you want the replay to begin. You can click:
NOTES
• While in time-lapse, you can navigate to other locations in the tree.
• The Graphics page can replay only trended values. Values that are not trended are grayed out.
Floorplan areas without trend data are dark grey.
• You can select an alarm on the Alarms page and then click the Activate Time-lapse button. This
changes the time-lapse to the 1-hour period in which the alarm occurred. You can step backward
or forward through the time-lapse at 1-minute intervals to see what other alarms occurred during
that hour. You can also go to Graphics or Trends to see what else happened when the alarm
occurred.
• The white horizontal line on a Trends time-lapse indicates where the replay currently is in the
time-lapse range.
Chapter 10
Reports
Use WebCTRL® reports to monitor and troubleshoot your system. In the WebCTRL® interface, you can:
• View preconfigured reports
• Create custom reports
See the table below for a list of all reports.
The Reports button drop-list varies depending on whether you selected the GEO
or NET tree and if you have created any custom reports at or above the
selected location.
A report shows data for the selected item and all of its children.
NOTE You can display icons and hover text in the GEO tree that show where
custom reports have been created. See Tree icons and hover text (page 25).
Schedules
Schedule Instances Find every schedule with its location that is entered at and below a
selected tree item. This report can help you discover newly added and
conflicting schedules.
Effective Schedules View all equipment that may be scheduled and the net result of all
schedules in effect for a selected date and time.
Commissioning
Test & Balance View the results of VAV box commissioning. Running this report
automatically uploads calibration parameters to the WebCTRL®
application.
Equipment Checkout View the information on the Equipment Checkout tab of the equipment's
Properties page during commissioning. Also, find equipment that has
not been fully commissioned.
Alarms
Alarms View, sort, and filter the information on the Alarms View (page 79) tab.
Alarm Sources Create a summary of potential alarm sources as configured on the
Alarms > Enable/Disable (page 101) tab.
Alarm Prefixes & Details Create a summary of the information configured on the Alarms >
Messages (page 104) tab.
Alarm Actions Create a summary of the information configured on the Alarms > Actions
(page 83) tab.
Equipment
Point List View the details of all points. Verify that all points have been checked
out during commissioning. Also, create custom lists for other
contractors. For example, create a list of BACnet IDs or Web services
links.
Locked Values Find all locked points and locked values.
NOTE Locks in the Airflow microblock are not reported.
Network IO Verify the programming and status of all network points—especially
useful for commissioning controllers used for third-party integration.
Trend Usage Creates a summary of the information configured on the Trends >
Enable/Disable (page 66) tab.
Parameter Mismatch Discover where your system has parameter mismatches that need to be
resolved.
Security NOTE You must have the Advanced Security package to run these
reports.
Location Audit Log View chronological lists of location-based changes, the operators that
made them, and the reasons for the changes. This report includes
changes such as property edits, downloads, driver changes, and view
changes.
System Audit Log View chronological lists of system-wide changes, the operators that
made them, and the reasons for the changes. This report includes
changes such as any change made in the CFG tree, login/logout, and
scheduled processes like deleting expired trends
Network
Equipment Status Display the thermographic color, status, and prime variable of each
control program.
Controller Status Discover network communication problems (shown as purple squares on
the report) that need troubleshooting. The report also shows boot and
driver version, download information, and if controller has 4.x or later
driver, the report shows the serial number and Local Access port status.
Equipment Summary View the following information for equipment at or below the location
where the report was created:
• Color
• Active alarm
• Locked values
• Current value of selected points
• Effective schedule
See To create an Equipment Summary report (page 118).
Equipment Values Compare point information. See To create an Equipment Values report
(page 119).
NOTE This report is available only if your system has the optional
Advanced Reporting package.
Trend Samples View trend values for a particular time frame. See To create an Trend
Samples report (page 121).
NOTE This report is available only if your system has the optional
Advanced Reporting package.
NOTE The Send E-mail alarm action (page 91) can run any WebCTRL® report and attach it to the
email. The Write to File alarm action (page 99) can run any WebCTRL® report and save it as a file. For
both alarm actions, the report can be a PDF, HTML, Excel, or CSV file.
To run a report
1 Select an item on the GEO or NET tree.
2 Click the Reports button drop-down arrow, then select a report.
3 On the Options tab, define the layout and content of the report.
NOTES
○ Changing the size and orientation of the printed page also changes the report layout on the
View tab.
○ To create a CSV (Comma Separated Values) file after you run the report, select Support CSV
text format. See To create a PDF, Excel spreadsheet, or CSV file (page 122).
○ The current operator's report options are saved so that when that operator logs in again, the
same options are used.
4 Click Run.
5 Click PDF if you want to print the report.
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Reporting.
Data is named Select this checkbox if similar points have different names
differently in some in different control programs. Then add each of the names
equipment to the Name to use list.
For example, if a point is named Zone Temp in one control
program and Zone Temperature in different control
program, add both names to the list.
Point to use Select the name of the point to show in the column.
Trend Sample Display Select First, Minimum, Maximum, or Last recorded trend
value.
Data is named Select this checkbox if similar points have different names
differently in some in different control programs. Then add each of the names
equipment to the Name to use list.
For example, if a point is named Zone Temp in one control
program and Zone Temperature in different control
program, add both names to the list.
Trend to use Select the name of the point to show in the column.
Set Click to have all columns in the report use the same time
range.
Time Range Select the time range to run the report for.
Set Click to have all columns in the report use the same time
range.
Time Range Select the time range to run the report for.
Control Program Display Select Color, Display Name, Display Path, Notes, Prime
Variable, or Reference Name to show in the column.
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Reporting.
A Trend Samples report provides trend values for a particular time frame.
To create a Trend Samples report:
1 On the GEO or NET tree, select the location where you want to view the report.
2 Select the Reports button drop-down arrow, then select New Report.
3 Select Trend Samples.
4 Optional: Select a Category.
NOTE The Category drop-down list is only visible if you have defined report categories. See To
organize custom reports (page 123).
5 Type a name for the report.
6 Click Create.
7 Select a Time Range from the drop-down list, then refine that option by selecting an option from
the drop-down list(s) to the right.
8 Define the trend data.
NOTES
○ Calculate values for missing samples calculates a value based on the 2 closest values to the
time interval.
○ Find the closest sample displays the value closest to the time interval selected.
9 Optional: Select the Highlight alternate rows checkbox to make the report easier to analyze.
10 Click Next or next to Columns.
11 Verify or change the report Title, Page units of measure for defining column widths, and Outer
border characteristics.
12 Select a column in the report preview.
NOTE The selected column is light purple.
13 Under Column Header, define how you want the column header to look.
14 Under Column Data, select the source of the trend data and how you want the data to look.
NOTE Select General from the Format drop-down list unless you want to define the number of
places to the right of the decimal point for the displayed value.
15 Optional: Use the Add, Delete, and arrow buttons below the report preview to manipulate the
columns.
16 Optional: Click next to Page to change the page size and orientation.
NOTE Changing the size and orientation of the printed page also changes the report layout on the
View tab.
17 Click OK.
18 Click Run.
NOTE To run this report later, go to the location where the report was created. Click the Reports
button drop-down arrow, select the report, then click Run.
1 Run a report.
2 Click PDF, Excel, or CSV Text.
3 For Excel or CSV Text, click Open to view the file or Save to save it.
NOTE If you need a digitally signed PDF to comply with 21 CFR Part 11, open the PDF in a program
that supports digital signing such as Adobe Acrobat®, then sign the PDF. The WebCTRL® application
does not support digital signing because 21 CFR Part 11 requires that the signature be added
manually, not through an automated process.
NOTE To delete a category, select the category, click Delete, then click OK.
f1j9_de.jar
f1j9_es.jar
f1j9_fr.jar
f1j9_it.jar
f1j9_ko.jar
f1j9_zhs.jar
f1j9_zht.jar
f1j9swing.jar
f1jtextures.jar
Then follow the steps below to make the reports appear in the Reports button drop-down list.
3 Select Other, then select a report type from that drop-down list. Name the report, then click Create.
NOTE Report Designer is licensed to Automated Logic by Actuate Corporation for WebCTRL® v2.5 and
earlier systems.
Chapter 11
Operator access
Privileges control the parts of a WebCTRL® system an operator can access. Privileges also control
what an operator can do and what he can change.
To set up operator access to your system:
1 Log in to the WebCTRL® application as the Administrator. See Operators and operator groups
(page 129).
2 Define privilege sets by job function. See Privilege sets (page 125).
3 Enter each operator in the system by assigning him privilege sets and entering settings that apply
only to him. If you need to assign the same privilege set to multiple operators, you can create an
operator group and assign the privilege set to the group. See Operators and operator groups (page
129).
An operator can change many of his operator settings on the My Settings page (page 131).
To access the WebCTRL® interface, an operator must enter his user name and password. This
password requirement can be enhanced by using the advanced password policy (page 137) (available
with the optional Advanced Security package).
CAUTION Each microblock property has a default Editing Privilege (represented by the Preset
option) that is appropriate for that property. Changing Preset to a specific privilege changes every
property in the microblock to the same privilege which may produce undesirable results.
Privilege sets
A privilege set is a group of one or more privileges (page 126). The Administrator creates privilege sets
and assigns them to operators and operator groups.
Privileges
CAUTION Include all required access privileges in a privilege set. For example, if you add
Acknowledge Non-Critical Alarms to a privilege set, also add Access Alarms to that privilege set.
TIP To create a privilege set that is similar to an existing set, select the existing set, then click
Add. The privileges that are initially selected are identical to those of the existing set.
Default operators
A WebCTRL® system has the following default operators:
To ensure system security, log in as the Administrator, then do one of the following:
• Assign the Admin privilege set to another operator, then delete the Administrator operator
• Assign a password to the Administrator operator.
If you want to prevent Anonymous access to your system, delete the Anonymous operator.
Field Notes
Login Name The name the operator must type to log in to the system. This name must be
unique within the system.
Change password Enable this field, then type the current and new passwords.
NOTE An operator can change his password on the My Settings page (page
131).
Force User to Forces the operator to change his password immediately after his next login.
Change Password at NOTE Use this field with the Change Password field to create a temporary
login? password that the operator must change after his next login.
Exempt From If the advanced password policy is enabled in System Settings on the Security
Password Policy tab (page 160), select this option if you do not want the policy to apply to this
operator.
Logoff options If the automatic logoff feature is enabled in System Settings on the Security
tab (page 160), select one of the 3 logoff options.
Personal Information You can enter contact information for this operator.
NOTE An operator can enter contact information on the My Settings page
(page 131).
Starting Location The WebCTRL® location and page that will be displayed after the operator
and logs in.
Starting Page
System-wide To assign a privilege set to the operator, select the privilege set's checkbox.
Privilege Sets NOTES
• Click Show current privileges only to see only the selected privilege sets.
• A grayed out privilege set with a group name beside it indicates the
operator is inheriting that privilege set from the group.
To delete an operator
1 On the CFG tree, select Operators.
2 Select the operator.
3 Click Delete.
4 Click OK.
TIP Every operator is automatically a member of a permanent default group called Everybody. You
can assign privilege sets to this group.
CAUTION When you delete an operator group, its individual members lose the privilege sets that
were assigned to the group.
To change My Settings
On the My Settings page, you can change settings, such as your:
• Password
• Viewing preferences
• Contact information
NOTE The System Administrator can also change these settings on the Operators page.
Field Notes
Change password Enable this field, then type your current and new passwords.
Starting Location and The WebCTRL® location and page that will be displayed after you log in.
Starting Page
Language The language and formatting conventions you want to see in the
WebCTRL® interface.
NOTES
• If you will be using a language other than English, see Setting up
your system for non-English languages (page 178) for additional
requirements.
• If support for your selected language is removed in SiteBuilder, the
WebCTRL® application will automatically assign the System
language to you.
Automatically collapse Expands only one tree branch at a time.
trees
Play sound at browser Select the Non-critical alarms or Critical alarms checkbox if you want
when server receives the system to audibly notify you when that type of alarm is received.
If you want to use a custom sound file (.au or .wav):
1 Put the file in the webroot\_common\lvl5\sounds folder.
2 In the Sound File field, replace warning_bell.au or critical_bell.au
with the name of your sound file.
NOTE You can put your sound file anywhere under the WebCTRLx.x
folder, but be sure to change the path in the Sound File field.
Chapter 12
Advanced security
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Security.
With the Advanced Security package, you can set up operator access to your system to be
location-dependent. This type of operator access lets you assign privileges to an operator only at
locations in the system where he needs them. For example, you could assign an operator mechanic
privileges in one building in a system, view-only privileges in another building, and no privileges in a
third building.
New and converted WebCTRL® systems default to location-independent operator access in which an
operator’s privileges apply throughout the system. You should understand this type of operator access
before switching to location-dependent. See Operator access (page 125) for more information on
location-independent operator access.
NOTE When using hierarchical servers, the security policy and privilege sets are local to each server,
so you can have location independent security on one server but not on another.
NOTES
• For an operator to add, edit, or delete schedule groups, he must have the system-wide privilege
Maintain Schedule Group Members. He must also have the local privileges Access Geographic
Locations and Maintain Schedules at each location that is a member of the schedule group.
• If you switch to location-dependent operator access in a system that has operators and privileges
set up, the WebCTRL® application splits any existing privilege set containing local and
system-wide privileges into 2 separate privilege sets - one local and one system-wide. Operators’
system-wide privilege sets still apply throughout the system. The operators’ local privilege sets are
automatically assigned at the system level. You can then reassign the local privilege sets to the
operators at the locations where they need them.
NOTE You can display icons and hover text in the GEO tree that show where privileges have been
assigned. See Tree icons and hover text (page 25).
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Security.
The Advanced Security package provides support for 21 CFR Part 11. With this feature enabled, the
WebCTRL® application can require an operator to record a reason for changing an equipment property
before it accepts the change. The WebCTRL® Audit Log report then displays the operator's name and
the recorded reason for making the change.
NOTE You cannot use WAP-enabled devices to change equipment that requires operators to log
changes.
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Adv. Security.
With the Advanced Security package, you can set up a WebCTRL® password policy to meet your
security needs.
1 On the CFG tree, select System Settings.
2 Select the Security tab.
3 Enter information in the fields described below.
NOTE See System Settings (page 159) for information on all the other fields.
Field Notes
Use advanced password policy Enable this field to put restrictions on passwords.
An operator’s login name and password must be different when
this policy is enabled.
After you change the password policy, any operator whose
password doesn't meet the new requirements will not be locked
out of the system, but will be prompted to create a new password.
Passwords must contain You can require that passwords contain any or all of the following:
Numbers
Special characters—any keyboard character that is not a number
or letter.
Letters—uppercase, lowercase, or both.
Cannot be changed more than Enter a number to limit how often users can change their
once every __ days. passwords. When set to 0, users can change them as often as
they want.
Field Notes
May not be reused until __ Enter a number between 1 and 20. Enter 0 to reuse passwords
different passwords are used. without a delay.
Expire after __ days Enable to set the number of days an operator can use his
password before the system requires him to change it. Enter a
number between 1 and 999.
Force expiration Click this button to force every user's password to expire. Each
user will be prompted to change their password when they next
attempt to log in to the WebCTRL® interface.
Chapter 13
Cost-saving strategies
HVAC equipment runs in order to maintain adequate temperature for zones. Some zones, like
classrooms, must maintain a comfortable temperature only while people occupy them. When a zone is
no longer occupied, you can define different setpoints that require less energy to maintain. Use
WebCTRL® Schedules for these occupied/unoccupied zones so that equipment runs only as needed
to reduce energy consumption, but not comfort.
Other zones, like computer server rooms and production floors, must maintain particular cooling and
heating setpoints 24 hours a day, 7 days a week. Schedules would have no cost-saving effect on them.
Use one of the other cost-saving strategies to reduce energy consumption and equipment repairs for
these kinds of zones.
You can realize the greatest savings by using Schedules. Then fine tune Optimal Start, Demand
Control, and Setpoint Optimization. Each strategy depends on a particular microblock.
Chapter 14
Manual commands
You must have the Manual Commands/Console Operations privilege to access the manual commands
dialog box. The descriptions below tell you if you need an additional privilege to run the corresponding
command.
Command Description
addon Opens a dialog box where you can upload, start, stop, or remove an
add-on program such as Tenant Override Billing.
arcnet Run this command each time you plug a device, such as a laptop,
into a controller using an ARCNET card. The arcnet command
configures the WebCTRL® application to recognize your device as
the WebCTRL® server. Run this command from the equipment,
controller, or network level on the NET tree.
autopilot location Displays the full path for the current location and copies the path to
the Windows® clipboard. You can then paste the path into the
autopilot.xml file that runs the WebCTRL® autopilot. See Running
the WebCTRL® autopilot (page 148).
bbmd commands: You must have the Manual Commands/Adv Network privilege to run
bbmd commands.
bbmd read <IP address> Reads the BBMD table of the controller at the given IP address.
For example, to display the BBMD table in the BACnet device router
at IP address 154.16.12.101, type:
bbmd read 154.16.12.101
bbmd update <network Selects BBMDs on the specified network and marks them for
number> download. If no network is entered at the end of the command, all
networks in the system are scanned.
For example, if the network number is 888, type:
bbmd update 888
Command Description
bbmd view <network Views the list of BBMDs that have been selected for the network
number> number at the end of the command. Assumes the update has been
run.
For example:
bbmd view 888
bbmd write <table file> <IP Writes the BBMD table into the controller at the given IP address.
address> See To set up BBMD's through the WebCTRL® interface.
For example, to write the BBMD table in dallasbbmd.bdt into the
BACnet device router at IP address 154.16.12.101, type:
bbmd write dallasbbmd.bdt 154.16.12.101
bbmd clear <IP address> Clears the BBMD for the specified controller.
For example:
bbmd clear 154.16.12.101
bbmd dump <network> Writes to a file the BBMD from the specified controller.
<file> For example:
bbmd dump 888 dallasbbmd.bdt
checkurls 1 Finds all network point exp: expressions for the selected item in
the GEO or NET tree.
2 Converts the exp: expressions to bacnet:// equivalent
expressions that the controllers use.
3 Compares the equivalent bacnet:// expressions to the bacnet://
expressions currently downloaded in the controllers.
4 Displays any mismatches.
checkurls -p Does the same as checkurls, then adds any mismatches to the
download queue as parameter downloads.
checkurls -v Does the same as checkurls, but displays the exp: and bacnet://
expressions for all network points that were checked.
commstat Gives a complete set of diagnostic information for all defined
connections as well as information regarding all modems in the
system.
copy Displays a global copy utility that allows you to selectively copy trend
graphs, custom reports and all editable properties from the selected
equipment to other equipment in the system with the same control
program. See To use Global Copy (page 45).
disconnect Disconnects you from a BACnet dial-up session if you are the last
active operator.
download commands: Each of these commands performs an immediate download to a
controller for the selected control program, device, or driver.
download m Downloads all content, including parameters, schedules, and
BBMDs (if applicable).
download p Downloads parameters only.
download s Downloads schedules only.
Command Description
go commands:
go <refname or path> Goes to the point in the system that is referenced.
For example:
go #oa_conditions
or
go vav_1/m28
go ~net Takes you from a piece of equipment on the GEO tree to the same
equipment on the NET tree.
go ~geo Takes you from a piece of equipment on the NET tree to the same
equipment on the GEO tree.
go ~device Takes you to the controller for a point or piece of equipment on the
NET tree.
go ~network Takes you to the network the selected object’s controller is
associated to.
go -logicpopup <refname> Goes to the microblock pop-up for the microblock that is referenced.
You must run this command from the microblock’s equipment in the
navigation tree.
For example:
go -logicpopup lstat
go <device ID> Goes to a device in the NET tree.
For example, to go to device 301205 referenced in a dead module
alarm, type:
go 301205
go <device ID>/<object Goes to a device and object in the GEO or NET tree.
ID> For example:
go 300550/AI:3
go <object ID> Goes to an object for the current device in the GEO or NET tree.
For example, if a module alarm reports a control program Locked
I/O Alarm and references an error in program 11, click the link to go
to the device, then go to the object by typing:
go PRG:11
go <s.g.m.p> (site, gateway, controller, program) Goes to the item that the s.g.m.p
address references. Use this command for legacy equipment only.
For example:
go 2,1,4,1
localhost Shows the IP address of the WebCTRL® server
logoffuser Logs off a user (without warning the user).
Type a whoson manual command to view the IDs of logged in
operators, then type logoffuser x, where x is a the user's ID.
Command Description
markdownload commands: These commands place the controller for the selected tree item on
the list to download at a later time. The download list can be viewed
at NET > Downloads.
markdownload Marks for an All Content download, that includes parameters,
schedules, and BBMDs (if applicable).
markdownload p Marks for a Parameters download.
markdownload s Marks for a Schedules download.
memory Shows the amount of server memory allocated for the WebCTRL®
application and the amount being used.
memory -free Releases unused server memory, then shows the WebCTRL®
memory usage before and after the release.
modstat commands: These commands display a Modstat report.
NOTE It is not necessary to download a controller before running a
Modstat on it. Binding takes place when you run the modstat.
modstat Displays status of the controller at the current location, including:
• Hardware components of the device
• Software components of the device
• Error conditions that may exist in the device
• Date and time the device is using
modstat 8:<device instance Displays status for a specific controller in the IP network using the
number> controller’s ID. Your location in the system does not have to be the
controller you are querying.
For example:
modstat 8:489202
modstat mac:<network Displays a Modstat for a specific controller in the system using the
number>,<media type>: controller’s MAC address. Network number is the number of the
<mac address> network this controller is on as specified in SiteBuilder; media type
is the type of network the controller is on; MAC address can be
either the controller address or the IP address and depends on the
controller’s media type.
For example:
modstat mac:48161,arcnet:2
or
modstat mac:888,bacnet/ip: 172.16.101.119
notify Sends a message to all operators currently logged in to the system.
For example, "The server is going to shut down in 5 minutes. Please
log off." To run this command, type: notify your message.
The message must use only alphanumeric characters. You must
have the Admin privilege set or the Engineer System privilege to run
this command.
Command Description
paramupload Uploads parameters (editable properties) to the WebCTRL®
application from the equipment or driver at the current location and
below. If you want to upload editable properties for all equipment on
a floor, navigate to the floor level on the GEO tree. If you want to do
this for everything under a particular router, navigate to the router or
the network on the NET tree. You must have the Manual
Commands/Adv Network privilege to run this command.
ping Ping to verify communication between to IP devices. You cannot
ping devices on non-IP networks. To run this command type: ping
<hostname> where <hostname> is the IP address or device name.
For example:
ping 192.168.168.1
(will ping the IP address 4 times)
or
ping 192.168.168.1 -t
(will ping the IP address constantly)
rebootserver Restarts the WebCTRL® Server application. You must log back in to
the WebCTRL® interface if you want to continue. You must have the
System Shutdown privilege to run this command.
rebuild Rebuilds a Properties page. Use if you make changes to control
program property text in the EIKON® LogicBuilder application.
reload Reloads a control program. Use if you make changes to control
program logic in the EIKON® LogicBuilder application. You must
have the Engineer System privilege to run this command.
restartmodule Restarts the current controller. You must have the Manual
Commands/Adv Network privilege to run this command.
rnet here Overrides the address configuration of the Rnet host controller to
allow a subsequent All Content or Parameters download. Run this
command if you experience communication problems with the
controller because the controller’s network number does not agree
with SiteBuilder’s network number. Run this command from a
control program, device or driver.
revert Resets the selected driver or control program to its default values.
setdefault Sets the current page as the default view for the selected action
button and the selected tree location. You must have the Engineer
System privilege to run this command.
Command Description
setgcm Initializes any LANgate (gateway) from a converted SuperVision®
system.
After downloading to the LANgate, run setgcm if you:
• Added a controller to a CMnet where the address is set higher
than any other address on the CMnet
• Changed the 3-letter system name
• Changed the dead module timeout value on the System Settings
page
• Changed the site number in SiteBuilder (previously referred to
as the line number)
setgcm sends the following information from the WebCTRL®
database to the LANgate:
• Maxnet (the highest addressed controller plus one)
• 3-letter system name
• Site number
• Dead module timeout value
NOTES
• You can send this command over network, direct or modem
connections, but not over a direct network (access port).
• In SuperVision, the command set the workstation phone number
in the LANgate. You must now type the LANgate’s phone
numbers on the LANgate’s parameter pages.
• You must have the Manual Commands/Adv Network privilege to
run this command.
showhistory Gives historical information on the system, such as when it was
created and updated. You must have the Manual
Commands/Unrestricted privilege to run this command.
shutdown Shuts down the WebCTRL® Server application. This stops
communication between the server and the client, but does not
close any open WebCTRL® pages. You must have the System
Shutdown privilege to run this command.
storetrends Uploads trend data from the controller(s) to the database for all
equipment at and below the selected item on the GEO tree. This
command stores trend data for points that have Trend Historian
enabled.
timesync Synchronizes the time on all controllers at the current location and
below to the time on the server. Run this command only from a
location in the NET tree.
NOTE For CMnet networks, executing a timesync on a controller
sends the timesync to its gateway, and all the controllers under that
gateway.
You must have the Manual Commands/Adv Network privilege to run
this command.
Command Description
updatedriver commands: You must have the Engineer System privilege to run updatedriver
commands.
updatedriver Updates the selected controller to the latest version of its driver.
updatedriver net Updates the selected controller to the latest version of its driver and
any other controllers on the same network that use that driver.
updatedriver all Updates the selected controller to the latest version of its driver and
all other controllers in the system that use that driver.
whereami Displays the full path for the current location and gives the display
and reference names of the action button, category, instance and
tab. If the selected tree location differs from the location shown in
the action pane (for example, a point trend page), whereami returns
information on both locations.
Use this command when you create links in ViewBuilder.
whoson Shows the list of users currently logged in to the WebCTRL® system,
the IP addresses from where they are logged on, what kind of
interface they are using (for example, lvl5 for an Internet browser on
a computer), and how long it has been since they have actively
interfaced with the WebCTRL® system.
zap Restarts the current controller. You must have the Manual
Commands/Adv Network privilege to run this command.
Chapter 15
Running the WebCTRL® autopilot
To monitor your WebCTRL® system, you can run the autopilot to display specified WebCTRL® pages at
regular intervals. You can run the autopilot on the WebCTRL® server or on one or more client
computers. Each computer can display a different set of pages.
CAUTION Do not open or edit the original autopilot.xml file in the WebCTRL® system. Keep
this file to set up the autopilot on other computers.
3 In the row that begins with <script, replace the highlighted text shown below with the information
needed to start your system.
NOTES
○ The Attribute list near the top of the file describes each field.
○ To prevent exposing someone's password in this file, create a generic user and password in
the WebCTRL® interface.
4 Each pair of rows beginning with <navigate and <delay define a WebCTRL® page and how many
seconds the page should display. Follow the steps below to replace each <navigate line with
information specific to your system. Add or delete rows as needed.
a) In the WebCTRL® interface, go to the page you want to display.
b) Press Ctrl+M.
c) Type autopilot location.
d) Click OK. The path to the WebCTRL® page is displayed and is copied to the Windows
clipboard.
e) In the autopilot.xml file, highlight a <navigate row, then press Ctrl+V to replace the highlighted
text with the copied WebCTRL® path.
NOTE To have the autopilot run a report, define the path to the report's View tab.
5 In the <delay row below each path, change 20 to the number of seconds you want to display the
WebCTRL® page.
6 Save the file.
NOTES
• To stop the autopilot, do one of the following:
○ Close the browser.
○ Close the Command Prompt window that is running the autopilot.bat file to stop the autopilot
but leave the WebCTRL® interface running in the browser.
• If the autopilot does not start, open autopilot.log to see the error.
Chapter 16
Managing files on a remote WebCTRL® server
A WebCTRL® system supports WebDAV, a network protocol designed for managing remote server files
through an Internet connection. By using WebDAV, you can access the Internet from anywhere in the
world and manage your system files residing on a distant WebCTRL® server.
Chapter 17
Using wireless devices with a WebCTRL® system
The WebCTRL® system supports Wireless Application Protocol (WAP), a communications protocol that
allows you to access your system through a wireless device, such as a mobile phone. The WebCTRL®
application supports WAP-enabled browsers on 2G and 3G devices on the Sprint PCS network and
Pocket Internet Explorer on devices running Windows Mobile for Pocket PC 2003 or later.
Using a WAP device, you can access the Internet and remotely manage certain aspects of your system.
Only English alphanumeric characters are supported.
NOTES
• Navigation buttons and how the information is presented varies among WAP devices.
• To use WAP through a Secure Sockets Layer (SSL), you must use a certificate from a trusted
Certificate Authority (CA). Ask your phone company which Certificate Authorities they support. See
"To set up TLS/SSL using a self-signed certificate" in WebCTRL® Help.
If your WAP device supports... ...append these characters to the end of the
address.
WML browsers. ?t=w
Applies to most older (pre 3G) WAP devices.
XHTMLMP browsers. ?t=xmp
Applies to most newer (3G) WAP devices.
XHTML browsers. ?t=X
A text only interface for PC's or PDA's.
EXAMPLE 192.168.168.1?t=xmp
7 Log in to your WebCTRL® system:
○ Tap in your WebCTRL® username, then select OK
○ Tap in your WebCTRL® password, then select Login.
The WebCTRL® application automatically generates default WAP interface pages. However, you can
create custom pages using ViewBuilder for WAP.
After you log in, the first screen shows the system level. The name at the top of the screen is the name
of the current level. To navigate deeper into the system, select an item by either pressing its number
on the keypad or by scrolling through the list and then selecting OK. To navigate to other areas of the
system, see below.
Select Action
1... Navigate up one level.
Menu Navigation Return to the navigation tree (area and equipment level only).
Alarms List the alarms at the current level (area and equipment level only).
Properties Show properties at the point level
and show properties at the area and equipment levels if custom
pages have been attached.
Back Return to the previous page.
Go to Root Return to the top of the GEO tree.
Logout Log out of the WebCTRL® application.
Select Action
1 List List all alarms at the current area or equipment level.
2 Navigation Return to the navigation tree.
3 Ack All Acknowledge all alarms at the current level.
4 Del All Closed Delete all closed alarms at the current level.
5 Del All Delete all alarms at the current level.
For example, from the BACnet analog input point level, you can view the following:
Select Action
Value Present value for that point.
Lock Locked override status for that point; True locks the present value to the At
value.
At Locked override value.
Alarm Alarm state for that point.
Chapter 18
Setting up a system in the WebCTRL® interface
Delete Delete the selected item. The item and all of its children will be
deleted.
CAUTIONS
• Make a backup of your system before making changes.
• Make changes carefully as they cannot be undone.
NOTES
• You can also right-click items in the Set up Tree dialog box to perform the above tasks.
• You can perform some of the above actions on multiple tree items simultaneously. Use Ctrl+click,
Shift+click, or both to select multiple items.
To import a clipping
You can export a clipping (a portion of a system) in SiteBuilder and then import it in the WebCTRL®
interface. The following items are imported:
• One or more selected Geographic and Network tree items including attached control programs,
graphics, and drivers
• Reports
• Alarm templates and categories
• Location-dependent security information
• Schedules and schedule group membership (including the entire schedule group and schedules, if
it does not exist in the target system)
• Alarm actions
• Alarm message prefixes and suffixes
• Source tree relationships (including source tree rules if the source tree does not exist in the target
system)
To import a clipping:
1 Right-click an item in the GEO tree, then select Set up Tree.
8 The interface shows any conflicts and problems that were found during the import. Make any
needed corrections in SiteBuilder.
NOTE Click Copy to Clipboard and then paste the list into another program such as Notepad for
viewing or printing.
9 Click Next.
10 Click Finish.
11 Do any of the following that apply.
A second BACnet/IP network Move the items under the new Download Parameters to any
into a site network to the original BACnet/IP controllers that you moved.
network, then delete the new
network.
Any controllers that use the N/A Download BBMDs to the routers.
SiteBuilder option
Automatically Configure My
BBMDs
Any controllers that use N/A Update the routers' BBMD tables.
manually configured BBMD See "To set up BBMD's through
tables the WebCTRL® interface" or "To
set up BBMD's using the BBMD
Configuration Tool" in WebCTRL®
Help.
System Settings
The System Settings page contains information that you must enter before the WebCTRL® application
can run properly.
1 On the CFG tree, select System Settings.
2 Click each tab, then enter the necessary information. Tab details are described below.
General tab
The General tab presents the following system information:
• System Directory Name
• System Date and Time
• Path to the Web Root Directory
• Database Type
Field Notes
Time Sync Click to synchronize the time on all controllers in the system to the
time on the server.
Time Format Select one of the following for the system's time:
• 12-hour clock (Example: 4:34 pm)
• 24-hour clock (Example: 16:34)
Date Format Select the format you want the system to use.
Node Name Display Depth The number of levels displayed in WebCTRL® paths. For example,
if Node Name Display Depth is set at:
2, a typical path might be ..\AHU-1\RA Temp
3, a typical path might be ..\Atlanta R&D\First Floor\AHU-1
NOTE Changing this field does not take effect until you restart the
WebCTRL® Server application.
System Language The language to be used for:
• The default language for new operators
• Alarms logged to the database
• State text and object names downloaded to the field
• The login page
NOTE Language also refers to formatting conventions. For
example, English uses the date format mm/dd/yy, but English
(International) uses the date format (dd/mm/yy).
Use a single alarm template for If your system is an upgraded legacy system, do one of the
CMnet alarms following:
• Select this checkbox to have alarms for CMnet equipment use
only the alert_auto alarm template.
• Disable this checkbox to allow multiple alarm templates.
Field Notes
All Source Files Use to export source files to a .zip file that can be imported into
Field Assistant. If the technician using Field Assistant changes or
adds files, he can export them from Field Assistant so that they
can then be imported in the WebCTRL® or SiteBuilder
applications. Source files include:
• Control programs (.equipment files only)
• Drivers
• Graphics (.view files only)
• BACview® files
NOTE If import detects a difference between a database file and
an import file with the same name, import does not overwrite the
database file. A message lists any file differences so that you can
resolve them.
See Commissioning equipment using Field Assistant.
Select the checkbox to use the Alarm Notification Client
Alarm Popup application. See Alarm Popup (page 84).
Restrict to IP Address If the server has more than one network interface adapter, type
the IP address of the server's network connection that the Alarm
Notification Client application will connect to.
Port Change this field if the Alarm Notification Client application will
use a port other than 47806 on the server.
Current client connections Shows any workstation whose Alarm Notification Client is actively
connected to this server.
Select a week of logs to review For troubleshooting, you can download a zip file that contains logs
of system activity.
Security tab
Field Notes
Log audit data to file Records operator activities and some system activities (such as
opening and closing the database or automatic deletions) in a text
file.
The default file is auditlog.txt stored in
WebCTRL\webroot\<system_name>. You can change the file name
and include a different path.
To prevent the file from growing too large as new data is appended,
you can archive the data to another text file by selecting an archive
frequency in the Archive log file contents field. The archive file is
auditlog_yyyy_mm_dd.txt, where yyyy_mm_dd is the creation date of
the archive file. This file is created in the same location as
auditlog.txt.
NOTE If you do not archive the log file contents, you should manually
delete the oldest entries.
Field Notes
Log audit data to database Records audit data in a database named audit.mdb that can be
accessed by third-party software.
NOTE For Access or MSDE, the database is automatically created. An
Access database is named audit.mdb; a MSDE database is named
audit.mdf. For MySQL, SQL Server, PostgreSQL, or Oracle, you must
create the database manually.
Delete database entries Automatically deletes entries in the database that are older than the
older than ____ days number of days you specify.
Log errors for invalid URLs Enable this field to write to the core.txt log any time an external
source sends a request to the WebCTRL® Server application.
NOTE Regular maintenance scans by external software can cause
the log files to grow large.
Security Policy See Location-dependent operator access (page 133) for information
on Change Policy.
Allow remote file Lets you access the system using WebDAV.
management
Return operators to previous Returns operators to current tree locations when the server
locations when server reconnects.
reconnects
Log off operators after _:_ The system automatically logs off an operator who has had no activity
(HH:MM) of inactivity in the system for the time period specified.
This is a default setting for the system. The System Administrator can
change this setting for an individual operator on the Operators page.
Lock out operators for __ Clear Lockouts removes lockouts for all users.
minutes after __ failed login NOTE Restarting the WebCTRL® Server application will remove
attempts lockouts.
Use advanced password A feature of the Advanced Security package that provides additional
policy security. See Advanced password policy (page 137).
Do not synchronize operator If using hierarchical servers, WebCTRL® automatically synchronizes
and privileges the operator/privilege settings on the child servers with those on the
parent server. You have the following options:
• Enable this checkbox on all servers to stop the synchronization
process.
• Enable this checkbox on a child server to remove it from the
synchronization process so that you can manage that server's
settings locally.
Synchronize Now Click this button on the parent server for immediate synchronization
of operator/privilege settings.
Field Notes
Permissions When control programs, views, and bacview files are created by an
original equipment manufacturer (OEM), they cannot be used in a
WebCTRL® system without the creator's permission. However, the
creator can produce a key for a system with a different license that
will grant permission to the key's recipient.
If you receive a key, put it in the WebCTRL X.X\resources\keys
folder. The table in the Permissions section of the Security page
shows all keys in the that folder. To activate a key, click Add, then
browse to the key.
To delete a key from your system, select the key in the table, then
click Delete.
Red text in the table indicates the key has a problem such as it does
not apply or has expired. See the Notes column for an explanation.
Communications tab
The fields on this tab let you define controller communication with the WebCTRL® Server application
and BACnet network communication.
Field Notes
WebCTRL Server BACnet The BACnet identifier for the system's server and the alarm recipient.
Device Instance You enter these system properties in SiteBuilder.
and
BACnet Alarm Recipient
Instance
Always upload properties Automatic uploads are listed in the Audit Log.
from controllers to WebCTRL If you do not select this field, properties must be manually uploaded
server on mismatch or downloaded by the operator when a mismatch occurs.
NOTE If an automatic upload fails and the operator chooses to do
nothing at that time, the upload will be attempted again when he
returns to the page where he encountered the mismatch.
Ignore incoming alarms from The WebCTRL® application will ignore alarms from third-party
sources not in this database devices not in the database or devices from other WebCTRL®
systems on the same network.
Field Notes
BACnet Settings Native WebCTRL® system only
Use Static BACnet Bindings If selected, the WebCTRL® application uses information in its
database to bind to BACnet devices rather than using BACnet's
Who-Is/I-Am/Who-Is-Router-To/I-Am-Router-To broadcasts to resolve
BACnet network and device bindings (dynamic binding).
If not selected, the WebCTRL® application uses BACnet (dynamic)
binding for communication between devices.
Leave this field at its default setting unless you are doing one of the
following:
• Select this checkbox if your system uses NAT routing.
• Clear this checkbox to use BACnet Discovery or for third-party
BACnet integration.
Log BACnet Binding Conflicts When checked, the WebCTRL® application logs binding conflicts that
result from duplicate network numbers or device IDs.
Field Notes
Automatically delete alarm Alarm incident groups are all alarm actions, such as Off Normal,
incident groups which have Fault, and Return to Normal, that are triggered by a single alarm.
been closed for more than NOTE Alarms in an incident group are not deleted until all alarms in
___ days the group have been closed.
Archive alarm information Writes alarm information to a text file.
upon alarm deletion
Archive file The default file is eventdel.txt stored in
WebCTRL\webroot\<system_name>. You can change the file name
and include a different path.
Archive file format The alarm information to be written to the archive file. To add
information, select field codes in Append Field Code. To delete field
codes, highlight them in the Archive file format box and press Delete.
Automatically delete expired To ensure there are no time zone conflicts, the WebCTRL®
schedules daily at ___ application waits 2 days after a schedule expires to delete it.
Keep historical trends for ___ Stores trend data in the WebCTRL® database for the time you
days specify. This is a default setting that you can change when you set up
trends for an individual point.
Remove expired historical Deletes trend data that has been in the database longer than then
trends daily at ____ time you specified in the previous field.
Field Notes
Enable time synchronization Automatically synchronizes the time on all equipment to the time on
of controllers daily at____ the server, adjusting for different time zones and Daylight Saving
Time. We recommend that you enable this field.
CAUTIONS
• To prevent time sync problems when the transition to and from
Daylight Saving Time occurs, set the time sync to occur at least 1
hour after the last controller in the system is adjusted for DST.
For example, your server and part of your system is in the Eastern
Standard Time zone, but you also have controllers in the Pacific
Time zone. Your server is adjusted for DST at 2:00 a.m. Eastern
Standard Time, but the controllers in the Pacific Time zone are
not adjusted until 3 hours later. So you would set the time sync to
occur daily at 6:00 a.m. or later.
• Make sure that your server’s time and time zone setting are
correct.
• Make sure that each site’s time zone setting is correct in
SiteBuilder.
NOTES
• You can disable this function for an individual site on the site’s
Properties page. See To set up site properties (page 166).
• You can also perform time synchronizations using the timesync
manual command (page 141).
Column Notes
Application To open the web application in a web browser, append this path to your
WebCTRL® system's address.
For example, to start EnergyReports, enter:
http://<system_name>/EnergyReports, or
http://<system_IP_address>/EnergyReports.
Name The web application's actual name, if its author provided one.
TIP You can hover over the Application or Name cell to see a description of
the web application, if its author provided one.
Version The web application's version, if its author provided one.
Running The web application's status. This column must show running for you to open
the web application in a browser.
Sessions The number of web browsers currently using the web application.
Data Directory Web applications have 2 data directories:
• A private directory in WebCTRLx.x\webroot\<system
name>\webapp_data\<web application> that contains information such as
configuration data
• A public directory in WebCTRLx.x\webroot\<system
name>\webapp_public\<web application> that contains data generated by
the web application.
This column shows the <web application> directory.
Data Directories The size of the data stored in the private and public directories.
Size
(private/public)
Field Notes
Enable Timesync Daily synchronizes the time in the site's controllers with the server's time,
adjusting for different time zones and Daylight Saving Time. Synchronization
occurs each day at the time specified in the field Enable time synchronization
of controllers daily at on the System Settings > Scheduled Tasks (page 163)
tab.
CAUTION Make sure that your server’s time and time zone setting are
correct. Also, make sure that the site’s time zone setting is correct in
SiteBuilder.
Group Cache The designated router where colors are cached when peer caching is enabled
Controller in SiteBuilder.
NOTES
• Do not edit any part of this registered license file. Editing a license file invalidates the license.
• Store the license in a safe location.
TIP Back up your system (page 203) before replacing your license.
Chapter 19
Working with control programs in the WebCTRL® interface
A control program is typically defined in SiteBuilder when the system is engineered, but you can make
the following changes to a control program in the WebCTRL® interface. These changes require you to
download All Content (page 46) to the controller.
NOTE If you change a control program in the EIKON® LogicBuilder application and it does not display
correctly in the WebCTRL® interface, Ctrl+right-click the WebCTRL® action pane, and then select
Refresh.
NOTES
○ If you are changing an IP router's control program, the second option will change all control
programs of this type only on the IP network.
○ If you are changing a control program on the network below an IP router, the second option
will not change control programs of this type in the router.
NOTE You can click Delete Unused in the Control Programs section to delete all unattached control
programs and any supporting files with the same name from the programs folder.
Chapter 20
Working with drivers in the WebCTRL® interface
A controller's driver is defined in SiteBuilder when the system is engineered, but you can make the
following changes to a driver in the WebCTRL® interface.
• Change or upgrade a driver. See topic below.
• Reload a driver if it becomes corrupt (for example, a driver page is missing in the WebCTRL®
interface). On the WebCTRL® NET tree, right-click the controller or driver, then select Reload
Driver. Changes you made on the driver pages in the WebCTRL® interface remain in effect.
After you make these changes, you must download All Content (page 46) to the affected controller(s).
NOTE You can also make these changes in SiteBuilder. See "To change or upgrade a driver" in
SiteBuilder Help.
NOTE You can click Delete Unused in the Controller section to delete all unused drivers in
WebCTRLx.x\webroot\<system_name>\drivers.
Chapter 21
Working with BACview® files in the WebCTRL® interface
To use a BACview® to view or edit a controller's property values, you must download a .bacview file to
the controller. The .bacview file is typically defined in SiteBuilder and downloaded with the initial
download to the controller, but you can select a different file in the WebCTRL® interface.
NOTE You can click Delete Unused in the Bacview section to delete all unused BACview® files in:
• WebCTRLx.x\webroot\<system_name>\views
• WebCTRLx.x\webroot\<system_name>\programs
Chapter 22
Running WebCTRL® Server as a Windows service
Run WebCTRL Server as a Windows service if you want WebCTRL Server to automatically start up when
the server computer is restarted.
NOTE If your WebCTRL® system uses a non-MS Access database located on the same computer as
WebCTRL Server, you must set up Windows to delay starting WebCTRL Server until the database
service has started. See Microsoft's "How to delay loading of specific services"
(http://support.microsoft.com/kb/193888).
Chapter 23
Setting up a system for non-English languages
English is the WebCTRL® default language, but you can set up your system to display a different
language. You can also set up multiple languages so different operators can view the system in
different languages.
Follow the procedures below to display the WebCTRL® interface in non-English languages.
1 Install a language pack (page 178).
2 Prepare your workstation for non-English text (page 178).
3 Create control programs and translation files (page 180).
4 Create graphics (page 182).
5 Create your system in SiteBuilder (page 184).
6 Set an operator’s language in the WebCTRL® interface (page 185).
NOTES
• You also use key terms and translation files with graphics that you create with WebCTRL®
extensions for FrontPage (page 182).
• To edit existing control programs or translation files, see Editing translation files, control
programs, or graphics (page 185).
NOTES
• Type only the key term in the EIKON® LogicBuilder application. Expressions such as
$present_value$ are put in the translation file as part of the translated text. See EXAMPLES in
"Translation files" below.
• Key terms can contain only alphanumeric characters and underscores (no spaces) and cannot
start with a number.
Translation files
Translation files are used to translate key terms in control programs and graphics created with
WebCTRL® extensions for FrontPage (page 183). A translation file contains key terms and their
language-specific equivalents.
For a non-English system, you must create an English translation file and a non-English translation
file* for each of the following:
• Each control program
• Key terms used in multiple control programs
• Each graphic created with WebCTRL® Extensions for FrontPage
• Key terms used in multiple graphics
EXAMPLES
Translation files Key term=Language-specific equivalent
English This_value=This value is $present_value$
Zone_temp=Zone temperature
Spanish This_value=Este valor es $present_value$
Zone_temp=Temperatura de zona
*If the WebCTRL® interface will display multiple non-English languages, create a translation file for
each language.
If key terms are used the file name is... File location
in...
A single control program <any_name>_xx.native* Any location
Multiple control equipment_xx.native* WebCTRL\webroot\
programs <system_name>\resources
A single <graphic_name>_xx.native* WebCTRL\webroot\
graphic <system_name>\graphics\lvl5
Multiple translations_xx.native* WebCTRL\webroot\
graphics <system>\resources
* xx = the language extension code. See "Extension codes and encoding" below.
3 Open the control program in the EIKON® LogicBuilder application, then select Control Program >
Bundled Resources.
4 Click , locate and select the translation file(s) for this control program, then click Open.
NOTES
○ Do not add equipment_xx.native files that you created for multiple control programs.
○ You can use Ctrl+click or Shift+click to select multiple files.
5 Save the control program. The translation files are embedded in the control program; the original
files are no longer necessary.
ViewBuilder uses the defined font for all text in your graphic. The default is Arial Unicode MS because it
supports all languages and is the only font that ensures controls and labels in your graphic will align
correctly in the WebCTRL® interface. If you do not see Arial Unicode MS in the Font column, install it if
possible using the following instructions. If you cannot install it, use the font shown or click on it to see
other fonts that you can select.
Creating a graphic for a multi-language system using WebCTRL® extensions for FrontPage
When you create a graphic using WebCTRL® extensions for FrontPage, you enter a key term instead of
text in the graphic. When the graphic is displayed in the WebCTRL® interface, the key term is replaced
with its equivalent in the translation file for the current operator language. See Creating control
programs and translation files (page 180).
System language
The system language is used for:
The default language for new operators
Alarms sent to the database
State text and object names downloaded to the field
The default login page *
All other information is displayed in the operator’s language, which may be different than the system
language. See To set an operator’s language in the WebCTRL® interface (page 185).
* You can change the language shown on the WebCTRL® login page by selecting a different language
from the list below the Password field.
Editing an EIKON® for WebCTRL control program in the EIKON® LogicBuilder application
To edit a non-English control program that you created in the EIKON® for WebCTRL application:
1 Open the .eiw or .equipment file in the EIKON® LogicBuilder application, then make your edits.
2 Select Control Program > Bundled Resources.
3 Verify that the list shows all translation files specifically for the control program. Use the plus or
minus button to add or delete translation files.
NOTE This list shows the translation files in the WebCTRL\webroot\<system_name>\programs
folder. This list should not include translation files for multiple control programs or graphics.
4 Click OK.
5 Save the control program. The translation files are bundled with the control program; the original
files are no longer necessary.
NOTE If you need to change a translation file after you save the control program, see To edit a bundled
resource (page 186).
Chapter 24
Web services
NOTE To see if your system has this optional package, click , then select About. You have this
package if Enabled Features shows Enterprise.
Using Web services, you can retrieve information or set values for items accessible through the
WebCTRL® GEO or NET tree. You can retrieve trend data, reports, present values, setpoints, and any
other BACnet object property information from a remote WebCTRL® server and import the information
into a SOAP client such as Microsoft Excel. You can also set present values, setpoints, and any other
object property information on a remote WebCTRL® server.
The Web services examples we provide use Microsoft Excel as the SOAP client, but you can use other
software packages.
NOTE To use Web services with Microsoft Excel or Microsoft Word:
• You should be comfortable writing Visual Basic scripts and setting up macros.
• You must install the Soap Toolkit found at
http://download.microsoft.com/download/xml/Install/3.0/W982KMeXP/EN-US/SoapToolkit30.EXE.
Every change made through Web services is recorded in the Audit Log. If you do not want these
changes recorded in the Audit Log, add the following privilege to the privilege set:
• Do not audit changes made using SOAP (Web Services)
1. Eval
See:
Example using Web services to set a value (page 193)
Example using Web services to retrieve values (page 195)
WSDL:
http://<WebCTRL_server>/_common/webservices/Eval?wsdl
Methods:
a. String getValue(String expression)
Returns the raw value for the given expression.
b. String [] getValues(String [] expressions)
Returns an array of the raw values for the given expressions.
c. String getDisplayValue(String expression)
Returns the display value for the given expression.
d. String [] getDisplayValues(String [] expressions)
Returns an array of the display values for the given expressions.
e. setValue(String expression, String rawVal, String reason)
Sets the given raw value for the expression.
f. setValues(String [] expressions, String [] rawVals, String reason)
Sets an array of the given raw values for the expressions.
g. setDisplayValue(String expression, String displayVal, String reason)
Sets the given display value for the expression.
h. setDisplayValues(String [] expressions, String [] displayVals, String reason)
Sets an array of the given display values for the expressions.
Parameters:
• expression:
For Methods a. through d., its the path to the value to be evaluated. For points, expression
only needs to refer to the microblock; present_value is assumed.
For Methods e. through h., its the path to the value to be set
• rawVal: The raw value (for instance, 1, indicating a On status) *
• displayVal: The display value (for instance, “On”, indicating On status) *
• reason: Reason for the change.**
* raw value versus display value: For a binary input that is on, the raw value would be "1".
For an operator whose default language is English, the display value would be "On". The
display value is in the operator's default language.
** reason can be used if you need to comply with 21 CFR Part 11 (page 136).
2. Trend
See Example using Web services to retrieve trend data (page 198).
WSDL:
http://<WebCTRL_server>/_common/webservices/Trend?wsdl
Method:
getTrendData(String trendLogPath, String sTime, String eTime, boolean limitFromStart, int
maxRecords)
Retrieves trend records for a given point or a trend log. A series of (time, value) pairs
representing trend samples is returned.
The first element of the array is the time for the first sample, second element of the array
is the trend data value for the first sample. The third element is time for second sample
fourth element is trend data value for second sample etc. The returned array is in the
following format:
10/02/2002 10:22:00 AM ----> Time for first sample
76.1 ----> Trend data value for first sample
10/02/2002 10:22:30 AM ----> Time for second sample
76.1 ----> Trend data value for second sample
10/02/2002 10:23:00 AM ----> Time for third sample
76.2 ----> Trend data value for third sample
Parameters:
• user: WebCTRL® operator login Id. This user should have the Remote Data Access
privilege.
• password: Password for the above WebCTRL® user.
• trendLogPath: The full path to the point, or trend log node whose trend data is desired. For
example, #mxm/ai_interval, or #mxm/ai_interval/trend_log
• sTime: Start Time. Returns trend data values starting with this time.
• eTime: End Time. Returns trend data values until this time.
• limitFromStart: If maxRecords is >0, use True to retrieve maxRecords from the start (sTime
if specified or the first record in the database); use False to retrieve maxRecords from the
end (eTime if specified or the last record in the database)
maxRecords: Maximum number of records desired. Use a number >0 to limit records; use 0 to
retrieve unlimited records. If using 0, you must specify sTime and eTime; limitFromStart will be
ignored.
NOTES
• sTime and eTime format: MM/dd/yyyy hh:mm:ss aa. Example: 10/02/2002 10:22:00
AM
• If you do not want to specify a start time or end time, use NULL or an empty string for the
sTime or eTime. In this case, maxRecords must be >0.
EXAMPLES
• sTime=04/07/2007 12:00:00 AM
eTime=NULL
limitFromStart=True
maxRecords=10
The first 10 records starting on 4/7/07 at 12:00:00 AM will be returned.
• sTime=NULL
eTime=NULL
limitFromStart=False
maxRecords=10
The most recent 10 records in the database will be returned.
• sTime=04/07/2007 12:00:00 AM
eTime=04/10/2007 11:59:00 PM
limitFromStart=False
maxRecords=0
All records in the database between 04/07/2007 12:00:00 AM and 04/10/2007
11:59:00 PM will be returned.
3. Report
See Example using Web services to retrieve a report (page 201).
WSDL:
http://<WebCTRL_server>/_common/webservices/Report?wsdl
Methods:
a. String runReport(String location, String reportName, String extension)
Runs the named report at the given location and returns the result as a large
string with embedded carriage returns.
b. String [] runReportCsvLines(String location, String reportName)
Runs the named report at the given location and returns an array of individual CSV
lines. The caller must still parse each line.
Parameters:
• location: The location to run the report at in the database
• reportName: The name of a built-in report or the reference name of a custom report
4. System
WSDL:
http://<WebCTRL_server>/_common/webservices/System?wsdl
Method:
String getWebAppStorageDirectory(String webAppName)
Returns a path to a folder in the system folder where a web application can store data. The
web application is responsible for creating the folder.
Parameter:
webAppName: A name unique to the web application.
Sub testSoapWrite()
host = Range("A1").Value
user = Range("A2").Value
passwd = Range("A3").Value
Dim changeReason As String
Dim client As MSSOAPLib30.SoapClient30
Set client = CreateObject("MSSOAP.SOAPClient30")
URL = "http://" & host &
"/_common/webservices/Eval?wsdl"
client.mssoapinit (URL)
client.ConnectorProperty("WinHTTPAuthScheme") = 1
client.ConnectorProperty("AuthUser") = user
client.ConnectorProperty("AuthPassword") = passwd
On Error GoTo err
i = 5
expression = Range("A" & i).Value
newValue = Range("B" & i).Value
changeReason = Range("C" & i).Value
client.setValue expression, newValue, changeReason
i = 6
expression = Range("A" & i).Value
newValue = Range("B" & i).Value
changeReason = Range("C" & i).Value
client.setDisplayValue expression, newValue, changeReason
GoTo done
err:
Range("D" & i).Value = err.Description
done:
End Sub
NOTE If you have problems connecting to the WebCTRL® application using Visual Basic, add the
following line:
client.ClientProperty("ServerHTTPRequest") = TRUE
above the line:
client.mssoapinit (URL)
The macro that will retrieve the values will write them to cells B5, B6, and B7.
Sub testSoapRead()
host = Range("A1").Value
user = Range("A2").Value
passwd = Range("A3").Value
Dim changeReason As String
Dim client As MSSOAPLib30.SoapClient30
Set client = CreateObject("MSSOAP.SOAPClient30")
URL = "http://" & host &
"/_common/webservices/Eval?wsdl"
client.mssoapinit (URL)
client.ConnectorProperty("WinHTTPAuthScheme") = 1
client.ConnectorProperty("AuthUser") = user
client.ConnectorProperty("AuthPassword") = passwd
REM VB arrays start at index 0 and are declared by the maximum index
REM some the next line declares an array of two strings at indices 0 and 1
Dim expressions (2) As String
Dim values (2) As String
Dim result() As String
expressions(0) = Range("A5").Value
expressions(1) = Range("A6).Value
expressions(2) = Range("A7").Value
result = client.getValues(expressions)
Range("B5") = result(0)
Range("B6") = result(1)
Range("B7) = result(2)
GoTo done
err:
Range("D" & i).Value = err.Description
done:
End Sub
NOTE If you have problems connecting to the WebCTRL® application using Visual Basic, add the
following line:
client.ClientProperty("ServerHTTPRequest") = TRUE
above the line:
client.mssoapinit (URL)
The macro will retrieve the trend data and write the time of each sample in column A and the
corresponding zone temperature in column B.
3 Add this section to define the trend data you want to retrieve from the path in cell A5. This
retrieves trends from startDate to endDate:
LimitFromStart - to retrieve maxRecords from beginning if true; from end if false
MaxRecords - the maximum numbers of records to retrieve
expression - the expression to evaluate
4 Identify the Web services program that allows the Excel spreadsheet to retrieve the data from the
WebCTRL server over the network or Internet.
5 Enter the code to authenticate the user.
6 Enter the error handling code.
7 Add this code to retrieve the trend data and displayed it.
8 This displays an error checking statement if an error is found in the data.
Sub evalTrends()
host = Range("A1").Value
user = Range("A2").Value
passwd = Range("A3").Value
startDate = Format(Range("A6").Value, "mm/dd/yyyy hh:mm:ss AMPM")
endDate = Format(Range("A7").Value, "mm/dd/yyyy hh:mm:ss AMPM")
limitFromStart = Range("A8").Value
MaxRecords = Range("A9").Value
expression = Range("A5").Value
Dim client As MSSOAPLib30.SoapClient30
Set client = CreateObject("MSSOAP.SOAPClient30")
URL = "http://" & host &
"/_common/webservices/Trend?wsdl"
client.mssoapinit (URL)
client.ConnectorProperty("WinHTTPAuthScheme") = 1
client.ConnectorProperty("AuthUser") = user
client.ConnectorProperty("AuthPassword") = passwd
On Error GoTo err
Dim result1() As String
For i = 1 To size
row = i + 11
Range("a" & row) = result1(index)
Range("b" & row) = result1(index + 1)
index = index + 2
Next
GoTo done
err:
Range("a10") = err.Description
done:
End Sub
NOTE If you have problems connecting to the WebCTRL® application using Visual Basic, add the
following line:
client.ClientProperty("ServerHTTPRequest") = TRUE
above the line:
client.mssoapinit (URL)
Sub TestReport()
host = Range("A1").Value
user = Range("A2").Value
passwd = Range("A3").Value
client.ConnectorProperty("WinHTTPAuthScheme") = 1
client.ConnectorProperty("AuthUser") = user
client.ConnectorProperty("AuthPassword") = passwd
On Error GoTo err
location = Range("A4").Value
report = Range("A5").Value
done:
End Sub
NOTE If you have problems connecting to the WebCTRL® application using Visual Basic, add the
following line:
client.ClientProperty("ServerHTTPRequest") = TRUE
above the line:
client.mssoapinit (URL)
Chapter 25
System database maintenance
To back up a system
The type of database your system uses determines the method you use to back up the system.
TIP To minimize the effects of fragmentation, you should maintain at least 20% free disk space on
the server.
Index
A C
Access database • 203 category • 23, 126
Access User Category privilege • 126 alarm • 78, 79, 83, 103, 104, 109
action button • 23 graphic • 35
action pane • 23 schedule • 63
Admin privilege set • 125, 129 trend • 73
advanced password policy • 137, 159, 160 category privilege • 125
Advanced reporting actions • 83 changing modes • 29
advanced security • 133, 136, 137 checkurls manual command • 141
alarm actions • 78, 83, 101, 104, 115 clipping • 156
alarm categories • 109 CMnet equipment • 157
alarm messages • 83, 104, 109, 126, 133, colors • 27
156 colors in WebCTRL® • 23, 27
Alarm Notification Client • 84 compact the database • 203
Alarm Popup alarm action • 83, 84, 159 comstat • 141
alarm source • 101 control programs • 39, 42, 44, 170
alarm templates • 104, 109, 126, 133, 156, controllers • 17, 29
159 copy manual command • 141
alarms • 78 copying a path • 44
acknowledging • 79 cost-saving strategies • 139
alarm actions • 83 CSV (Comma Separated Values) • 117, 122
archiving deleted alarms • 159, 163 custom reports • 44, 115, 118, 119, 121,
changing settings • 78 122, 123
deleting • 79, 163
sounds for alarms • 131 D
viewing • 79 database, system • 29
arcnet manual command • 141 back up • 203
audible sounds for alarms • 131 database type • 159, 203
audit log • 126, 133, 136, 159 defragment • 203
automatic logoff • 32, 129, 159, 160 maintenance • 203
automatically collapse trees • 131 minimize size • 204
autopilot • 148 date format • 159
Daylight Saving Time • 159, 164, 166
B defragmenting the database • 203
Back button • 23 demand control • 52, 139
backing up database • 203 Design mode • 29
BACnet alarm recipient intance • 159 device ID • 162
BACnet binding conflicts • 159, 162 Devices page • 49
BACnet devices • 18 disconnect manual command • 141
BACnet routers • 18 display name • 35
BACnet/IP • 156 download • 27, 46, 49, 51, 58, 126, 133,
BACview • 18 141, 156, 162, 164, 170, 172, 173
BACview files • 173 download manual commands • 141
BBMD • 47, 141 download options • 47
bbmd manual commands • 141 Downloads page • 47
binary schedule category • 63 driver • 126, 141, 164, 172
browser • 17, 18, 29
F M
Field Assistant • 47 maintenance • 203
floorplans • 27 manual commands • 141
font • 73, 178, 184 Manual Commands/Console Operations
privilege • 126, 141
G markdownload manual commands • 141
memory • 66
global copy • 44, 45, 66, 73, 141
menu button • 23
global modify • 35, 39, 42, 44, 109
menu commands • 23
go manual commands • 141
microblock paths • 44
graphics • 24, 35, 178
microblock pop-up • 33, 35, 39, 42, 141
attaching graphic files • 35, 156
microblock properties • 33, 35, 39, 42, 44
category • 37, 126
microblocks • 33, 35, 39, 42
editing • 36
minimize database size • 204
size • 26, 35
mismatch • 51, 141, 159, 162
Graphics button • 35, 37
modems • 83, 101, 141
Graphics pages • 33, 35, 52
modstat • 141
H modstat manual commands • 141
module memory • 66
Help button • 23 MSDE database • 160, 203
hierarchical servers • 57, 129, 133, 159 multi-state schedule category • 63
historical trends • 66, 159, 163, 204 My Settings • 82, 131, 133
HTTP • 159 MySQL database • 160, 203
I N
index • 63 NAT • 83
interactive thermostat control • 38 navigation pane • 23, 26
Internet browser • 17, 18, 29 navigation tree • 23
IP address • 141, 159 navigation, WebCTRL® • 23
network number • 162
K node name • 159
keyboard shortcuts • 71, 156 non-English system • 178
Normal mode • 29
L Notify all users • 32
labels • 42 notify manual command • 141
language pack • 178 O
languages • 131, 178
license • 167 operator access • 125, 133, 137
links • 24, 31, 35, 168 operator groups • 125, 129
local privileges • 133, 135 operators • 125, 129, 130, 133, 135
U
upload • 49, 51, 162
W
WAP • 152
WAP devices • 152
Web applications • 165
WebCTRL Server • 18, 29
changing systems • 29
restarting • 29
shutting down • 29
starting • 29
WebCTRL Server BACnet device instance •
159
WebCTRL® action pane • 23
WebCTRL® client • 18, 29
WebCTRL® Design Server • 31
WebCTRL® extensions for FrontPage • 180,
182
WebCTRL® navigation • 23
WebCTRL® navigation tree • 23
WebDAV • 150, 160
WebPRTL • 18
whoson manual command • 141
Windows service • 29, 175
Write Property alarm action • 83
Write to Database alarm action • 83
Write to File alarm action • 83, 99
Z
zones • 33, 52