Metasys SMP Help: Code No. LIT-1201793 Software Release 8.0 Issued June 2016
Metasys SMP Help: Code No. LIT-1201793 Software Release 8.0 Issued June 2016
Metasys SMP Help: Code No. LIT-1201793 Software Release 8.0 Issued June 2016
Welcome.....................................................................................................................................6
Getting Started....................................................................................................................................6
Summary of Release Changes .........................................................................................................6
Related Documentation......................................................................................................................6
System Overview................................................................................................................................9
Site Management Portal User Interface..........................................................................................10
Site Management Portal User Interface Concepts..............................................................................10
Site Management Portal User Interface Steps....................................................................................37
Working in the SMP UI........................................................................................................................41
Remote Services Connection..........................................................................................................42
Remote Services Connection Concepts.............................................................................................43
Remote Services Connection Steps...................................................................................................44
Remote Services Connection Troubleshooting...................................................................................44
Wizards..............................................................................................................................................45
Wizards Concepts...............................................................................................................................45
Wizards Steps.....................................................................................................................................46
Item Menu.................................................................................................................................47
Printing...............................................................................................................................................47
Edit Menu..................................................................................................................................47
Delete Items.......................................................................................................................................47
Deleting Objects or Items....................................................................................................................47
View Menu.................................................................................................................................48
Launching the Event Viewer............................................................................................................48
Event Viewer and Event Messages....................................................................................................56
Alarm and Event Management...........................................................................................................51
Alarm and Event Management for Metasys Systems Integrated with BACnet Devices.....................77
Launching the Audit Viewer.............................................................................................................87
Audit Trail............................................................................................................................................88
Trend Viewer......................................................................................................................................99
Trend Viewer Overview.......................................................................................................................99
Views...................................................................................................................................................99
Trend Viewer Steps...........................................................................................................................103
Tailored Summary Viewer Introduction........................................................................................106
Using a Tailored Summary................................................................................................................107
Summary Definitions Library.............................................................................................................108
Tailored Summary Viewer User Interfaces in SMP ..........................................................................117
Creating a New SCT Summary Definition.........................................................................................119
Summary Definition Wizard Descriptions..........................................................................................120
Tailored Summary Viewer Workflows................................................................................................120
Column Attributes for Summary Definitions......................................................................................120
Defining User Views with Summary Definitions................................................................................122
Defining Key Data.............................................................................................................................122
Viewing a Tailored Summary.............................................................................................................123
Editing an Existing SCT Summary Definition....................................................................................123
Tailored Summary Troubleshooting..................................................................................................125
Metasys SMP Help
Action Menu...........................................................................................................................132
Action Menu - Feature Specific.....................................................................................................133
Action Menu - Item Specific...........................................................................................................134
Commands.......................................................................................................................................135
Commands Dialog............................................................................................................................135
Modify...............................................................................................................................................143
Modify Dialog....................................................................................................................................144
Import Definition.............................................................................................................................150
Importing a Summary Definition........................................................................................................151
Export Definition.............................................................................................................................151
Exporting a Summary Definition.......................................................................................................151
View Annotations............................................................................................................................152
Add Annotation...............................................................................................................................152
Viewing Extensions........................................................................................................................152
Extension Wizard..............................................................................................................................152
Extensions.........................................................................................................................................153
Discard.............................................................................................................................................208
Refresh.............................................................................................................................................208
Refresh Current Tab........................................................................................................................208
Refresh All Tabs..............................................................................................................................208
Ack....................................................................................................................................................208
Import Integration...........................................................................................................................208
Remove From Site..........................................................................................................................208
Insert Menu.............................................................................................................................208
Site....................................................................................................................................................209
Site Object.........................................................................................................................................209
Supervisory Device.........................................................................................................................217
Engine Device Object.......................................................................................................................217
Metasys Server................................................................................................................................230
ADS Device Object...........................................................................................................................230
Open Data Server (ODS) .................................................................................................................235
Integration........................................................................................................................................248
BACnet Integration Object................................................................................................................249
Generic Integration Object................................................................................................................252
MS/TP Field Bus Integration Object..................................................................................................255
LON Integration Object.....................................................................................................................263
N1 Migration Object..........................................................................................................................266
N2 Master Datalink Object (N2 Trunk)..............................................................................................269
VND Integration Object.....................................................................................................................270
Wireless Receiver Supervisor Object...............................................................................................272
XL5K Integration Object....................................................................................................................273
Field Device.....................................................................................................................................274
Help
Graphic Object..................................................................................................................................622
XAML Graphic Object.......................................................................................................................624
Trend Studies..................................................................................................................................624
Trend Studies Concepts....................................................................................................................624
Trend Studies Steps..........................................................................................................................630
New User View.................................................................................................................................633
User Views........................................................................................................................................633
User Navigation Tree........................................................................................................................640
Summary Definition Wizard...........................................................................................................640
Summary Definition Object...............................................................................................................640
Tools Menu.............................................................................................................................641
User Profile......................................................................................................................................642
Preferences.......................................................................................................................................642
Change Password...........................................................................................................................651
Administrator...................................................................................................................................651
Configure Preferences...................................................................................................................651
All Items Organizer.........................................................................................................................651
Field Device Tools...........................................................................................................................652
Passthru Wizard................................................................................................................................652
HVAC PRO........................................................................................................................................653
GX-9100 Tool....................................................................................................................................654
XTM Configurator..............................................................................................................................654
DX Commissioning...........................................................................................................................654
N2 Device Loader.............................................................................................................................654
Controller Configuration Tool (CCT)..................................................................................................654
Query Menu............................................................................................................................655
Query Menu Introduction...............................................................................................................655
Query Menu Concepts......................................................................................................................655
Reports.............................................................................................................................................655
Global Search..................................................................................................................................657
Global Search Concepts...................................................................................................................657
Global Search Steps.........................................................................................................................661
Opening an Object List...................................................................................................................664
Saving an Object List.....................................................................................................................665
Deleting an Object List...................................................................................................................666
Create New Scheduled Report Screen..........................................................................................666
Scheduled Reports...........................................................................................................................667
Right-Click Menus..................................................................................................................677
Right-Click Menus and Menu Bar Equivalents.............................................................................677
Right-Click Menus - Feature Specific............................................................................................678
Right-Click Menus - Item Specific.................................................................................................681
Troubleshooting.....................................................................................................................683
Help
Index........................................................................................................................................692
Help
Welcome
Welcome to the Metasys Site Management Portal (SMP) Help. This Help system contains information on how to
use the Metasys software. This section describes the organization of the Help system and offers tips for using it
effectively. If you want an overview of Metasys software, go to the Site Management Portal User Interface section.
If you want an overview of the components that make up a Metasys system, see System Overview.
Getting Started
The Site Management Portal User Interface allows you to set up and maintain your building management system
by interacting with Metasys engines and servers to perform functions such as:
Navigating a Site, displaying information about an item, modifying an item, and issuing commands.
Creating graphical displays using the User Graphics Tool (UGT) and Graphics+.
Windows 10 Pro and Enterprise operating system support. Removed unsupported operating systems throughout
the document.
Object searching in the navigation trees with the Locate in Tree feature in the Working in the SMP UI section.
Related Documentation
Use the following table to find information available outside this Help system:
Table 1: Related Documentation
For More Information On
See Document
Metasys System
(LIT-12011832)
LIT-1201612
Launcher Help
LIT-12011742
Network Information Including Internet Security Network and IT Considerations for the IT
Risks
Professional Technical Bulletin
Network and IT Guidance for the BAS
Professional Technical Bulletin
Application and Data Server (ADS) or Extended Metasys Server Installation and Upgrade
Application and Data Server (ADX) Installation Instructions Wizard 1
and Upgrade
LIT-1201578
LIT-12011279
LIT-12012162
See Document
LIT-12012067
LIT-1201645
LIT-1201519
LIT-1201645
LIT-1201645
LIT-12011527
Use of the Export Utility to Extract Historical Data Export Utility Help
to Formats Such as Microsoft Excel and
Access
LIT-120952
LIT-12011525
Configuration and Use of the Advanced Graphics Advanced Graphics Application Help
Application to Create Graphics with Dynamic
Capabilities
LIT-1201850
LIT-12011685
Configuration and Use of the Graphic Generation Graphic Generation Tool Help
Tool to Create Graphics+ Files
LIT-12011697
LIT-12011708
SCT Help
LIT-12011964
LIT-1201528
LIT-12011530
LIT-12011568
LIT-1201519
See Document
LIT-12011044
LIT-12011524
LIT-1201990
LIT-1201532
LIT-1201672
How to Use Web Service Technology for Secure Metasys System Extended Architecture Secure LIT-1201663
Access to the Metasys System
Data Access DLL Technical Bulletin
The Concepts and Procedures to Perform an N1 N1 Migration with NIE Technical Bulletin
Migration with an NIE
LIT-1201535
How to Set Up an NAE as a LONWORKS Network LONWORKS Network Integration with NAE and LIT-1201668
Integrator
LCS Technical Bulletin
The Operation of and Setting up Metasys System DLLR Technical Bulletin
Demand Limiting and Load Rolling
LIT-12011288
Metasys Advanced Reporting System and Energy Metasys Advanced Reporting System Help
Essentials
LIT-12011312
How to Install the Metasys Advanced Reporting Metasys Server Installation and Upgrade
1
System
Instructions
LIT-12012162
LIT-12011539
LIT-1201645
LIT-1201645
Master-Slave/Token-Passing (MS/TP)
Communications and Field Controllers
1
2
System Overview
The major components of the Metasys system are:
Engine: The term engine is used in the Metasys system to describe a family of devices, including the NAE, NIE,
and Network Control Engine (NCE):
The NAE is a web-enabled, Ethernet-based supervisory controller that monitors and supervises networks of
field-level building automation devices that typically control HVAC equipment, lighting, security, fire, and building
access. The NAE provides features, including alarm and event management, trending, archiving, energy
management, scheduling, and password protection through its embedded Site Management Portal. Different
models and options support various communications protocols, including BACnet over IP, BACnet MS/TP, N2
Bus, N2, and LONWORKS network devices. The NAE55 Series supports a comprehensive set of supervisory
features and functions for large facilities and technically advanced buildings and complexes. The NAE35 and
NAE45 Series extend the power of the NAE to the smaller buildings (or small areas of larger buildings) and
enables the wider distribution of supervisory functions in larger facilities. The NAE85 supports large BACnet/IP
integrations.
The NCE combines the network supervisor capabilities and IP network connectivity of an NAE with the Input/Output
(I/O) point connectivity and direct digital control capabilities of a Metasys Field Equipment Controller (FEC). The
NCE provides a cost-effective solution designed for central plants and large built-up air handler applications. All
NCE models provide IP Ethernet network connectivity, the Site Management Portal, and the network supervisory
functions featured on network automation engines, including the BACnet IP integration. Depending on the model,
an NCE supports either a BACnet MS/TP trunk, an N2 Bus trunk, or a LONWORKS Network trunk.
The NIE is a web-enabled supervisory controller for integration of Metasys N1 Networks. The NIE is a specialized
version of the NAE and is designed to provide for the migration of existing N1 networks into the Metasys system.
The NIE provides the same Site Management Portal as the NAE. Unlike the NAE, the NIE does not support
integration of BACnet MS/TP or BACnet IP, N2, and LONWORKS networks. Two models of the NIE are available.
The NIE55 supports smaller N1 networks, while the NIE85 supports larger N1 integrations.
The NIEx9 is a web-enabled supervisory controller for integration of building control devices that communicate
over the Modbus, MBus, or KNX protocol. The NIEx9 also communicates over the BACnet MS/TP, BACnet
IP, N2, or LONWORKS networks. This specialized version of the NIE is designed to provide for the migration of
these existing third-party networks into the current generation Metasys system. The NIEx9 provides the same
Site Management Portal UI as the NAE or NIE. Several models are available: NIE29, NIE39, NIE49, NIE59, and
NIE89.
ADS/ADX (Server): The Application and Data Server is a software package that provides long-term storage of
alarm and event messages, trend data, and user transactions. The ADS/ADX typically coordinates multiple user
access from web browsers to the network. The Extended Application and Data Server provides extended user access
and historical data storage capabilities. An ADS/ADX provides access to the user interface and may serve as the
location for user graphics.
The ADX can also be installed in a split configuration with the ADX software/user interface on one computer (the
web/application server computer) and the historical trend data on another computer (the database server computer).
System Configuration Tool (SCT): The System Configuration Tool assists in all phases of engineering, installing,
and commissioning of devices that make up the Metasys system. The SCT can be used offline to create archive
databases that can be downloaded to an Engine or Server. The SCT also allows you to upload and archive databases
that were created or edited online from an Engine or Server. Using the SCT, you can view and configure multiple
sites in one archive.
SCT no longer requires the Site Director to be of an equivalent release version as the tool. The SCT also allows you
to maintain a variety of engines from Release 5.2 and later. The Site Director must now be at an equivalent or greater
release version than the highest versioned engine. For example, if you have a 6.5 engine and a 5.2 engine in your
archive, your Site Director needs to be greater or equal to Release 6.5.
The SCT has the same look and feel as the Engine and Server Site Management Portal. The SCT also provides a
Simulation feature, which allows you to simulate a functioning Engine and test the databases control logic before
you download it.
Metasys system configuration requires that you define a single device as the Site Director. The Site Director device
may be a network engine or server, and its primary role is to coordinate multiple-user access from the web browser
to the network. If an ADS/ADX exists in the system, it is defined as the Site Director automatically. When
communicating directly to Metasys system servers or network engines, you are in the online mode. For information
on the online, offline, and simulation modes of operation, see the modes section.
manage events
schedule activities
Note: The term Site Management Portal (SMP) refers to the user interface of the online Metasys engines and
servers as well as the offline System Configuration Tool (SCT), unless otherwise indicated.
For information on the Ready Access Portal UI, refer to the Ready Access Portal Help (LIT-12011342).
10
Object / Class ID
BACnet Analog Input / 0
N2 Analog Input / 147
XL5K Analog Input / 202
Lon Analog Input / 351
N1 Analog Input / 417
VND Analog Input / 428
BACnet Analog Input Mapper / 500
Analog Input Mapper / 599
BACnet Analog Output / 1
N2 Analog Output / 149
XL5K Analog Output / 203
Lon Analog Output / 352
N1 Analog Output / 419
VND Analog Output / 429
BACnet Analog Output Mapper / 501
Analog Output Mapper / 600
BACnet Analog Value / 2
JCI Analog Value / 165
BACnet Analog Value Mapper / 502
Analog Value Mapper / 601
BACnet Binary Input / 3
N2 Binary Input / 148
XL5K Binary Input / 204
Lon Binary Input / 353
N1 Binary Input / 418
VND Binary Input / 430
BACnet Binary Input Mapper / 503
Binary Input Mapper / 602
BACnet Binary Output / 4
N2 Binary Output / 150
XL5K Binary Output / 205
Lon Binary Output / 354
N1 Binary Output / 420
VND Binary Output / 431
BACnet Binary Output Mapper / 504
Binary Output Mapper / 603
11
12
13
14
15
16
Launcher
The Metasys system relies on a private internal Java Runtime Engine (JRE) that is installed when you download
the Launcher application. This private JRE is not exposed to the same security risks as the public version of the
JRE.
The Launcher manages a list of all supervisory engines, ADS/ADX servers, and SCT computers at your facility. You
can also add the Metasys UI, Ready Access Portal, Metasys Advanced Reporting System, and any web address
to its managed list of websites. You can access any release of the Metasys system with the Launcher, but opening
the SMP or SCT UI at Release 5.2 or earlier requires the public JRE on the client computer.
To install the Launcher application:
1. Open your web browser and enter the URL for the Site Management Portal. Examples:
http://MAIN-ADX/metasys
http://10.10.15.100/metasys
The Windows Launcher Download screen appears.
17
2. Click Full Launcher Installer if you need to access SMP or SCT, and you are allowed to install applications on
your computer.
Click Single Site Connection if you only need to access Metasys servers or engines of a specific release version
or you are not allowed to install applications on your computer.
3. Refer to the Launcher Installation Instructions (LIT-12011783) for completing the installation of Launcher.
4. After installation, close the web browser. By default, the Launcher screen appears after installation if you install
the full version of the Launcher (Figure 2). If you installed the Single Site Connection of the Launcher, the Metasys
Launcher screen appears (Figure 3) when you double-click its icon on the computer Desktop.
5. Refer to the Adding a New SMP or SCT Device Profile and Adding a New Other Profile sections of the Launcher
Help (LIT-12011742) for instructions on how to manage a list of all engines, ADS/ADX , SCT, Ready Access
Portal, Metasys Advanced Reporting System, or any generic website links that require a login.
18
Login
Note: We strongly advise that you do not access the Metasys Site Management Portal UI from a computer running
a server-class operating system. By default, Windows Internet Explorer Enhanced Security Configuration is
enabled on server-class operating systems and may block the Launcher download page from which you
install the Launcher application for access to the Site Management Portal. Open the Site Management Portal
UI from a computer that is not running a server-class OS.
19
The Metasys system supports Active Directory service and single sign-on (SSO). Metasys systems at Release
8.0 or later also support login for non-local users through Remote Authentication Dial-In User Service (RADIUS)
servers. Therefore, when you launch the device that is configured as the Site Director of the extended Metasys
network, four possible login scenarios occur:
If the Active Directory service or RADIUS server feature is disabled, the Metasys login screen appears. Enter
your Metasys user name and password to gain access to the Metasys Site Management Portal (SMP) user
interface.
If the Active Directory service and SSO features are enabled and you are logged in to your Windows desktop
as an Active Directory service user with access to the Metasys system, the login screen does not appear and
you automatically have access to the Metasys SMP user interface.
If the Active Directory service feature is enabled, but you are not logged in to your Windows desktop as an Active
Directory service user with access to the Metasys system (or if the Active Directory service feature is enabled
and SSO is disabled), the login screen appears. From that screen, you can access the Metasys system by
entering your Metasys user name and password, and by selecting Metasys Local from the Login To drop-down
menu; or by entering an Active Directory service user name and password, and by selecting the Active Directory
service domain from the Login To drop-down menu.
If the RADIUS server feature is enabled, and a user selects RADIUS from the login screen and provides a
non-local user name to the Metasys system for login. After confirming that the supplied password conforms to
Metasys complexity rules, the server or engine passes the credentials, including the user name and password,
to the configured RADIUS server for authentication. Only after the RADIUS server confirms authenticated access
is authorization then permitted as specified in the Metasys security database.
Note: Messages reporting errors in RADIUS authentication are intentionally obscure to hinder possible intrusion
from unauthorized users. Refer to the RADIUS Errors section of the Security Administrator System
Technical Bulletin (LIT-1201528) for situations that may result in error messages. Descriptive Metasys
system login failure messages are presented to the user only when RADIUS is disabled. When RADIUS
is enabled, local and non-local authentication failure messages are identical and obfuscated.
The first time you log in to the site or device and after you change the default password, the Metasys Terms and
Conditions appear. Scroll through and read the entire Terms and Conditions text. If you agree with the terms, click
Accept at the end of the text. If you do not agree, click Cancel to return to the login screen.
Note: If the Site Director is not available, you may want to directly connect to an Engine device. In this scenario,
Active Directory and RADIUS service login is not supported (both automatic login and user name/password
login), and you must use a Metasys user name and password to connect. The security configuration for an
Engine device may be set up differently than in the Site Director.
Department of Defense Enhancements
After ADS/ADX installation, you can use the SMP UI to enable the US Department of Defense (DoD) Banner option
at the Site object. After you enable the DoD Banner, a special login feature is presented to the user that satisfies
the requirements for a mandated DoD Information Assurance Certification and Accreditation Process (DIACAP).
This feature consists of a custom Department of Defense banner that the user must read and accept before logging
in.
Department of Defense Banner
A custom DoD warning statement (Figure 4) appears each time you access the Site Management Portal.
20
The statement contains information critical to any Metasys user accessing the BAS at a Department of Defense
facility. You must click OK to consent to the statement before reaching the login screen. The standard Metasys
system login screen appears after you click OK. If the Active Directory service and SSO features are enabled, Active
Directory logs you in without asking for the user name and password.
When the Metasys system login screen appears, you have up to 30 seconds to log in. If 30 seconds pass with no
login activity, the login screen clears and the DoD banner screen returns. The banner also reappears after you log
out of the Metasys system or the system logs you out because of user inactivity.
Record of User Access with IP Address
The Audit Viewer in the Metasys software records each change that occurs in the Metasys system. The User column
in the Audit Viewer records the name of each user who logged in (authorized user) or tried to log in (unauthorized
user). The Post Value column records the IP address of the client computer used to access the Metasys system.
See Figure 5.
21
Metasys Modes
Metasys software can operate in three different modes: online (Site Management Portal UI), offline using the SCT,
and Simulation (SCT). When you are connected to the Engine or ADS/ADX , you can perform online mode operational
activities such as monitoring and commanding. When you are connected to the SCT only, you can perform offline
mode system configuration tasks such as configuring point objects and features. The SCT has the ability to simulate
custom logic programs in the Logic Connector Tool (LCT) in Simulation mode.
Online Mode
When you are connected to the Engine or ADS/ADX , you can perform online operational activities such as monitoring
and commanding equipment. You can also perform online database configuration activities, such as defining field
controllers or adding points. This function is referred to as online mode or online Site Management Portal (SMP) UI.
The online mode is available to users with the Access Type of Standard Access or Basic Access. See the Access
Types section.
Any changes you make to the system configuration are made online to the system and need to be uploaded to be
stored in the archive database.
Offline Mode
SCT is a standalone software program installed on a computer, including the ADS/ADX server, that allows you to
configure the servers and network engines without being connected to the live Metasys system server and network
engines; this function is called the offline mode. In offline (system configuration) mode, use SCT to set up the system
database. You must load configuration changes created in offline mode to the Engine for the settings to take effect.
22
Two features are available only with SCT: ActionQ and Manage Archive. You can only add servers and network
engines in offline mode. Simulation mode can be started only using SCT.
The offline mode is available to users with the Access Type of Standard Access. See the Access Types section.
Simulation Mode
The SCT can simulate custom logic in the LCT. In Simulation mode, the LCT establishes a connection to a simulated
device and accesses simulated data. Simulation mode can only be started from offline mode. Simulation mode
allows you to experiment with the configuration and settings before you load it into the Engine. See the Access
Types section for more information about Standard Access.
Note: Simulation is not available on the ADS/ADX .
Note: Simulation testing requires that the engine be upgraded to the latest release supported within SCT.
Access Types
Metasys system administrators determine the type of access a user has to the Metasys system through user accounts
in the Security Administrator tool. The three access types are Standard Access, Basic Access, and Tenant Access.
Standard Access
Standard Access allows the Metasys local system user, RADIUS, or Active Directory service user to access all
authorized features of the online Site Management Portal (SMP) UI and the SCT.
Note: If you have Standard Access and the Advanced Reporting privilege, you can use the Metasys Advanced
Reporting System.
Basic Access
Basic Access provides users with access to a limited set of user interface capabilities based on their assigned
permissions. Basic Access allows the Metasys local system user, RADIUS, or Active Directory service user to access
only authorized features of the online Site Management Portal (SMP) UI. Typically, a Basic Access user is not
allowed to make any configuration changes. Metasys system administrators can also assign the Basic Access type
to Active Directory or RADIUS service users who have been added to the Metasys system. Basic Access meets the
user interface requirements for most building operators.
Tenant Access
Tenant Access allows the local user to access a single dashboard view as defined by a system administrator in the
Ready Access Portal UI.
Authorized Menu Items
Access to particular menu items depends not only on the mode of operation, but also on the defined System Security
and Authorization (Access Control) that provides users with appropriate levels of access to the Metasys system.
Use the Security Administrator System to set Authorization and System Security.
In each menu table, a check in the Authorization Required column means you must be authorized to perform that
action for that particular item.
Screen Layout and Frames
The screen contains four frames and provides a consistent look and feel in every mode (online, offline, or simulation).
Your access to certain features depends on the mode in which you are operating and your assigned access type
and privileges.
23
Note: If the navigation frame or a display frame is active, the header bar of the active frame or pane is highlighted.
The Menu and Status frames are not highlighted even when you click in them.
Figure 6: Basic Screen Layout
24
Menu
Displays the menu bar and the first three characters of the logged-in user name. Active Directory
or RADIUS service user names display as the fully qualified user name (for example,
user@engineering.jci.com).
Log out or exit from the system using buttons in the menu frame.
Display
Presents data or information in the user-selected Panel Layout. In the example in Figure 6, the
Display Frame contains two Display Panels. The top Display Panel shows information about
the Site Director named jciADX1 (the device is selected in the navigation tree and the name of
the device appears at the top of the Display Panel). The bottom Display Panel contains a Tailored
Summary called Engine Summaries associated with the Configuration and Diagnostics Panel
Layout user navigation tree. See the Display Frame Layout section for more information on the
Display Frame.
Navigation
Displays navigation trees that organize items in the system. The All Items tree generates
automatically when you configure the system database. You can create one or several user
navigation trees (also referred to as user views) for defining your own navigation concept.
Status
For more information on the navigation tree, see the Navigation Tree section.
Displays information about current user actions and the current time/time zone of the server
that you are logged into (supervisory device or Site Director). Status bar icons indicate system
status. In the screen above, the status bar indicates that all alarms are snoozed.
Navigation Tree
The navigation frame can display several navigation trees in online mode (Standard Access or Basic Access) . The
All Items tree is generated during system configuration and represents the network layout of your system. You can
add additional user-defined navigation trees (also referred to as user views) that provide navigation capabilities for
viewing particular parts of your system.
Note: The navigation trees that appear for a particular user, including the All Items tree, are defined by the system
administrator when the user's access permissions are created.
Navigation trees support standard browsing concepts such as the plus sign (+) for expanding items in the tree and
the minus sign (-) for collapsing or hiding items in the tree. The maximum number of items that you can nest under
an item in the All Items tree is 7. User-defined trees have no restrictions on the number of nested items.
To see more details on an item in the navigation tree, drag and drop the item or double-click the item in the navigation
tree. The navigation frame also supports scroll bars and both right-click and left-click options.
You can display user views as either a set of tabs (default) or a drop-down list. This interface helps with large jobs
that have many user views, as the tabs can occupy a large percentage of the viewable navigation screen area.
Configure the default navigation display in the General Display Settings on the Display Settings Tab of the Metasys
Preferences.
button to detach the navigation frame. You can minimize and maximize the navigation frame, but if you
Click the
click the X button, the frame is restored to its default position.
Items
The Metasys system uses the term item as a generic reference to an object or selection in the navigation tree. Items
in the All Items navigation tree include the site, devices, control systems (logic), graphics, objects, integrations,
schedules, files, trend studies, field points, user-defined navigation trees, and other system data. Each item can
have another item under it, and so on as the system hierarchy continues. Items have right-click pop-up menus that
provide commanding and viewing options. A symbol represents each item in the navigation tree, and status symbols
indicate the status of each item.
Metasys SMP Help: SMP Start Up Menu
25
Status Indicators
Status indicators show the status of items in the system on the user interface. For example, these status indicators
appear in the navigation tree, in a column on Summary views, and in a column on the Global Search Viewers Search
Results table. The following table shows examples of the status indicators and the mode in which they may appear.
Table 4: Status Indicators
Indicator
Indicator
Description
Status
Mode
Red Exclamation Point Alarm: Item (or an item under this item in the tree) is in an alarm Online
state.
Blue Exclamation Point Warning: Item (or an item under this item in the tree) is in a warning Online
state.
Red Exclamation Point Unreliable Alarm: Item (or an item under this item in the tree) may Online
and Red Question Mark be in alarm which is in an unreliable state.
Note: The Unreliable Alarm icon appears when the alarm state of
the object is Unreliable, and only applies to objects that have
alarming defined through an alarm extension, intrinsic alarming, or
an event enrollment object. If the objects Reliability attribute causes
its Status to be Unreliable, but the object does not have alarming
defined, its Alarm State is Normal and the icon is not shown.
Red X
Online
Note:
Field devices with the Disable Automatic Alarming attribute set
to True display a red X when they are offline. See the
appropriate object in the Object Help for details on this attribute.
Blue X
1
Online mode includes both Standard Access and Basic Access types unless noted otherwise. If the items under an item have
different states, the parent item displays only the icon for the state of highest priority (of Unreliable Alarm, Alarm, and Warning
states). Unreliable Alarm is the highest priority, followed by Alarm and Warning.
26
Panel Layout
The Display Frame can be divided into up to four display panels. When viewing an item in a display panel, the name,
status, and default attribute (usually the present value) of the item you display appear at the top of the display panel.
Each display panel can contain different tabs, depending on the item selected from the navigation tree, and each
tab shows different information. Dynamic attributes displayed in a panel automatically refresh when changes are
detected.
The default display panel is the first empty panel or last unlocked panel if all displayed panels are filled. Display
panels are locked while in Edit mode, or may be locked using the Lock button of the selected display panel. If all
available panels are locked, you cannot display an additional item in any of the display panels.
You can resize each display panel by dragging its borders, or using an available splitter bar. With some items, an
Edit button appears (except in Simulation mode), allowing you to edit the items configuration attributes. Editing in
online mode with Basic Access is limited to Schedules and Calendars, and no Edit button appears for any other
items.
You can drag and drop items into a display panel and navigate among them using the Back and Forward display
panel buttons. The display panel holds a maximum history of five items.
If you run any of the predefined reports found in the Query Menu, the result of the query appears in an available
panel in a spreadsheet format. Sort the report results by clicking the column heading, and resize columns by dragging
column borders. When you scroll down through the column, the headers remain visible.
The data presented in a report comes from a snapshot of the system at the time you request the report. The displayed
data does not automatically refresh and does not support an Edit mode. You can manually refresh the report through
the Action Menu.
Display Frame Layout
The user interface allows you to define your own display frame layout. Six options are available:
Figure 7: Panel Layout Options
To change the way the panels are arranged, see Changing the Display Panel Layout. If you have a multi-panel
display and you change to a layout with fewer panels, the locked items/newest items in the view stay, depending
on how many panes are available in the new layout. The other panels close (they do not reappear if you switch back
to the multi-pane view).
To resize the panels, drag the borders of the panel until it reaches the desired size. To make one panel (in a
multi-panel arrangement) take up the entire Display frame temporarily, click the maximize button. To restore a
maximized panel in a multi-pane view, click the restore button. A panel can also be maximized/restored by
double-clicking its header bar.
27
Becomes available when you define an Alarm Extension for a point. The New and Delete buttons allow you to
add or delete Alarm Extensions for the point. The Basic and Advanced radio buttons allow you to filter the
attribute display in this tab. The Edit button allows you to change configurable attributes.
Focus
Becomes available when you define a point object. The Focus tab shows operation attributes available for the
object type to which the object belongs. Please note that the Basic and Advanced radio buttons allow you to
filter the attribute display in this tab. The Edit button allows you to change configurable attributes.
Hardware
Becomes available when you define a point object that has a reference to a physical input or output. The
Hardware tab shows hardware-related attributes available for the object type to which the point object belongs.
BACnet Alarm Becomes available when you define a BACnet instrinic alarm for a point. The Intrinsic Alarming Defined attribute
is explained in Trend Extension Attributes section. The BACnet Alarm tab shows BACnet Alarm-related attributes
available for the object type to which the point object belongs. The Basic and Advanced radio buttons allow you
to filter the attribute display in this tab. The Edit button allows you to change configurable attributes.
Totalization
Becomes available when you create a Totalizator Extension. New and Delete buttons allow you to add or delete
Totalization Extensions for the point. The Edit button allows you to change configurable attributes.
Trend
Becomes available when you create a Trend Extension for a point object. New and Delete buttons allow you
to add or delete Trend Extensions for the point. The Chart view allows you to view data samples in a graphical
format and retrieve new trend data. The Table view of the Trend Extension allows you to view the trends data
samples in a table format. The Definition view of the Trend Extension allows you to view and edit the attributes
of the trend extension object.
Averaging
Becomes available when you create an Averaging Extension for a point object. The New button allows you to
add Averaging Extensions for the point.
Load
Becomes available when you create a Load Extension for a point object. The New button allows you to add
Load Extensions for the point.
Other items may contain fewer or more tabs. For example, the item representing the Engine or ADS/ADX contains
the following tabs:
Focus
Summary
Diagnostic
Communication
Network
Email
Pager
SNMP
Alarm
Trend
Printer
For information on the tabs available in the system, see the Object and Feature Tabs section.
28
This button does not appear if the user has Basic Access mode permission. It appears dimmed if
the user has Standard Access mode, but does not have Modify Items permission for the object being
viewed.
The term edit refers to changing items using the Edit button. See the Modify section. The term modify
refers to changing items using the Modify menu item and the Modify dialog box. See the Modify
Dialog section.
Displays the content previously displayed in that panel. Each panel can have a display history of up to
five items.
Displays the content of the next panel saved in the history.
Locks the selected display panel (prevents another item from being dropped in this panel and overwriting
it). A locked panel can be resized. This button toggles between locked and unlocked.
Maximizes the active panel to the full size of the Display Frame. You can also maximize the pane by
double-clicking the header bar. The other panels reappear if you click the restore button.
Restores the panels to their original size and position. You can also restore the pane by double-clicking
the header bar.
Closes just the currently displayed view in the display panel.
Closes all of the views in the display panel (including views stored in history).
Displays commonly used information about the displayed item.
Displays all the information the system contains pertaining to the displayed item.
Tailored Summaries
Tailored Summaries appear in the display frame, and allow you to view, command, and modify large quantities of
similar data in a tabular format. Tailored summaries are essentially summary views of Metasys system items. For
more information on this feature, see the Tailored Summaries section in the Metasys SCT Help (LIT-12011964)
.
Alarms Window
The Alarms Window (also referred to as Metasys - Events or Alarm Bar) displays the newest, highest priority alarm
message. Only alarms defined in the Fault Ack Required and Normal Ack Required attributes of the alarm extension
or the BACnet alarm definitions are eligible to appear in the Alarms Window. In addition, only those alarms for which
you have the Manage Item Events category-based permission appear in the Alarms Window. The alarm message
includes the name of the item in alarm, the current status, date and time when the alarm occurred, alarm priority,
the present value of the item, and a description related to the alarm condition (if applicable). The color of the Alarms
Window is based on the Alarms Priority level and is configured on the Alarm Settings Tab of the Metasys Preferences.
Metasys SMP Help: SMP Start Up Menu
29
Note: If the SMP UI is running on a Windows 10, Windows 8.1, Windows Server 2012 R2, or Windows Server
2012 device, the Alarms Window does not appear on the Start screen. Therefore, always operate the SMP
UI on the desktop if you are using one of these operating systems.
The number of alarm messages that require acknowledgment appear above the View Item button. Use the Alarms
Window buttons to perform actions related to the displayed alarm message. For more information on alarms and
events, see Alarm and Event Management. When no alarm messages need acknowledgement (or all alarms are
snoozed), the Alarms Window disappears. No matter which mode the system is in, you can minimize the window,
but it automatically restores itself if a new alarm occurs.
In an Engine that is not the Site Director, alarm and event messages that are acknowledged or discarded at the
Engine do not appear acknowledged or discarded in the Application and Data Server/Extended Application and Data
Server (ADS/ADX) .
To enable or disable the display of the Alarms Window, see Enabling or Disabling Alarm Pop-ups.
To have an audible sound notify users of changes occurring in the Alarms Window, on the Tools menu, click
Administrator, select the Enable Audible Alarm check box, and click OK. However, a user with administrator
rights must use the Security Administrator Tool to set this property for any Active Directory or RADIUS service users
who were added to the Metasys system. Make sure the Windows operating system audio controls are not muted
and the volume is loud enough to hear. An audible alarm sounds as long as an alarm is detected (if alarms are not
snoozed or at least one unacknowledged alarm is pending for the logged-in user). The alarm sound interval (15
seconds by default) is configurable from the Preferences dialog box.
The Alarms Window does not appear when you are using the SCT in offline (configuration) mode.
The current navigation view does not limit or affect the Alarm notification, only the users permissions for managing
item events can. Therefore, it is possible for a user to receive an alarm for an item that does not exist in the currently
displayed navigation view.
Alarms Window Buttons
The Alarms Window (also referred to as Metasys - Events or Alarm Bar) contains buttons to acknowledge, snooze,
view, and discard alarm messages.
Table 7: Alarms Window Buttons
Button Text
Description
Ack
Acknowledges events and stops the event from appearing on the Alarms Window.
Snooze
Sends the currently displayed alarm message away for 5 minutes, allowing any pending next highest
events to appear in the Alarms Window. After 5 minutes, the alarm appears in the Alarms Window again
(if it is the highest priority event). To change the amount of time the Alarms Window snoozes, see Engine
Device Object.
Snooze All
Puts the entire Alarms Window to sleep for 5 minutes. For the next 5 minutes, the Alarms Window
disappears, even if high priority alarms or events occur. To change the amount of time the Alarms Window
snoozes, see Engine Device Object.
View Item
Shows the Focus tab of the object in alarm in the Display Frame.
View Graphic
Displays the graphic associated with the alarm extension of the item in alarm in the available display
frame. This button appears only if a graphic has been defined for the object.
Discard
Minimize
Minimizes the Alarms Window to the Windows task bar. If a new alarm occurs, the Alarms Window
appears again as the top window.
For more information on alarm and event management, see the Alarm and Event Management section.
30
When the system detects any of the preceding conditions, a new diagnostic message appears at the bottom of the
message list. Whenever the UI Diagnostics window is open (even if cleared), an icon appears in the status bar.
When the user clicks the UI Diagnostics icon, the UI Diagnostics window moves to the front of all other windows. If
the UI Diagnostics window is closed, it opens automatically when a new diagnostics message is logged. Click Clear
to clear the window contents without closing the window.
Click Close to close the window.
Viewing Item Data
Item data is the information associated with an item such as the attributes of an object. Access the information
associated with an item by viewing it in a display frame. See the Displaying Information About an Item section for
more information.
Reports
Use the predefined report feature to query a single Engine, multiple Engines, or the entire site (all Engines on the
site) for alarm, offline, disabled, override, trouble, and out of service conditions. To generate a report, select one or
multiple Engines or the site in the navigation tree and select a report from the Query Menu. The query executes for
the selected Engine or site. When you select multiple Engines or the site in the navigation tree, the report feature
queries each supervisory device and combines the results in one report.
31
These predefined reports (alarm, offline, disabled, override, trouble, and out of service) are different from the
Scheduled Reports option available in the Query menu. For information on scheduled reports, see the Scheduled
Reports section. For information on the Global Search and Object List options, see the Global Search section.
The query results in a report in the display panel. The report shows the time the query was initiated, the report status,
and the report results. The stop button allows you to cancel a running query at any time. The Copy button allows
you to copy the report content to the clipboard. The following figure shows an example of an Offline Report. See the
Running Reports topic for information on how to run a query.
Figure 8: Offline Report Screen
Description
Alarm
Offline
32
Table 9: Reports
Report
Description
Disabled
Operator Override
Supervisory Override Lists all items currently overridden by the supervisory device.
For each overridden item, the report displays the item type icon, item name, status, item description,
and the current value of the item. See the status column to determine whether a supervisory overridden
item should be released.
Dormant User
Account
Trouble
Lists all items that have the Trouble attribute set to True.
For each item in trouble state, the report displays the item type icon, item name, and item description.
Binary Input and Binary Output points often have this property. It is mostly used in Fire and Security
applications, but may be used when the Binary Output command does not match the feedback. (Trouble
reports are integration dependent.)
Out of Service
Lists all items that have the Out of Service attribute set to True.
For each out of service item, the report displays the item type icon, item name, and item description.
All BACnet point objects have this property (for all integrations) as well as the BACnet Loop, Program,
and Schedule objects.
Commands
Use commands to force an item to perform a specific action. For example, ON and OFF commands for a binary
output make a fan run or stop, and the Enable and Disable commands in the Trend extension start and stop the
collection of samples.
For information on which commands an item supports, see the appropriate topic in the Object Help.
For information on how to send a command to a single item, see Commanding an Item in the Commands Dialog
section.
For information on sending a command to multiple items, see Commanding Multiple Items (Global Command) in
the Commands Dialog section.
Temporary Operator Override
Temporary Operator Override allows the operator to override a point for a specified time. After the specified time
period passes, the Override is automatically released. New at Release 8.0, Temporary Operator Override Command's
now support N2, LON, and VND integration objects.
33
Note: The command duration can range from 1 minute to 100 hours, 59 minutes.
Table 10: Temporary Operator Override Supported Objects
Local
BACnet
MSTP
N2
LON
VND
AV
AO
AO
AO
AO
AO
BV
BO
BO
BO
BO
BO
MSV
AV
AV
BV
BV
MSO
MSV
MSO
MSO
MSO
MSV
34
Note: The command duration can range from 1 minute to 100 hours, 59 minutes.
Table 11: Temporary Out of Service Supported Objects
BACnet
MSTP
N2
LON
VND
AI
AI
AI
AI
AI
BI
BI
BI
BI
BI
MSI
MSI
MSI
MSI
35
Interlock Object
Pop-up Menus
Pop-up menus provide an efficient way to quickly access important item information. Pop-up menus are also referred
to as right-click menus. To access pop-up menus, right-click an item in the Navigation Tree. Content of the menu
depends on the type of selected item and your level of authorization. For example, point object pop-up menus usually
show the options View, Command, Modify, and Show Extensions. For Engines, pop-up menus usually show View,
Event Viewer, Audit Viewer, Command, Modify, Show Extensions, Alarm Report, Offline Report, Disabled Report,
Operator Override Report, Supervisory Override Report, Trouble Report, Out of Service Report, and Remove from
Site.
Timed Inactivity Logout
Timed logout automatically logs you out of the Metasys system after a predefined time of inactivity. The system
closes open databases, discards unsaved changes and view settings, and logs out the user. Users who logged in
with a Metasys user name, RADIUS service user name, and users who were automatically logged in via Active
Directory service see the login screen at timed logout. If this system has the DoD Banner option installed, the DoD
banner screen appears at timed logout.
36
If you are a RADIUS user and want to access the Metasys system again, navigate to the Metasys URL, re-enter
your RADIUS user name and password, and select your RADIUS domain at the login screen. Click login to regain
access to the Metasys system.
If you are an Active Directory service user and want to access the Metasys system again through automatic login,
close the login screen and navigate to the Metasys URL. Otherwise, you can enter your Active Directory service
user name and password and select your Active Directory service domain at the login screen to regain access to
the Metasys system. Use the Security Administrator System to set this and other security features.
When the DoD banner screen appears at timed logout, you must click OK to consent to the statement before returning
to the login screen. The login screen waits 30 seconds for you to enter your credentials. If 30 seconds pass with no
login activity, the login screen clears and the DoD banner screen returns.
Electronic Signatures and Annotations for Metasys for Validated Environments (MVE) Only
MVE sites have settings in the Site Object for enabling annotation and electronic signature functionality. You can
set the MVE site to require only annotations, only electronic signatures, both annotations and signatures, or neither
annotations nor signatures. Non-MVE sites may optionally define and use annotations; however, electronic signatures
are specific to MVE sites.
When enabled, electronic signatures challenge users whenever they attempt to make a change to the system. Before
the system performs the users request, they must supply a signature and state a reason for the change. The
mechanism the Metasys system uses for expressing that signature is a reauthentication challenge, in which users
must reenter the password they used to log in to the Metasys system using either their Metasys password or their
Active Directory service password. This process is recognized as an electronic signature.
In addition to collecting the electronic signature, the Metasys system may also require the user to enter or select an
annotation. Annotations are statements that further describe the change being requested. After the password is
verified and an annotation is selected, the user request is performed.
You can configure electronic signatures and annotations at the device and object levels. You cannot delete annotations
on an MVE site. For information on enabling these settings, see Configuring Annotation and Electronic Signature
Requirements in the Site Object in MVE . For additional information, refer to the Metasys for Validated Environments,
Extended Architecture Technical Bulletin (LIT-12011327).
37
To disable the alarm pop-up windows feature of the Alarms Window, on the View menu, remove the selection from
the Enable Alarm Pop-Ups check box.
Note:
You can perform this task only if you have permission to disable the alarm pop-ups feature.
A dashed box appears around the alarm status bar icon,
, when the alarm pop-up windows are
disabled. If you click the icon, alarm pop-ups are automatically re-enabled, and the Alarms Window
appears if applicable.
By default, alarm pop-up windows are enabled every time you log into the system. However, if you want
to disable the Alarm Window from appearing every time you log in, set the Enable alarm pop-ups on
login attribute to False. This setting is located under Tools > Configure Preferences > Display Settings
tab, User Preferences section. You can perform this task only if you have permission to change User
Preferences. For more information, see Display Settings Tab.
Running Reports
You must be in online mode to run a report. Follow the steps in this procedure to run one of the predefined reports
(alarm, offline, disabled, operator override, supervisory override, trouble, and out of service). To schedule a report
on an ADS/ADX , see Creating a New Scheduled Report in the Scheduled Reports section.
To run a report:
1. Select the single supervisory device (Engine or ADS/ADX ), multiple supervisory devices, or the entire site in
the navigation tree that you want to query.
2. On the menu bar, click Query and select the type of report you want to run (Alarm Report, Offline Report, Disabled
Report, Dormant User Account Report, Operator Override Report, Supervisory Override Report, Trouble Report,
or Out of Service Report). The Report Viewer appears in the default display panel.
Note: If you did not select a supervisory device or site, a message box appears. Click OK, select a supervisory
device or site, and repeat Step 2.
3. View the results of the report.
Printing
1. Select the navigation tree or display panel you wish to print.
Note: You must select either the navigation tree or a display panel to enable Print. If you selected a display
panel, the entire contents of the visible display panel prints out. If you selected the navigation tree, all
visible parts of the tree print out (even parts of the tree that you need to scroll to view). Collapsed parts
of the tree (not visible in the tree) do not print. You cannot print the contents of the Alarms Window.
2. Select Page Setup from the Item menu if you wish to change the paper, orientation, or margin size. Click OK
when done.
3. Select Print Preview from the Item menu to see what the printout looks like. Click Print or click OK and go on
to Step 7.
4. On the Item menu, select Print.
Note: If the panel you selected is not printable, Print is disabled.
Configuring Annotation and Electronic Signature Requirements in the Site Object in MVE
For sites with MVE installed, configure the following attributes in the Site Object for MVE annotations and electronic
signatures:
Annotation Include
Annotation Exclude
Annotation Alarm Priority Threshold
38
Signature Include
Signature Exclude
Signature Alarm Priority Threshold
These settings appear only on MVE sites. See the Site Object section for details on these attributes.
You can require annotations, electronic signatures, both, or neither on an MVE site. Non-MVE sites may optionally
define and use annotations; however, electronic signatures are specific to MVE sites. For information on annotation
and electronic signature preferences, see Annotation Settings Tab and Electronic Signature Settings Tab in the
Preferences section. Also see Audit Message Annotations in Audit Trail for information on the fields in an annotation.
For additional information, refer to the Metasys for Validated Environments, Extended Architecture Technical Bulletin
(LIT-12011327).
Working with Items
In addition to the procedures in this section, see also Creating items and Exiting.
Navigating to an Item
To navigate to and select an item, click the plus (+) and minus (-) signs in the Navigation Tree to expand and collapse
folders until the desired item appears on the tree.
Note: Use the Ctrl or Shift key to select multiple items.
Note: For information about how to display information about the item, see the Displaying Information About an
Item section.
Displaying Information About an Item
To display information about an item you selected in the navigation tree:
Do one of the following and click the desired tab:
Drag and drop the item from the navigation tree into a display panel.
Select an item in the navigation tree, open the View Menu, and click Selected Item. The data displays in the
default display frame.
Double-click the item in the navigation tree; it displays in the default display panel.
Right-click an item in the navigation tree or a feature in the display panel (such as Global Search or a Tailored
Summary) and select View.
Note:
Modify
Note:
When you display information in a panel that already contains data, the older data is replaced and added
to the panel history. To access up to five previously displayed items in the panel history, click the back
button in the display panel.
If all available panels are locked and you try to display information about an item, a message appears
stating that all panels are locked. Click OK and unlock a panel to display other item information.
In online mode with Basic Access, you can edit only the Schedule and Calendar objects.
The term edit refers to changing items using the Edit button as described in this procedure. The term
modify refers to changing items using the Modify menu item and the Modify dialog box. See the Modify
Dialog section.
39
40
1. Select the object or item you want to delete in the All Items navigation tree. This option is not available in user
views.
2. On the Edit menu, select Delete Items.
Note:
You cannot select an object or item in the display frame and delete it from the system. You can only
delete objects or items by selecting them in the navigation tree.
After deleting objects or items in the online mode, perform an upload to store the updated system
configuration in the archive. Perform a download of your site to verify that the changes are visible in
the Metasys UI. After deleting objects or items in offline mode using SCT, perform a download to
update the online configuration of the device.
Logging Out
Save your changes before you log out. Logging out closes the Alarms window and all other open windows except
the login screen and Help. If your system is configured with a timed logout, the system times out after a specific
period of inactivity. For more information on exiting, see Exiting.
To log out, click the Logout button in the menu bar.
If you are an Active Directory service user who accessed the Metasys system by using an automatic login and want
to access the Metasys system again in the same manner, close the login screen and navigate to the Metasys URL.
Alternatively, you can regain access to the Metasys system by entering your Active Directory service user name
and password and selecting your Active Directory service domain at the login screen.
If you are a RADIUS user, you can regain access to the Metasys system by entering your RADIUS user name and
password, and selecting your RADIUS domain at the login screen.
Note: If you are editing an item in a display panel, the Metasys software cancels the logout process and notifies
you that you cannot exit or log out while in Edit mode. You must exit Edit mode by saving or cancelling your
changes before you can log out of the application.
Exiting
Save changes before exiting. Exiting closes all open windows (except the Help) associated with the session, including
the Alarms Window and login screen. For more information on logging out, see the Logging Out topic.
To exit, click the Exit button in the menu bar.
Note: If you are currently editing an item in a display panel, the Metasys software cancels the exit process and
notifies you that you cannot exit or log out while in Edit mode. You must exit Edit mode by saving or cancelling
your changes before you can exit the application.
41
Note: Locate in Tree search feature is not compatible with User Views and the Unlicensed Item trees.
42
43
44
Wizards
Wizards make complex tasks easy and guide you through creating and configuring objects and features. A wizard
typically consists of a series of steps, each corresponding to a screen presented to the user.
A wizard may appear when you select an option from the Insert menu and when you prompt certain actions such
as copying and pasting an item in the Navigation Tree. For example, a wizard appears when you select Object from
the Insert menu. Wizards that are available in different modes (for example, any combination of online, offline, or
simulation) appear the same.
Wizards Concepts
Types of Wizards
The following table lists the wizards in the system.
Table 14: Types of Wizards
Integration
Control System
Insert Object - AV
Insert Object - MV
Insert Object - BV
Field Device
Field Point
Graphic
Folder
45
Passthru Wizard
Closes the wizard without saving any data. This button is always active.
< Back
Takes you back one screen in the wizard. This may not be the last screen viewed, since you can move between
screens. This button is active on all screens except the first.
Next >
Takes you to the next screen in the wizard. If the current screen requires user input or you are on the last screen
in the wizard, the Next button is disabled.
Last
If available, presents a summary screen for the wizard. If your input is required in any previous screen, the Last
button is disabled. The Last button takes the user to the last wizard screen, which is the summary screen. Once
the summary screen is displayed, the Last button is replaced by the Finish button.
Finish
Exits the wizard and saves the data. Selecting Finish is the normal method of exiting a completed wizard. If any
prior screens require your input, this button is disabled. If a wizard has a summary screen, the Finish button is
not available until the summary screen is displayed.
Wizards Steps
Using Wizards
Browse the following Menu Topic chapters for more information on using wizards, including:
46
Note: All items appear in the wizard, not just valid destinations. When you click an item that is not a valid
destination for the item being added, an error message appears on the right side of the wizard and the
Next button is disabled.
3. Select Finish on the summary page to create the item. If an error occurs, a message displays and the wizard
returns to the summary page. If the item supports extensions, the Extension Wizard displays after the item is
successfully created.
Item Menu
The Item menu functions are used to select views to print.
Printing
1. Select the navigation tree or display panel you wish to print.
Note: You must select either the navigation tree or a display panel to enable Print. If you selected a display
panel, the entire contents of the visible display panel prints out. If you selected the navigation tree, all
visible parts of the tree print out (even parts of the tree that you need to scroll to view). Collapsed parts
of the tree (not visible in the tree) do not print. You cannot print the contents of the Alarms Window.
2. Select Page Setup from the Item menu if you wish to change the paper, orientation, or margin size. Click OK
when done.
3. Select Print Preview from the Item menu to see what the printout looks like. Click Print or click OK and go on
to Step 7.
4. On the Item menu, select Print.
Note: If the panel you selected is not printable, Print is disabled.
Edit Menu
The Edit menu is used to delete objects from your All Items tree.
Note: When in online mode with Basic Access, you can delete only Schedule and Calendar objects.
Delete Items
Menu Selection: Edit > Delete Items
Deletes (removes) one or more items selected in the All Items navigation tree from the site.
For details on deleting items, see Deleting Objects or Items.
47
Note:
You cannot select an object or item in the display frame and delete it from the system. You can only
delete objects or items by selecting them in the navigation tree.
After deleting objects or items in the online mode, perform an upload to store the updated system
configuration in the archive. Perform a download of your site to verify that the changes are visible in
the Metasys UI. After deleting objects or items in offline mode using SCT, perform a download to
update the online configuration of the device.
View Menu
Click the menu item in the following table for a description of the menu item. For a description of the Authorized
Required column, see Authorized Menu Items.
Table 16: SMP View Menu
Menu Item
Mode Visible In
Authorization Required
Online (Standard
Access)
Selected Item
Event Viewer
Audit Viewer
Trend Viewer
Scheduled Reports
Change Results
Panel Layout
Single Panel
Four Panel
Extended Labels
Validation Labels/Settings
1
2
48
3. Click OK. The Event Viewer appears in the display frame and displays the event messages from the event
repository of the selected device. See Event Viewer and Event Messages for details.
Note: Alternatively, you can right-click the desired device in the navigation frame and select Event Viewer from
the menu that appears.
Indicates the device for which the Event Viewer is displayed. The device name appears on the left side of
the Event Viewer above the table only for Engine devices.
This field corresponds to the selection made in the Device Selection Dialog box. See Launching the Event
Viewer.
Event Count
(Engines Only)
Indicates the number of event messages that currently appear in the Event Viewer. The Event Count appears
on the right side of the Event Viewer above the table only for Engine devices.
49
Apply - queries the ADS/ADX database and displays the resultant event messages
See Creating a Custom Filter for the Event Viewer (ADS/ADX Only).
Status Icons
Type
Displays the status of the item associated with the event message:
Normal
Trouble
Status
Offline
Unreliable
Priority
Indicates the priority of the event. See Event Priority. A lower priority number indicates event messages of
higher importance.
When
Displays the date and time that the event message was generated. The date and time format is defined by
the Language selected in the User Profile (User Profile tab of the Security Administrator System).
50
Displays the Name of the item that generated the event message. An item name is the label displayed for
the selected item in the All Items navigation tree (for example, AV1, NAE2, or Schedule1). Be sure you
define relatively unique item names if you plan to use printed lists of the event messages of the Event Viewer.
Value
Displays the Present Value and engineering units, if applicable, of the associated item at the time the event
message was generated.
Description
Displays the text defined by the Description attribute for the item that generated the event message. Be sure
you define relatively unique descriptions if you plan to use printed lists of the event messages of the Event
Viewer.
Alarm Message
Text
Displays the text defined by the Alarm Message Text attribute of the alarm extension for the state of the
item associated with the event message, if applicable.
Specifies the column of data used to sort the event messages currently displayed in the Event Viewer
(ascending or descending order).
Paging Controls Allows you to navigate through the pages of event messages in the Event Viewer. Use the buttons to go to
(ADS/ADX Only) the first page, previous page, next page, or last page. Type a page number in the text box and press the
enter key to jump directly to a specific page.
Ack Button
Discard Button
Removes the selected event messages from the Event Viewer. See Discarding Event Messages.
Note: In an Engine that is not the Site Director, acknowledged or discarded alarm and event messages do
not appear acknowledged or discarded in the ADS/ADX .
Copy Button
Copies the selected events to the Clipboard for pasting into other applications such as Microsoft Excel or
Word.
If nothing is selected in the Event Viewer when you click this button, all entries copy to the Clipboard. You
can also use Ctrl+A to select all and Ctrl+C to copy to Clipboard.
51
When an FAC generates an event message, it temporarily stores the event message in its Event Log. It also
immediately forwards the event message to the Engine to which it is connected. When an Engine generates an
event message, it temporarily stores the message in its local event repository. When an ADS/ADX generates an
event message, it permanently stores the message in its ADS/ADX event repository. You can send event messages
stored in the local event repository of an Engine to the event repository of an ADS/ADX for permanent storage by
defining an ADS/ADX event repository as the default destination. Also, you can route event messages to other
destinations such as a pager or an email account. For more information, see the Event Repositories and Event
Message Routing, Filtering, and Destinations sections.
For sites with MVE installed, configure the following attributes in the Site Object:
Annotation Include
Annotation Exclude
Annotation Alarm Priority Threshold
Signature Include
Signature Exclude
Signature Alarm Priority Threshold
These settings apply to only MVE sites, and enable the MVE required annotations and electronic signature for event
messages. You can apply these settings at the site level or down to the object level as needed. You can define the
settings to require an electronic signature, an annotation, neither, or both. When both options are required, and a
user acknowledges or discards an event message, they are prompted to reauthenticate and enter a reason and
annotation for the action. The users login name, date and time of signature, and the reason for signature are saved
as part of the annotation. You cannot delete annotations on an MVE site.
Non-MVE sites may optionally define and use annotations; however, electronic signatures are specific to MVE sites.
See Configuring Annotation and Electronic Signature Requirements in the Site Object in MVE in the Site Management
Portal User Interface section. For additional information, refer to the Metasys for Validated Environments, Extended
Architecture Technical Bulletin (LIT-12011327).
The Alarms Window and Event Viewer allow you to examine and respond to event messages. The Alarms Window
displays event messages one at a time in a prioritized order and allows you to respond to the newest alarm first.
The Event Viewer displays all of the event messages stored in the event repository of the currently selected device.
In addition, Alarm Reports allow you to query for alarm conditions in the Metasys system online and provide a list
of items that are currently in an alarm condition.
Note: The current navigation view does not limit or affect the alarm notification; only the users permissions for
managing item events can. Therefore, a user may receive an alarm for an item that does not exist in the
currently displayed navigation view.
52
The following figure shows the flow of event messages through the Metasys system.
Figure 13: Event Message Flow
For information on how to configure and route event messages for Metasys systems integrated with BACnet devices,
see the Alarm and Event Management for Metasys Systems Integrated with BACnet Devices topics.
Alarm Extensions
Using object alarm extensions is a very easy method for configuring the detection of alarm conditions. To configure
the values that determine alarm condition detection, use the Alarm Extension Wizard that appears after creating an
object using the Object. You also can add alarm extensions after you create an object by selecting it in the navigation
tree and selecting Show Extensions from the Action Menu. You cannot add, edit, or delete alarm extensions in online
mode with Basic Access.
Use alarm extensions to define the values for the high/low warning and high/low alarm conditions for Analog Input
Object, Analog Output Object, and Analog Value Object. For a complete list of Analog Alarm extension attributes,
see Analog Alarm Attributes.
Also, use alarm extensions to define the values for the alarm and trouble conditions for Binary Input Object, Binary
Output Object, Binary Value Object, Multistate Input Object, Multistate Output Object, and Multistate Value Object.
For a complete list of Multistate Alarm extension attributes, see Multistate Alarm Attributes.
In addition, you can use alarm extensions to define the following conditions:
alarm state parameters such as Event Enable, Delay Time, and Report Delay
alarm setup parameters such as Acknowledgment Required, Alarm Message Text, and associated Graphics
Devices with the Disable Automatic Alarming attribute set to True do not produce an alarm but indicate they are
offline in the navigation tree with a red X. See the appropriate object in the Object Help for details on this attribute.
This attribute does not affect alarm extensions.
The Enable Alarms and Disable Alarms commands affect any and all alarm extensions defined for an object.
For more details on configuring alarm extensions, see Creating Extensions, Alarm Extensions, and the Help section
for the selected object.
53
After using alarm extensions to configure the detection of alarm conditions, you must configure the routing, filtering,
and format of event messages from Engine or ADS/ADX to the desired destinations. For more information on filtering
or routing events messages, click one of the following section names:
ADS/ADX Event
Repository
Allows the event messages stored in the local Engine event repository to appear in the Event
Viewer and Alarms Window.
Sends event messages from the local Engine event repository to the defined Default Destination.
Event messages generated on an ADS/ADX platform are placed directly into the ADS/ADX
event repository.
Allows the event messages stored in the ADS/ADX event repository to appear in the Event
Viewer and Alarms Window.
Receives event messages from multiple local Engine event repositories and provides permanent
storage for the event messages. The ADS/ADX event repository is usually defined as the
Default Destination for event messages from local Engine event repositories.
Provides the option to send event messages from a single ADS/ADX event repository to one
or more ADS/ADX event repositories for permanent storage. See the Configuring an ADS/ADX
Event Repository section for details.
Event logs are only viewable in the CCT. Configure the Advanced tab to work with Advanced
Application Field Equipment Controllers (FACs) to record events via events logs. Refer to
Working with the Advanced Tab in the CCT Help (LIT-12011147).
The CCT can be set up to send event notifications from the FAC event logs to other devices.
Refer to Setting up Device Notification in the CCT Help (LIT-12011147).
For information on configuring the event repositories, click one of the following section names:
A Database Timeout Error can occur when viewing events if the repository contains too many events to be filtered
before the system times out (typically, one million events). To prevent this error, you should backup and purge event
records from the repository (JCIEvents) using the Metasys Database Manager on a regular basis.
54
Default Destination
You can define an ADS/ADX repository as a Default Destination for each Engine where event messages are sent
under certain conditions and permanently stored:
If the Default Destination is an ADS/ADX that has a LAN connection (as defined by the Engine Device Objects
ADS Connection Type attribute or the Site Objects Default ADS Connection Type attribute), event messages
generated by the Engine are sent to the ADS/ADX as they occur.
If the Default Destination is an ADS/ADX that has a Dial connection, event messages generated by the Engine
are sent to the ADS/ADX when the local event repository is 90% full (NAE objects Alarm Repository's Size
attribute), at the user-defined time (NAE objects ADS Delivery Time attribute), or when the event priority
exceeds the user-defined level (NAE objects ADS Priority Threshold attribute).
See the Site Object, Engine Device Object, and Server Connection Type sections for information on these attributes.
For information on how to define a Default Destination, see the Configuring an Engine Event Repository section.
If you have not defined a Default Destination when the Engine local event repository is 100% full, the local event
repository either replaces the oldest messages (rollover) with new messages or stops recording events according
to the Event Action When Full attribute configuration.
Event message rollover begins or replacement stops only when the total number of nonforwarded event messages
reaches the size defined by the Event Repository Size attribute. In other words, once the local event repository
reaches the defined size, new event messages continue to enter the local event repository replacing forwarded
messages until all forwarded messages are gone. The following figure illustrates the Event Action When Full when
set to Rollover or when set to Stop.
Figure 14: Event Action When Full
If you have defined a Default Destination and the Event Action When Full attribute is set to Stop, the event messages
do not stop rolling over as long as forwarding is successful. This situation occurs because event messages are
forwarded to the Default Destination when new event messages are received, and the forwarded messages are
automatically replaced. The local event repository does not fill up with nonforwarded event messages and, therefore,
does not stop accepting new event messages.
55
If an event repository is full when a new event occurs, the following rules apply:
1. Events forwarded to an ADS Event Repository are always removed before events not forwarded.
2. The lowest priority event with the oldest time stamp and Acknowledge Required set to false is replaced first.
3. If the event about to be created is of higher priority than at least one event in the repository, the event with the
oldest time stamp and lowest priority is replaced.
4. If all events are of the same priority, the event with the oldest time stamp is replaced.
5. If the event about to be created is of a lower priority than all other events in the Event Repository, no event is
replaced and the new event is discarded. In this situation, the new event does not cause the Alarm Window to
appear, or any other Destination Delivery Agent (DDA) action to take place.
Note:
The local repository for alarms in the NAE is set to rollover at 1000 alarms automatically if the alarms
meet the above requirements.
You can define only one ADS/ADX Repository as the Default Destination for an Engine; however, different
Engines can have different ADS/ADX Repositories defined as their Default Destination.
You can forward event messages from one ADS/ADX to other ADS/ADXs on the same site. For details,
see the Configuring an ADS/ADX Event Repository section.
56
Indicates the device for which the Event Viewer is displayed. The device name appears on the left side of
the Event Viewer above the table only for Engine devices.
This field corresponds to the selection made in the Device Selection Dialog box. See Launching the Event
Viewer.
Event Count
(Engines Only)
Indicates the number of event messages that currently appear in the Event Viewer. The Event Count appears
on the right side of the Event Viewer above the table only for Engine devices.
Standard Filter
Indicates that standard filtering is applied to the Event Viewer for the selected ADS/ADX . This filter information
Radio Button
appears on the right side of the Event Viewer above the table. The count of entries that apply to this filter
(ADS/ADX Only) appears in parentheses next to the radio button.
Custom Filter
Indicates that custom filtering is applied to the Event Viewer for the selected ADS/ADX . This filter information
Radio Button
appears on the right side of the Event Viewer above the table. The count of entries that apply to this filter
(ADS/ADX Only) appears in parentheses next to the radio button.
Custom Filter
Allows you to apply custom filtering to the Event Viewer when the Custom Filter radio button is selected.
Table (ADS/ADX This table appears but is not active when the Standard Filter radio button is selected. You may need to
Only)
adjust the slider bar to show the Custom Filter table.
The buttons for this table are:
Add - adds a filter using the Add Filter dialog box
Apply - queries the ADS/ADX database and displays the resultant event messages
See Creating a Custom Filter for the Event Viewer (ADS/ADX Only).
Status Icons
57
Displays the status of the item associated with the event message:
Normal
Trouble
Status
Offline
Unreliable
Priority
Indicates the priority of the event. See Event Priority. A lower priority number indicates event messages of
higher importance.
When
Displays the date and time that the event message was generated. The date and time format is defined by
the Language selected in the User Profile (User Profile tab of the Security Administrator System).
Item
Displays the Name of the item that generated the event message. An item name is the label displayed for
the selected item in the All Items navigation tree (for example, AV1, NAE2, or Schedule1). Be sure you
define relatively unique item names if you plan to use printed lists of the event messages of the Event Viewer.
Value
Displays the Present Value and engineering units, if applicable, of the associated item at the time the event
message was generated.
Description
Displays the text defined by the Description attribute for the item that generated the event message. Be sure
you define relatively unique descriptions if you plan to use printed lists of the event messages of the Event
Viewer.
Alarm Message
Text
Displays the text defined by the Alarm Message Text attribute of the alarm extension for the state of the
item associated with the event message, if applicable.
Specifies the column of data used to sort the event messages currently displayed in the Event Viewer
(ascending or descending order).
Paging Controls Allows you to navigate through the pages of event messages in the Event Viewer. Use the buttons to go to
(ADS/ADX Only) the first page, previous page, next page, or last page. Type a page number in the text box and press the
enter key to jump directly to a specific page.
Ack Button
Discard Button
Removes the selected event messages from the Event Viewer. See Discarding Event Messages.
Note: In an Engine that is not the Site Director, acknowledged or discarded alarm and event messages do
not appear acknowledged or discarded in the ADS/ADX .
Copy Button
Copies the selected events to the Clipboard for pasting into other applications such as Microsoft Excel or
Word.
If nothing is selected in the Event Viewer when you click this button, all entries copy to the Clipboard. You
can also use Ctrl+A to select all and Ctrl+C to copy to Clipboard.
58
When viewing annotations: The User field appears under the Annotation Information section
that displays the user ID of the person that added the annotation.
When adding annotations: Displays the date and time the event message was generated.
When viewing annotations: The first Date and Time field displays the date and time the event
message was generated. The Date and Time field appearing under the Annotation Information
section displays the date and time the annotation was added to the event message.
The date and time format is defined by the Language selected in the User Profile (User Profile
tab of the Security Administrator System).
Item Reference
Indicates the complete Item Reference defined for the item that generated the event message.
Description
Displays the text defined by the Description attribute of the item that generated the event message.
Annotation
Allows you to select from a list of predefined annotations or add a text string (annotation) of
1255 characters that may be used to describe any operational tasks that should be performed
to respond to the cause or condition that prompted the generation of the event message.
Navigation Controls
Allows you to navigate through the annotations, if the event message has multiple annotations
associated with it. Use the buttons to go to the first annotation, previous annotation, next
annotation, or last annotation.
The text box displays the number of the annotation being viewed. The Annotations feature
automatically assigns a number to each annotation created. For example, if the event message
has three annotations, the number appearing in this section can be 1, 2, or 3 depending on the
annotation being viewed. Type a number in the text box and press the Enter key to jump directly
to a specific annotation.
59
Note:
When you forward event messages, the messages are sent (copied) to the ADS/ADX repository defined
as the Default Destination. The event messages are not removed from the ADS/ADX repository that sent
the messages.
Use message forwarding for notification purposes, not as a backup or archiving method. Use standard
SQL practices for backup, archiving, or replication purposes.
Pager
SNMP Trap
Serial Printer
Note: This DDA is enabled using Remote Desktop of a Site Director Engine and no attributes/tabs appear in
the UI. This DDA is not available on the NAE35, NAE45, NCE25, or NIE59. Refer to the NAE
Commissioning Guide (LIT-1201519) for details on this DDA.
For each ADS/ADX , you can configure the routing and filtering of event messages using the following DDAs:
Pager
Printer
SNMP Trap
When configuring any of these DDAs, you can apply filters for routing specific event messages and define the format
in which the event messages are displayed at the destination. See Configuring Destination Delivery Agents (DDAs)
for information on how to route event messages to destinations. See Configuring Event Message Format to define
the message delivery format.
Use filters to determine which event messages get routed to the defined Destination, such as a pager or email
account. For example, define a filter to route only the event messages that require acknowledgment by selecting
Acknowledge Required == true.
For more information on filters, click the following section names:
Filtering Operators
Filtering Options
Filtering Examples
See the Event Message Routing Sample Scenario section for a sample event message routing scenario.
See the Related Documentation table.
60
Filtering Operators
The following table describes the Boolean operators used to configure the filters for routing event messages to
destinations.
Table 21: Operators
Operator
Meaning
==
Equal To
!=
Not Equal To
<
Less Than
<=
>
Greater Than
>=
Note: If you define multiple filters for a destination, the DDA combines all the criteria with an AND condition (all
filter criteria must be met).
For more information on filters, click one of the following section names:
Filtering Options
Filtering Examples
Filtering Options
You can apply filters to define which event messages are sent to specific destinations. For information on how to
apply filters to event messages, see Applying Filters for Routing Event Messages to Destinations. Use the following
table as a guide to defining filters.
Note: If you define multiple filters for a destination, the DDA combines all the criteria with an AND condition (all
filter criteria must be met).
Table 22: Filters
Item
Operator
Value
Item Category
==, !=
Acknowledge Required
==, !=
true, false
Current Status
==, !=
Normal, Fault, Off Normal, High Limit, Low Limit, Low Warning,
High Warning, Low Alarm, High Alarm, Alarm, Trouble, Status,
Offline, Shutdown, Unreliable, Online, Unknown Previous State
==, !=
Normal, Fault, Off Normal, High Limit, Low Limit, Low Warning,
High Warning, Low Alarm, High Alarm, Alarm, Trouble, Status,
Offline, Shutdown, Unreliable, Online, Unknown Previous State
Priority
Range 0255
See Event Priority.
61
Operator
Value
Start Time
End Time
Filtering Operators
Filtering Examples
Filtering Examples
The following table provides examples of filters used by DDAs for routing event messages.
Table 23: Filtering Examples
Example
Meaning
The DDA routes all event messages to the defined destination except those
from the HVAC category.
The DDA routes only the event messages that require acknowledgment to
the defined destination.
The DDA routes all event messages that were generated by objects in
Alarm status to the defined destination.
The DDA routes all event messages to the defined destination except those
that were generated by objects in the unknown previous state.
The DDA routes all event messages with an Event Priority equal to or less
than 200 to the defined destination. See Event Priority.
The DDA routes all event messages generated from 5:00:00 PM on Friday
through 6:00:00 AM on Monday.
and
Start Time >= 05:00:00 PM
The Time format is defined by the Language selected in the User Profile
(User Profile tab of the Security Administrator System).
and
End Day of Week <= Monday
and
End Time <= 06:00:00 AM
62
If you want to define a set of filters for sending all High Alarm messages for your HVAC systems that have been
defined with event priorities belonging to the Property Safety Group (Priority 4079) and require acknowledgment
at an email destination, apply all the following filters under the Email tab of the Engine or ADS/ADX .
Filtering Operators
Filtering Options
Email
You can configure email addresses as destinations for event messages. The Email DDA supports standard SMTP.
You can also send encrypted email messages.
For information on how to configure an email destination, see Configuring Destination Delivery Agents (DDAs). For
information on sending encrypted email messages, see Configuring Encrypted Email.
Note: The procedure for configuring the Email DDA is the same for the NAE, NCE, NIE, ADS, and ADX .
For additional information, see one of the following sections:
Configuring Event Message Format to configure how the event message appears at the email destination
63
Displays the users defined in the Security Administrator System and their email addresses.
This information appears only for the device that you are currently accessing.
Allows you to enter email addresses not appearing in the Metasys User Addresses list.
When entering more than one email address, separate the addresses with a comma
(John.Smith@jci.com,Jane.Smith@jci.com).
64
Displays the Metasys User Addresses and Additional User Addresses that you selected
or entered from the Metasys User Addresses and Additional User Addresses lists.
You can expand or collapse the Metasys User Addresses folder and Additional User
Addresses folder by clicking the + or - sign or by double-clicking the folders.
If you right-click the Metasys User Addresses folder or Additional User Addresses folder,
the following menu options appear:
Sort-by Name: Displays the users in alphabetical order by name. This option is
available only for the Metasys User Addresses folder.
Remove All: Removes all users and email addresses from the selected list.
For the button next to the Metasys User Addresses list, adds the selected users and
their email addresses to the Destination Email Addresses list.
Add Button
For the button next to the Additional User Addresses lists, adds the email addresses
entered to the Destination Email Addresses list.
Displays the number of characters in the email address string. This number is calculated
after clicking the Add button next to either the Metasys User Addresses list or the
Additional User Addresses list.
The maximum number of characters allowed for the email address string is 256.
Remove
Removes the selected user and email address from the Destination Email Addresses
list. You also can select a user or email address, right-click, and select Remove.
Remove All
Removes all users and email addresses from the Destination Email Addresses list.
Pager
You can configure one or more pagers as destinations for event messages. The Pager DDA supports standard
Telelocator Alphanumeric Protocol (TAP).
For information on how to configure a pager destination, see Configuring Destination Delivery Agents (DDAs).
Note: The procedure for configuring the Pager DDA is the same for the NAE, NCE, NIE, ADS, and ADX .
For additional information, see the following:
Configuring Event Message Format to configure how the event message appears at the pager destination
Note: The event message format for pagers is very brief to conform to pager space limitations.
Troubleshooting Tip:
Any modem initialization strings set in the Control Panel of an ADS/ADX are prefixed with AT&. Enter the initialization
strings for the modem accordingly. Several safe, benign codes can be entered at the beginning of your string to
prevent any improper initialization but must be re-entered if the ADS/ADX is restarted. The exact text of the string
varies per modem. For example, for one U.S. Robotics modem qualified with the Metasys system, enter
M4S13=7S19=2.
Troubleshooting Tip:
Metasys SMP Help: View Menu
65
Occasionally, a pager message may contain extraneous junk characters. These characters may come from the
paging service, appear as a result of interference, or appear when the pager battery is low.
To reduce the number of pager messages containing such characters, cycle power to the modem by unplugging
the USB cable from the modem and any power adapters, if applicable. Wait 10 seconds, and then reconnect the
USB cable and any power adapters.
Printer
On the ADS/ADX platform, you can define any printer supported by Windows software as a destination for event
messages, and a single DDA can print alarms on multiple printers. Printers connected to the ADS/ADX by parallel
port or USB are supported, as well as IP-based network printers (if printers are set up with an IP address). This
platform does not support Novell NetWare printers. Printer support is the same for both the ADS and ADX.
To set up a printer on a split ADX, the printer must be accessible from the web/application server computer, as
opposed to the database server computer.
You can configure the ADS/ADX Printer DDA for single line printing for a tractor feed printer (also known as tractor
feed printing, line printing, and dot matrix printer support). To set up a printer for single line printing for a tractor feed
printer (no form feed/tractor printing mode), set the ADS Device Object Printer tab Line Out attribute to 0. By setting
this attribute to 0, when an alarm is sent to the tractor feed printer, it prints the alarm text, and then advances a single
line, thus waiting to print the next alarm.
Note:
When using a tractor feed printer (without any form feeds), the Timeout, Printing Priority Threshold,
Orientation, Font Face, and Font Size attributes are not used and any values set for them are ignored.
You can set the Orientation, Font Face, Font Size, and line wrapping at the printer itself.
Tractor feed printing is only intended for tractor feed printers. You may encounter abnormal behavior if
you set the Line Out attribute to 0 for other type of printers, such as deskjet and laserjet printers.
For information on how to configure a printer destination on an ADS/ADX , see Configuring Destination Delivery
Agents (DDAs).
For additional information on ADS/ADX Printer DDAs see the following:
Configuring Event Message Format to configure how the event message appears at the printer destination
On the NAE55/NIE55 and NAE85/NIE85 platform, you can use the Serial Printer DDA on the Site Director Engine
to print event messages. This DDA is enabled using Remote Desktop and no attributes/tabs appear in the UI. This
DDA is not available on the NAE35, NAE45, or NIE59. Refer to the NAE Commissioning Guide (LIT-1201519) for
details on this DDA.
SNMP Trap
You can configure a Simple Network Management Protocol (SNMP) Trap as a destination for event messages. The
SNMP Trap DDA supports SNMP Versions 1, 2C, and 3.
For information on how to configure an SNMP Trap destination, see Configuring Destination Delivery Agents (DDAs).
Note: The procedure for configuring the SNMP Trap DDA is the same for the NAE, NIE, ADS, and ADX .
For additional information, see the following:
Configuring Event Message Format to configure how the event message appears at the SNMP Trap destination
66
Syslog
New at Release 8.0, you can configure a Syslog destination for error logging. through destinations track that forward
all system events or audits to your Syslog server.
The Metasys system provides the optional capability of sending its configured audit log entries and alarm notifications
to an external, industry-standard Syslog server, conforming to Internet published RFC 3164. The Syslog option
provides positive indication of each field possible in the Metasys event and audit entries, replacing any blank field
with the single character dash (-). Individual fields of each Metasys message are sent to the Syslog server separated
by the vertical bar symbol (|), ensuring the integrity of all data sent to the Syslog server.
After the Syslog DDA is configured, all messages sent to the local ADS Repository are also sent immediately to the
configured Syslog server. You can apply forensic analysis on the consolidation of all electronic audit and event
information at the Syslog server.
For information on how to configure a syslog destination, see Configuring Destination Delivery Agents (DDAs).
Note: The procedure for configuring a syslog DDA is the same for the NAE, NCE, NIE, and ADS .
For additional information, see the following:
Configuring Event Message Format to configure how the event message appears at the syslog server
Use a consistent priority scheme to make sorting event messages based on priority in the Event Viewer
easier.
You can specify alarm notification sounds based on alarm priorities. See Alarm Settings Tab.
67
Recommended Use
11
14
19
Medical Alarm
22
25
Panic Alarm
28
31
Recommended Use
45
48
Security Alarm
51
60
63
66
69
Recommended Use
85
88
91
Other Supervisory
100
103
106
109
Process Trouble
112
Energy Alarm
115
Other Failure
124
127
68
Recommended Use
130
Energy Warning
133
Other Warning
Recommended Use
145
148
Comfort Alarm
151
160
System Events
163
172
179
186
189
198
201
Comfort Warning
204
213
216
Comfort Normal
219
222
Miscellaneous
View an Engine device. See Viewing Item Data for information on how to display an item.
Select the Focus tab and click the Advanced radio button to display additional item information.
Select Edit.
Scroll down to the Alarms and Site sections.
5. Edit the attributes in these sections. Use the following table as a guide. See Engine Device Object for information
about the attributes. The NAE Device attributes table contains Default Value and Values/Options/Range information
for the attributes. Click the attribute names in the table for descriptions.
69
Forward acknowledged and discarded alarms and events Ack Forward Enable
from an NxE to the ADS repository
Designate an ADS/ADX repository as a Default Destination ADS Repository
Indicate the type of connection used by the ADS/ADX
Define a time to deliver event messages to the ADS/ADX ADS Delivery Time
Define the event message priority that triggers delivery ADS Priority Threshold
to the ADS/ADX
Note: You can define only one repository as the Default Destination for an Engine. See Event Repositories for
more information.
6. Click Save.
Note: If you want to define all local Engine repositories for the entire site at one time instead of individually,
select the Site in the navigation tree and edit the following Site Object attributes (the Site attributes table
contains Default Value and Values/Options/Range information for the attributes):
View the ADS/ADX . See Viewing Item Data for information on how to display an item.
Select the Focus tab and click the Advanced radio button to display additional item information.
Select Edit.
Scroll down to the Repository Storage section.
5. Edit the ADS Device Object s ADS Repositiories attribute. See the ADS/ADX attributes table ( Table 105 ) for
more information on this attribute or other ADS/ADX attributes, including their Default Value and
Values/Options/Range information.
6. Click Save.
Configuring Destination Delivery Agents (DDAs)
To provide consistency and easy configuration of DDAs, each DDA tab in the Metasys system user interface contains
the same layout. Follow the instructions in this section when configuring any DDA. See Event Message Routing,
Filtering, and Destinations for more information on DDAs.
70
On the NAE55/NIE55 and NAE85/NIE85 platform, you can use the Serial Printer DDA on the Site Director Engine
to print event messages. This DDA is enabled using Remote Desktop, and no attributes/tabs appear in the UI. This
DDA is not available on the NAE35, NAE45, or NIE59. Refer to the NAE Commissioning Guide (LIT-1201519) for
details on this DDA.
Note: You cannot create, edit, or delete DDAs in online mode with Basic Access.
To configure DDAs for routing event messages:
1.
2.
3.
4.
View an Engine or ADS/ADX device. See Viewing Item Data for information on how to display an item.
Select the tab for the desired destination type (such as, Pager).
Select Edit.
Edit the attributes in the Shared Configuration section.
Note:
See the specific DDA tab in the Object and Feature Tabs for information on configuring attributes.
Also, see the Engine Device Object or the ADS Device Object section for information on configuring
Engine or ADS/ADX attributes, respectively.
5. In the Destinations section, select New to add a destination or click an existing destination.
6. Edit the parameters in the Destinations section.
For the Engine, see the following:
Pager
SNMP Trap
Syslog
Pager
Printer
SNMP Trap
Syslog
Note:
See the specific DDA tab in the Object and Feature Tabs for information on configuring attributes.
Also, see the Engine Device Object or the ADS Device Object section for information on configuring
Engine or ADS/ADX attributes, respectively.
If you are enabling an Email DDS on an ADS/ADX and the ADS/ADX computer is using Symantec
Endpoint Protection software, verify that the POP3/SMTP Scanner feature is not installed. If this
feature is installed, email alerts for the ADS/ADX are blocked. To uninstall the POP3/SMTP Scanner
feature, open Control Panel and select Add/Remove Programs or Programs and Features. Locate
Symantec Endpoint Protection in the list of installed programs and click Change. Navigate through
the installation wizard until you reach the Custom Setup screen. Place an X next to the POP3/SMTP
Scanner feature, then navigate the remaining wizard screens to remove this feature.
7. Repeat Step 5 and Step 6 if you want to configure this device to send event messages to more than one destination
of that type. Add the number of destinations. For example, to send event messages to two different pagers,
create two separate destinations on the Pager tab.
71
Note:
See Applying Filters for Routing Event Messages to Destinations for information on how to apply
filters to route particular event messages to destinations.
See Configuring Event Message Format for information on how to configure event message format.
8. To remove a destination, select the destination and click Delete.
9. Click Save.
Configuring Encrypted Email
By default, Metasys software encrypts your user name and password as they are entered into the SMP UI, but the
software does not automatically encrypt email messages. This feature allows embedded and server machines to
send email to email servers over a secure channel (secure socket layer [SSL]). The entire email payload is encrypted,
and allows our software to communicate to email servers that require SSL connections.
Consider these points when using email encryption:
The SMTP port is different when using secure socket layer connections. This port is typically 465.
Server-class machines and embedded devices do not have the same list of trusted Certificate Authorities. An
embedded device may not trust a certificate that is trusted on a server-class machine. To increase the chances
of an embedded device trusting a certificate used by a server-class machine, have the certificate signed by a
major authority.
To maximize efficiency when using this feature, set up mailing groups instead of individual users in the destination
field to minimize the number of users to which the machine has to send email. This setup allows you to create
different email groups and customize the type of messages that each user receives.
To increase the chance of an embedded device or an ADS/ADX trusting the certificate the mail server uses,
ensure the signed certificate is obtained by a major certificate authority.
If you are using an embedded device as your site director, no option is available to update the Trusted Certificate
Authority list at this time.
To ensure you have the latest list of Trusted Certificate Authorities installed on your ADS/ADX , install any
available certificate updates from Microsoft Windows Update.
You can configure encrypted email in three ways:
Configuring Encrypted Email with No Authentication Required
Configuring Encrypted Email with SMTP Authentication
mail.yourdomain.com or yourdomain.com
SMTP Port
465
72
None
True
False
Selection
mail.yourdomain.com or yourdomain.com
SMTP Port
465
Authentication Type
SMTP
True
False
mail.yourdomain.com or yourdomain.com
SMTP Port
465
Authentication Type
POP-before-SMTP
yourdomain.com or pop.yourdomain.com
73
True
False
Select a filter type from the Item drop-down menu. For more information and examples on filtering, see Event
Message Routing, Filtering, and Destinations.
7.
8.
9.
10. Repeat Step 4 through Step 9 to add more filters to that destination.
Note: If you define multiple filters for a destination, the DDA combines all the criteria with an AND condition
(all filter criteria must be met).
11. Make changes to filters using the drop-down menus or text boxes.
12. To remove a filter, select a filter and click Delete.
13. Click Save.
Configuring Event Message Format
1. View an Engine or ADS/ADX device. See Viewing Item Data for information on how to display an item.
2. Select the tab for the destination type (such as, Pager).
3. Select Edit.
4. Select a destination in the Destinations section.
5. Select the check boxes in the Format section to define which attribute information is included in the event message
when delivered to that destination.
Note: For example, select Value and Units if you only want to display the Value and Units portion of the event
message at the destination.
6. Click Save.
Acknowledging Event Messages
1. Launch the Event Viewer.
2. Select one or more event messages.
Note: Use the Ctrl or Shift key to select multiple messages.
3. Click Ack.
Metasys SMP Help: View Menu
74
Note:
Alternatively, you can right-click and select Ack or you can acknowledge event messages in the Alarms
Window. See Acknowledging, Snoozing, and Discarding Events for details.
In an Engine that is not the Site Director, acknowledged or discarded alarm and event messages do
not appear acknowledged or discarded in the ADS/ADX .
All acknowledgments add an annotation to the event message. See Event Message Annotations.
An electronic signature and/or annotation may be required when acknowledging an event.
Alternatively, you can right-click and select Discard or you can discard event messages in the Alarms
Window. See Acknowledging, Snoozing, and Discarding Events for details.
In an Engine that is not the Site Director, acknowledged or discarded alarm and event messages do
not appear acknowledged or discarded in the ADS/ADX .
An electronic signature or annotation may be required when discarding an event.
75
Note:
Some items, such as site level items, do not support this option because they do not have viewable
information.
Alternatively, you can launch the Focus view of the item that generated the event message in the
Alarms Window by clicking on the View Item button. See Acknowledging, Snoozing, and Discarding
Events for details.
76
Alarm and Event Management for Metasys Systems Integrated with BACnet Devices
The Metasys system provides the option to use the Alarm and Event feature when integrating with BACnet devices
(including the N30). You can send event messages generated by the Metasys systems Engine, FAC , or ADS/ADX
devices to BACnet devices. This alarming method uses the Notification Class Object and Event Enrollment or objects
with intrinsic alarming to detect alarm conditions and route event messages from the Metasys system to BACnet
devices.
Note: Event Enrollment objects are not supported by any field controllers.
For the alarm and event feature steps, see the Alarm and Event Management Alarm and Event Steps section.
For details on the attributes appearing on the BACnet Alarms tab, see BACnet Alarm Tab in the Object and Feature
Tabs section.
For information on the BACnet Integration object, see the BACnet Integration Object.
For information on alarm and event management for the Metasys system, see Alarm and Event.
Alarm and Event Management for Metasys Systems Integrated with BACnet Devices Concepts
Metasys/BACnet Alarming Overview
The Metasys system provides the functionality to use the Alarm and Event feature when integrating with BACnet
devices (including the N30). You can configure the Metasys systems Engine, FAC , or ADS/ADX devices to BACnet
devices to comply with the standard BACnet alarm and event services such as intrinsic alarming, Event Enrollment
object alarming, and alarm routing using the Notification Class Object. These optional alarming methods allow you
to send alarm and event messages from the Metasys system to BACnet devices.
To use the alarm and event feature for Metasys systems that integrate BACnet devices, configure the Notification
Class object, then reference that Notification Class object from the Event Enrollment Object or from an object with
intrinsic alarming. The Notification Class object routes event messages from Event Enrollment objects or objects
with intrinsic alarming to one or more BACnet device. Intrinsic alarming attributes, Event Enrollment objects, and
Notification Class objects are fully compliant with the BACnet standard specifications and should be used if you want
your Metasys system to send event messages to BACnet devices.
Event Messages routed through the Notification Class object to the Metasys systems event repositories can use
the Alarm and Event features such as the Event Viewer, Alarms Window, Alarm Reports, and DDAs. To enable this
functionality, you must set the Route to Metasys attribute to true in the Notification Class objects used. See Configuring
Metasys/BACnet Integration Alarming. See the Alarm and Event Management Alarm and Event Steps section for
more information on the alarm and event feature.
The following figure shows the flow of event messages routed by the Notification Class object.
77
For details on configuring the detection of alarm conditions, the routing event messages to destinations, and the
filtering and message formatting options, click one of the following:
intrinsic alarming
The alarm extensions method of alarming is easier to configure and provides greater flexibility and functionality for
standard Metasys applications. Use alarm extensions for alarming if your system does not require integration with
BACnet devices.
BACnet Intrinsic Alarming
Intrinsic alarming is fully compliant with the BACnet standard specifications and should only be used when integrating
with BACnet devices. Intrinsic alarming allows you to configure the detection of alarm conditions and the generation
of event messages based on attributes (properties) within an object that is compliant with the standard BACnet
objects, such as the High/Low alarm limits for analog objects and the alarm state for binary objects. The Notification
Class Object routes the event message.
78
By default, objects do not have intrinsic alarming; however, you can add intrinsic alarming to an object by setting its
Intrinsic Alarming Defined attribute to True. You can add intrinsic alarming when you create an object, or you can
add intrinsic alarming to an existing object. You can also remove intrinsic alarming from an existing object by changing
its Intrinsic Alarming Defined attribute to False. The Intrinsic Alarming Defined attribute is located under the
BACnet heading in the Insert Object wizard and in the objects Focus view, which is accessible when you select the
Advanced option for the display. When you set the Intrinsic Alarming Defined attribute to True, the BACnet Alarm
tab appears the next time you view the object. The default alarming settings (for example, high and low limits) are
used until you change the settings on the BACnet Alarm tab. When you set the Intrinsic Alarming Defined attribute
to False, all intrinsic alarm settings configured through the BACnet Alarm tab are discarded and the alarming settings
return to their default values. For more information on configuring intrinsic alarming in an object, see Configuring
Metasys/BACnet Integration Alarming.
Intrinsic alarming is only available for your Metasys system if you set the BACnet Site attribute to True in the Site
object. See the Site Object for information on configuring the BACnet Site attribute.
To view the BACnet intrinsic alarming attributes of existing Metasys objects after they have been configured, view
the object and click the BACnet Alarm tab. You can add alarm extensions to objects supporting intrinsic alarming.
The following Metasys objects are compliant with the standard BACnet objects and support BACnet intrinsic alarming:
Accumulator Objects
After configuring one or more objects with intrinsic alarming, you must configure at least one Notification Class object
to define the routing of event messages to BACnet device destinations. Then you must reference the desired
Notification Class object from the objects with intrinsic alarming. If you want the Notification Class object to route
the event messages created by the objects with intrinsic alarming to the Metasys Alarm and Event feature, set the
Notification Class objects Route to Metasys attribute to true.
In addition, you can add object alarm extensions to objects with intrinsic alarming if you want to route event messages
to both BACnet device destinations and Metasys DDAs. For more information on DDAs, see Event Message Routing,
Filtering, and Destinations.
The Enable Alarms and Disable Alarms commands for objects using intrinsic alarming edit the Event Enable flags
under Alarm State to prevent alarms.
You can configure intrinsic alarming online at the Site Management Portal (SMP) UI or offline in the SCT. Intrinsic
alarms for objects in an FAC can be defined using Controller Configuration Tool (CCT) or SMP, but not SCT. If
defined with SMP, you must specify if the intrinsic alarm is to Use Remote Alarming as defined in the object's Focus
tab. If true, the intrinsic alarm parameters are stored in the FAC. If false, the parameters are stored in the Engine.
79
Note: The BACnet Integration mapper objects Loop and Load Control do not support intrinsic alarming parameters
stored in the Engine. When Intrinsic Alarming Defined is set to true on these objects, then Use Remote
Alarming must also be set to true, and any intrinsic alarming parameters must be stored and provided by the
field device.
For details on the attributes appearing on the BACnet Alarms tab, see BACnet Alarm Tab in the Object and Feature
Tabs section.
BACnet Event Enrollment Object Alarming
The Event Enrollment Object is fully compliant with the BACnet standard specifications and should only be used
when integrating with BACnet devices. The Event Enrollment object monitors the value of a single attribute and
generates event messages based on the defined alarm conditions.
You can create an Event Enrollment object using the Object and configure its attributes, or you can view an existing
Event Enrollment object and edit its attributes. Event Enrollment objects are not supported by any field controllers.
Based on the defined event type, the Event Enrollment object generates event messages for different conditions
monitored in the referenced object. See the Event Type attribute of the Event Enrollment Object and the Event
Enrollment Configuration Examples for more information.
Note: Event Enrollment alarming is only available for your Metasys system if you set the BACnet Site attribute to
true in the Site object. See the Site Object for information on configuring the BACnet Site attribute.
After configuring one or more Event Enrollment objects, you must configure at least one Notification Class Object
to define the routing of event messages to BACnet device destinations. Then you must reference the desired
Notification Class object from the Event Enrollment objects. If you want the Notification Class object to route the
event messages created by the Event Enrollment objects to the Metasys Alarm and Event feature, set the Notification
Class objects Route to Metasys attribute to true.
You can add object alarm extensions to Event Enrollment objects if you want to route event messages to Metasys
DDAs. For more information on DDAs, see Event Message Routing, Filtering, and Destinations.
The Enable Alarms and Disable Alarms commands for the Event Enrollment object alarming edit the Event Enable
flags under Alarm State to prevent alarms.
Click one of the following for more information:
event types used by the Event Enrollment Object (Event Type attribute)
Event Enrollment Configuration Example - Change of Value Example 1 and Event Enrollment Configuration
Example - Change of Value Example 2
80
Event Enrollment1
Description
Status Change
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To Off Normal
Notify Type
Alarm
Notification Class
4194001
Execution Priority
Normal
Event Tab:
Input Reference
10
Event Type
Change of bitstring
Mask
Values
81
Value
Focus/Configuration Tab:
Name
Event Enrollment1
Description
Feedback Reliability
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To Off Normal
Notify Type
Alarm
Notification Class
4194001
Feedback State
Execution Priority
Normal
Event Tab:
Input Reference
MV1: Reliability
Event Type
Change of state
Value
Unreliable
82
Event Enrollment1
Description
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To Normal
Notify Type
Alarm
Notification Class
4194001
Execution Priority
Normal
Event Tab:
Input Reference
120
Event Type
Change of value
COV Increment
3.0
Event Enrollment1
Description
Status COV
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To Normal
Notify Type
Alarm
Notification Class
4194001
83
Execution Priority
Normal
Event Tab:
Input Reference
30
Event Type
Change of value
Mask
Value
Focus/Configuration Tab:
Name
Event Enrollment1
Description
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To Off Normal
Notify Type
Value
Notification Class
4194001
Execution Priority
Normal
Event Tab:
Input Reference
60
84
Value
Event Type
Command Failure
Command Target
Value
Focus/Configuration Tab:
Name
Event Enrollment1
Description
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To Off Normal
Notify Type
Alarm
Notification Class
4194001
Execution Priority
Normal
Event Tab:
Input Reference
120
Event Type
Floating Limit
Setpoint Reference
3.0
4.0
Deadband
1.5
85
Value
Focus/Configuration Tab:
Name
Event Enrollment1
Description
Status Change
Object Type
Event Enrollment
Object Category
HVAC
Enabled
true
Event Enable
To off Normal
Notify Type
Alarm
Notification Class
4194001
Execution Priority
Normal
Event Tab:
Input Reference
300
Event Type
Out of Range
Low Limit
66.0
High Limit
74.0
Deadband
2.0
Alarm and Event Management for Metasys Systems Integrated with BACnet Devices Steps
Configuring Metasys/BACnet Integration Alarming
The BACnet Intrinsic Alarming and BACnet Event Enrollment Object Alarming routing services are fully compliant
with the BACnet standard specifications and should only be used when integrating your Metasys system with BACnet
devices.
You can configure intrinsic alarming online at the SMP UI or offline in the SCT. Intrinsic alarming for FAC objects
can be defined with the SMP or offline with CCT.
To configure Metasys/BACnet integration alarming:
86
1. Set the BACnet Site attribute to true in each Site Object representing a site that you want to use Metasys/BACnet
Integration alarming.
2. For each NAE in the site using alarming integration, configure one or more Notification Class objects for routing
event messages from Event Enrollment objects and/or objects with intrinsic alarming to BACnet device destinations.
Be sure you reference the BACnet devices by adding them to the Recipient List of the Notification Class object.
Identify a BACnet device by using either its network address or BACnet device identifier (OID).
Note:
If you want to display alarm and event data from BACnet device destinations on the Metasys system
Alarms Window and Event Viewer, set the Notification Class Objects Route to Metasys attribute to
true. The BACnet device must specify the NAE as a recipient for their alarms. To make the NAE an
alarm recipient, configure a Notification Class object on the BACnet device. Alarms and
acknowledgements from the BACnet device are incorporated into the Metasys alarming system. To
route BACnet alarms from the N30 to the NAE, the N30 must be configured to use BACnet alarm
routing. For information on how to configure the N30 to use BACnet alarm routing, refer to the
documentation of the BACnet device you are integrating.
When the NAE receives an alarm from an NAE, it can be sent from the DDAs on the receiving NAE
but cannot be routed again from that NAE. If the alarms need to be routed from the NAE device, they
should set the Use Remote Alarming to False for objects in the FAC.
3. Configure one or more Event Enrollment Object or objects that supports intrinsic alarming using the Object. See
BACnet Intrinsic Alarming for a list of objects that support intrinsic alarming.
Note: For both types of these alarm generating objects, you must configure the Event Enrollment objects Notification
Object Reference attribute to reference the Notification Class Object created in Step 2. This reference
represents the instance number of the Notification Class (value of its Object Identifier attribute). The Notification
Class object and the alarming object must exist on the same device.
See BACnet Intrinsic Alarming for more information on intrinsic alarming.
See BACnet Event Enrollment Object Alarming for information on Event Enrollment alarming.
For more information on BACnet Integration, see the BACnet Integration Object and the Related Documentation
table.
87
Audit Trail
The Audit Trail feature generates audit messages and stores them in Audit Repositories. An audit message contains
information about a significant event on the Building Automation System (BAS). For audit purposes, a significant
event is an action or occurrence on the system that should be recorded for later analysis of building operations. A
new audit message is generated for each significant event on the BAS. The Audit Viewer displays the audit messages
stored in an audit repository. You can access the Audit Viewer from the View Menu of the Metasys user interface
in online mode.
The Audit Trail provides a historical record of the audited events, such as creating or deleting items, that have
occurred within the system. By viewing audit messages, you can examine and analyze the actions that occurred in
the system.
Audit Trail Concepts
Audit Trail Overview
The Audit Trail feature initiates an audit message when the system detects an audited event such as a user logging
in or logging out of the Metasys system, commanding an item, or changing the configuration of a device. An audit
message is stored in the Audit Repositories of the device that generated the audit message. When the local audit
repository is full, you can send its audit messages to an ADS (ADX) repository defined as the Default Destination
for permanent storage.
The Audit Viewer allows you to view audit messages stored in the audit repository of the selected device. You can
determine how to sort and filter the audit messages that appear in the Audit Viewer as well as forward them to the
defined default destination. You can add annotations to audit messages and view them when displayed on an
ADS/ADX . You can also define customized annotations and add these custom annotations to audit messages.
For sites with MVE installed, configure the following attributes in the Site Object:
Annotation Include
Annotation Exclude
Signature Include
Signature Exclude
These settings are used by MVE sites to enable the MVE desired annotations and electronic signature for audit
messages. You can apply these settings at the site level or down to the object level as needed. You can set the
MVE site to require only annotations, only electronic signatures, both annotations and signatures, or neither annotations
nor signatures. Non-MVE sites may optionally define and use annotations; however, electronic signatures are specific
to MVE sites.
When both annotations and signatures are required, and a user acknowledges or discards an audit message, they
are prompted to reauthenticate and enter a reason and annotation for the action. The users login name, date and
time of signature, and the reason for signature are saved as part of the annotation. You cannot delete annotations
on an MVE site.
See Configuring Annotation and Electronic Signature Requirements in the Site Object in MVE in the Site Management
Portal User Interface section. For additional information, refer to the Metasys for Validated Environments, Extended
Architecture Technical Bulletin (LIT-12011327).
Figure 17 shows the flow of audit messages through the Metasys system.
88
Audited Events
Audited events are significant events occurring in the system that trigger the Audit Trail feature to generate an audit
message. The following table lists the features and corresponding actions that initiate the generation of audit
messages. The following table also lists Audit Classes (Set 568) in which the actions belong. Click the feature name
for more information about that feature.
Note: Do not confuse audited events with those associated with alarming. See Alarm and Event Management for
details on alarming.
Table 40: Audited Events
Feature
Action Causing Audit Message
ActionQ
each command issued, enabled, disabled, or deleted (Audit Class = User Action)
By default, the ADS/ADX does not create an audit entry when you discard an event that originates
on the ADS/ADX via the Alarms Window, Event Viewer, or via a BACnet device (Audit Class =
User Action). To capture audit entries for these events would create an undue number of entries
in the database.
Note:
Engines do not create an audit entry when you discard events that originate on the engine.
For details on changing this setting, refer to Creating Audit Entries for Discarded Events in
the NAE Commissioning Guide (LIT-1201519).
Audit Trail
Error messages returned by the Email DDA logged in the Audit Viewer appear in English
only.
each command issued to clear the Audit Repository. See Clearing the Audit Repository.
(Audit Class = User Action)
each command issued to discard an audit message or a group of audit messages (Audit
Class = User Action)
each command issued to change the Enabled Audit Level attribute in the Engine Device
Object or ADS Device Object based on a system event, a user changing the time of day,
or a user command
See Configuring the Engine Audit Repository. (Audit Class = User Action, Non-critical System
Event, Critical System Event, Application, or Diagnostic)
89
Trend studies
each change to the trend routing configuration (Audit Class = User Action)
each command issued to the trend extension (Audit Class = User Action)
each change to trend views such as creating, deleting, or editing a trend view (Audit Class
= User Action)
each change to the Engine and ADS/ADX configuration (Audit Class = User Action)
each item added to or removed from the schedule (Audit Class = User Action)
each change to the key item or its scheduled attribute (Audit Class = User Action)
each time the schedule is enabled or disabled (Audit Class = User Action or Application)
each successful and failed log in and log out attempt (Audit Class = User Action)
Scheduling
System Security
each change in item configuration such as adding, deleting, and editing an item (Audit Class
= User Action)
each controller upload, download, synchronization, and reset occurring in online mode. Audit
messages are not generated for those actions in the SCT offline mode. (Audit Class = User
Action, Application, Non-critical System Event, Critical System Event)
Audit Repositories
The following table describes the two types of audit repositories for storing audit messages in the Metasys system.
Table 41: Audit Repositories
Type
Description
Local (Engine) Audit
Repository
Allows the audit messages stored in the Engine local audit repository to be displayed in the
Audit Viewer.
Forwards audit messages from the Engine local audit repository to the Default Destination.
See Default Destination and Message Forwarding.
Places audit messages generated on an ADS/ADX platform directly into the ADS (ADX)
audit repository.
Receives audit messages from multiple Engine local audit repositories and provides
permanent storage for the audit messages. The ADS (ADX) audit repository is usually defined
as the default destination for audit messages from Engine local audit repositories.
Allows the audit messages stored in the ADS (ADX) audit repository to be displayed in the
Audit Viewer.
90
For information on configuring the Engine local audit repository and the default destination, click one of the following:
A Database Timeout Error can occur when viewing audit messages if the repository contains too many unfiltered
audit messages before the system times out (typically, one million messages). To prevent this error, back up and
purge audit message records from the repository (JCIAuditTrails) using the Metasys Database Manager on a regular
basis.
Default Destination and Message Forwarding
The Default Destination defines where audit messages are sent when the Engine local audit repository is full, at a
user-defined time ( ADS Delivery Time attribute of Engine device), or when a user clicks the Forward Messages
button in the Audit Viewer. Configure an ADS (ADX) Audit Repository as the Default Destination to permanently
store audit messages. For information on how to define a default destination, see Configuring the Engine Audit
Repository.
When the Audit Forwarding Threshold is reached, all non-forwarded audits in the Local Audit Repository are
forwarded to the defined ADS Repository.
To generate an alarm message when a Rollover or Stop condition occurs, set the Audit Generate Alarm When
Full attribute in the Engine device to True. See Configuring the Engine Audit Repository and Audit Repositories.
You can forward audit messages to the Default Destination from the Engine local audit repository by clicking the
Forward Messages button in the Audit Viewer. See Forwarding Audit Messages to the Default Destination.
Note:
You cannot forward audit messages from an ADS (ADX) audit repository to another ADS (ADX) audit
repository.
You can define only one ADS (ADX) audit repository as the Default Destination for messages from an
Engine local audit repository; however, different Engines can have different ADS (ADX) repositories
defined as their Default Destination.
If you have not defined a Default Destination when the Engine local audit repository is 100% full, the local audit
repository either replaces the oldest messages (rollover) with new messages or stops recording audits according
to the Audit Action When Full attribute configuration.
Audit message rollover begins or replacement stops only when the total number of non-forwarded audit messages
reaches the size defined by the Audit Repository Size attribute. In other words, once the local audit repository
reaches the defined size, new audit messages continue to enter the local audit repository replacing forwarded
messages until all forwarded messages are gone. The following figure illustrates the Audit Action When Full when
set to Rollover or when set to Stop.
91
If you have defined a Default Destination, the Audit Forwarding Threshold attribute is set to any percentage other
than 100%, and the Audit Action When Full attribute is set to Stop; also the audit messages do not stop rolling
over as long as forwarding is successful. This situation occurs because audit messages are forwarded to the Default
Destination when new audit messages are received, and the forwarded messages are automatically replaced. The
local audit repository does not fill up with non-forwarded audit messages and, therefore, no alarm is generated.
Audit Message and Audit Viewer
The Audit Trail feature generates a new audit message for each significant event occurring on the system that
contains data associated with the event. See Audited Events. The Audit Viewer displays the audit messages residing
in the Audit Repositories of the currently selected device and is accessible from the View Menu of the Metasys user
interface in online mode. The window displays 1,000 audit messages per page for an ADS/ADX , other engines are
limited to a maximum of 500 audit messages per page. See Launching the Audit Viewer.
You can only view the audit messages from one audit repository of one device at a time:
If you are viewing the contents of an Engine local audit repository, the audit messages displayed come from that
Engine only.
If you are viewing the contents of a Engine local audit repository of an Engine device designated as the Site
Director, the audit messages displayed come from that Engine local audit repository only.
If you are viewing the contents of an ADS (ADX) audit repository, the audit messages displayed come from that
ADS (ADX) audit repository only. An ADS (ADX) audit repository may contain audit messages that have been
routed from other Engine or ADS/ADX devices, but the repository does not display the contents of multiple
repositories.
92
Note: You can define an audit repository as a Default Destination, so it receives audit messages from other audit
repositories. See Default Destination and Message Forwarding.
When viewing an ADS/ADX device, a standard filter is applied to the Audit Viewer when it is first opened. This filter
allows you to see all audit messages.
Custom filters can also be used when viewing the ADS/ADX device to narrow the list of audit messages to only
those that meet specific criteria. Custom filters query the entire ADS/ADX database, not just the list of audit messages
that appears on the screen. You can filter audit messages by any combination of Date/Time, User, Class Level,
Action Type, and/or Discarded. New audit messages appear in the list only if they meet all criteria specified in the
filter. Custom filters cannot be saved.
The following table describes the format of the audit message (and corresponding buttons and fields) as displayed
in the Audit Viewer.
Table 42: Audit Viewer
Item/Column
Description
Selected Device
Indicates the device for which the Audit Viewer is displayed. The device name appears on the left side
of the Audit Viewer above the table.
This field corresponds to the selection made in the Device Selection Dialog box. See Launching the
Audit Viewer.
Indicates the number of audit messages that currently appear in the Audit Viewer. The Audit Count
appears on the right side of the Audit Viewer above the table only for Engine devices.
Standard Filter Radio Indicates that standard filtering is applied to the Audit Viewer for the selected ADS/ADX . This filter
Button (ADS/ADX Only) information appears on the right side of the Audit Viewer above the table. The count of entries that
apply to this filter appears in parenthesis next to the radio button.
Custom Filter Radio
Indicates that custom filtering is applied to the Audit Viewer for the selected ADS/ADX . This filter
Button (ADS/ADX Only) information appears on the right side of the Audit Viewer above the table. The count of entries that
apply to this filter appears in parenthesis next to the radio button.
Custom Filter Table
(ADS/ADX Only)
Allows you to apply custom filtering to the Audit Viewer when the Custom Filter radio button is selected.
This table appears but is not active when the Standard Filter radio button is selected. You may need
to adjust the slider bar to show the Custom Filter table.
The buttons for this table are:
See Creating a Custom Filter within the Audit Viewer (ADS/ADX Only).
93
When
Displays the date and time that the audit message was generated. The date and time format is defined
by the Language selected in the User Profile (User Profile tab section of the Security Administrator
System).
Item
Displays the name of the item that generated the audit message. An item name is the label displayed
for the selected item in the All Items navigation tree (for example, AV1, NAE2, or Schedule1). Be sure
you define unique item names.
Class Level
Indicates the class in which the audit message belongs. For more information on Class Level, see the
Enabled Audit Level attribute in the Engine Device Object or ADS Device Object .
Origin Application
Indicates the application that performed the action that generated the audit message. For example,
the origin application may be the Alarm and Event, Trend, or Security feature.
User
Indicates the user associated with the action that initiated the audit message (for example, the person
who changed a setpoint).
Action Type
Description
Provides the description of the action that generated the audit message. For example, Enabled appears
in this column if you send an Enable command to an item. The description appearing in this column
comes from the State, Mode, and Type Sets associated with the time that generated the audit message.
Note: If the Class Level is Non-Critical System Error or Diagnostics and the Action Type is Error, then
the associated error string appears. If the Action Type is Command and there is no further definition
of the type of command (for example, Operator Override, Adjust, etc.), then Description will show the
value of the new command (for example, On or Off).
Previous Value
Indicates the value and engineering units, if applicable, of the item before performing the action that
generated the audit message.
Post Value
Indicates the value and engineering units, if applicable, of the item after performing the action that
generated the audit message.
Note: If the Action Type is Command and there is no further definition of the type of command (for
example, Operator Override, Adjust, etc.), then the actual post value is shown in the Description
column. If the Description is a User Login Successful or Failed, then the Post Value shows the IP
address of the client computer from which the login attempt was made.
Status
Indicates the status of the item at the time the audit message was generated.
Specifies the column of data used to sort the audit messages in the current Audit Viewer (ascending
or descending order).
94
Allows you to navigate through the pages of audit messages in the Audit Viewer. Use the buttons to
go to the first page, previous page, next page, or last page. Type a page number in the text box and
press the enter key to jump directly to a specific page.
Forward Messages
Button
Sends audit messages from the Engine local audit repository to the Default Destination. See Forwarding
Audit Messages to the Default Destination.
Discard Button
Removes the selected audit messages from the Audit Viewer. See Discarding Audit Messages.
Copy Button
Copies the selected audit messages to the Clipboard for pasting into other applications such as
Microsoft Excel or Word.
When you click this button with nothing selected in the audit viewer, all entries are copied to the
clipboard.
Note: You can also use Ctrl+A to select all entries and Ctrl+C to copy to the clipboard.
When adding annotations, indicates the user ID of the person associated with the action that generated
the audit message.
When viewing annotations, the first User field displayed indicates the user ID of the person associated
with the action that generated the audit message. The User field displayed under the Annotation
Information section indicates the user ID of the person that added the annotation.
When adding annotations, indicates the date and time the audit message was generated.
When viewing annotations, the first Date and Time field displayed indicates the date and time the audit
message was generated. The Date and Time field displayed under the Annotation Information section
indicates the date and time the annotation was added to the audit message. The date and time format
is defined by the language selected in the User Profile (User Profile tab section of the Security
Administrator System).
Item Reference
Indicates the complete Item Reference of the item associated with the audit message.
Description
Provides the description of the action that generated the audit message. For example, Enabled appears
in this field if you send an Enable command to an item. The descriptions come from the State, Mode,
and Type Sets associated with the item that generated the audit message.
Note: If the Class level is Non-Critical System Error or Diagnostics and the Action Type is Error, then
an associated error string appears.
95
Allows you to select from a list of predefined annotations or add or view a text string (annotation) of
up to 254 characters describing the associated audit message.
Navigation Controls
If the audit message has multiple annotations associated with it, allows you to navigate through the
annotations. Use the buttons to go to the first annotation, previous annotation, next annotation, or last
annotation.
The text box displays the number of the annotation being viewed. The Annotations feature automatically
assigns a number to each annotation created. For example, if the audit message has three annotations,
the number being displayed in this section can be 1, 2, or 3 depending on the annotation being viewed.
Type a number in the text box and press the enter key to jump directly to a specific annotation.
ADS Repository
Define how full the audit repository must be before forwarding audit Audit Forwarding Threshold
messages to the ADS/ADX .
Define if the Audit Trail feature overwrites existing audit messages Audit Action When Full
1
or stops generating audit messages when the audit repository is full.
Define if the Audit Trail feature should generate an alarm when the
audit repository is full.
Define which level of audit messages get added to the audit repository. Enabled Audit Level
1
This action is only valid when the device is not set to forward data to an ADS/ADX . The stop/rollover option only applies
when there is no forwarding to an external repository.
Note: You can define only one repository as the Default Destination for audit messages from an Engine audit
repository. See Audit Repositories for more information.
Metasys SMP Help: View Menu
96
6. Click Save.
Note: If you want to define all Engine local repositories for the entire site instead of individually, select the Site
in the navigation tree and edit the following Site Object attributes. The Site object attributes table contains
Default Value and Values/Options/Range information for the following attributes:
Adding Annotations
Note: You can add annotations from the ADS/ADX device only. Annotations are not forwarded between ADS/ADXs
.
1. Launch the Audit Viewer by selecting the ADS/ADX from the Device Selection Dialog box.
2. Right-click the audit message, and select Add Annotation from the menu. Alternatively, you can select Add
Annotation from the Actions menu. The Add Annotation dialog box appears.
Note: The drop-down list on the Add Annotation dialog box contains predefined annotations from your system
preferences. If you have not defined annotations in your system preferences, the drop-down list is empty.
See Annotation Settings Tab in Preferences.
3. Type the desired text in the message box.
4. Click OK.
Viewing Annotations
Note: You can view annotations from the ADS/ADX device only.
To view annotations:
1. Launch the Audit Viewer by selecting the desired ADS/ADX from the Device Selection dialog box.
2. Double-click the annotation icon in the first column of the Audit Viewer for the audit message. The View Annotations
dialog box appears.
Note: To indicate that an audit message was electronically signed, a signed book icon appears in the first
column of the Audit Viewer on a validated ADX on an MVE system.
Note: Alternatively, you can select View Annotations from the Actions menu or right-click the audit message
and select View Annotations from the menu.
3. View the message.
4. Click OK.
Metasys SMP Help: View Menu
97
Creating Annotations
1. Select the Annotation Settings tab on the Metasys Preferences screen.
2. Enter annotation text. The text can be from 1 to 254 characters in length.
3. Click Add to save the annotation settings.
Note: The annotations you create appear in the drop-down list on the Add Annotations dialog box. If you do not
create any annotations, this list is blank.
Sorting the Audit Message List
1. Launch the Audit Viewer.
2. Click the header of the column in which you want to use as the sorting criteria. An up or down arrow appears in
the header of the column. Click on the arrow to change the sorting order, and the table reorganizes.
Creating a Custom Filter within the Audit Viewer (ADS/ADX Only)
1. Launch the Audit Viewer.
2. Click the Custom Filter radio button.
3. Click the Add button.
4. Select the criteria and the associated values for the filter and click OK. All criteria added to the custom filter table
make up the rules of the filter.
5. Click Apply to get the results of the custom filter.
6. To view the data without the custom filter, click the Standard Filter radio button.
Clearing the Audit Repository
1. Launch the Audit Viewer by selecting the desired Engine or ADS/ADX from the Device Selection dialog box.
2. Click anywhere in the Audit Viewer.
3. Click Clear. All audit messages stored in that Audit Repository are cleared.
Note: If you want to permanently store audit messages, click the Forward Messages button before clicking
Clear.
Note: For a validated ADX on an MVE system, an electronic signature with annotation is required before clearing
the audit repository.
Discarding Audit Messages
1. Launch the Audit Viewer.
2. Select one or more audit messages.
Note: For a validated ADX on an MVE system, an electronic signature with annotation is required before
discarding an audit message.
3. Click Discard.
Note: When you discard audit messages from the repository, they are not automatically discarded from the
originating device.
Forwarding Audit Messages to the Default Destination
1. Launch the Audit Viewer.
Metasys SMP Help: View Menu
98
2. Click Forward Messages. The messages are forwarded from the local audit repository to the defined Default
Destination.
Launching the Focus View of the Item That Generated the Audit Message
1. Launch the Audit Viewer.
2. Select an audit message and choose Selected Item from the View menu.
Note: Some items, such as site level items, do not support this option because they do not have viewable information.
Trend Viewer
Trend Viewer Overview
The Trend Viewer has three different views: Trend Viewer Chart View, Trend Viewer Table View and Trend Viewer
Definition View. The Chart View and Table View allow you to see trend data in a variety of different formats. The
Definition View allows you to configure how the data appears within the views.
The Trend Viewer can display the data for up to 10 trends. Although you can select up to 32 items to include in the
Trend Viewer, you are limited to showing the data for a maximum of 10 trends in the Chart or Table views. The Trend
Viewer lists the included items in the Chart Legend (Chart View), and in the Trend Items table (Definition View). Use
the Chart Legend check boxes to choose which items should be shown or hidden. You can also display multiple
Trend Viewers in the display panels of the user interface.
As you add items to the Trend Viewer, the trends for the new items are automatically shown up to the maximum
number of 10. Once 10 items are shown, you are unable to choose additional trends to show until you hide one or
more of the currently displayed trends. You can hide a trend by clearing the check box on the Chart Legend.
Note: Changes you make to the Trend Viewer, such as changes to how the chart appears, are only maintained
while you are logged in to the Metasys system user interface. Changes apply to all new instances of Trend
Viewer, within your user session. Changes do not affect existing Trend Viewers, Trend Study views, or Trend
Extension views.
Views
There are three views in the Trend Viewer: Chart View, Table View, and Definition View.
Table 45: Views
Button
View
Description
Chart View
Table View
Definition View
Allows you to view the trend viewer setup and display options.
99
(Zoom)
Description
Update
Retrieves the most recent data samples for the displayed trends.
Zoom
Toggles the mouse behavior for the chart between zoom mode and normal mode.
While in zoom mode:
(Normal)
drag the mouse over an area of the chart to zoom in on that area.
click Zoom to exit zoom mode and restore the mouse to normal mode.
When you exit zoom mode, the chart remains at the current zoom level. Use the
Restore button to fully zoom out on the chart.
Note: You cannot pan while the mouse is in zoom mode.
Note: You can also zoom and unzoom in normal mode by using the Shift key and the
mouse. To zoom, hold the Shift key down while dragging the mouse across the chart.
To zoom out one level, left-click the mouse while holding the shift key down.
Restore
Allows you to return to an unzoomed view and switches the mouse back to normal
mode if the chart's zoom mode is active.
Pan
Allows you to pan the view of the chart vertically or horizontally by dragging the mouse
across a zoomed chart. Panning is not available for unzoomed charts or when zoom
mode is active. To pan left or right, drag the mouse over the X-axis. To pan up or
down, drag the mouse over the Y-axis.
Points Line
Displays the data using lines and point markers. This is the default.
Area
Bar
Points
Line
Stacked Y-axis
Single Y-axis
Opens the Select A Color dialog box and allows you to configure the background color of the
chart.
Y-axis Scale
100
Gridlines
Allows you to select what type of gridlines appear on the chart. You can choose: None, X and
Y, X Only, and Y Only.
Chart Type
Allows you to select which type of chart to display. You can choose: Points Line, Area, Bar,
Points, and Line.
Stacked Y-axis
Chart Legend
The Chart Legend appears below the graphical charting area. The Chart Legend displays the list of trend items for
the Trend Viewer in a table, and includes information about each item. Log events are also included.
Table 48: Legend
Button/Field
Name
Description
Select All
Selects the maximum number (10) of trend items for display in the chart.
Add
Opens the Select Item dialog box and allows you to add trend items to the Trend
Viewer.
Note: All items and navigation trees appear in the Select Item window; however,
you can only select trends. All other items appear dimmed.
Remove
Show
Indicates if the data for the trend item appears in the Chart. When checked, the
data appears on the chart and in the table. When unchecked, the data does not
appear in the chart or table.
Indicates the trend was selected from the ADS Historical Database folder.
Marker
Indicates the appearance of the marker style and color for the trend item on the
Chart.
Color Palette
Opens the Select a Color dialog box. Allows you to change the color used to chart
the trend data.
Log Event
Indicates a change in trend log status. Possible indicators shown vertically along
the red line include:
Log Disabled, Log Purged, Log Enabled, Log Interrupted, Time Change, Read
Error
Name
Reference
101
Name
Description
Update
Add
Copy to Clipboard Allows you to copy selected trend data to the system clipboard for pasting
into other applications such as Microsoft Excel. You can also use Ctrl + C
to copy data to the clipboard.
1
The Historical Trend Icon appears in the Table View column headings when applicable.
Chart Display
Refresh Rate: specifies the amount of time, in seconds, for automatic refresh of data. You must
configure this attribute with a value of 0 seconds, 60 seconds, or greater than 60 seconds. Values 1
to 59 are invalid and not allowed. 0 means manual refresh. If the refresh rate is 0, click the Update
button to display new data.
Display Precision: specifies the decimal point rounding and the number of decimal places used to
format real values that do not report a display precision. If the value reports a display precision, this
Trend Viewer attribute is ignored in favor of the values native display precision.
Specifies the Start Time and End Time for the Trend Viewer.
Allows you to add gridlines, stack the Y-axis, and choose the chart style for the Trend Viewer.
Opens the Select Item dialog box and allows you to add trend items to the Trend
Viewer.
Remove
Name
102
Plotting Style
Allows you to select the plotting method for the trend item.
Discrete - line stays at the same value until the next data sample is taken (good
for binary data). Discrete plotting has 90-degree angles at the time when samples
change value. The chart appears to be a series of steps.
103
Note: When you select Use Automatic Range Calculation, you do not fill in the Range fields.
4. Specify the Start Time, Start Date, End Time, and End Date.
5. Click OK.
Note: You can also configure the X-axis range by changing the start and end dates and times in the Definition View.
See Editing the Definition View.
Configuring the Y-axis
To configure the Y-axis in the Chart view:
1.
2.
3.
4.
Note: When you select Use Automatic Range Calculation, you do not fill in the Range fields.
5. Specify the minimum and maximum values for the Y-axis.
Note: When you use stacked Y-axis, click Apply to apply the changes to a specific trend item. You can continue
setting the ranges for other trend items in the Range Configuration dialog box.
6. Click OK.
Changing the Background Color
To change the background color in the Chart View:
1.
2.
3.
4.
button in the Marker column in the Chart Legend for the desired trend item. The Select a Color
104
105
3. Click Yes.
Changing the Gridlines
To change the gridlines in the Chart view, right-click > Gridlines > and select type.
To change the gridlines in the Definition view, click the Gridlines drop-down list and select type.
Printing Trend Viewer Information
To print Trend Viewer information, follow the printing instructions in the Printing Specific Help Topics section.
106
You can use one of the following two workflows for the Tailored Summary Viewer:
In the All Items Tree, select the desired objects. Click View > Tailored Summary Viewer. In the SMP, you can
select the Summary Definition to define what and how the information for the selected objects is displayed.
Click Query > Global Search. Select the search location, enter the desired criteria, and click Search. From the
search results, select the desired objects. In the SMP, you can select the Summary Definition to define what and
how the information for the selected objects is displayed.
In the SMP, you can use the Tailored Summary Viewer much like you use the Tailored Summary to view and modify
large quantities of data. Once data is presented in a Tailored Summary View, you can select data in the view,
right-click the data you wish to modify, and select the Modify function to edit the data pertinent information. After
modifications are made to data in the viewer, you must refresh the screen by right-clicking the header of the view.
Note: The display limitation for Tailored Summaries is 100 rows and 7 columns.
To issue commands, select one or more items (that is, select the table cells), then right-click and select
Command. To command all items in a column, right-click the column header and select Command. For
example, use this process to send an operator override command to multiple items.
To make modifications, select one or more items, then right-click and select Modify. To modify all items in
a column, right-click the column header and select Modify. See the Modify Dialog section for details. For
example, use this process to change the Authorization Category for multiple items.
To view an item, select an item and right-click and select View. The item appears in the display panel.
To resize a column, place the cursor between the column headers so that the cursor has double-sided arrows
(
). Click and drag the column to the desired width.
To sort the column data alphanumerically, click a column header. Click the column header again to sort in
the reverse order.
To rearrange the order of the columns while viewing the Tailored Summary, select a column header and use
drag-and-drop functionality to move it to the desired location.
To keep a snapshot of the Tailored Summarys data for later comparison, select and copy the table data.
Then paste it into a program such as Microsoft Excel. Use the keyboard shortcuts Ctrl+A, Ctrl+C, and Ctrl+V.
To view a graphic associated with field controller, double-click the graphic icon that appears in the second
column of the table (by default). The graphic appears in the display panel.
107
To link a graphic to multiple field controllers, select the field controllers, then right-click and select Modify.
The Global Modify dialog box appears. Edit the Graphic and Graphic Alias attributes as desired and click
Send. This procedure applies only to field controllers. See Performing a Global Modify in the Modify Dialog
section for details.
3. Work with the Key Data table as follows:
To issue a command, select one item and right-click and select Command.
To make modifications to an item, select one item and right-click and select Modify. See the Modify Dialog
section for details.
To view an item, select one item and right-click and select View. The item appears in the display panel.
To resize a column, place the cursor between the column headers so that the cursor has double-sided arrows
(
). Click and drag the column to the desired width.
To rearrange the order of the columns, select a column header and use drag-and-drop functionality to move
it to the desired location.
To view a graphic associated with a field controller, double-click the graphic icon that appears in the first
column of the table (by default). The graphic appears in the display panel.
To link a graphic to a field controller, select the field controller, then right-click and select Modify. The Modify
dialog box appears. Edit the Graphic and Graphic Alias attributes as desired and click Send. This procedure
applies only to field controllers. See the Modify Dialog section for details.
Note: You cannot perform global commands/modifications or sort the data in the Key Data table.
108
Config - Trends
Default Columns
Present Value
Alarm Priority
Differential
Config - Trends
Config - Trends
Present Value
Unoccupied State
Occupancy Reference
Cooling Setpoint Reference
Heating Setpoint Reference
Present Value
Warning Priority
Warning Reference
Report Delay
109
Default Columns
Present Value
Device Type
Min Value
Max Value
COV Increment
Out of Service
Relinquish Default
Model Name
Description
Object Identifier
Instance Number
Config - BACnet
Controller Info
Config - Trends
Model Name
Network Address
BACnet IP Port
Object Identifier
Diag - Engines
Config - Trends
Present Value
BACnet Object Name
Object Identifier
110
Default Columns
Present Value
You can modify the attributes from the Tailored Summary view
using the Global Modify feature. See the Modify Dialog section.
Min On Time
Heavy Equip Delay
Out of Service
Relinquish Default
Device Type
Model Name
Status
Version
IP Address
IP Mask
Diag - Engines
DHCP Enabled
Description
Model
Status
ADS Repository
Last Archive
Diag - Engines
Local Time
Local Date
Config - FEC Controllers Displays the key network configuration attributes of any FEC
2
controllers.
Model
Status
Description
Version
Address
Trunk Number
Auto Alarm
Status
Description
Neuron ID
Program ID
DSN 1
XIF Present
Present Value
Interface Vlue
Field Units
Manual Control
Update Interval
Target Reference
Priority
Config - Engine Summary Displays the key configuration attributes of any NxEs.
Config - LON Controllers Displays the key network configuration attributes of any
2
LONWORKS controllers.
111
Default Columns
Config - Multistate Value Displays multistate alarm configuration data. The typical rows
Alarms
are any key multistate points (for example, modes of operation,
fan status, and so on) that have alarm, trend, and averaging
1
extensions.
Config - Trends
Config - N2 Controllers
Config - Schedules
Present Value
Normal State
Alarm Priority
Capture Changes
Report Delay
Report Delay Active
Alarm Message Text
Status
Description
Controller Type
Trunk Number
Auto Alarm
Item Reference
Version
Status
Gate Number
Network Name
Node Number
Object Count
Poll Delay
Description
Present Value
Name
Enabled
Item Reference
Authorization Category
You also can use this Summary Definition for features other
than schedules.
112
Default Columns
Config - TEC Controllers Displays the key network configuration attributes of any TEC
2
controllers.
Model
Status
Version
Auto Alarm
Config - Trends
Diag - Engines
Buffer State
Enable
Repository Enabled
Sample Interval
Transfer Setpoint
CPU USage
Battery Condition
% Flash Utilized
% Memory Utilized
Object Count
Board Temperature
Model
Status
Memory Usage
CPU Usage
Object Count
Flash Usage
Lost Messages
Missed Messages
Transmit Errors
Transaction Timeouts
Framing Errors
Lost Token
Buffer Overflows
Description
Present Value
113
Default Columns
Diag - N2 Trunks
Command Count
Message Timeouts
Offline Occurrences
Retries
Description
The rows for this Summary Definition are the VAV controllers
associated with an air handling system. The absolute error
114
Default Columns
Description
The rows for this Summary Definition are the VAV controllers
associated with an air handling system. The absolute error
Monitoring - Air Handling Displays the key point information based on standard naming
conventions for a Mixed Air Single Duct systems. The rows for
Unit (AHU)s
2
this Summary Definition are FEC or TEC Series controllers.
Definition.
Monitoring - Alarm
History
Heating Output
Present Values
Config - Trends
115
Default Columns
Present Value
Averaging Value
Min Value
Max Value
Reliability
Item Reference
Config - Trends
116
Monitoring - VMA1600
Flow
Monitoring - VMA1400
Overview
Default Columns
2
that are associated with an air handling system.
Box Area
2
that are associated with an air handling system.
Box Area
2
with an air handling system.
Zone Temperature
Pickup Gain
Flow
Cooling Max Flow Setpoint
Cooling Min Flow Setpoint
Heating Flow Setpoint
Pickup Gain
Flow
Cooling Max Flow Setpoint
Cooling Min Flow Setpoint
Heating Flow Setpoint
Supply Temperature
Setpoint
Flow
Flow Setpoint
2
3
2
with an air handling system.
Zone Temperature
Supply Temperature
Setpoint
Flow
Flow Setpoint
Damper Output
Heating Output
The Name attribute of alarm, trend, or averaging extensions must be unique across all extensions on the item (that is, the
alarm and trend item extensions cannot both have a Name attribute of Present Value). You can modify the Name attributes
from the Tailored Summary view using the Global Modify feature. See the Modify Dialog section.
You can use the Global Modify feature to add an associated graphic to all the device objects. See the Modify Dialog section.
You can use the Global Command feature to send Clear Statistics and Latch Statistics from the Tailored Summary view to
capture the most current diagnostic information. See the Commands Dialog section.
117
On a Site Director, the Summary Definition Editor allows you to define and edit an SCT Summary Definition object.
The SCT Summary Definition Editor appears when you view an SCT Summary Definition object. In the SMP user
interface, you view large quantities of live data in a tabular format. SCT Summary Definition objects always reside
on a Site Director in the Configuration Data > SCT Summary Definitions folder of the All Items tree (that is, you
cannot put a SCT Summary Definition object in another location).
Summary Definition Tab
The Summary Definition Editor's Summary Definition tab allows you to define the table that appears in the Tailored
Summary Viewer.
Figure 20: Summary Definition Editor - Summary Definition Tab
Defines the label to display in the first column (that is, the row header column) in a Tailored
Summary. The label is limited to a maximum of 50 characters. This field also can be left
blank.
Add/Plus
Allows you to add a column at the end of the column configuration table. To select a column,
click the column heading.
Note: One column is created by default when you create the definition. You must define a
minimum of at least one column. The display limitation for Tailored Summaries is 100 rows
and 7 columns. You may not see optimal performance when tables exceed this
recommendation.
Remove/Minus
Allows you to remove the currently selected column from the column configuration table.
To select a column, click the columns header.
Note: One column is created by default when you create the definition and the user interface
will not let you remove the last column. You must define a minimum of at least one column.
118
Lets you configure the columns that appear in the Tailored Summary:
Column Heading - Defines the name of the column heading. The name can have a
maximum of 50 characters.
Child Item - Indicates the item for which the column data is retrieved based on its item
name attribute. You can use the Select Item dialog box to pick a name, or type in the
text box. The name must match a user-specified pattern (such as ZN-* or ZN-T, Zone-T).
You can define an unlimited number of wildcards. The first item found that matches this
item name pattern appears in the Tailored Summary view column. To display an attribute
of the row item, leave this field blank. Otherwise, specify the name of the child item to
display.
Note: To mass search child-item strings, separate your search criteria with commas.
For example, ::classid:156,172,155.
Attribute - Defines the attribute information for the column. To display the default
attribute, no change is required (that is, leave the Attribute box set to Default). The
attributes are grouped into categories for easy selection. To specify an attribute, select
a category in the Attribute Filter section of the Select Column Attribute dialog box, and
then select the desired attribute from the list.
Note: To change the order of the columns, select a column and drag it to the desired
placement.
Note: When you display a Tailored Summary, the system searches for data within all levels
of a field device (VMA, for example). For all other objects (NAE, for example), the system
searches for data only one level down (not subsequent levels).
Browse (Child Item)
Opens the Select Item dialog box where you can specify the item name.
Note: This dialog box provides an easy way to fill in the item name of a child item. It does
not mean that the selected item displays in that column.
Browse (Attribute)
Opens the Select Column Attribute dialog box where you can select the attribute to display
in the column of the table. This process is necessary only when selecting an attribute other
than the default attribute.
This dialog box has two list boxes to aid in selection:
Attribute Filter - Allows you to filter the items appearing in the Attribute list using
common attribute categories. If you filter on Alarms, for example, the supported alarm
attributes appear in the list for selection.
Note: To display the default attribute of the row item, leave the Attribute box set to Default
(Attribute Filter: Common Attributes and Attribute: Default).
119
5. Click Finish. The new SCT Summary Definition appears in the Configuration Data > SCT Summary Definitions
folder.
Displays the save location of the new Summary Definition. You can only save files in the Configuration
Data > Summary Definitions folder.
Identifier
Allows you to enter a name for the Summary Definition object. There is a maximum of 32 characters.
Configure
Allows you to define the data of the Summary Definition and Configuration tabs.
Summary
In the All Items Tree, select the objects you would like the Summary Definition to apply to in the
Tailored Summary Viewer.
2.
Click View > Tailored Summary Viewer. The Tailored Summary Viewer appears.
Select a Summary Definition to apply to the objects.
3.
Table 56: Tailored Summary Viewer Workflow - Using Query > Global Search
Step
Description
1.
Click Query > Global Search. The Global Search Viewer appears.
2.
Click Add to select the Search Locations. You can select multiple locations.
3.
Enter the search criteria. You can enter an object name, object type, include child objects, and
include search locations in the search criteria. For more information, see Global Search.
4.
Click Search.
5.
Select the rows you would like the Summary Definition to apply to in the Tailored Summary Viewer.
6.
Click View > Tailored Summary Viewer. The Tailored Summary Viewer appears.
7.
120
BACnet IP Port
Instance Number
Object Name
Common Attributes
Authorization Category
DSN1
Neuron ID
Program ID
XIF Present
Memory Usage
Object Count
Trunk Number
Device Status
NCM Name
Object Count
Poll Delay
Controller Type
Trunk Number
Device Type
Max Value
Min Value
Out of Service
Interface Value
Target Reference
Update Interval
Feedback
Setpoint
APDU Retries
Buffer Overflow
Missed Messages
Transmit Errors
Transaction Timeouts
Integrations (N2)
Command Count
Space
Served By
Type
Integrations (LON)
121
Trends
IP Address
Model Name
Object Count
Buffer State
Enable
Sample Interval
Transfer Setpoint
You can perform this task in SCT or the online Site Management Portal UI for the Site Director.
See the Focus Tab and Summary Definition Object sections for information on the Key Data attribute of
the Summary Definition.
1. In the Summary Definitions folder of the All Items tree, right-click the Summary Definition and click View. The
Summary Definition appears in the display panel.
2. On the Focus tab, click Edit.
3. In the Key Data list box, click the browse button. The Modify List dialog box appears (Figure 1).
4. Add Key Data as follows:
a. Click Add. An undefined item appears in the list.
b. Click the Browse button of the item. The Select Item dialog box appears.
c. Select an item.
d. Click OK.
Note:
5.
6.
7.
8.
You also can type in the text box and use wildcards (asterisks * only) to search for the item within
the user view folder.
You can define up to four Key Data items.
Select an item and click Remove to delete the item from the Key Data list.
Select an item and click Move Up or Move Down to rearrange the order the items appear in the list.
Click OK.
Click Save.
122
Enter the text to display as the label for the row header column (that is, the
first column).
The label is limited to a maximum of 50 characters. This field also can be
left blank.
Column Headings
Click
To change the order of the columns, select a column and drag it to the
desired placement.
Enter the text to display as the label for the column header column
(maximum 50 characters).
123
select an item from the All Items Tree and drag it to the Child Item text
box
Note: This functionality is not available in the Create New SCT Summary
Definition wizard.
click
and the Select Item dialog box appears. Select an item and
click OK.
Select the attribute to display (only when selecting an attribute other than
the default attribute):
. The Select Column Attribute dialog box appears.
a. Click
b. In the Attribute filter list box, select a filter category. The attributes of
that type appear in the Attribute list box.
c. In the Attribute list box, select an attribute.
d. Click OK.
4. Click Save.
5. On the Configuration tab, click Edit.
6. Click Save.
124
This issue was resolved in Release 5.1. If this delay is problematic, we recommend
you upgrade to Release 5.1 or later.
When running a Tailored Summary, user On a summary view with more than 500 objects from a single NxE, you may
views with large point counts display red occasionally see red Xs if the device is busy. As the view continues to update data,
Xs.
the red Xs disappear.
Allows you to monitor, enable/disable, reschedule, delete, and reschedule reports that are in progress
or pending.
Scheduled Actions
Allows you to enable/disable, delete, edit, and run upcoming scheduled reports.
Completed Actions
Allows you to view the status of completed reports, reschedule reports, delete the status entries from
the screen, and view the content Scheduled Report output file.
125
126
Displays the results of all global commands/modifications sent during the current user session.
If you select an item in the table and place your cursor over it within each column, tooltips appear
providing more information, if available.
Any data that does not fit within the columns is identified by an ellipse (...). You can resize the
column or place your cursor over the table cell to see its tooltip text.
If you send another global command/modification at a later time during the current user session,
the result entries are added to any existing result entries from prior commands/modifications sent
during the session.
The most recent entry appears at the top of this table by default. If desired, you can sort the
results.
See the Working with the Change Results Viewer section for more information on manipulating
and using the table data.
When
Item
Displays the name of the object to which the command/modification was sent. The objects full
reference identifier appears in a tooltip when you place the cursor over the name.
Change Type
Parameters
Displays the list of parameters for the command/modification that was sent. For example, for a
Release command, an attribute and priority such as Present Value, 15 (Scheduling) appear in
the Parameters column.
Status
Displays the status of the command/modification that was sent (for example, OK or an explanation
of failure).
Note:
An OK status for a command indicates the supervisory device validated and accepted the
command, but does not necessarily indicate the command executed successfully. There may
be cases where the command is accepted, but fails execution. For example, a Route command
to a trend extension may be accepted by the supervisory device with a status of OK, but if
the actual routing of the trend data fails due to the ADS offline or other error, the failure is
noted in the Audit log at that point in time.
Deletes all the entries from the Change Results Viewer and adds an entry to indicate when it
cleared those entries.
Copy
Copies the selected change results to the Clipboard for pasting into other applications such as
Microsoft Excel or Word.
Save to File
Saves the current content of the change results table to a text file.
127
Note: If no global commands/modifications were issued during the current user session, the Change Results Viewer
appears with a message stating No global commands or modifications have been issued within the
current session.
Selecting Entries in the Change Results Viewer
To select entries in the Change Results Viewer, click an individual entry in the change results table or use the Ctrl
or Shift keys when clicking to select multiple entries.
Note: You also can click and drag your cursor over entries in the change results table to select entries that appear
consecutively. With an entry in the change results table selected, you can press Ctrl+A to select all entries.
Sorting Change Results in the Change Results Viewer
To sort change results in the Change Results Viewer, click the heading of the desired column in the change results
table. The results sort and a small arrow appears indicating the order of the sort (ascending or descending). Click
the column heading again to change the sort order.
Reordering Columns in the Change Results Viewer
To reorder the columns in the Change Results Viewer, drag the heading of the column to the desired location.
Printing the Change Results
To print the contents of the Change Results Viewer, follow the Printing instructions in the Site Management Portal
User Interface section.
Saving Change Results to File
To save the contents of the Change Results Viewer to a file:
1. Click Save to File. The Save dialog box appears.
2. Specify the desired location to save the results.
Note: The default name for the text file is ChangeResultsLog.txt. You can change the name as you wish to
further identify these results, or to prevent overwriting previously saved results.
3. Click Save.
Copying Change Results to the Clipboard
To copy change results in the Change Results Viewer to the clipboard:
1. Select the desired results according to the Selecting Entries in the Change Results Viewer section.
2. Click Copy.
Note: You also can use Ctrl+C to copy the data.
3. Open the program to paste the results (for example, Microsoft Excel or Word).
4. Paste the results according the programs conventions (generally, Edit > Paste or Ctrl+V).
Clearing the Change Results Viewer
If the size of the results log becomes too large, the Global Command or Global Modify feature prompts you to clear
the change results.
To clear all change results in the Change Results Viewer:
1. Click Clear Results Viewer. A dialog box appears asking if you want to permanently clear all command results.
2. Click Yes.
Metasys SMP Help: View Menu
128
Extended Labels
Menu Selection: View > Extended Labels (select the check box)
Toggles the display of the item labels in the All Items navigation tree or user navigation tree from standard to extended.
An extended label shows the BACnet object name that was defined when the object was initially created in braces
next to the standard label. This is the name used in the object's Fully Qualified Reference. The Metasys object name
may be the same as the BACnet object name, or it may have been edited as a label that is more recognizable to
the user.
Example:
Standard Label = N2 Trunk1
Extended Label = N2 Trunk1{N2-1}
Validation Labels/Settings
Menu Selection: View > Validation Labels (in the online UI), View > Validation Settings (in the SCT UI) (select the
check box)
In the SCT, this setting toggles the display of the item labels in the All Items navigation tree or user navigation tree
to show extra label information for MVE. When selected, this menu item also displays the Validation Settings attribute
section for objects on the Focus/Configuration tab.
This setting has no effect in the online UI (the validation labels are always visible).
Panel Layout
The Display Frame can be divided into up to four display panels. When viewing an item in a display panel, the name,
status, and default attribute (usually the present value) of the item you display appear at the top of the display panel.
Each display panel can contain different tabs, depending on the item selected from the navigation tree, and each
tab shows different information. Dynamic attributes displayed in a panel automatically refresh when changes are
detected.
The default display panel is the first empty panel or last unlocked panel if all displayed panels are filled. Display
panels are locked while in Edit mode, or may be locked using the Lock button of the selected display panel. If all
available panels are locked, you cannot display an additional item in any of the display panels.
You can resize each display panel by dragging its borders, or using an available splitter bar. With some items, an
Edit button appears (except in Simulation mode), allowing you to edit the items configuration attributes. Editing in
online mode with Basic Access is limited to Schedules and Calendars, and no Edit button appears for any other
items.
You can drag and drop items into a display panel and navigate among them using the Back and Forward display
panel buttons. The display panel holds a maximum history of five items.
If you run any of the predefined reports found in the Query Menu, the result of the query appears in an available
panel in a spreadsheet format. Sort the report results by clicking the column heading, and resize columns by dragging
column borders. When you scroll down through the column, the headers remain visible.
Metasys SMP Help: View Menu
129
The data presented in a report comes from a snapshot of the system at the time you request the report. The displayed
data does not automatically refresh and does not support an Edit mode. You can manually refresh the report through
the Action Menu.
To change the way the panels are arranged, see Changing the Display Panel Layout. If you have a multi-panel
display and you change to a layout with fewer panels, the locked items/newest items in the view stay, depending
on how many panes are available in the new layout. The other panels close (they do not reappear if you switch back
to the multi-pane view).
To resize the panels, drag the borders of the panel until it reaches the desired size. To make one panel (in a
multi-panel arrangement) take up the entire Display frame temporarily, click the maximize button. To restore a
maximized panel in a multi-pane view, click the restore button. A panel can also be maximized/restored by
double-clicking its header bar.
Display Panel Tabs
Each display panel contains tabs that vary depending on the item displayed.
For example, most of the point objects, such as the OAT contain the following tabs:
Table 62: Tabs
Tab
Description
Alarm
Becomes available when you define an Alarm Extension for a point. The New and Delete buttons allow you to
add or delete Alarm Extensions for the point. The Basic and Advanced radio buttons allow you to filter the
attribute display in this tab. The Edit button allows you to change configurable attributes.
Focus
Becomes available when you define a point object. The Focus tab shows operation attributes available for the
object type to which the object belongs. Please note that the Basic and Advanced radio buttons allow you to
filter the attribute display in this tab. The Edit button allows you to change configurable attributes.
Hardware
Becomes available when you define a point object that has a reference to a physical input or output. The
Hardware tab shows hardware-related attributes available for the object type to which the point object belongs.
BACnet Alarm Becomes available when you define a BACnet instrinic alarm for a point. The Intrinsic Alarming Defined attribute
is explained in Trend Extension Attributes section. The BACnet Alarm tab shows BACnet Alarm-related attributes
available for the object type to which the point object belongs. The Basic and Advanced radio buttons allow you
to filter the attribute display in this tab. The Edit button allows you to change configurable attributes.
Totalization
Becomes available when you create a Totalizator Extension. New and Delete buttons allow you to add or delete
Totalization Extensions for the point. The Edit button allows you to change configurable attributes.
130
Becomes available when you create a Trend Extension for a point object. New and Delete buttons allow you
to add or delete Trend Extensions for the point. The Chart view allows you to view data samples in a graphical
format and retrieve new trend data. The Table view of the Trend Extension allows you to view the trends data
samples in a table format. The Definition view of the Trend Extension allows you to view and edit the attributes
of the trend extension object.
Averaging
Becomes available when you create an Averaging Extension for a point object. The New button allows you to
add Averaging Extensions for the point.
Load
Becomes available when you create a Load Extension for a point object. The New button allows you to add
Load Extensions for the point.
Other items may contain fewer or more tabs. For example, the item representing the Engine or ADS/ADX contains
the following tabs:
Focus
Summary
Diagnostic
Communication
Network
Email
Pager
SNMP
Alarm
Trend
Printer
For information on the tabs available in the system, see the Object and Feature Tabs section.
Display Panel Buttons
Table 63 shows the display panel buttons.
Table 63: Display Panel Buttons
Button
Description
Allows you to edit attributes for the displayed item. The values you can edit vary depending on the
displayed item. Click Save to save your changes.
Note:
This button does not appear in Simulation mode.
This button does not appear if the user has Basic Access mode permission. It appears dimmed if
the user has Standard Access mode, but does not have Modify Items permission for the object being
viewed.
The term edit refers to changing items using the Edit button. See the Modify section. The term modify
refers to changing items using the Modify menu item and the Modify dialog box. See the Modify
Dialog section.
Displays the content previously displayed in that panel. Each panel can have a display history of up to
five items.
Displays the content of the next panel saved in the history.
131
Action Menu
In addition to the four modes of operation that determine the items appearing in menus, the Action menu is
context-specific. Different item-specific options appear in the Action menu based on what is currently selected in
the navigation tree. Also, different feature-specific options appear in the Action menu based on the active panel or
feature displayed in the selected display panel.
The following table lists the menu items for the Action menu. For details on which options appear with certain items
or features selected, see:
Click one of the following menu items for a description of the menu item. For a description of the Authorized Required
column, see Authorized Menu Items.
Table 64: SMP Action Menu
Menu Item
Command
Modify
Mode Visible In
Online (Standard
Access)
Online (Basic
Access)
Import Definition
Export Definition
Show Extensions
View Annotations
Add Annotation
Authorization Required
X
4
X
X
Refresh
132
Mode Visible In
Authorization Required
Online (Standard
Access)
Online (Basic
Access)
Ack
Discard
Import Integration
1
2
3
4
Active Panel/Feature
Online (Standard
Access)
Event Viewer
Audit Viewer
Scheduled Reports
Tailored Summary
Trend Viewer
Online (Basic
Access)
Refresh
Add Annotation
View Annotations
Ack
Discard
Refresh
Offline (SCT)
Refresh
Simulation (SCT)
Refresh
Refresh
2
2
Add Annotation
View Annotations
Refresh
Command
Modify
2
2
Command
Modify
Add Annotation
View Annotations
Add Annotation
View Annotations
Show Extensions
Remove From
4
Site
Import Integration
Refresh
Refresh
Refresh
Command
Command
Command
2
2
2
2
133
Active Panel/Feature
Online (Standard
Access)
Global Search Viewer
Change Results Viewer
1
2
3
4
5
6
Refresh
Online (Basic
Access)
Offline (SCT)
Refresh
Simulation (SCT)
Refresh
The Refresh, Refresh Current Tab, and Refresh All Tabs menu items appear in the Action menu for all other features or
active panels.
Available on the ADS/ADX/ODS only.
The menu options available are item-specific (that is, they depend on the type of item selected in the Tailored Summary table
and Key Data table).
Available for an Engine only.
Available for a Tailored Summary with trunk/integration data (for example, trunk diagnostics).
There are no Action menu options for this feature.
Item
Online (Standard
Access)
ADS Device Object
Integration
Online (Basic
Access)
Offline (SCT)
Simulation
Command
Add Annotation
Modify
Modify
View Annotations
Rename
Add Annotation
View Annotations
Command
Command
Modify
Command
Modify
Add Annotation
Show Extensions
Show Extensions
Add Annotation
View Annotations
Import Integration
View Annotations
Show Extensions
Import Integration
134
Item
Online (Standard
Access)
Site Object
Command
Command
Add Annotation
Add Annotation
View Annotations
View Annotations
Command
Modify
Add Annotation
View Annotations
Show Extensions
Command
Modify
Modify
Add Annotation
Add Annotation
View Annotations
View Annotations
Show Extensions
1
2
Online (Basic
Access)
Offline (SCT)
Simulation
Site Discovery
Command
Command
Modify
Command
Add Annotation
Show Extensions
Show Extensions
View Annotations
Start Simulation
Rename
Modify
Command
Show Extensions
Show Extensions
Command
2
The Refresh Current Tab and Refresh All Tabs menu items appear in the Action menu for all of these items.
Available for only Schedule and Calendar objects.
Commands
Use commands to force an item to perform a specific action. For example, ON and OFF commands for a binary
output make a fan run or stop, and the Enable and Disable commands in the Trend extension start and stop the
collection of samples.
For information on which commands an item supports, see the appropriate topic in the Object Help.
For information on how to send a command to a single item, see Commanding an Item in the Commands Dialog
section.
For information on sending a command to multiple items, see Commanding Multiple Items (Global Command) in
the Commands Dialog section.
Commands Dialog
The Commands dialog box allows you to send a command to a single item (single command feature) or to multiple
items at once (global commands feature). You can open the Global Search Viewer or a Tailored Summary, for
example, in a display panel and select one or more items from the table to command. For example, you could send
a command to open all the reheat valves on VAV boxes so the balancer can balance the hot water system in your
facility.
The single command feature uses the Commands dialog box. The global commands feature uses the Global
Commands dialog box for sending commands and uses the Change Results Viewer for viewing, saving, and printing
the sent global commands.
For information on the Change Results Viewer and how to use it, see the Change Results Viewer section. The
Change Results Viewer is used by both the Global Modify and the Global Commands features.
See Using Global Commands with the Global Search in this section for steps on using the Global Search and Global
Commands features together.
135
Allows you to filter the commands shown in the commands list by:
All Commands: Shows all commands for the item.
Primary Commands: Shows the commonly used commands for the item. Selecting this
setting shows only the Archive, Reset Device, and Route Samples commands.
Secondary Commands: Shows the less commonly used commands for the item. Selecting
this setting shows only the Change Audit Enabled Class Level, and Update Flash Usage
commands.
Displays the list of commands available for the selected item. Unauthorized commands are either
grayed out (disabled) or not shown (hidden), depending on user preference settings. The default
is grayed out. For commands that require parameter values, the fields appear after selecting the
command.
Send
Sends the selected command to the object/item. All commands are sent at the default priority
for the command.
Cancel
136
137
Commands Tab: Show Allows you to filter the commands shown in the commands list by:
All Commands: Shows all commands for the item.
Command Set
Drop-Down Menu
Primary Commands: Shows the commonly used commands for the item. Selecting this setting
shows only the Off, On, Operator Override, Release Operator Override, and Change Default Value
commands.
Secondary Commands: Shows the less commonly used commands for the item. Selecting this
setting shows only the Release and Release All commands.
Displays the list of commands available for the selected items. Unauthorized commands are either
grayed out (disabled) or not shown (hidden), depending on user preference settings. The default is
grayed out. For commands that require parameter values, the fields appear after selecting the command.
Items Tab
Send
Sends the selected command to the objects listed in the Items tab. All commands are sent at the
default priority for the command.
Cancel
Closes the Global Commands dialog box without sending the command.
Show Command
Results
When selected, displays the Change Results Viewer in the display panel after clicking Send.
138
Present Value
Alarm Extensions
Enable
Disable
In Service
Out of Service
Release All
Release
Operator Override
Temporary Override
Adjust
Release All
Release
Operator Override
Temporary Override
Adjust
In Service
Out of Service
Release All
Release
Operator Override
State Commands
Release All
Release
Operator Override
Temporary Override
State Commands
139
Integration Objects
Load Extensions
Schedule Object
Clear Statistics
Latch Statistics
Unlock
Lock
Shed
Release Load
Comfort Override
Enable
Disable
Release All
Release
Operator Override
State Commands
Enable
Disable
In Service
Out of Service
Release All
Release
Operator Override
Temporary Override
State Commands
Release All
Release
Operator Override
Temporary Override
Enable
Disable
Enable
Disable
140
Totalization Extensions
1
2
3
4
Clear
Execute
Enable
Disable
Route
Reset
Enable
Disable
You must select and command similar object types. For example, you cannot send a command to both alarm extensions
and trend extensions at once. You need to command the alarm extensions and trend extensions separately.
For binary objects, state commands display as the generic State0 and State1 commands if the States Text attribute is different.
If the States Text attribute is the same, then the specific states text is used (for example, On or Off).
Integrations include Field Bus, XL5K, N2 Trunk, VND, Wireless Supervisor, BACnet, and N1 Migration.
For multistate objects, state commands display as the generic State0 and State1 commands if the States Text attribute is
different. If the States Text attribute is the same, then the specific states text is used (for example, On, Off, or Auto). In
addition, you can command multistate items together only when the number of states matches.
This works only for schedules in the NxE, not the FAC.
141
1. Select the desired, compatible objects in the navigation tree or in the display panel. Hold the Ctrl or Shift keys
when clicking to select multiple items in the navigation tree, or use the selection conventions of the feature
displayed in the display panel. For example, see Commanding Objects in the Search Results Table in the Global
Search section.
Note: You must select and command similar object types. For example, you cannot send a command to both
alarm extensions and trend extensions at once. You need to command the alarm extensions and trend
extensions separately.
2. From the Action Menu, select Command, or right-click and select Command. If you selected objects from the
navigation tree, a Preparing Data box appears stating the authorization information for the selected objects is
being retrieved. The Global Commands dialog box appears.
Note:
If you click Cancel on the Preparing Data box, both it and the Global Commands dialog box close
without issuing commands.
If no commands are available for the selected objects or if you have selected incompatible object
types, a dialog box appears stating so. Click OK. The Commands dialog box does not open. Go back
to Step 1.
3. On the Commands tab, filter the list of commands using the Show Command Set drop-down menu, if desired.
4. On the Commands tab, select the command to send to the objects.
Note: After selecting one of the available commands, you may be prompted to specify additional parameters
for the command.
5. On the Items tab, review the list of objects to command.
Note: To change the objects in this list, click Cancel and go back to Step 1.
6. Select the Show Command Results check box to display the Change Results Viewer after issuing the command.
7. Click Send. The command is sent to the selected objects and the Change Results Viewer appears if you selected
the Show Command Results check box.
Note: If you are not authorized to send a global command to one or more objects, a dialog box appears stating
the command will not be sent to unauthorized objects. Click Yes to continue to send the command to the
authorized objects. Click No to return to the Command dialog box without sending the command to any
objects. Click Cancel to close the Command dialog box without sending the command to any objects.
Your system access and category-based privileges set in the Security Administrator System determine
your authorization.
After the command has been sent to all selected items, the Global Command Completed dialog box appears
indicating:
142
8. Click OK.
See Working with the Change Results Viewer in the Change Results Viewer section.
Using Global Commands with the Global Search
To use Global Commands with the Global Search:
1. Perform a global search according to the Performing a Global Search procedure in the Global Search section.
For example, search for alarms that you plan to command.
2. Save the object list if this is a common search (for example, you plan to command the alarms or review their
status often). See Working with Search Results and Saving an Object List in the Global Search section.
3. Select the items in search results table and send a global command (for example, enable or disable alarms)
according to the instructions in the Commanding Multiple Items (Global Command) section.
Note: In addition to these options, you can perform a global modification on items in the object list. Select and
right-click the items, and modify them as desired. See the Modify Dialog section.
Modify
Note:
In online mode with Basic Access, you can edit only the Schedule and Calendar objects.
The term edit refers to changing items using the Edit button as described in this procedure. The term
modify refers to changing items using the Modify menu item and the Modify dialog box. See the Modify
Dialog section.
143
Note: Some items contain an Advanced radio button. If you select this button, additional attributes appear.
3. Click Edit.
4. Edit the attributes as needed.
Note: If you place your cursor over an edit field, the ToolTip provides information about the valid format or range
for that value. ToolTips also appear for strings.
5. Click Save.
For information on using the Modify dialog box to modify single or multiple items, see the Modify Dialog section.
Modify Dialog
Note: The term edit refers to changing items using the Edit button. See the Modify section. The term modify refers
to changing items using the Modify menu item and the Modify dialog box as described in this section.
The Modify dialog box allows you to modify attributes of a single item (single modify feature) or multiple items at
once (global modify feature). You can open the Global Search Viewer or a Tailored Summary, for example, in a
display panel and select one or more items from the table to modify. For example, you could send a modification to
change the Authorization Category of all VAV boxes in your facility from General to HVAC. Only attributes common
to all items being modified appear in the Global Modify dialog box.
The single modify feature uses the Modify dialog box. The global modify feature uses the Global Modify dialog box
for sending modifications and uses the Change Results Viewer for viewing, saving, and printing the sent global
modifications.
For information on the Change Results Viewer and how to use it, see the Change Results Viewer section. The
Change Results Viewer is used by both the Global Modify and the Global Commands features.
See Using Global Modify with Global Search in this section for steps on using the Global Search and Global Modify
features together.
Single and Global Item Modify Concepts
Modify Dialog Box
The Modify dialog box allows you to modify attributes of a single item in the Metasys system. You can access the
Modify dialog box for the selected item by selecting the Modify menu option from the Action Menu or the right-click
menu. The attributes shown in the modify box are different for different object types.
144
Attributes Table
Displays the list of attributes available to modify for the selected item. Unauthorized modifications
are disabled. Attribute value fields appear after the attribute name.
The check box next to an attribute is automatically selected when you make a modification in its
value field. Modifications are sent for only the selected (checked) attributes.
Send
Cancel
145
146
Attributes Tab
Displays the list of common attributes available to modify for the selected items. Unauthorized
modifications are disabled. Attribute value fields appear after the attribute name.
The check box next to an attribute is automatically selected when you make a modification in its
value field. Modifications are sent for only the selected (checked) attributes.
Items Tab
Send
Sends the selected modification to the objects/items listed in the Items tab.
Cancel
Closes the Global Modify dialog box without sending the changes.
Displays the Change Results Viewer in the display panel after clicking Send (when this box is
checked).
Modify Attributes
The following table lists the attribute groupings and examples of the attributes available for modification.
147
Example Attributes
General
COV Increment
Display Precision
Authorization Category
Units
BACnet Deadband
High Limit
Low Limit
Differential
Alarm Priority
Event Enable
Graphic
Graphic Alias
Alarm Values
Alarm Setup
Graphic Setup
148
You can perform a global modification on items from the navigation tree, display panel view (for example, Tailored
Summary view), or Global Search Results table.
Note: Once sent, you cannot undo a global modification; however, you can send another global modification to
readjust values as needed.
To perform a Global Modify:
1. Select multiple items in the navigation tree, display panel view, or global search results. Right-click the items
and select the Modify menu item. The Global Modify dialog box appears.
Note: The Items tab lists the selected items and your permissions to modify them.
2. On the Attributes tab, make changes to one or more attributes as desired.
Note: You can easily enter each controller's Fully Qualified Reference (FQR) by entering an asterisk (*) in the
Graphic Alias field.
3. Select the Show Modify Results check box to display the results of the modifications, if desired.
4. Click Send. If you selected to view results, the Change Results Viewer appears in a display panel. The Change
Results Viewer has options to copy the results, save the results to a file, and clear the results.
Note: If you are not authorized to send a global modification to one or more objects, a dialog box appears stating
the modification can not be sent to unauthorized objects. Click Yes to continue to send the modification
to the authorized objects. Click No to return to the Modify dialog box without sending the modification to
any objects. Click Cancel to close the Modify dialog box without sending the modification to any objects.
Your system access and category-based privileges set in the Security Administrator System determine
your authorization.
Note: On an MVE site, you are prompted to authorize this action (only once) with the defined annotation and/or
electronic signature requirements.
After the modification has been sent to all selected items, the Global Modify Completed dialog box appears
indicating:
149
Note: The Succeeded value in the Global Modify Completed window reflects the number of objects modified,
not the number of object attributes modified.
5. Click OK.
Note: You cannot use the modify feature to modify items that reside on a Release 2.2 or earlier device. If you
attempt to modify Release 2.2 or earlier items, one of the following errors appears: Object does not
exist or One or more attribute modifications failed.
See Working with the Change Results Viewer in the Change Results Viewer section.
Using Global Modify with Global Search
To use Global Modify with Global Search:
1. Perform a global search according to the Performing a Global Search procedure in the Global Search section.
For example, search for alarms that you plan to modify.
2. Save the object list if this is a common search (for example, you plan to modify the alarms or review their status
often). See Working with Search Results in the Global Search section.
3. Select the items in the search results and send a global modify according to the instructions in the Performing
a Global Modify section.
Note: In addition to these options, you can perform a global command on items in the search results. Select and
right-click the items, and command them as desired. See the Commands Dialog section.
Import Definition
Menu Selection: Action > Import Definition
Imports the pre-built summary definition that is stored on the computer and is only available when the Summary
Definitions folder is selected in the All Items tree. After importing a definition, the imported Summary Definitions
appear in the Summary Definitions folder in the All Items tree.
Note: You also can import Summary Definitions that were previously exported. Refer to the Exporting a Summary
Definition section in the Metasys SCT Help (LIT-12011964) for more information.
150
The pre-built Summary Definitions are provided on the SCT installation media and the Johnson
Controls BPP. You can save these files to your computer or access them from the SCT installation
media or BPP DVD.
You also can import Summary Definitions that were previously exported. See the Exporting a Summary
Definition section.
3. Select one or more Summary Definitions to import.
4. Click Import. The Notice dialog box appears, indicating the results of the import after all imports complete.
Figure 30: Notice Dialog Box
5. Click OK. The imported Summary Definitions appear in the Summary Definitions folder in the All Items tree.
Export Definition
Menu Selection: Action > Export Definition
Exports the summary definition that is stored in the Summary Definitions folder in the All Items tree to a location on
the computer. You can now share the Summary Definition with others and import it to other sites as desired.
Note: If you import the Summary Definition to another site, you may need to update the key data references. Refer
to the Importing a Summary Definition section in the Metasys SCT Help (LIT-12011964) for more information.
151
4. Click OK.
Note: You can now share the Summary Definition with others and import it to other sites as desired. If you import
the Summary Definition to another site, you may need to update the key data references.
View Annotations
Menu Selection: Action > View Annotations
Displays the existing annotations for the selected item in the Audit Viewer, Event Viewer, Tailored Summary, Global
Search results, Navigation Tree, and so on.
Add Annotation
Menu Selection: Action > Add Annotations
Adds an annotation for the selected item in the Audit Viewer, Event Viewer, Tailored Summary, Global Search
results, Navigation Tree, and so on.
Viewing Extensions
To view extensions:
1. Drag and drop the object into the Panel Layout.
2. Click the tab along the top for the desired extension.
Extension Wizard
Note: You cannot add or delete extensions in Simulation mode.
Menu Selection: Actions > Show Extensions (menu option is available only when an item that supports extensions
is selected)
Adds features, such as trending, alarming, averaging, loading and totalization, to an item. Extension types include:
Alarm - Adds attributes for generating alarm and event messages to an item. See the Alarm and Event
Management feature for information.
152
Extensions
Extensions add features, such as trending, alarming, and totalization, to an item.
Click one of the following for more information on extensions:
For information on searching for extensions, see the Global Search section.
For more information on managing extension attributes as part of a tailored summary, see the Summary Definition
Object section.
Alarm Extensions
Alarm extensions monitor an attribute of an object and send alarms using the Alarm and Event Management feature.
There are two types of alarm extensions, Analog Alarm and Multistate Alarm. Use the Analog Alarm extension to
monitor attributes with real values. Use the Multistate Alarm extension to monitor attributes with True or False, or
Multistate data types.
For general information on Metasys system objects, see the Object Help section.
Alarm Extensions Concepts
Analog Alarm Extension
The Analog Alarm extension adds the alarming capability for attributes with real values, such as the Present Value
of an Analog Input Object. This extension detects an alarm based on up to four limits and can be configured to report
that alarm. It also sets the Alarm State attribute of the object to which it is added. The Analog Alarm Extension is
also used in conjunction with the Graphic Setting Preferences which are used to establish color choices for alarm
conditions in graphics.
For example, you can configure the Analog Alarm extension to issue an alarm if the temperature in a room falls
below 15.6C (60F).
For general information on Metasys system objects, see the Object Help section.
For detailed information on the Analog Alarm extension, see Analog Alarm Attributes.
Multistate Alarm Extension
The Multistate Alarm extension adds the alarming capability for an attribute with True or False, or Multistate data
types, such as the Present Value of a Binary Input Object.
The Multistate Alarm extension detects the alarm with respect to a difference from a defined normal state and sets
the Alarm State attribute of the object to which it is added. In addition, you can configure the Multistate Alarm extension
to report alarms and True or False and/or Multistate events.
For general information on Metasys system objects, see the Object Help section.
For detailed information on the Multistate Alarm extension, see Multistate Alarm Attributes.
Normal State
Normal state occurs when the alarm extension is in an acceptable, expected condition, as indicated by the attribute
point to which it is added.
Metasys SMP Help: Action Menu
153
Warning State
Warning state occurs when the analog alarm extension transitions from Normal into the high or low warning conditions.
Alarm State
Alarm state occurs when the extension transitions into the high alarm, low alarm, or unreliable conditions.
AO/BO Feedback
The Alarm extensions provide feedback in points to prevent the detection of alarm conditions that are really false
alarms. For the Analog Alarm Extension, this feedback is done through the configuration of the Setpoint Reference
attribute. For the Multistate Alarm Extension, this feedback is done through the configuration of the Command
Reference attribute. When you reference other attributes using the Setpoint Reference or Command Reference
attributes, the alarm analysis works differently.
Analog Points:
For example, add an Analog Alarm extension to an Analog Input Object (zone temperature). Define the Present
Value of the Analog Input Object as the Input Reference and define the Define the Present Value of an Analog
Output Object (setpoint) as the Setpoint Reference of the Analog Alarm extension.
If you edit the Setpoint (Define the Present Value attribute of the Analog Output Object), the Warning Reference
attribute of the Analog Alarm extension of the Zone Temperature Analog Input Object changes to the same value.
The Reference Delay Time of the Analog Alarm extension resets at this same time, preventing a false alarm condition
from being detected.
Binary or Multistate Points:
For example, add a Multistate Alarm extension to a Binary Input Object or Multistate Input Object. Define the Present
Value of a Binary Input (fan status) or Multistate Input as the Input Reference, and define the Present Value of a
Binary Output Object (command state) or Multistate Output Object as the Command Reference of the Multistate
Alarm extension.
If you edit the Command State (Present Value attribute of the Binary Output Object or Multistate Output Object), the
Normal State attribute of the Multistate Alarm extension of the Fan Status Binary Input Object or Multistate Input
Object changes to the same value. The Reference Delay Time of the Multistate Alarm extension resets at this same
time, preventing a false alarm condition from being detected.
Delay Timer Interaction
There are two timers used to delay the analysis or reporting of an alarm. These timers are used to allow normal
functions to occur before an objects behavior appears abnormal and generates an alarm. The first timer is the Alarm
State: Reference Delay Timer, which allows a preset amount of time to pass between commanding an object and
making sure that the commanded object has obeyed the command before considering an alarm condition to be
present. The second timer is the Alarm State: Report Delay Timer, which prevents the analysis of an objects
condition until the preset time has passed after that object has appeared to obey a command.
The length of the reference delay time is a combination of the reference delay time and the report delay time settings.
If you change the warning reference, both delays go active and if the reference delay time is greater than or equal
to the report delay time, then the total delay is the sum of both timer settings; however, if the reference delay time
is less than the report delay time, then the delay is equal to the report delay time setting.
The delay timers of the alarm extensions interact as follows:
Note: If no Warning Limits are defined, the Reference Delay Time and Reference Delay Timer Active attributes do
not apply.
Metasys SMP Help: Action Menu
154
User Action
Warning reference
command
Commands the Warning reference to change, moves the setpoint and the corresponding
High and Low warnings.
Reference Delay Timer Interval starts when the Warning Reference changes.
155
For example, with a BO controlling a fan and a BI with an Alarm Extension set using the BO as an Input reference,
two possible conditions are affected by the Alarm State delay timers:
1. Fan On and Operating Normally - In the following figure, a fan has been commanded On and is operating
normally. In this case, when the BO commands the Fan On, the Normal State of the BI changes to On and the
Reference Delay Time starts. Within the interval set by the Reference Delay Time, the Input Reference of the
BI changes to On and the Report Delay time starts. After the Reference Delay Time and Report Delay Time have
passed, the BI is analyzed for Alarm conditions.
Figure 33: Fan On and Operating Normally
User Action
BO Command
BI Normal State
Alarm State: Reference Reference Delay Timer interval starts when BI Normal State switches to On.
Delay Timer
BI Input
2. Fan Is Commanded On but the Fan Is Not Working - In the following figure, the fan is commanded on but
does not turn on due to a problem. In this case, the BO commands the Fan On, the Normal State of the BI
changes to On, and the Reference Delay Time starts. However, the Input Reference of the BI never changes to
On because the Fan does not turn on. Therefore, the Alarm State: Report Delay Timer never starts. After the
interval set by the Alarm State: Reference Delay Time, the BI goes into an Alarm condition.
156
Callout Name
User Action
BO Command
BI Normal State
Alarm State: Reference Reference Delay Timer interval starts when BI Normal State switches to On.
Delay Timer
BI Input
BI Input does not turn On during the Reference Delay Timer interval due to problem with
Fan.
After Reference Delay Timer interval. BI is analyzed and goes into Alarm.
Notes
Initial
Value
Values/
Tailored Global SCT
Options/Range Summary Modify3 Configuration
2
4
Pick
Attribute
Reference
Name
Text
CW
Maximum 400
characters
157
Notes
Description
Text
CW
Object Type
Analog
Alarm
Present Value
Normal
Initial
Value
Values/
Tailored Global SCT
Options/Range Summary Modify3 Configuration
2
4
Pick
Attribute
Maximum 40
characters before
Release 8.0.
Maximum 64
characters at
Release 8.0 and
later.
Y
Normal,
Low Warning,
High Warning,
Low Alarm,
High Alarm
Input
Real value
Alarm State
Event Enable
True or False
CW
True
True or False
CW
False
Report Delay
Number
CW
Enabled
True or False
True
Reliability
Multistate
Time
Time
Date
Date
Error Log
Structure
Y
065,535
seconds
Status
Y
Input
Uses Reliability
Unreliable (Set 503).
Alarm/Warning Thresholds
High Alarm Limit
Attribute
Reference
Null
Real value
CNW
Cooling Setpoint
Number
CNW
Null
Heating Setpoint
Number
CNW
Null
Real value
CNW
Setpoint Reference
Attribute
Reference
CW
Null
Warning Reference
Real value
CW
0.00
158
Notes
Initial
Value
Values/
Tailored Global SCT
Options/Range Summary Modify3 Configuration
2
4
Pick
Attribute
Attribute
Reference
CW
Null
Heating Setpoint
Reference
Attribute
Reference
CW
Null
CW
Null
Unoccupied State
CW
Set redirected to
Unoccupied_Set
Attribute
0.00
Positive value
Multistate
Engineering Values
Item Reference
Text
Version
Number
Input Reference
Attribute
reference
Differential
Real value
CW
Real value
CNW
Positive value
Real value
CNW
Positive value
Reference Delay
Timer Active
True or False
False
CW
065,535
seconds
False
False
Y
Y
Alarm Setup
Alarm Ack Pending
True or False
True or False
Alarm Time
Time
Alarm Date
Date
Alarm Priority
Number
CW
CW
False
False
Warning Ack
Required
True or False
Warning Time
Time
Warning Date
Date
Warning Priority
Number
CW
70
CW
120
159
Notes
CW
Initial
Value
Values/
Tailored Global SCT
Options/Range Summary Modify3 Configuration
2
4
Pick
Attribute
False
False
Normal Time
Time
Normal Date
Date
Normal Priority
Number
CW
CNW
Text
Graphic
Graphic Alias
Text
200
Null
CW
Object Type =
Graphic
Maximum 256
characters
BACnet
Object Name
Text
False
Text
Y
Y
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Extensions Reliability, W - Writable
Y - Can be used in the Tailored Summary User View. See the Defining User Views with Summary Definitions section for
information about recommended groupings of Summary Definitions in a Tailored Summary.
Y - Can be mass edited from a Tailored Summary or Global Search Results.
Y - Viewable in SCT Alarm Extension Focus Window.
160
Alarm Time
Indicates the last time this extension transitioned into the Alarm state. Each time this transition occurs, a message
is created and this time is updated.
Cooling Setpoint
Indicates the actual monitored Cooling Setpoint value based on the Setpoint Reference mapping. You can either
define the Cooling Setpoint and High Alarm Limit or the Setpoint Reference.
Cooling Setpoint Reference
When specified, indicates the Above Setpoint limit. You must define both the Cooling Setpoint Reference and
Heating Setpoint Reference, or leave both blank. If the Cooling Setpoint Reference is defined, the High Warning
Offset is added to the Cooling Setpoint Reference value to calculate the High Warning Limit.
The Heating and Cooling Setpoint References are typically mapped to the Actual Heating and Cooling Setpoints
created for all FEC based VAV and Terminal Unit control applications. The High and Low Warning Offsets are added
to these references to calculate the High and Low Warning Limits. These reference points are used in conjunction
with the Room Control Module Graphics Symbol to provide indication of above and below setpoint conditions.
Date
Indicates the date of the last change in the Present Value or Reliability reported by this extension.
Differential
Specifies a deadband range used for analog object state transitions from High Alarm Limit, Low Alarm Limit, High
Warning Offset, and Low Warning Offset. If the Differential is applied to an object in High Alarm, the object remains
in the state until it changes to a value less than the High Alarm Limit minus the value of the Differential.
When the Cooling Setpoint and the Heating Setpoint are configured, the Differential specifies:
The deadband range for transitions to the Above and Below Setpoint states.
The deadband range for transitions from Above and Below Setpoint states to return to a Normal state. In this
case, half of the value specified for the Differential is used. This allows the value to return to normal in cases
where the control algorithm controls to a value close to the setpoint, but may not achieve or cross the setpoint.
Event Enable
Determines if an alarm condition is reported back to the event viewer and if alarm pop-ups are created.
Graphic
Indicates the graphic associated with the extension.
Note: Do not set the Graphic attribute for an alarm extension to an aliased graphic. Aliased graphics do not display
properly when displayed from the Alarms Window or Event Viewer.
Graphic Alias
Indicates a portion of the graphics item reference, up to and including the name of the folder containing this extension
or the controller containing this extension.
161
Heating Setpoint
The Heating and Cooling Setpoint References are typically mapped to the Actual Heating and Cooling Setpoints
created for all FEC based VAV and Terminal Unit control applications. The High and Low Warning Offsets are added
to these references to calculate the High and Low Warning Limits. These reference points are used in conjunction
with the Room Control Module Graphics Symbol to provide indication of above and below setpoint conditions.
You can either define the Cooling Setpoint and Low Alarm Limit or the Setpoint Reference.
Heating Setpoint Reference
Indicates the value of the Below Setpoint limit. You must define both the Cooling Setpoint Reference and Heating
Setpoint Reference, or leave both blank.
High Alarm Limit
Specifies the actual High Alarm Limit. If blank, the limit is not used.
High Warning Offset
Indicates the value added to the Warning Reference or Setpoint Reference variable to determine the actual High
Warning Limit. If blank, the offset is not used and warning analysis is disabled. Both the High Warning Offset and
Low Warning Offset must be defined, or both must be blank.
Input
Indicates the last value received from the Input Reference.
Input Reference
Specifies the object and attribute monitored by this alarm extension. The reliability of the Input Reference is monitored
and sets the Reliability attribute of this extension. It also can be reported in an alarm message.
Low Alarm Limit
Specifies the actual Low Alarm Limit. If blank, the limit is not used.
Low Warning Offset
Indicates the value subtracted from the Warning Reference or Setpoint Reference variable to determine the actual
Low Warning limit. If blank, the offset is not used and warning analysis is disabled. Both the High Warning Offset
and Low Warning Offset must be defined, or both must be blank.
Normal Ack Pending
Indicates if an event in transition to the Normal state is awaiting acknowledgement.
Normal Ack Required
Indicates whether a transition into the Normal state creates a message that requires acknowledgement.
Normal Date
Indicates the last date this extension transitioned into the Normal state.
Normal Priority
Indicates the priority assigned to the Normal state.
Metasys SMP Help: Action Menu
162
Normal Time
Indicates the last time this extension transitioned into the Normal state. Each time this transition occurs, a message
is created and this time is updated.
Occupancy Reference
When mapped, provides a specific graphic preference color indication of a zones occupancy status. When the
reference is in an unoccupied state, warning states are not displayed; only alarm states are displayed. This capability
is typically used in conjunction with the Room Status symbol graphic floorplan.
Present Value
Represents the current value of the extension.
Reference Delay Time
Specifies the amount of time that the Input has to move within the Warning Limits after a Warning Reference change
before the object reports the warning. The Normal state is reported until the Reference Delay Time expires. If the
Reference Delay Time is changed, any current timer is cancelled and reset to the new Reference Delay Time.
Reference Delay Timer Active
The Reference Delay Timer Active is True while the alarm extension waits for the Input value to respond to the
Warning Reference change.
Reliability
Indicates the Reliability of the Analog Alarm extension. Reliability changes due to communication errors between
the Analog Alarm extension and the Input Reference or Setpoint Reference. When unreliable due to communication
problems, any further execution of the main logic of the Analog Alarm extension is cancelled and no report is issued.
The reliability also indicates when the Input or Setpoint Reference becomes unreliable. When reliability changes
due to the Input being unreliable, an event is issued if reporting is enabled. The exception is Comm Loss reliability,
which results in the same behavior as the communication problems described above.
If a Setpoint Reference, High Alarm Limit, and Low Alarm Limit are defined, and the setpoints value is outside of
the range defined by the limits, then the Analog Alarm becomes unreliable and an event message is generated (if
reporting is enabled).
Report Delay
Indicates the number of seconds that the extension waits before generating a warning or alarm after the Input value
moves outside of the Heating or Cooling Setpoint or warning limit. After this time, the Input value is reevaluated. If
the value is still outside the limit, a report generates. Report Delay applies only to changes from the Normal state
to the Alarm state. High or Low Alarms returning to the Normal state are reported immediately.
Report Delay Active
The Report Delay Active is True while the alarm extension waits for the alarm or warning to stabilize.
Setpoint Reference
A Setpoint Reference or Warning Reference is established for controllers that only provide a Single Setpoint value.
The value established by either one of these references is used in conjunction with the High Warning Offset and
Low Warning Offset to establish the High Alarm Warning Limit and Low Alarm Warning Limit.
Metasys SMP Help: Action Menu
163
Status
The Common Object Attributes section details this attribute. Of the three states that can be assumed by this attribute
(Disabled, Unreliable, and Normal), two of these, Disabled and Normal, are managed outside the scope of this
extension. A complete list of relevant states follows (listed in hierarchical order from highest to lowest):
Time
Indicates the time of the last change in the Present Value or Reliability reported by this extension.
Unoccupied State
Indicates the value of the Occupancy Reference (if defined), that is considered the Unoccupied State.
Unoccupied State Set
Indicates the set used to select the Unoccupied State. If Occupancy Reference is defined, the Unoccupied State
Set uses the same value.
Warning Ack Pending
Indicates whether an event concerning a transition into the Warning state is waiting for acknowledgement.
Warning Ack Required
Indicates whether a transition into the Warning state creates a message that requires acknowledgement.
Warning Date
Indicates the last date this extension transitioned into the Warning state. Each time this transition occurs, a message
is created and this date is updated.
Warning Priority
Indicates the priority assigned to the Warning state.
Warning Reference
A Setpoint Reference or Warning Reference is established for controllers that only provide a Single Setpoint value.
The value established by either one of these references is used in conjunction with the High Warning Offset and
Low Warning Offset to establish the High and Low Warning limits.
Warning Time
Indicates the last time this extension transitioned into the Warning state. Each time this transition occurs, a message
is created and this time is updated.
Analog Alarm Extension Examples
The Analog Alarm extension adds the alarming capability for attributes with real values, such as the Present Value
of an Analog Input Object. This extension detects an alarm in two different modes: the Single Setpoint method, or
the Cooling/Heating Setpoint Method.
164
165
166
167
The following table lists the attributes specific to the Multistate Alarm extension. Click the attribute name in the table
for a description of the attribute.
Note: Also, see Status.
Table 76: Multistate Alarm Attributes
Attribute Name
Data Type
Notes
Initial Value
Values/Options/Range
False
False
70
True or False
True or False
Alarm Date
Date
Text
CNW
Alarm Priority
Number
CW
Alarm Time
Time
Alarm Values
Text
Capture Changes
True or False
Command Reference
Attribute Reference CW
Date
Date
Event Enable
True or False
CW
True
Graphic
Object Reference
CNW
Null
Graphic Alias
Text
CW
Input
Real value
Input Reference
Attribute Reference C
True or False
True or False
Normal Date
Date
Normal Priority
Number
Normal Time
Time
Normal State
CW
CW
False
See Command Reference.
False
CW
False
CW
200
CW
State 0
Present Value
DR
Normal
Number
CW
065,535 seconds
False
Reliability
Multistate
Report Delay
Number
CW
True or False
CW
False
Alarm Time
Time
065,535 seconds
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Extensions Reliability, W - Writable
168
169
Graphic
Indicates the graphic associated with the extension.
Note: Do not set the Graphic attribute for an alarm extension to an aliased graphic. Aliased graphics do not display
properly when displayed from the Alarms Window or Event Viewer.
Graphic Alias
Indicates a portion of the graphics item reference, up to and including the name of the folder containing this extension
or the controller containing this extension.
Input
Indicates the multistate value processed for alarms by the extension as defined by the Input Reference. The value
of the Input is compared to the Normal State.
Input Reference
Specifies the object and attribute monitored by this alarm extension. The last value received from Input Reference
is written to the Input attribute. The reliability of the Input Reference is monitored and sets the Reliability attribute
to this extension. It is also reported in an alarm message.
Normal Ack Pending
Indicates whether an event concerning a transition into the Alarm state is waiting to be acknowledged.
Normal Ack Required
Indicates whether a transition into the Normal state creates a message that requires acknowledgement.
Normal Date
Indicates the last date this extension transitioned into the Normal state. Each time this transition occurs, a message
is created and this date is updated.
Normal Priority
Indicates the priority assigned to the Normal state.
Normal Time
Indicates the last time this extension transitioned into the Normal state. Each time this transition occurs a message
is created and this time is updated.
Normal State
Indicates the attribute value to which the Input is compared. If the Input value is different from the Normal State, an
alarm state occurs.
Present Value
Represents the current value of the extension.
Reference Delay Time
Specifies the feedback delay in seconds. The purpose of the Reference Delay Time is to allow time for equipment
to start or stop before the status is compared to the command.
Metasys SMP Help: Action Menu
170
When a Binary Output Object (BO) (supply fan command) is commanded On, the Normal State for the associated
Binary Input Object (BI) (supply fan status) alarm extension is also On. After the Reference Delay Time, the current
state of the BI is compared to the Normal State. If the BI is still Off, an alarm is detected. The Reference Delay Time
is also used when the BO is commanded Off.
Reference Delay Timer Active
The Reference Delay Timer Active is True while the alarm extension waits for the equipment to start or stop.
Reliability
Indicates the reliability of the Multistate Alarm extension. Reliability changes due to communication errors between
the Multistate Alarm extension and the Input Reference or Command Reference. When unreliable due to
communication problems, any further execution of the main logic of the Multistate Alarm extension is cancelled and
no report is issued.
The reliability also indicates when the Input or Command Reference becomes unreliable. When reliability changes
due to the Input being unreliable, an event is issued if reporting is enabled. The only exception is Comm Loss
reliability, which results in the same behavior as the communication problems described above.
Report Delay
Indicates the delay between detecting an alarm and actually reporting the alarm. The purpose of this delay is to
make sure that the alarm is stable. If a status feedback device is fluctuating, an alarm is detected numerous times.
The alarm must be True at the end of the duration of the Report Delay before the alarm is reported.
Report Delay Active
The Report Delay Active is True while the alarm extension waits for the alarm to stabilize.
Status
The Common Object Attributes section details this attribute. A list of relevant states follows (listed in hierarchical
order from highest to lowest):
Time
Indicates the time of the last reported condition.
Alarm Commands
The following table lists the commands supported by the Alarm Extensions feature.
Table 77: Alarm Extension Commands
Command Name
Parameters
None
None
171
Analog Totalization - Tracks and records analog attribute values over time.
Runtime Totalization - Tracks the total time that an attribute resides in a specified state.
For general information on Metasys system objects, see the Object Help section.
For more information on managing time in the Metasys system, see the NAE and ADS commissioning documents
listed in the Related Documentation table in the Welcome section.
Totalization Extensions Concepts
Analog Totalization
The Analog Totalization extension tracks and records the usage of any consumable monitored through an analog
attribute. Some examples of consumables include electricity, gas, steam, and chilled water.
These three essential parameters determine the Analog Totalization extensions mode of operation:
the Low CutOff Value that the input must meet or exceed
Use the Analog Totalization extension to determine the usage of the given consumable. For example, you can
determine the amount of gas or steam used by the facility for a given month. Also, use Analog Totalization to
determine how many kilowatt/hours were used in a week or to totalize a calculated value (for instance, degree days).
For general information on Metasys system objects, see the Object Help section.
For detailed information on the Analog Totalization extension, see Analog Totalization Attributes.
Event Totalization
The Event Totalization extension tracks the number of binary events or pulses over time, meaning it counts the
number of transitions that occur at an input reference. Unlike other types of totalization, event totalization increases
the value each time the event occurs, instead of calculating the value once each minute.
172
These three essential parameters determine the Event Totalization extensions mode of operation:
You can use this extension to determine the number of changes in an input value, which may be helpful in maintaining
and monitoring equipment. For example, use Event Totalization to determine how many times a motor started, how
often a sensor was in alarm, or how many cars entered a parking lot.
For general information on Metasys system objects, see the Object Help section.
For detailed information on the Event Totalization extension, see Event Totalization Attributes.
Runtime Totalization
The Runtime Totalization extension tracks the time that elapses while a designated input, such as a binary or
multistate value, matches a specified state.
These two essential parameters determine the Runtime Totalization extensions mode of operation:
Use this extension to track the amount of time that a piece of equipment, such as a fan or a pump, is operational.
This extension also determines the amount of time a point is in alarm or the runtime of fixed loads (such as lighting)
for energy consumption and tenant billing.
For general information on Metasys system objects, see the Object Help section.
For detailed information on the Runtime Totalization extension, see Runtime Totalization Attributes.
Analog Totalization Attributes
The Analog Totalization extension contains attributes common to Metasys system objects. For details, see Common
Object Attributes.
The following table lists the attributes specific to the Analog Totalization extension. Click the attribute name in the
table for a description of the attribute.
Note: Also, see Status.
Table 78: Analog Totalization Extension Attributes
1
Attribute Name
Data Type
Notes
Initial Value
Values/Options/Range
Display Precision
10ths
Executing
Active
See Executing.
CW
Active
Totalize Limit
Inactive
Input Reference
Attribute reference
Real value
CW
Present Value
Real value
CDRW
173
Initial Value
Values/Options/Range
Reliability
Reliable
False
False
Reset
True
Reset Date
Date
Reset Time
Time
Rollover
True or False
CW
False
False
True
Rollover Count
Number
04,294,967,295
Scale Factor
Real value
CW
1.0
Timebase
CW
Hours
Seconds
Minutes
Hours
Totalize Limit
Real value
CNW
Limit > 0
Units
CW
IP
SI
Real value
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Extensions Reliability, W - Writable
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Active: The extension is calculating and has not reached the Totalize Limit.
Totalize Limit: The extension has reached the limit and has stopped calculating because Rollover is set to
False.
Inactive: The extension is unreliable or disabled and is not calculating.
Input Reference
Specifies the object and attribute monitored by this extension. If this attribute is unreliable or falls below the Low
CutOff Value, totalization is temporarily suspended.
Low CutOff Value
Defines a minimum input value: Values beneath this minimum input value are not totalized. This attribute eliminates
sensor errors associated with the low readings of flow sensors.
174
Present Value
Represents the current value of the extension.
Reliability
Represents the reliability of the Present Value. If the Input Reference becomes unreliable, the totalization extension
monitoring the input becomes unreliable.
Reset
Forces the extension into a reset condition. (Terminates any ongoing calculations, restores the Present Value to
initial state, and for each triggerable attribute, forces a COV report.)
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Reset Date
Represents the date of the last Reset condition of the extension.
Reset Time
Represents the time of the last Reset condition of the extension.
Rollover
Defines the special action the totalization extension must take when the Present Value reaches the Totalize Limit
value. If the Rollover attribute is set to False, the Analog Totalization extension ceases further operation when the
Present Value equals or exceeds the Totalize Limit value. If it is True, it resets the present Value to 0.0 and resumes
a new cycle of totalization.
Rollover Count
When the Rollover attribute is True, this value increases each time Present Value reaches a value equal to or
greater than the Totalize Limit value.
Scale Factor
Indicates the value used to scale the totalized value to either a larger or smaller value than otherwise results.
Status
The Common Object Attributes section details this attribute. Of the three states that can be assumed by this attribute
(Disabled, Unreliable, and Normal), two of these, Disabled and Normal, are managed outside the scope of this
extension. A complete list of relevant states follows (listed in hierarchical order from highest to lowest):
Timebase
Establishes the time frame on which the calculated totalization value is based.
175
Totalize Limit
Defines a threshold value that the Present Value must meet or exceed for the totalization extension to take special
action. When the Rollover attribute is set to False, the totalization process ceases further operation. When it is set
to True, Present Value is cleared to 0, and the totalization process starts over.
Units
Indicates the measurement units of this extension.
Value Before Reset
Indicates the value of the Present Value at the time of the last reset operation.
Event Totalization Attributes
The Event Totalization extension contains attributes common to Metasys system objects. For details, see Common
Object Attributes.
The following table lists the attributes specific to the Event Totalization extension. Click the attribute name in the
table for a description of the attribute.
Note: Also, see Status.
Table 79: Event Totalization Attributes
Attribute Name
Data Type
Flags
Initial Value
Values/Options/Range
Display Precision
CW
1s
Executing
Active
See Executing.
Active
Totalize Limit
Inactive
Input Reference
Attribute reference
Present Value
Real value
CDRW
Reference
CW
Reliability
Reset
True or False
State 0
Reliable
False
False
True
Reset Date
Date
Reset Time
Time
Rollover
True or False
CW
False
False
True
Rollover Count
Number
RW
04,294,967,295
Scale Factor
Real value
CW
1.0
CW
States
States Text
176
Flags
Totalize Limit
Real value
CNW
Transition
CW
Units
CW
Initial Value
Values/Options/Range
Entering State
Entering State
Count All
IP
SI
Real value
Real value
1
2
CW
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Extensions Reliability, W - Writable
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Active: The extension is calculating and has not reached the Totalize Limit.
Totalize Limit: The extension has reached the limit and has stopped calculating because Rollover is set to
False.
Inactive: The extension is unreliable or disabled and is not calculating.
Input Reference
Specifies the object and attribute totalized by this extension. If this attribute is unreliable, totalization is temporarily
suspended.
Present Value
Represents the current value of the extension.
Reference
Defines the value that is processed for totalization by the extension as defined in the Input Reference attribute.
Reliability
Represents the reliability of the Present Value. If the Input Reference becomes unreliable, the totalization extension
monitoring the input becomes unreliable.
Reset
Forces the extension into a reset condition. (Terminates any ongoing calculations, restores the Present Value to
initial state, and for each triggerable attribute, forces a change of value (COV) report.)
This attribute does not appear in a view, but may be scheduled, trended, and so on.
177
Reset Date
Represents the date of the last Reset condition of the extension.
Reset Time
Represents the time of the last Reset condition of the extension.
Rollover
Defines the special action the totalization extension takes when the Present Value reaches the Totalize Limit value.
If the Rollover attribute is set to False, the Runtime Totalization extension ceases further operation when the Present
Value equals or exceeds the Totalize Limit value. If the attribute is set to True, it resets the present Value to 0.0 and
resume a new cycle of totalization.
Rollover Count
When the Rollover attribute is True, this value increases each time Present Value reaches a value equal to or
greater than the Totalize Limit value.
Scale Factor
Indicates the value used to scale the totalized value to either a larger or smaller value than would otherwise result.
States Text
Indicates the displayed strings for the Present Value.
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Status
The Common Object Attributes section details this attribute. A list of relevant states follows (listed in hierarchical
order from highest to lowest):
Totalize Limit
Defines a threshold value the Present Value must meet or exceed for the totalization extension to take special
action. When the Rollover attribute is set to False, the totalization process ceases further operation. When it is set
to True, Present Value is cleared to 0, and the totalization process starts over.
Transition
Describes the behaviors of the transitions to be counted. If the value is 0, it counts the transition of entering a given
reference. If the value is 1, it counts all state transitions.
Units
Indicates the measurement units of this extension.
Value Before Reset
Indicates the value of the Present Value at the time of the last reset operation.
Metasys SMP Help: Action Menu
178
Notes
Initial Value
Values/Options/Range
Display Precision
CW
10ths
Executing
Active
See Executing.
Active
Totalize Limit
Inactive
Input Reference
Attribute reference
Present Value
Real value
CDRW
Reference
CW
Reliability
Reset
True or False
State 1
Reliable
False
False
True
Reset Date
Date
Reset Time
Time
Rollover
True or False
CW
False
False
True
Rollover Count
Number
RW
04,294,967,295
CW
States
Timebase
CW
Hours
Totalize Limit
Real value
CNW
Hours
Units
CW
No Units
Real value
States Text
1
2
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Extensions Reliability, W - Writable
This attribute does not appear in a view, but may be scheduled, trended, and so on.
179
Active: The extension is calculating and has not reached the Totalize Limit.
Totalize Limit: The extension has reached the limit and has stopped calculating because Rollover is set to
False.
Inactive: The extension is unreliable or disabled and is not calculating.
Input Reference
Specifies the object and attribute totalized by this extension. If this attribute is unreliable or changes from the
Reference (state) to another state, totalization is temporarily suspended.
Present Value
Represents the current value of the extension.
Reference
Defines the value that is processed for totalization by the extension as defined in the Input Reference attribute.
Reliability
Represents the reliability of the Present Value. If the Input Reference becomes unreliable, the totalization extension
monitoring the input becomes unreliable.
Reset
Forces the extension into a reset condition. (Terminates any ongoing calculations, restores the Present Value to
initial state, and for each triggerable attribute, forces a COV report.)
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Reset Date
Represents the date of the last Reset condition of the extension.
Reset Time
Represents the time of the last Reset condition of the extension.
Rollover
Defines the special action the totalization extension takes when the Present Value reaches the Totalize Limit value.
If the Rollover attribute is set to False, the Runtime Totalization extension ceases further operation when the Present
Value equals or exceeds the Totalize Limit value. If it is True, it resets the present Value to 0.0 and resumes a new
cycle of totalization.
Rollover Count
When the Rollover attribute is True, this value is incremented each time the Present Value reaches a value equal
to or greater than the Totalize Limit value.
Metasys SMP Help: Action Menu
180
States Text
Indicates the displayed strings for the Present Value.
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Status
The Common Object Attributes section details this attribute. A list of relevant states follows (listed in hierarchical
order from highest to lowest):
Timebase
Establishes the time frame on which the calculated totalization value is based.
Totalize Limit
Defines a threshold value the Present Value must meet or exceed for the totalization extension to take special action.
When the Rollover attribute is set to False, the totalization process ceases further operation. When it is set to True,
Present Value is cleared to 0, and the totalization process starts over.
Units
Indicates the measurement units of the Present Value, Totalize Limit, and Value Before Reset attributes.
Value Before Reset
Indicates the value of the Present Value at the time of the last reset operation.
Totalization Commands
The following table lists the commands supported by the Totalization Extensions. Click the command name for a
description of the command.
Table 81: Totalization Commands
Command Name
Parameters
Disable
None
Enable
None
Reset
None
Reset Rollover
181
Reset
Terminates any ongoing calculations, restores the present value to its initial state, creates a reset date and time
stamp; and for each triggerable attribute, forces a COV report.
Reset Rollover
Resets the Rollover Count attribute.
Trend Extensions
The Trend Extension monitors and records the changes in the behavior of an individual attribute over time, thereby
assisting you with diagnosing various system-wide behavioral characteristics. The Trend extension collects sample
values at timed intervals or only upon changes in the given value. Trend data is still collected if the object is unreliable.
The Trend extension continues to log data using the previous value preceded by ???, which indicates an unreliable
status.
For example, use a Trend extension to collect data from the Analog Input object of a controller on the N2 Bus, which
reports information such as outdoor air temperature or room air temperature.
Trend extensions are different from Trend Studies because Trend Studies query both the ADS and Engine for
historical data (Trend Extensions query only the Engine).
Note: Although multiple trend extensions can be added to an object on an NxE, these extensions are combined as
a single trend if sent to a Historical Data Repository. This may not yield the expected result. To use multiple
trends on a single object in a Historical Data Repository, create duplicate AV or BV objects that map to the
point in question, then create a new trend on the parallel AV or BV.
For trend performance information, refer to the Metasys System Extended Architecture Overview Technical Bulletin
(LIT-1201527).
For general information on Metasys system objects, see the Object Help section.
Trend Extensions Concepts
Views
There are three views in the Trend Extension: Chart View, Table View, and Definition View.
Table 82: Views
Button
View
Description
Chart View
Table View
Definition View
182
Description
When initially displayed, the Trend Extension view shows the data samples
currently in the local trend buffer. Click the Update button to retrieve and
display new data samples (for example, any trend buffer data later than the
currently displayed samples). The Update button adds the new samples to
the display without removing the old samples.
Note: Gaps may appear in the data if the trend buffer has rolled over since
the last update. If you wish to clear the Trend Extension view and re-display
only those samples currently in the trend buffer, use the Refresh Current Tab
menu option (right-click or Action menu).
(Zoom)
Zoom
(Normal)
Toggles the mouse behavior for the chart between zoom mode and normal
mode.
While in zoom mode:
drag the mouse over an area of the chart to zoom in on that area.
click Zoom to exit zoom mode and restore the mouse to normal mode.
When you exit zoom mode, the chart remains at the current zoom level. Use
the Restore button to fully zoom out on the chart.
Note:
You cannot pan while the mouse is in zoom mode.
You can also zoom and unzoom in normal mode by using the Shift key
and the mouse. To zoom, hold the Shift key down while dragging the
mouse across the chart. To zoom out one level, left-click the mouse while
holding the shift key down.
Restore
Allows you to return to an unzoomed view and switches the mouse back to
normal mode if the charts zoom mode is active.
Pan
Allows you to pan the view of the chart vertically or horizontally by dragging
the mouse across a zoomed chart. Panning is not available for unzoomed
charts or when zoom mode is active. To pan left or right, drag the mouse over
the X-axis. To pan up or down, drag the mouse over the Y-axis.
Points Line
Displays the data using lines and point markers. This is the default.
Area
Bar
Points
Line
183
Opens the Select a Color dialog box and allows you to configure the background color.
Gridlines
Allows you to select what type of gridlines to appear on the chart. You can choose: None, X and
Y, X Only, and Y Only.
Chart Type
Allows you to select what type of chart to display. You can choose: Points Line, Area, Bar, Points,
and Line.
Name
Description
Update
Copy to Clipboard
184
Trend Buffer
The trend buffers reside in the NAE and store the trend samples for the NAE. The number of samples stored in each
individual trend buffer is user-configurable (see Trend Extension Attributes). When the buffer gets full, you can
choose to have the new trends overwrite the old ones or to have the trending stop. Whether the trends are overwritten
or trending stops, you can configure the system to issue an alarm when the buffer gets full. You can also configure
to transfer samples to a configured ADS .
Table 86 shows the relationship between the buffer size and the sample interval. Determine the sample interval, in
seconds, by converting minutes to seconds. Determine the buffer size by examining the interval, in seconds, against
the desired time period size to retain data.
Table 86: Buffer Size and Sample Interval Relationship
Interval Interval
Buffer for Previous Time Period
(Min.)
(Sec.)
1 Hr.
2 Hrs.
4 Hrs.
8 Hrs.
16 Hrs.
1 Day
2 Days
3 Days
60
60
120
240
480
960
1,440
2,880
4,320
120
30
60
120
240
480
720
1,440
2,160
300
12
24
48
96
192
288
576
864
10
600
12
24
48
96
144
288
432
15
900
16
32
64
96
192
288
30
1,800
16
32
48
96
144
60
3,600
16
24
48
72
120
7,200
12
24
36
Trend Sampling
Trend sampling for the trend buffer occurs periodically (samples taken after a set time expires) if you set the Sample
Interval to a value higher than zero. To sample based on COV reporting of the object, set the Sample Interval attribute
to zero. You can stop or start sampling manually (using the Enable or Disable command) or control the start and
stop with Interlocking a Trend Extension or scheduling. With interlocking, the trend samples are taken when a defined
event occurs. If you use the scheduling feature, trend samples are taken at certain times on certain days.
Trend Extension Attributes
Alarm Extensions contains attributes common to Metasys system objects. For details, see Common Object Attributes.
The following table lists the attributes specific to the Trend extension. Click the attribute name in the table for a
description of the attribute.
Table 87: Trend Extension Attributes
Attribute Name
Data Type
Notes
Initial Value
Acked Transitions
Series of True or
False states
CW
Buffer Size
Number
144
15,000
Buffer State
Operational
Real value
Values/Options/Range
CW
185
Notes
Initial Value
Values/Options/Range
Number
CW
3,600
Units = Seconds
Event Enable
Series of True or
False states
CW
True, False
Event State
Set of values
Input Reference
Attribute reference
True or False
CW
Number
Enable
True or False
Logging Type
Log Interval
Number
Notification Class
Number
Normal, Fault
False
0
CW
False
Polled
CW
60,000
CW
CW
Notify Threshold
Number
CW
Notify Type
CW
Events
Record Count
Number
CDW
05,000
See Record Count.
Number
Repository Enabled
True or False
CW
False
Sample Interval
Number
CW
600
0604,800
Units = Seconds
See Sample Interval.
Number
Start Time
Date/Time
Status Flags
Series of True or
False states
Stop Time
Date/Time
CW
True or False
Number
Transfer Setpoint
Trigger
1
05,000
CW
False
Number
CW
15,000
True or False
CW
CW
186
187
188
Record Count
Represents the number of samples recorded since the creation of the trend extension or the last time the buffer was
cleared, when the Stop When Full attribute is set to True.
Represents the position of the next sample recorded, when the Stop When Full attribute is set to False.
A value of zero for this attribute deletes all records in the log buffer and resets Samples Not Sent to ADS and Total
Record Count to zero. If the buffer overflows, the Record Count resets to zero.
Records Since Notify
Indicates the number of records collected since the last notification occurred or since logging began if no notification
occurred.
Repository Enabled
Enables transferring of the trend sample data to the ADS/ADX when this attribute is set to True and the buffer fills
to the level specified by the Transfer Setpoint attribute.
Note: If you create multiple trend extensions on a single point and send it to a Historical Data Repository, then
setting Repository Enabled to true causes the Trend Viewer and/or Trend Study to display a combination of
15-minute and 1-minute samples. If Repository enabled is set to False then the Trend viewer displays only
the data from the selected Trend Extension. To use multiple trends on a single object in a Historical Data
Repository, create duplicate AV or BV objects that map to the point in question, then create a new trend on
the parallel AV or BV.
Sample Interval
Specifies the periodic time in seconds for which the referenced property is logged. If this attribute is zero, samples
are recorded using COV reporting.
Note:
If you want to take samples on a COV, set the value of this attribute to 0 seconds.
Otherwise, configure the Sample Interval at 60 seconds or higher to prevent loss of trend data and
reduction in performance of the Engine and ADS/ADX devices that receive samples from the configured
trend.
189
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by
BACnet Intrinsic Alarming.)
Fault - True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is True if the Present Value is overridden from the hardware source level.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Stop Time
Specifies the time and date to disable logging. If the Stop Time contains any wildcard values, then the conditions to
disable logging based on time are ignored. Logging is disabled if the Stop Time is prior to the Start Time. When the
Trend object is inactive due to the current time being outside of the Start Time or Stop Time, the Status attribute
reflects this state (assuming it is the highest priority status). A change in the active/inactive state due to the Start
Time/Stop Time value has no impact on the Enable attribute. If the Trend object was disabled due to the Stop Time,
the Trend object attempts to send the trend samples to the server. If you define a Stop Time that is before the Start
Time, the Trend object is disabled.
Stop When Full
Specifies whether logging ceases when the buffer is full. When set to True, logging ceases and all accumulated
samples remain in the buffer.
When set to False, logging continues. If the Repository Enabled attribute is set to False, the previously recorded
samples are overwritten. If the Repository Enabled attribute is set to True and the buffer fills to the level specified
by the Transfer Setpoint attribute, the previously recorded samples are sent to the ADS/ADX . The buffer must be
cleared for logging to continue.
Total Record Count
Represents the total number of records collected by the Trend Extension since creation. When the value of Total
Record Count reaches its maximum possible value of 0XFFFFFFFF, the next value it takes is zero. Once this value
has wrapped to zero, its semantic value (the total number of records collected) is lost, but its use in generating
notifications remains.
Transfer Setpoint
Represents the amount of buffer memory (in number of samples) that must fill before the trend extension requests
a transfer of the current samples to the ADS/ADX for permanent storage. The value cannot be greater than the
buffer size when Repository Enabled is true.
Trigger
Causes the collection of data when changed from False to True, Enable is set to True, and the trend is within the
Start/Stop times. When data collection completes, this attribute resets to False. This attribute does not trigger
Johnson Controls COVs.
Trend Extension Commands
The following table lists the commands supported by Trend Extensions. Click the command name for a description
of the command.
190
Parameters
Clear
None
Disable
None
Enable
None
Execute
None
Route
None
191
Notes
Initial Value
Values/Options/Range
Active Timer set
Active Timer
None
Number
Object Reference
Comfort Override
Inactive
Display Precision
CW
10ths
Display Reference
CW
Duty Window
Number
Eligibility
Event State
Normal, Fault
Number
Input Reference
Attribute reference
Date
Time
Load Locked
True or False
False
Load Priority
Number
CW
10
Load Rating
Array of structures
CW
Enabled
True or False
True
Number
CNW
15
CNW
165,535
0
C
110
165,535
Undefined = 65,535
Units = Minutes
Number
CW
165,535
Units = Minutes
Number
CW
165,535
Units = Minutes
On Release
Present Value
Inactive
Rate Units
kW
Units set
Reliability
Reliable
Number
165,535
Release
Immediately
192
Notes
Initial Value
Values/Options/Range
Shed Command
None
Shed Duration
Number
165,535
Array
Shed Levels
Array
165,535
Shed Status
Released
Shed Ineligibility
Shed Strategy
Time Remaining
Number
CW
Start Time
Structure
Status Flags
Series of True or
False values
Units
CW
CW
IP
SI
193
194
195
Also, consider an example of a three-speed fan that can have the following states: High, Medium, Low, and Off. The
operator decides to set the fan to Low when the Load is shed. In this case, the first Shed from entry is High because
the most energy would be saved when shedding from this state. The second Shed from entry is Medium. A Shed
from entry for Off is not required because no energy is saved by shedding from Off to Low. The entries might look
like this:
Table 90: Load Rating Entries
Shed From
Shed To
Energy Savings
High
Low
5.0 kW
Medium
Low
3.2 kW
Enabled
Indicates whether the Load object responds to shed requests.
Maximum Shed Time
Specifies the maximum number of minutes that a load can be shed before it is automatically released. If the Maximum
Shed Time value is not defined, the default value of 65,535 is used. The range is 0 to 65,535 minutes. It is possible
for the Load to be released before this time. A Load does not remain shed longer than the maximum shed time
unless the load has been locked shed.
196
197
Shed Command
Indicates the current shed/release state of the Load. This attribute also offers the option of shedding or releasing a
Load.
Release - Releases the Load. The On Release attribute determines when the Load is released. If the Load is
already released, there is no change.
Shed - Immediately sheds a released Load regardless of its Minimum On Time. If the Load is already shed,
there is no change.
Shed Duration
Indicates the number of minutes to shed the Load. Writing this attribute to a value less than the current time minus
the Start Time attribute value cancels a shed.
The DLLR object sets this attribute to shed the load. After the shed completes, the Load sets it to zero.
If the Load object sheds via a non-BACnet method, such as the Shed command or Shed Command attribute, it sets
this value to the Max Shed Time and returns it to zero when the shed completes. If no Max Shed Time is defined,
the Load sets this value to its maximum value (0xFFFF), which is the maximum number of minutes that a Load can
shed without being locked shed.
Shed Level Descriptions
Provides a description of the shed level supported by the Load object.
Shed Levels
Specifies the shed levels used for the Requested Shed Level attribute. Set this attribute to a value of one (1) for the
DLLR to automatically shed the Load. If this attribute is set to another value, the DLLR does not shed or release the
Load; although the Load can be shed and released manually or by another feature, and is automatically released
upon expiration of its Maximum Shed Time, unless the Load is locked shed.
Shed Status
Indicates if the Load is shed or released, and, if shed, which strategy was used to shed the Load (DL or LR).
Shed Ineligibility
Indicates whether a load is eligible to be shed at the current time, and, if ineligible, the cause of ineligibility.
Shed Strategy
Indicates which strategy is permitted to shed the Load (DL, LR, or both).
Time Remaining
Indicates how much longer a Load timer is in effect. The Active Timer attribute indicates which timer is in effect.
Start Time
Indicates the date and time that the Load sheds. Writing this attribute to a wildcard releases a shed load.
The DLLR object sets this attribute to shed the Load. Once the shed completes, the Load object sets the value to
date and time wildcards (NONE_FFFF).
If the Load object sheds via a non-BACnet method, such as the Shed command, it sets this attribute to the current
time, and returns it to NONE_FFFF after the shed completes.
Metasys SMP Help: Action Menu
198
Status Flags
Indicates the general status of the object in BACnet terms and contains four independent states.
The four flags are:
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by
BACnet Intrinsic Alarming.)
Fault - True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is True if the Present Value is overridden from the hardware source level.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Units
Indicates the measurement units of this extension.
Load Commanding
Objects with a Load extension and intended for use with the DLLR feature permit the following operator or scheduled
commands.
Table 91: Commands Available to Load Objects
Command
Parameters
Shed
Type
Percent, Level, or Amount
Value
New shed value
Description
Sheds the load immediately. The output is written at priority 13
(LR) if the loads Shed Strategy is set to Load Rolling Only.
Otherwise, it is written at priority 11 (DL). When this command is
issued, the output is commanded regardless of whether DLLR is
in Shed or Monitor Only mode.
Select only the Level command and use the default value of 1.
The Percent and Amount command options are intended for future
use.
Release Load
None
Comfort Override
Release Immediately
Release Comfort
Override
None
Lock
None
Locks the load in its current shed or released state. The load
remains in this state until an Unlock (or Disable) command is
issued.
Unlock
None
Releases a Lock command. If the load was locked shed and its
Maximum Shed Time expired, it now releases.
199
Description
Disable
None
Enable
None
Explanation
Shed
Shed
Shed + Locked
Comfort Override
or
Release Load
Comfort Override
Shed
Released + Locked
Shed
Released + Locked
Shed
and
Comfort Override
200
Notes
Date
Date
File Name
File Size
Number
Information
Text
CW
Initial Value
Values/Options/Range
Category = File
See the File Name section.
0
Units = Bytes
Size = 80
Category = Default
Time
1
Time
Values/Options/Range
Exportable
True or False
Object References
Object reference
References
True or False
Relative Path
Text
False
False
Size = 100
Category = Default
201
Attempted Samples
COV Increment
Notes
Initial Value
Values/Options/Range
Real value
DR
NaN
Number
Real value
CW
Display Precision
Input Reference
Maximum Value
CW
Attribute reference
Real value
100ths
-INF
Invalid DateTime
202
Notes
Initial Value
Values/Options/Range
INF
Invalid DateTime
Reliable
No Units
3,600
Units = seconds
Real value
Reliability
Units
Valid Samples
Window Interval
Number
Number
CW
Range: 900360,060
Window Samples
1
2
3
4
Number
CW
15
Range: 2200
203
Input Reference
Defines the object and attribute pair to be sampled. The sampled object must be on the same device as the Averaging
object.
Maximum Value
Indicates the highest value of the valid samples in the buffer. After Attempted Samples, Window Samples, or
Window Interval is written, until a sample is taken, this attribute is set to -INF with its Reliability set to Unreliable.
Max Value Timestamp
Indicates the date and time that the Maximum Value has changed in the sampling buffer.
Minimum Value
Indicates the lowest value of the valid samples in the buffer. After Attempted Samples, Window Samples, or Window
Interval is written, until a sample is taken, this attribute is set to -INF with its Reliability set to Unreliable.
Min Value Timestamp
Indicates the date and time that the Minimum Value has changed in the sampling buffer.
Object Property Ref
Designates the particular object and attribute referenced by the Averaging object. This is a BACnet Device Property
Reference structure type attribute that specifies bind information from the object/attribute defined by the Input
Reference attribute. The binding information consists of the Device Identifier, Object Identifier, Array Index, and
Property Identifier of the trended property. An on-box object returns nothing for the Device Identifier. The Device
Object configures this attribute during object creation. Changing Object Property Ref may change Input Ref, and
changing Input Ref may change Object Property Ref. Since Object Property Ref is based on Input Ref, and Input
Ref does not support Array Index, Object Property Ref does not support Array Index either.
Reliability
Indicates whether the Average Value, Minimum Value, and Maximum Value attributes are Unreliable. After Attempted
Samples, Window Samples, or Window Interval is written, until a sample is taken, this attribute is set to Unreliable.
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Units
Indicates the units of the mapped attribute of the extended object. Average Value, Minimum Value, and Maximum
Value use the same units.
This attribute does not appear in a view, but may be scheduled, trended, and so on.
Valid Samples
Indicates the number of samples in the sampling buffer that are valid. A sample is marked invalid if a read error
occurs when reading requested attributes from the host object. The number of invalid samples can be determined
by subtracting Valid Samples from Attempted Samples. If the difference is greater than zero, it indicates an error
during sample collection. After Attempted Samples, Window Samples, or Window Interval is written, until a sample
is taken, this attribute is set to zero.
204
Window Interval
Indicates the period of time in seconds over which the Minimum Value, Maximum Value, and Average Value are
calculated. Samples are taken at a specific sample rate, which cannot be less than 4 seconds. The sample rate is
calculated by dividing the Window Interval by the number of samples as defined in the Window Samples attribute.
The default value is 3,600 seconds.
Window Samples
Indicates the number of samples to be taken during the Window Interval and saved to the local sampling buffer. A
maximum of 200 samples can be saved. After reaching the limit, the oldest samples in the buffer are overwritten
with the newest samples. If the sampling rate is not a whole number, it is rounded up to the nearest integer.
Averaging Commands
The following table lists the commands supported by the Averaging Extensions. Click the command name for a
description of the command.
Table 96: Averaging Extension Commands
Command Name
Parameters
Enable
None
Disable
None
Clear
None
205
2. Select New for the type of extension that you want to create. The corresponding Extension Wizard appears.
3. Select the attribute that you want to associate with the item.
4. Complete the information on the wizard screens. The screens vary depending on the type of extension you are
creating.
5. Select Finish on the summary page to create the extension.
Editing Extensions
Note: You cannot edit an extension in online mode with Basic Access.
To edit extensions:
1. View the extension.
2. Select the tab for the extension.
3. Select the extension you want to edit.
Note: For trend extensions, make sure you select the Definition View button to display the trends attributes.
4. Click Edit.
5. Make your changes.
6. Click Save.
Copying and Pasting Extensions
Note: You can perform this procedure only in the System Configuration Tool (Offline Mode). You must first create
extensions before you can copy and paste them from one item to another. See Creating Extensions for details
on how to create extensions.
To copy and paste existing extensions:
1. Select the item from the Navigation Tree that contains the existing extensions that you want to copy, and select
Show Extensions from the Action menu. The Extension wizard appears.
2.
3.
4.
5.
Note: Alternatively, you can right-click the item in the navigation tree and select Show Extensions from the
menu that appears.
Select the check box for one or more of the existing extensions that you want to copy.
Click Copy Checked Extensions.
Click Done.
Select the item from the navigation tree that you want to receive the copied extensions, and select Paste from
the Edit Menu.
Note: Alternatively, you can right-click the item in the navigation tree and select Edit > Paste from the menu
that appears.
When you paste an extension, the extension retains the name of the copied extension and appends it with a
number.
Deleting Extensions
Note: You cannot delete an extension in online mode with Basic Access.
Note: For a trend extension that is configured to automatically transfer data to an ADS/ADX (Repository Enabled
= True), be sure to route unforwarded data to the ADS/ADX before deleting the trend extension. If you do
not, unforwarded trend data is lost.
1. To delete extensions (using the Navigation Tree):
Metasys SMP Help: Action Menu
206
a. Select the item from the navigation tree and select Show Extensions from the Action menu.
b. Select the check box of the extension you want to delete.
c. Click Delete.
2. To delete extensions (when the item is in the Panel Layout):
a. View the extension.
b. Select the tab for the extension.
c. Select the extension.
d. Click Delete.
Searching for Extensions
You can search for Alarm, Trend, or Totalization extensions using the Global Search feature. This allows you to find
up to 100 extension objects and view their current values.
Commanding Extensions
You can command Alarm, Trend, or Totalization extensions from an Extension View or from the Global Search
Viewer. You can also command Trend extensions from a Trend Viewer or Trend Study view.
Single Extension
To command a single extension object:
1.
2.
3.
4.
207
Discard
Menu Selection: Action > Discard
Discards the selected events currently displayed in the Event Viewer. Discards selected entries from the audit log
when the Audit Viewer is displayed.
Refresh
Menu Selection: Action > Refresh
Refreshes the data displayed in the active frame or panel in the Event Viewer, Audit Viewer, Trend Viewer, and
Scheduled Reports.
Ack
Menu Selection: Action > Ack
Acknowledges the selected event(s) currently displayed in the Event Viewer.
Import Integration
Menu Selection: Action > Import Integration
This command is only available when an Integration under an engine is selected in the All Items tree. After adding
an Integration, you can select the integration in the navigation tree and use this menu selection to add existing
devices and points under the integration.
Insert Menu
Click one of the following menu items for a description of the menu item. For more information on the modes of
operation, see Metasys Modes. For a description of the Authorized Required column, see Authorized Menu Items.
Table 97: SMP Insert Menu
Menu Item
Mode Visible In
Online (Standard
Access)
Online (Basic
Access)
Authorization
1
Required
Integration
Field Device
208
Mode Visible In
Online (Standard
Access)
Online (Basic
Access)
Authorization
1
Required
Field Point
Folder
Control System
Object
Graphic
Trend Study
User View
Summary Definition
X
1
System Access-Based Privileges gives users with Standard Access the following privileges: Access to SCT, Configure and
Simulate using the SCT, Passthru mode, and Import Integration. Gives users with Basic Access permission to use Passthru
mode. Basic Access and Tenant Access users do not have access to the SCT.
In online mode with Basic Access, the Insert Object wizard is limited to the Schedule and Calendar objects.
Site
Menu Selection: Insert > Site
Inserts a site into the archive database in the SCT.
Tip: The Create Device? dialog box appears after inserting a site asking if you want to create a device in the site.
Selecting Supervisory Device and clicking OK invokes the Insert Device wizard. Selecting Metasys Server
and clicking OK invokes the Insert Metasys Server wizard. Select None and OK if you do not want to add a
device at this time.
See one of the following sections for more information:
Related Documentation
Site Object
Site Object
The Site object defines the attributes that represent the characteristics of a site. If the Site object exists on a device,
that device is considered a Site Director. Starting at Release 6.5, the Remote Services Connection tab of the Site
object provides the capability to connect and communicate with the cloud-based platform.
Note:
In SCT, a Site object may exist without a Site Director. In this case, you can open the edit window and
make changes to the custom authorization category; however, you cannot save any changes until you
add a Site Director.
When promoting or demoting a Site Director offline in SCT, the custom categories are rebuilt using their
default settings.
If you need to change the name of the Site object, make sure you first close all user views. This action
ensures that all object references throughout the site reflect the new Site object name.
For general information on Metasys system objects, see the Object Help section.
209
Site Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
For information on the Custom Enumeration tab, see User Defined Enumeration Editor Tab.
Table 98: Site Object Attributes - Site View Tab
1
Attribute Name
Initial Description
Notes
Value
All Items Update in
Progress
CW
False
140
Specifies the value that represents the range of alarm priority thresholds.
The default value is 140. This attribute is checked when determining
whether an event requires annotation on an ADX MVE installation. If the
Event Priority value is below the threshold, annotation is required. This
attribute appears only when you have MVE installed.
For more information, refer to Metasys for Validated Environments,
Extended Architecture Technical Bulletin (LIT-12011327).
Annotation Exclude
CW
Annotation Include
CW
CW
Unicode Specifies the type of string encoding to use in BACnet messages. Unicode
(0)
should be specified unless third-party BACnet devices are employed on
the site. In this case, specify the BACnet encoding type supported by the
third-party BACnet devices. This attribute is automatically distributed to
the site devices.
For information on how to set up an NAE as a BACnet system integrator
in a Metasys system network, see the Related Documentation table in
the Welcome section.
210
CW
False (0) Specifies whether specific information from the BACnet device for each
Metasys object is shown in the UI. When true, BACnet information
integrates into the UI for objects. When false, the information is omitted.
Internally, the BACnet protocol is used at a certain level regardless of this
attribute. This attribute is distributed automatically to site devices.
For information on how to set up an NAE as a BACnet system integrator
in a Metasys system network, see the Related Documentation table in
the Welcome section.
Broadcast Disabled
Default Language
CW
False
CW
CW
20
CW
255
Allows you to specify the priority of an event that triggers the Engine to
connect (dial-up or LAN connection) to the defined ADS/ADX or ODS and
deliver the event messages from the Engine local event repository to the
event repository of that ADS/ADX or ODS. This attribute is used for Alarm
and Event Management only.
For example, a value of 20 for this attribute means that any event having
a priority of 20 or higher (1 is highest) forces a connection to the ADS/ADX
or ODS and forwards event messages from the Engine local event
repository to the event repository of that ADS/ADX or ODS.
LAN
12:15
AM
CW
Note: All Metasys devices that are part of the Site use the time zone they
are located in.
211
0.0.0.0
CW
Central
Time
Specifies the sites default time zone. The Site object determines and
updates the UTC offset from this value. Once set in the Site object, the
time zone is propagated to the other devices on the site.
(US and
Canada) Note: All Metasys devices that are part of the Site use the time zone of
the Site Director, even if some of those devices are physically located in
a different time zone.
Device Time Servers
CW
This attribute is used only for Windows time synchronization. Leave this
attribute blank if you are not using Windows time synchronization. Specifies
a list of resolvable host names or IP addresses of Simple Network Time
Protocol (SNTP) server devices that the devices on the site (except the
Site Director) use as their time server.
Periodically, each device on the site (except the Site Director) attempts
to sync time from an SNTP server from this list. Contact with an SNTP
server is attempted one at a time in list order until one successful contact
is made.
A host name may be specified only if a DNS server is available to the site
server. If the site server is also an SNTP time server, the site server may
be specified in this attribute. This attribute is distributed automatically to
the site devices.
Note:
The NxE, ADS, ADX, or ODS designated as the Site Director is the
device time server for the site and provides the time management for
all other engines/servers on the site.
212
True
0
CW
Indicates amount of memory used by the created auto and custom sets.
Specifies an XML file containing site organization data within the file
system of the host computer. This attribute appears only in the Snapshot
Focus view.
Multicast Heartbeat
Interval
CW
Multicast TLL
CW
CW
123
Specifies the UDP port on which multicast time synchronization polls and
listens for messages. The RFC-2030 defined standard port is 123.
Poll Rate
CW
Fast
1000
256
Security Level
CW
Medium Specifies the security level to be used by this device. This attribute is
(1)
distributed to the site's devices automatically.
This attribute appears only in the Snapshot Focus view. Valid options
include:
213
140
Specifies the value that represents the range of alarm priority thresholds.
The default value is 140. This attribute is checked when determining
whether an event requires electronic signature on an ADX MVE installation.
If the Event Priority value is below the threshold, a signature is required.
This attribute appears only when you have MVE installed.
For more information, refer to the Metasys for Validated Environments,
Extended Architecture Technical Bulletin (LIT-12011327).
Signature Exclude
CW
Signature Include
CW
Site Director
CW
CW
0.0.0.0
214
CW
Address-UDP Port: Use the BACnet UDP Port address. The default
is 47808.
CW
215
CW
Warning Banner
CW
Specifies the interval at which the Site Director polls the defined site time
server (STS) (for example, the Atomic clock) for the time. We recommend
leaving the default value for this attribute. This attribute applies only to
the Engine.
False
1
2
C - Configurable, W - Writable
This attribute appears only in the Snapshot Focus view.
Table 99: Configuring Metasys System Devices in the Third Party BBMD List
Field
Description
Address-UDP Port
Address-IP
Ip Broadcast Mask
Note: The changes made to labels on Authorization Category in the Site object are shown in the Security
Administrator screens. Refer to the Authorization Category Assignment section of the Security Administrator
System Technical Bulletin (LIT-1201528) for more information on changing Object Categories labels and
how these changes affect the UI.
Table 100: Site Object Attributes - Object Categories Tab
Authorization Category
Display Text
1
HVAC
Fire
Fire
Security
Security
Services
Services
Administrative
Administrative
General
General
Lighting
Lighting
Refrigeration
Refrigeration
Critical Environment
Critical Environment
Air Quality
Air Quality
Power
Power
Energy
Energy
System
System
216
Supervisory Device
Menu Selection: Insert > Supervisory Device
Inserts a supervisory device: NAE35, NIE39, NAE45, NAE451L, NIE49, NAE55, NIE59, NAE85, NIE89, NCE25,
NIE29, NIE55, or NIE85 into the archive database in the SCT. You can insert a device at a previous Metasys system
release, beginning with Release 5.2 and later.
Note: Some products or models mentioned in this document are available only to specific markets. Refer to the
Application and Data Server (ADS) Lite for Europe (E) Product Bulletin (LIT-12011690) and the Application
and Data Server (ADS) Lite for Asia (A) System Product Bulletin (LIT-12011694) for availability.
On the Configure screen of this wizard, click any tabs that may appear for further device configuration.
See one of the following sections for more information:
Related Documentation
This object allows you to see data about the controller, such as the IP address and the current date and time.
For general information on Metasys system objects, see the Object Help section.
Engine Concepts
Flash Memory
A type of nonvolatile memory within the Engine device. The Engine stores the operating system, software, and
archive within this memory. This memory is not used during normal operation of the Engine device, except when a
new graphic is added and the new image is uploaded and stored. The flash memory is mostly used during shutdown
and system restart.
Metasys SMP Help: Insert Menu
217
Operating System
Engines use a Microsoft Windows operating system (specific operating system (OS) depends on the model), which
is shipped preinstalled on the Engine. In general, the operating system cannot be modified by adding or deleting
programs or drivers, although provisions are made to install factory-authorized patches and upgrades.
Software
The software is the Johnson Controls programs used in the Engine, also preinstalled at the factory. This includes
graphics, trending, logic, alarm, and other programs. Provisions are made for both the software and the operating
system to be upgraded at the job site when new revisions of Metasys Engine software are available.
Database
The database is the collection of objects and their parameters as defined by the user. Each database is unique to
the job. A database can be created or edited (with appropriate user authority) either online using the Site Management
Portal UI, or offline using the SCT. SCT can also be used to download a database or upload and create a backup
copy of the database.
Archive
A copy of the database, called the archive, is kept in each Engines flash memory. This happens automatically once
a day or on operator command. Following restoration of power loss to an Engine, the archive is copied into main
memory to restore normal operation.
Engine Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
218
CW
When this attribute is enabled and a server repository is configured, all events
acknowledged or discarded at a site NxE are forwarded to the ADS/ADX/ODS repository.
This includes:
Events and BACnet intrinsic alarm notifications generated by the NxE and
acknowledged by a user logged into the NxE SMP.
BACnet intrinsic alarm notifications received by a site NxE that are acknowledged
at a BACnet device and acknowledged by the NxE without a user id and forwarded
to the repository.
Specifies the time of day when a connection should be established to the ADS/ADX/ODS
(determined by the ADS Repository attribute). A connection is attempted at a minimum
of once a day at the specified time to deliver audit, alarm, and trend data to the
ADS/ADX. If a value is specified, it overrides the value of the Default ADS Delivery
Time attribute. If no value is specified, the value of the Default ADS Delivery Time
attribute is used (Default ADS Delivery Time is a site level setting sent out to the sites
devices). ADS Delivery Time is ignored if no ADS/ADX/ODS is defined for this site.
CNW
219
This attribute is used for alarm and event management only. The ADS Priority Threshold
attribute allows you to specify the priority of an event that triggers the Engine to connect
(dial or LAN connection) to the defined ADS/ADX/ODS and delivers the event messages
from the Engine local event repository to the ADS/ADX/ODS event repository without
waiting for the ADS Delivery Time.
For example, a value of 20 for this attribute means that any event having a priority of
20 or higher (events of higher alarm priority have lower alarm priority numbers) forces
a connection to the ADS/ADX/ODS and forwards event messages from the Engine
local event repository to the ADS/ADX/ODS's repository.
ADS Repository
CNW
Specifies the ADS Repository device. The ADS/ADX/ODS is the device to which local
audit, alarm, and trend data is delivered. Repository refers to the three files in the
ADS/ADX/ODS that store this data. If a value is specified, it overrides the value of the
Default ADS Repository attribute of the site. If no value is specified, the value of the
Default ADS Repository attribute is used (Default ADS Repository is a site level setting
sent to the sites devices).
Note: If the Engine uses a dial-up connection to transmit data to the ADS/ADX/ODS,
then the ADS Repository must be the first IP address listed in the range specified when
configuring the ADS/ADX/ODS to Allow Incoming Connections (see External Modem
Config).
The Default ADS Repository of the Site is intentionally left blank and must be updated
by the user (online or offline). If the user does not populate the Default ADS value and
leaves the Default ADS Repository value for all devices at 0.0.0.0, the ADS/ADX/ODS
does not receive any audit, alarm, or trend data. The SCT does not automatically
populate the Default ADS Repository value because of the many different possibilities
that could exist during archive creation, including multiple ADS/ADX/ODS on a site or
no ADS/ADX/ODS for a site. In these cases, it is not immediately clear which
ADS/ADX/ODS should be the default ADS/ADX/ODS under the Site object.
Specifies the maximum number of alarms that can be maintained on the local device.
Specifies the amount of time to delay after an operator temporarily ignores, or snoozes
an alarm before re-announcing the alarm.
CW
Align Intervals
CW
Indicates the maximum number of times that an Application Layer Protocol Data Unit
(APDU) (as specified by the BACnet device) is retransmitted. If the device does not
perform retries, it is set to zero. If the value is greater than zero, a nonzero value appears
in the APDU Timeout attribute. If you write the value of this attribute, you must reset
the Engine for the new settings to take effect.
APDU Segment
2
Timeout
CW
APDU Retries
If you write the value of this attribute, you must reset the Engine for the new settings
to take effect.
APDU Timeout
CW
220
Identifies the version of the application software installed in the device. The content of
this string is locally defined (date-and-time stamp, a programmers name, a host file
version number, and so on).
Archive Date
Indicates the date of the last successful archive of object instances. The value of this
attribute is valid when a valid archive exists and during the archive download process.
The value of this attribute is *.*.*.* at all other times.
Specifies the operation of the audit trail feature when the audit repository is full. If the
value is Stop, additional audit entries are discarded. If the value is Rollover, additional
audit entries replace the oldest audit entries.
Audit Forwarding
Threshold
Specifies the size limit of the audit repository (as a percent of the audit repository size)
at which the system attempts to deliver audit entries to the ADS/ADX/ODS. This attribute
applies only if an ADS/ADX/ODS device has been defined for the site. When the Audit
Forwarding Threshold is reached, all audits in the Local Audit Repository that have not
been forwarded are forwarded to the defined ADS Repository.
CW
Specifies the maximum number of audit trail entries that can be maintained on the local
device.
BACnet
Communications
Password
CW
CW
Specifies the UDP port number used to communicate with other BACnet devices over
the IP network. This value allows multiple BACnet networks on a single IP network and
prevents communication between the multiple BACnet networks.
BACnet IP Port
If you write the value of this attribute, you must reset the Engine for the new settings
to take effect.
Specifies the BIOS version in the Engine. The format of the basic input/output system
(BIOS) version is <V><major release>.<minor release>. For example: V2.02.
BIOS Version
For NAE55/NIE55, if the BIOS version is earlier than V2.02, update the BIOS using the
BIOS Update Utility. This update significantly improves overall product performance.
For information on the BIOS Update Utility, refer to the BIOS Update Utility Technical
Bulletin (Part No. 24-10110-42).
Database Revision
Specifies a logical revision number for the devices database. Database Revision is
incremented when an object is created or deleted, an object name changes, or a restore
is performed.
W
DST Status
Indicates whether daylight saving time is in effect (True) or not (False) at the devices
location.
Duplicate References
Lists references that are duplicated in the system. Entries in this list are object references
that exist on more than one device within the system.
Enable Application
Generated Audits
CW
221
CW
Specifies which level of audit entries are added to the Audit Repository. Only audit
entries of type Level 1 through (and including) the specified level are included. All other
levels are not stored in the audit trail. Level 1 and Level 2 audit entries are always
stored in the audit trail.
Level 1 and 2 (1): Stores all user action and system error audit messages.
Level 3 (2): Stores application audit messages in addition to Level 1 and 2 auditing.
Level 4 (3): Stores system audit messages in addition to Level 3 auditing.
Level 5 (4): Stores diagnostic audit messages in addition to Level 4 auditing.
CW
Firmware Version
Specifies the operation of the Alarm and Event Management feature when the event
repository is full. If the value is Stop, additional event entries are discarded. If the value
is Rollover, additional event entries replace the oldest event entries.
Represents the release of firmware installed in the main code section of the device.
The first digit in the revision number is advanced on major releases. The second digit
is advanced on minor releases.
CW
Provides a list of structures with the following elements: Network Number, Device ID
High Limit, and Device ID Low Limit. The first set of Who-Is messages is broadcast
once the device reaches the Enable Field Commands phase of startup. At this time, a
timer starts running that calls a method to send the Who-Is messages at the period
specified by IEIEJ Function A Period.
IEIEJ Function A
Period
CW
Sets the period at which the IEIEJ Function A List sends the Who-Is message
broadcasts. Clearing the value of this property disables the function A feature. Each
destination is guaranteed to get a Who-Is message within the period specified by this
property; however, if the list contains multiple destinations, the object attempts to spread
out the Who-Is messages so that they are not all sent out at the same instant.
Controls the frequency of communication with remote Ethernet devices. This value is
used by the Ethernet IP Datalink object. Among other communications, this attribute
defines the frequency of the heartbeat to monitored devices (monitored at a rate of two
times the Internode Comm Timer). A change to this attribute does not take effect until
the next Engine restart (cold or warm).
Interval Offset
CW
Specifies the offset, in minutes, from the beginning of the period defined for time
synchronization until the actual time synchronization requests are set. Interval Offset
has no effect when Align Intervals is False.
JCI Exception
Schedule
CW
Indicates how long exception schedules are kept after the exception date has expired.
The default value is Auto Delete 31 days, which is the same behavior prior to this
release. New options are Auto Delete 7 days and Manual Delete.
Note: The NAE (using SCT and online UI) and FAC (at CCT) allows selections for
Manual Delete, Auto Delete 31 days, and Auto Delete 7 days.
Note: Manual Delete is needed for locations like Japan where the local standards state
that only the BACnet workstation can delete exception schedules.
222
SUSPENDED: The device was suspended. How the device was suspended or
what it means to be suspended is a local matter.
Indicates the date to the best of the devices knowledge. The Date type is a series of
four one-number elements.
Local Date
The first number is the year (for example, 2005); the second number is the month (1..12,
1=January); the third is the day of month (1..31). To maintain compatibility with BACnet
protocol, a fourth number contains the day of week (1=Monday). A value of FF *
(asterisk) in any of the elements indicates the value is not specified.
Local Site Director
CW
Specifies a resolvable host name or IP address of the Site Director. A host name may
be specified only if a DNS server or other means of name resolution is available to the
device. A Site Director may have more than one host name. The host name specified
here must be resolvable to an IP address on the LAN or WAN on which the sites
devices exist.
The Local Site Director attribute is based on the Computer Name attribute, not the
Name attribute. When you change the Site Director devices Computer Name attribute,
its Local Site Director attribute automatically changes to match its Computer Name.
When you change a non-Site Director devices Computer Name, its Local Site Director
attribute remains unchanged.
For information designating an Engine as the Site Director, refer to the NAE
Commissioning Guide (LIT-1201519).
Local Time
Location
Indicates the time of day to the best of the devices knowledge. The Time type is a
series of four one-number elements. The first number is the hour (0..23); the second
number is the minute (0..59); and the third number is the seconds (0..59). A fourth
number has been added to maintain compatibility with BACnet protocol and contains
the hundredths of second (0..99). A value of * (asterisk) for any number indicates the
value is unspecified. This value would be used, for example, when the hundredths
value is not important.
CW
CW
Indicates the maximum number of bytes that may be contained in a single, indivisible
application layer protocol data unit. If you write the value of this attribute, you must
reset the Engine for the new settings to take effect.
CW
Specifies the largest piece of data that can be sent to a device at one time, excluding
all communications headers. Some applications need to perform segmentation of data
outside the communications system. This value is used to size the data in those
situations.
Max Segments
Accepted
Model Name
Indicates the device model, the hardware revision associated with the firmware, and
the code file name used to download the device.
CW
Specifies the BACnet network address. A change to this attribute takes effect after the
next Engine restart (cold or warm). If you write the value of this attribute, you must reset
the Engine for the new settings to take effect.
Power Consecutive
Sample
CW
Specifies the number of consecutive AC line status samples (indicate a power loss)
must be received before the device concludes that a power failure has occurred. When
the device concludes that power has failed, the device begins an orderly shutdown
process. The process used for determining whether a power failure has occurred
protects the device from shutting down during short power failures or certain brownout
conditions. Using default values, a power failure of less than 5 seconds does not prompt
a device shutdown.
Power Sampling
Interval
CW
Specifies the period at which the AC line status is sampled to determine whether a
power failure has occurred. This attribute is used in conjunction with the Power
Consecutive Samples attribute.
Process ID List
CW
Contains a list of unsigned 32-bit numbers used to compare the Process ID sent with
the BACnet events. If the event Process ID is not found on this list, then the event is
ignored. An empty list or a list containing only one entry with the value of zero allows
all events to be processed.
Network Address
Indicates which standard BACnet object types the devices protocol implementation
supports.
This attribute is a bit string that uses the Object Type (Set 508). Each bit represents a
BACnet object type in that set. For example, bit 0 represents the BACnet AI object type,
whereas bit 17 represents the BACnet schedule object type. If the bit is true (1), the
object type is supported. If the bit is false (0), the object type is not supported. The
BACnet object types supported can vary between device models.
Protocol Revision
Indicates the minor revision level of the BACnet standard the device supports.
Indicates which standard BACnet protocol services the devices protocol implementation
supports. For more information on the Protocol Implementation Conformance Statement
(PICS) and BACnet Interoperability Building Blocks (BIBBs) of the Engine, see the
Related Documentationsection. This object now supports both the BACnet
UTCTimeSynchronization message and the BACnet TimeSynchronization message
(non-UTC version). Third-party devices now have the ability to send the
TimeSynchronization message to an Engine.
This attribute is a bit string that uses the Protocol Ser Support (Set 136). Each bit
represents a BACnet service in that set. For example, bit 0 represents the Acknowledge
Alarm service, whereas bit 12 represents the Read Property service. If the bit is true
(1), the service is supported. If the bit is false (0), the service is not supported.
224
Represents the BACnet protocol the device supports. Initial releases are Version 1;
subsequent releases increase the number by one.
CW
Controls the restrictions on which devices, if any, are notified when a restart occurs.
The value of this attribute is a list of BACnetRecipients. When the length of this list is
empty, the device cannot send a device restart notification.
The default value of this property is a single entry representing a broadcast on the local
network. If the list has one or more entry, the device sends a restart notification, but
only to the devices or addresses listed.
Segmentation
Indicates if the device supports segmentation of messages and (if so) if it supports
segmented transmission, reception, or both.
Indicates the communication status of this device with the Site Director. This value is
kept current by a command sent by the Data Refresh COV Monitor task whenever the
status changes. The COV Monitor task performs this check every 80 seconds. This
attribute is triggered so it can be used for an alarm.
System Status
Unbound References
Lists references that are not bound in the system. This attribute indicates that a process
cannot find an object either because the device on which the object is located is offline,
the object has been deleted, or the object reference is incorrect.
Vendor ID
Vendor Name
1
2
Specifies the number of audit messages destined for the Metasys server in the last
hour (for diagnostic purposes). The value of this attribute updates every 5 minutes.
Average Intermittent
Failure Period
Specifies the average number of seconds devices in the transport layer are offline
(for diagnostic purposes). Only times less than one minute are used in this average,
to eliminate device resets. Ideally, this number should be zero, indicating there are
no failures.
BACnet Broadcast
Receive Rate
Indicates the number of BACnet broadcast messages received by the device in the
previous minute. BACnet broadcast messages are generated as part of the normal
BACnet operation, but are also generated when a BACnet device searches for another
device that does not exist, such as when a device has objects with references to other
nonexistent objects (called unbound references). This number increases when the
number of unbound references increases on network connected devices. If this number
gets too high, it indicates possible performance problems.
225
Indicates the number of BACnet messages received by the device on the IP network
in the previous minute. If this number is high, it indicates that the performance of the
MS/TP field bus network is affected by broadcast transmit traffic.
Battery Condition
Specifies the current battery condition. It is updated every 60 seconds. For the
NAE55/NIE55, a value of Fault implies the battery is missing or defective and a value
of OK implies there is no known problem with the battery.
For the NCE25/NAE35/NAE45, the values are:
Good - Battery is operating at normal specifications. Provided the battery is fully
charged, it should supply backup power to the engine three times a day for 6
minutes each time.
Service - Battery useful life is predicted to end soon. We recommend you replace
the battery. Backup power lasts less than 72 hours.
Replace - Battery useful life is over. Replace the battery. Backup power may fail
if the battery is not charged fully.
After a line power failure, the battery is used to supply power to the device so the
device can perform an orderly shutdown without losing data. After the device shutdown
process finishes, the device discontinues its use of battery power. Valid data is provided
only on the Engine hardware. Under device simulation, the value is Fault.
Battery Charging
Board Temperature
Specifies the current printed wire board (PWB) temperature in degrees Celsius. It is
updated every 60 seconds. It is obtained from a temperature sensor built onto the
PWB. The device is designed to run reliably with a PWB temperature at or below 67
degrees Celsius. If this temperature is exceeded, appropriate measures should be
taken to cool the device. Under device simulation, the value is 0.
Specifies the number of COV messages the Engine receives from other supervisory
devices or field controllers per minute. This attribute value updates every minute. Each
COV message represents one object reporting a value change.
COV Tx Rate
Specifies the number of COV messages the Engine sends to other supervisory devices
per minute. This attribute updates every minute. Each COV message represents one
object reporting a value.
CPU Temperature
226
Specifies a running average of CPU usage over the last 50 minutes. The value is
updated every 30 seconds. The running average is calculated by adding or subtracting
1% of the difference between the current and average CPU usage. The value may
not be meaningful until 50 minutes after a system restart. A value of 0% means the
CPU is 100% idle. A value of 100% means the CPU is 0% idle. A value of 50% or less
is considered OK, although other performance indicators should also be assessed.
Under device simulation, the value is 0.
Detection Interval
Indicates the time, in seconds, determined by the HTTP transport mechanism based
on the Poll Rate and Network Tolerance settings. This value determines how fast a
site detects a device going offline.
Specifies the estimated flash memory available within the device for use by the users
database and applications.
This value can be used to determine whether additional use of flash can be
accommodated; however, other performance indicators should also be assessed.
This propertys value is calculated at the same time as the Flash Usage attribute. A
negative value suggests that the flash usage should be reduced. Also, a negative
value can affect system reliability now or in future releases of software.
Event Rate
Specifies the number of event messages destined for the Metasys server in the last
hour (for diagnostic purposes). The value of this attribute updates every 5 minutes.
Events Lost
Specifies the total number of events which failed to be forwarded to the configured
repository and which were deleted from the NxE's local repository. This count does
not persist through an NxE reset, and reflects the number of lost events since the last
reset.
Flash Usage
Specifies the estimated percent of flash memory currently in use. The percentage is
based on the portion of flash that is designated for use by the users database. The
value is updated on device startup, after a database archive, sync or download from
the SCT (offline mode), and by manual command (Update Flash Usage). A value
greater than 100% can affect system reliability now or in future software releases. No
restrictions are in place to prohibit use of flash over 100%.
If you are simulating an NAE/NIE, your computers hard disk must be formatted for
NTFS. If your computers hard disk is formatted to use FAT32 (32-bit File Allocation
Table), the simulated value for the Flash Usage attribute is not accurate.
Maximum Intermittent
Failure Period
Specifies the maximum number of seconds a device was offline at the transport layer
(for diagnostic purposes). Only times under one minute are recorded, to eliminate
device resets. The value of this attribute does not match the offline times determined
from generated alarms. Ideally, this number should be zero, indicating there are no
failures.
Memory Usage
227
CW
Sets the timeout tolerance of the flexible polling feature (that is, changes the lower
level communication timeouts). When edited by a user, this attribute is sent to the
HTTP transport layer and determines how long the device waits to connect, send, and
wait to receive HTTP Post responses. The setting options are LOW, MEDIUM, and
HIGH. LOW is the default and matches the current behavior. The MEDIUM or HIGH
setting increases the tolerance by adding longer timeouts and more retries and should
be used for poor network connections. Note that it takes longer to detect an offline
device as the tolerance gets higher.
Object Count
Indicates the number (count) of all of the object instances within the device. Objects
of all classes are included.
Specifies the percent of the object database that is currently in use. Each object
created consumes memory within the object database. This attribute can be used to
help determine the devices capacity for additional objects; however, other performance
indicators should also be assessed. Generally, the number of objects you define
determines the object memory usage. This attribute is valid on the Engine hardware
and under device simulation.
Note: If you have a large number of objects, the object memory usage increases and
the archive.moi file size increases also. The archive.moi file is stored in flash memory.
Also, an attempt to create an object known to require X bytes of object database may
fail even if more than X bytes are available in the object database. This is because
the object database is composed of multiple blocks. If the free space of each block is
fewer than X bytes, the request for X bytes fails even though the sum total of free
space from all blocks is greater than X bytes.
Specifies the number of event messages destined for the Metasys server in the last
hour (for diagnostic purposes). The value of this attribute updates every 5 minutes.
Registration Usage
This attribute indicates the number of registrations used by the Metasys Time Series
Data feature in the cloud-based platform. It is the total usage of all clients of this
feature. Each registration is a sign-up for an attribute of an object. The feature supports
up to 1,000 registrations per fully loaded field bus per site device. This feature is only
used by a site director and is updated every 1 minute. See Site Object and Remote
Services Connection for additional information on the Metasys system connection to
the cloud-based platform.
Repository Status
Indicates the status of the communication between the device and the
trend log sample repository (for diagnostic purposes). This attribute
uses the Repository Status set.
Uses Repository Status set:
0 = Offline
1 = OK
2 = Undefined
3 = Dialup
4 = RAP
5 = Incompatible Release
228
Specifies the number of trend samples lost because the Metasys server did not retrieve
them fast enough (for diagnostic purposes). This value resets only when the device
restarts.
Sample Rate
Specifies the number of trend samples destined for the Metasys server in the last hour
(for diagnostic purposes). The value of this attribute updates every 5 minutes.
Note: The sample rate at the NxE is calculated based on the actual raw samples
taken by every trend object. The sample rate at the ODS is calculated once every poll
cycle and is based on the number of samples received from all the NxEs and the time
it took to poll them. Most NxEs do not forward all the samples taken between polls
because the ODS transfer setpoint is usually not set to 1 (that is, forward on every
sample). The result is that the sample rate at the ODS is less than the sum of the
samples taken at all the NxEs. The total ODS sample rate is 60,000 and the total NxE
sample rate is larger than 100,000.
Indicates the time, in minutes, between Engine trend consolidation buffer readings
from the Metasys server (for diagnostic purposes).
Indicates the percentage full of the Engine trend consolidation buffer (for diagnostic
purposes).
Specifies the number of transport failures per day (for diagnostic purposes). This
number represents how often HTTP posts from this engine failed when they were sent
to another device that is considered online. Failures include the inability to open the
connection, to send the message, or to receive the reply. This value represents failures
over the last 24 hours and is updated hourly, but does not correlate directly to the
number of offline alarms generated by your system. Ideally, this number should be
zero, indicating there are no failures.
CW
CW
CW
Initial Value
Completion Domains
Computer Name
DHCP Enabled
Values/Options/Range
Set of mixed
values
CW
List of text
CW
Text
CW
True or False
CW
True (1)
0 = DHCP disabled
1 = DHCP enabled
DNS Server IP
Addresses
List of numbers
CW
List of IP addresses.
229
Text
Values/Options/Range
CW
List of numbers
CW
IP Mask
List of numbers
CW
IP Router Address
List of numbers
CW
True or False
CW
Routing Mode
1
2
True (1)
Metasys Server
Menu Selection: Insert > Metasys Server
Inserts a Metasys server (ADS/ADX, ADS-L-A, ADS-L-E ) into the archive database in the SCT, beginning with
Release 5.2 and later.
Note: Some products or models mentioned in this document are available only to specific markets. Refer to the
Application and Data Server (ADS) Lite for Europe (E) Product Bulletin (LIT-12011690) and the Application
and Data Server (ADS) Lite for Asia (A) System Product Bulletin (LIT-12011694) for availability.
Tip:
The first Metasys server you add to the site becomes the Site Director. The Site Director coordinates all
Web browser communication to the Metasys network. You can only have one Site Director per site. Any
subsequent Metasys servers are primarily used for archiving historical data.
On the Configure screen, select each tab for further configuration options.
230
Beginning with Release 2.2, the attributes shown on the ADS/ADX Focus tab (when viewed from the Site Director)
do not refresh automatically. To refresh the Focus tab, either close and reopen the tab or issue the Refresh command.
Table 105: ADS Device Object Attributes - Focus/Configuration Tab
1
Attribute Name
Values/Options/Range Description
Flags
ADS Repositories
CW
CW
Offline, OK
CW
075
Units = Minutes
DHCP Enabled
CW
0 = DHCP disabled,
1 = DHCP enabled
231
CW
Local Data
Local Time
Model Name
232
Service Time
Units = Seconds
Units = %
IP address and
Value
Units = seconds
Units = Per Minute Indicates the data value collection rate of the Ready Time
Series Data feature. It represents the rate of data values
Maximum value =
collected, not the rate of data values delivered to the clients.
83333
The feature buffers data values when the data collection rate
is within the maximum expected rate (83,333 data values per
minute) and the client is unknown or offline. In the event of a
remote connection failure, a minimum of 60 hours of data is
buffered locally for automatic delivery when the error condition
is resolved. This feature is only used by a site director and is
updated every 1 minute.
Data Usage
Units = %
233
IP address and
Value
Units = seconds
Registration Usage
Units = None
IP address and
Value
ADS/ADX Features
The ADS/ADX runs on a computer platform and is installed within the Metasys network. With an ADS/ADX, you
can provide a location to install the SCT and a location to send trend logs (Trend Studies), event logs (Alarm and
Event Management), and audit trails (Audit Trail). The ADS/ADX can also be configured to take the role of the Site
Director to coordinate system access and present data to the user in a web browser running on the same computer
or connected over the LAN, WAN, Internet, or telephone line via a dial-up connection.
Note: Online/offline modes as explained here do not apply to the ADS/ADX. However, the ADS/ADX can be online
and offline in the same sense as any other device on the network can be connected or disconnected from
the network.
Note: You may need to change the Windows Defender tool settings on your operating system (OS) when using an
ADS/ADX. Windows Defender is a spyware identification and removal tool that is part of the OS. For Windows
8.1, Windows 8, and Windows 7, this tool is on by default. For Windows Server 2012 R2, Windows Server
2012, Windows Server 2008 R2, and Windows Server 2008, this tool is off by default. Windows Defender
scans the OS for spyware every night at 2 A.M. If you expect heavy use of the ADS/ADX at this time (for
example, due to trend collection), reschedule the scan to a time when the ADS/ADX is not as active.
234
Note: You may need to change the Disk Defragmentation settings on your OS when using an ADS/ADX. Disk
Defragmentation is scheduled to run by default every Wednesday at 1 A.M. If you expect heavy use of the
ADS/ADX at this time (for example, due to trend collection), reschedule the scan to a time when the ADS/ADX
is not as active.
Trend Repository Database
The trend repository database resides within the server that stores the trend data. For more information, click one
of the following:
Trend Studies
Trend Extensions
Online/offline modes as explained here do not apply to the ODS. However, the ODS can be online and
offline in the same sense as any other device on the network can be connected or disconnected from the
network.
You may need to change the Windows Defender tool settings on your operating system (OS) when using
an ODS. Windows Defender is a spyware identification and removal tool that is part of the OS. For
Windows 8.1, Windows 8, and Windows 7, this tool is on by default. For Windows Server 2012 R2,
Windows Server 2012, Windows Server 2008 R2, and Windows Server 2008, this tool is off by default.
Windows Defender scans the OS for spyware every night at 2 A.M. If you expect heavy use of the ODS
at this time (for example, due to trend collection), reschedule the scan to a time when the ODS is not as
active.
You may need to change the Disk Defragmentation settings on your OS when using an ODS. Disk
Defragmentation is scheduled to run by default every Wednesday at 1 A.M. If you expect heavy use of
the ODS at this time (for example, due to trend collection), reschedule the scan to a time when the ODS
is not as active.
235
Trend Studies
Trend Extensions
Specifies a list of ADS (ODS) Repository devices. The ODS is the device
to which local audit, alarm, and trend data is delivered. Repository refers
to the three files in the ODS that store this data. If a value is specified,
it overrides the value of the Default ADS Repository attribute of the site.
If no value is specified, the value of the Default ADS Repository attribute
is used (Default ADS Repository is a site level setting sent to the sites
devices).
CW
The Default ADS Repository of the Site is intentionally left blank and
must be updated by the user (online or offline). If the user does not
populate the Default ADS value and leaves the Default ADS Repository
value for all devices at 0.0.0.0, the ODS does not receive any audit,
alarm, or trend data. The SCT does not automatically populate the
Default ADS Repository value because of the many different possibilities
that could exist during archive creation, including multiple ODSs on a
site or no ODS for a site. In these cases, it is not immediately clear which
ODS should be the Default ADS under the Site object.
ADS Repositories Status
CW
CW
Indicates the status of the devices listed in the ADS (ODS) Repositories
attribute.
5
236
APDU Retries
CW
4,000
APDU Timeout
CW
6,000
Appl SW Version
BACnet Communications
Password
When this attribute is set to Include in Object List and Routing Mode is
set to Enabled, the same third-party object appears in the list twice (as
a native object on the actual device and as an integrated object within
the Engine); therefore, this setup is not recommended. When Routing
Mode is set to Enabled Without Broadcasts, it prevents third-party
devices outside the network from discovering devices on a routed
network using broadcast data.
237
CW
47,808
Specifies the UDP port number used to communicate with other BACnet
devices over the IP network. This value allows multiple BACnet networks
on a single IP network and prevents communication between the multiple
BACnet networks. If you write the value of this attribute, you must restart
the ODS for the new settings to take effect.
065,535
Database Revision
DHCP Enabled
IP Address
IP Mask
IP Router Address
IP Mask
When DHCP Enable is True, the UI ignores the following attributes and
should not attempt to write to them. The values from the DHCP are
assumed to be more current than the tool interface:
IP Address
IP Mask
IP Router Address
DST Status
Duplicate References
Lists references that are duplicated in the system. Entries in this list are
object references that exist on more than one device within the system.
238
CW
Audit Level
2 (1)
Specifies which level of audit entries are added to the Audit Repository.
Only audit entries of type Level 1 through (and including) the specified
level are included. All other levels are not stored in the audit trail. Level
1 and Level 2 audit entries are always stored in the audit trail.
Range = 14 with 5 Audit Levels
Level 1 and 2 (1): Stores all user action and system error audit
messages.
Firmware Version
Host Name
Specifies the name of the supervisory engine with the trend consolidation
buffer that was the most full during the last buffer transfer scan (for
diagnostic purposes). This buffer is filled to the percent indicated by the
Transfer Buffer Full Worse NxE value.
Provides a list of structures with the following elements: Network Number,
Device ID High Limit, and Device ID Low Limit. The first set of Who-Is
messages is broadcast once the device reaches the Enable Field
Commands phase of startup. At this time, a timer starts running that
calls a method to send the Who-Is messages at the period specified by
IEIEJ Function A Period.
CW
CW
60
Sets the period at which the IEIEJ Function A List sends the Who-Is
message broadcasts. Clearing the value of this property disables the
function A feature. Each destination is guaranteed to get a Who-Is
message within the period specified by this property; however, if the list
contains multiple destinations, the object attempts to spread out the
Who-Is messages so that they are not all sent out at the same instant.
CW
20
Interval Offset
CW
Specifies the offset, in minutes, from the beginning of the period defined
for time synchronization until the actual time synchronization requests
are set. Interval Offset has no effect when Align Intervals is False.
239
240
Indicates the date to the best of the devices knowledge. The Date type
is a series of four one-number elements.
The first number is the year (for example, 2005); the second number is
the month (1..12, 1=January); the third is the day of month (1..31). To
maintain compatibility with BACnet protocol, a fourth number contains
the day of week (1=Monday). A value of FF * (asterisk) in any of the
elements indicates the value is not specified.
Local Time
Indicates the time of day to the best of the devices knowledge. The
Time type is a series of four one-number elements. The first number is
the hour (0..23); the second number is the minute (0..59); and the third
number is the seconds (0..59). A fourth number has been added to
maintain compatibility with BACnet protocol and contains the hundredths
of second (0..99). A value of * (asterisk) for any number indicates the
value is unspecified. This value would be used, for example, when the
hundredths value is not important.
Location
Max APDU Length
CW
(empty
string)
CW
1,024
CW
994
Specifies the largest piece of data that can be sent to a device at one
time, excluding all communications headers. Some applications need
to perform segmentation of data outside the communications system.
This value is used to size the data in those situations.
Model Name
Indicates the device model, the hardware revision associated with the
firmware, and the code file name used to download the device.
Network Address
CW
1,001
CW
empty list
Indicates the minor revision level of the BACnet standard the device
supports.
Protocol Version
Restart Notification
Receipts
CW
Sample Rate
Specifies the number of trend samples destined for the Metasys server
in the last hour (for diagnostic purposes). The value of this attribute
updates every 5 minutes.
Note: The sample rate at the NxE is calculated based on the actual raw
samples taken by every trend object. The sample rate at the ODS is
calculated once every poll cycle and is based on the number of samples
received from all the NxEs and the time it took to poll them. Most NxEs
do not forward all the samples taken between polls because the ODS
transfer setpoint is usually not set to 1 (that is, forward on every sample).
The result is that the sample rate at the ODS is less than the sum of the
samples taken at all the NxEs. The total ODS sample rate is 60,000 and
the total NxE sample rate is larger than 100,000.
Segmentation
Service Time
Displays the amount of time in seconds that it takes for the ODS device
to poll all NxEs on the site for trend samples.
System Category
General
System Status
242
Time Synchronization
Interval
CW
Unbound References
Lists references that are not bound in the system. This attribute indicates
that a process cannot find an object either because the device on which
the object is located is offline, the object has been deleted, or the object
reference is incorrect.
UTC Offset
Vendor ID
Vendor Name
1
2
JCI
243
Specifies the number of COV messages the ODS receives from other
supervisory devices or field controllers per minute. This attribute value
updates every minute. Each COV message represents one object
reporting a value change.
COV Tx Rate
CPU Usage
Indicates the data value collection rate of the cloud-based platform Time
Series Data feature. It represents the rate of data values collected, not
the rate of data values delivered to the clients. The feature buffers data
values when the data collection rate is within the maximum expected
rate (83,333 data values per minute) and the client is unknown or offline.
In the event of a remote connection failure, a minimum of 60 hours of
data is buffered locally for automatic delivery when the error condition
is resolved. This feature is only used by a site director and is updated
every 1 minute. See Site Object and Remote Services Connection for
additional information on the Metasys system connection to the
cloud-based platform.
244
Detection Interval
Event Rate
Events Lost
Maximum Intermittent
Failure Period
Memory Usage
Network Tolerance
CW
Object Count
Low
Sets the timeout tolerance of the flexible polling feature (that is, changes
the lower level communication timeouts). When edited by a user, this
attribute is sent to the HTTP transport layer and determines how long
the device waits to connect, send, and wait to receive HTTP Post
responses. The setting options are LOW, MEDIUM, and HIGH. LOW
is the default and matches the current behavior. The MEDIUM or HIGH
setting increases the tolerance by adding longer timeouts and more
retries and should be used for poor network connections. Note that it
takes longer to detect an offline device as the tolerance gets higher.
Indicates the number (count) of all of the object instances within the
device. Objects of all classes are included.
245
Registration Usage
Repository Status
Indicates the status of the communication between the device and the
trend log sample repository (for diagnostic purposes). This attribute
uses the Repository Status set.
Uses Repository Status set:
0 = Offline
1 = OK
2 = Undefined
3 = Dialup
4 = RAP
5 = Incompatible Release
246
Specifies the number of trend samples destined for the Metasys server
in the last hour (for diagnostic purposes). The value of this attribute
updates every 5 minutes.
Note: The sample rate at the NxE is calculated based on the actual
raw samples taken by every trend object. The sample rate at the ODS
is calculated once every poll cycle and is based on the number of
samples received from all the NxEs and the time it took to poll them.
Most NxEs do not forward all the samples taken between polls because
the ODS transfer setpoint is usually not set to 1 (that is, forward on
every sample). The result is that the sample rate at the ODS is less
than the sum of the samples taken at all the NxEs. The total ODS
sample rate is 60,000 and the total NxE sample rate is larger than
100,000.
Samples Lost
Specifies the number of trend samples lost because the Metasys server
did not retrieve them fast enough (for diagnostic purposes). This value
resets only when the device restarts.
1
2
ODS Commands
The table below lists the commands supported by the Table 109.
Table 109: ODS Device Object Commands
Command Name
Description
Archive
247
Routes all Trend samples to the Metasys Server. Use this command before
performing an engine upgrade to minimize the risk of losing any trend samples.
Resets the States Text across a supervisory device by rediscovering text strings
from all mapped BACnet objects.
Note: When the Rediscover Text Strings command is sent from the Site Director
device UI to another supervisory device and the UI is running on the supervisory
device, you must close and restart the UI on the supervisory device in order for
the text to appear correctly.
Integration
Menu Selection: Insert > Integration
Integrates the following types of buses or networks into the NAE, NIEx5, NIEx9, or NCE :
Tip: Select the Hardware tab (if it appears) on the Configure screen for further configuration.
After adding an integration, you can select the integration in the navigation tree and click Action > Import Integration
to add existing devices and points under the integration.
See one of the following sections for more information:
Related Documentation
N1 Migration Object
248
Structure elements:
Remote
165,345 (editable)
CW
CW
1065,535
249
CW
065,535
Units = seconds
Poll Delay
CW
Milliseconds
1050
Preserve Discovered
Devices
CW
Request Vendor ID
CNW
065,535
250
List
Execution Timer
Number
Number
Parameters
None
251
utcTimeSynchronization is set, the code functions as if Time Sync Type is set to UTC.
utcTimeSynchronization is not set and timeSynchronization is set, local time is sent.
neither utcTimeSynchronization nor timeSynchronization is set, no time is sent.
inputs
outputs
parameters
When the GIO appears in Metasys software, the attributes are organized by tabs bearing the names of the three
categories (Input Category, Output Category, and Parameter Category tabs). Each tab includes the status, description,
and value of the items in that category.
Note: Currently, the GIO supports N1 Migration Object and LON Integration Object. You can no longer manually
add a GIO to a LON trunk; however, the GIO is still supported in existing databases, even after upgrading
to the next software release.
For general information on Metasys system objects, see Common Object Attributes.
Generic Integration Concepts
N1 Integration and the GIO
For N1 integration, use the Control System object from your existing Metasys network. Hardware and internal points
are already defined in the Control System object so there is one to one mapping between a Control System object
and the GIO. N1 point mapping is one to one and the Metasys system restricts which characteristics of the GIO (for
example, label, display precision) can be edited once they are added to the system.
252
Offline
Overridden
Present Value
DW
Reliability
Target Reference
Represents the label of the Display Attribute. The Display Reference is not stored in
the object, but read when requested.
Identifies the source that provides the data elements linked to the individual attributes
of the GIO.
253
CW
Contains a list of structures that store data about each attribute defined within a GIO.
The elements listed in this table appear as columns on the Hardware tab of the
Configure screen of the Insert Point Wizard - GIO.
Table 114: Hardware Tab Configuration Columns
Element Name
Description
Adjust Allowed
Category
Display Precision Specifies the display precision for an attribute with a real value
(floating point).
Element Ref
Field Units
Represents the units that can be used for the attribute. Uses
Unit Set (Set 869)
Label
Contains the user label for the attribute name. This is the name
used whenever you view the attribute in Metasys software.
Override Allowed Indicates whether or not this attribute supports the Override
command.
Units or Enum Set Specifies the units for an attribute that is a real value (floating
point). If an attribute is one value from a set, this attribute sets
the states text from the sets listed in the Alphabetical Set List.
Use Unit Set (Set 869) to set the units of a real value.
Display Attribute
Specifies the attribute that represents the value of the GIO. The value of this attribute
is used as the Present Value of the GIO. For example, for a GIO representing a
temperature control strategy, you might choose the attribute representing room
temperature to be the Display attribute. Then, the room temperature appears as the
GIO Present Value.
Number of Parameters
Attribute Command
None
254
In the navigation tree, right click on the GIO object and select Commands then select an attribute for the GIO
Attribute Command, and click the ellipsis button.
In a category view for the GIO (in the display frame), right-click on the attribute you want to command, and select
Commands.
The attribute commands that appear are based on the data type of the attribute and whether Override Allowed and
Adjust Allowed are True or False. SeeTable 114 for more information about these elements.
Table 117: Attribute Commands
Command
Notes
Real values only (floating points)
Adjust
Operator Override
Change Name
Change Display Precision
1
State0...StateN
True
False
1
2
True/False only
255
CW
Indicates the maximum number of times the device can retransmit a data
frame. If the device does not perform retries, it has a value of 0. If this value
is greater than 0, a non-zero value appears in the APDU Segment Timeout
attribute. We do not recommend changing this attribute value from the default
value without a strong reason.
APDU Timeout
CW
CW
CW
Count
Device Discovery Range
Baud
Rate
Description
Auto
1200
Use 1200 baud only. This value is not recommended and may
not be allowed on some devices.
9600
Use 9600 baud only. This value is the lowest standard MS/TP
baud rate.
19200
38400
Use 38400 baud only. This value is the recommended baud rate
for bus supervisor ports.
76800
Contains the number of FEC series and non-FEC series BACnet objects
mapped on the field bus.
CW
Specifies the destinations for the messages sent during the device auto
discovery process. This list is empty by default. When the list is empty, a global
broadcast message is sent. Adding entries to the list limits the scope of the
broadcast message to only the specified networks and device instance ranges.
If multiple entries appear in the list, the messages are sent sequentially. This
attribute appears only in the snapshot view.
256
CW
Toggles the integration between pure BACnet mode and BACnet with
proprietary messaging. When set to True, proprietary messaging is disabled.
This may be useful for special cases where customers do not want Private
Transfer messages on the BACnet trunk. Note that when this attribute is True,
proprietary Objects, Attributes, and Services on Johnson Controls devices
(such as Field Equipment Controllers (FECs), Advanced Application Field
Equipment Controllers (FACs), and VAV Modular Assemblies (VMAs)) are
not available. This attribute must be set before devices are added to the
Integration. If you change the value, restart the supervisory device to make
the change effective. You can restart immediately or after you have completed
the mapping process. The default value is False.
Execution Priority
CW
Indicates the order in which any given object within a group of objects is
allowed to run or change data within a system. This attribute should not be
changed for this object.
CW
CW
Max Master
CW
Specifies the highest possible address for devices on this network and is less
than or equal to 127. This attribute is present if the device is a bus supervisor
device on an MS/TP network. Do not change this value from the default unless
you have a strong reason because incorrect values may cause devices to
lose communications.
Page Size
CW
Determines how many points are discovered per page. The default number
is 1,000.
Periodic Update
CW
Specifies how frequently integrated BACnet objects that do not support COV
subscription update their attribute values. Every period, the MS/TP Field Bus
Integration object prompts each integrated BACnet object that needs to update
its attribute values. This attribute applies only to non-FEC series devices. See
the Poll Delay attribute description for information on how these attributes
interact.
Poll Delay
CW
Specifies the time in milliseconds between BACnet object polls for attribute
values. The polls start at the time specified in the Periodic Update attribute.
As the poll delay increases, the overall time in the Execution Time attribute
increases.
It is useful to specify a Poll Delay on sites where the rate of reading the remote
objects causes too high of a burden on the Metasys network or third-party
device. The initial value of the Poll Delay attribute is blank (zero).
257
CW
Controls the behavior when field device discovery is started. This attribute
exists for historical reasons and is ignored by the MS/TP Field Bus Integration
object for FEC series or non-FEC series devices. The value of the attribute is
shown in the snapshot view. If an auto discovery has been completed since
the last device restart, a complete new auto discovery is performed for all FEC
Series or non-FEC Series devices for each subsequent auto discovery in
which Restart is selected.
Requested Vendor ID
CN
Used as a filter when discovering new devices to limit the device list to
whatever is specified as the Vendor ID value. The default value of this attribute
is Null (stored as zero), which allows all vendors to be discovered and
displayed. Note that this filter applies only to non-Johnson Controls devices.
Johnson Controls devices are always included in the discovered device list.
The current list of Vendor IDs can be viewed at
http://www.bacnet.org/VendorID/BACnet%20Vendor%20IDs.htm.
Note: If you do not want to display devices already discovered or mapped,
then set Preserve Discovered Devices to False.
Synchronize Time
CW
Broadcasts time synchronization to all devices on the field bus when the field
device comes online or when the time changes by a significant amount. When
changed from false to true, a time synchronization is sent immediately to all
devices on the field bus.
CW
Displays the actual data rate on the wire for transmitting and receiving. When set to Auto,
the port is waiting to synchronize with the network.
Indicates the number of BACnet broadcast messages received on the MS/TP field bus
network of the device in the last minute. If this number is high, it indicates that the
performance of the specific MS/TP field bus network is affected by broadcast receive
traffic.
Broadcast Receives
Indicates the number of BACnet broadcast messages transmitted on the MS/TP field bus
network for the device in the last minute. If this number is high, it indicates that the
performance for the specific MS/TP field bus network is affected by broadcast transmit
traffic.
Broadcast Transmits
Buffer Overflow
Indicates the number of data frames lost at this MS/TP device because there was no buffer
available to which to save it. This number includes outgoing and incoming messages.
258
Displays the date when the last full MS/TP field bus scan finished. The Analyze Field Bus
command initiates the network scan.
Displays the time when the last full MS/TP field bus scan finished. The Analyze Field Bus
command initiates the network scan.
Indicates the progress of the full MS/TP field bus scan initiated by the Analyze Field Bus
command.
Lists MS/TP devices that either have been detected on the FC bus or have been configured
on field devices existing under the MS/TP Field Bus Integration Object.
The Bus Device Configuration List provides configuration information for each device,
including which devices are responding, which devices may have been configured
incorrectly, and the addresses of all devices. Only bus supervisor devices provide all this
information. This object creates the list when you issue an Analyze Field Bus command.
Indicates the overall health of the MS/TP field bus based on the number of errors occurring
at the NAE. The most desirable value is 0. The higher the number, the worse the bus
health/higher the number of errors. The Bus Health Index is re-evaluated every 30 seconds
and gradually returns to zero if no new errors occur.
This object derives the value for the Bus Health Index from periodically reading the Header
CRC Errors, Data CRC Errors, Framing Errors, and Lost Token attribute values to create
a moving average of total errors. The Weighted Bus Health Constant attribute determines
the responsiveness of the Bus Health Index.
Indicates the responsiveness of the bus supervisor device on the MS/TP field bus. The
most desirable value is 1. Values from 2.5 to 6 are marginal and updates to devices on
the bus may be slow. If the value is greater than 6, the performance is poor and may
indicate offline conditions.
The device derives the value for the Bus Performance Index by comparing the measured
token loop time at the NAE and the predicted token loop time calculated when the MS/TP
Field Bus Integration object is first created or when the NAE device count changes. This
object uses the difference as input for determining the weighted moving average of the
token loop time. The Weighted Bus Performance Constant attribute determines the
responsiveness of the Bus Performance Index.
Bytes In
Indicates the number of data bytes received by this device. This number includes all
messages from all devices.
Bytes Out
Indicates the number of data bytes sent by this device. This number includes all messages
to all devices.
Counts errors detected in the data portion of data frames sent to the device. Many data
frames are used only for protocol control and do not contain a data portion, and thus cannot
have Data CRC Errors. The Header CRC Errors check must be successful before the
device attempts a Data CRC check. This attribute supplies an error count for the Bus
Health Index attribute.
Displays the number of data frames received by the device that require an immediate
reply. This value includes proprietary frames that have been received and are expecting
a reply.
Displays the number of data frames sent by the device that requires an immediate reply
from the destination device.
This value includes proprietary frames that have been sent and are expecting a reply.
259
Lists any duplicate object identifiers found after an auto-discovery of MS/TP BACnet
devices finishes. If any devices are listed, then the list of automatically discovered devices
may be incomplete. The list contains the instance number of the Object Identifier and the
network address (represented in hex notation) of each device with the same identifier
instance number as another device on the same bus. MS/TP devices with duplicate device
identifiers may be integrated without problem, but should be physically located and their
object identifiers changed to make them unique network-wide.
Execution Time
Records the amount of time taken for the last periodic update of all referenced mapped
BACnet objects. The value for this attribute can be used to tune the Periodic Update
attribute. If the Execution Time is greater than the Periodic Update, attribute values of
referenced BACnet objects are constantly being updated over the network. This attribute
applies only to non-FEC series devices. See the Poll Delay attribute description for
information on how these attributes interact.
Framing Errors
Counts the number of errors detected in the individual data bytes received by the device.
A framing error occurs when the device receives a stop bit in the wrong state. This attribute
supplies an error count for the Bus Health Index attribute. Framing errors are usually
caused by electrical noise on the bus, message collisions, incorrect baud rate settings,
bus wiring or termination errors, or devices that are not operating within the BACnet
specified timing. Framing errors generally cause CRC errors since the frame has been
corrupted.
Counts the number of errors detected in the header portion of frames received by the
device. Many frames are only used for protocol control and only contain a header portion.
This attribute supplies an error count for the Bus Health Index attribute.
Internal Errors
Indicates the number of internal MS/TP driver operation errors resulting from an incorrect
state, insufficient memory, errors from the serial port driver, incorrect internal state
transitions, and other error states.
Lost Token
Indicates the number of times the device detects a lost token. A lost token indicates that
the bus encountered a serious network disruption. Serious disruption may occur when the
bus first starts up or when wiring changes are made. This attribute supplies an error count
for the Bus Health Index attribute.
Displays the largest number of outgoing frames the device has held in a queue for
transmission. The largest possible value for this attribute depends on the capabilities of
the engine. Generally, the maximum value is reached during device startup, but is not
reached during normal operation.
Indicates the maximum time in milliseconds last seen at the device for the token to complete
one circuit of the MS/TP field bus (go from the originating bus supervisor device through
several other devices and return to the original bus supervisor device). The value is reset
when the statistics are cleared. Maximum loop time is closely associated with the worst-case
performance encountered since the last time the value was reset.
Overrun Errors
Displays the number of times the MS/TP port hardware loses received data because the
device is too slow in reading the data. An overrun error occurs when the hardware receives
a byte before it moves the prior byte to a buffer.
260
Displays the number of Poll For Master (PFM) frames received by the device. On a clean
network, this should only count the first PFM frame received when the device (or another
with a MAC address below that of the device) comes online. These frames are used to
discover other devices on the network and should be seldom received.
Displays the number of PFM frames sent by the device. In normal operation on a clean
network, only the bus supervisor (MAC address 0) and the highest numbered master
device on the network should be sending PFM frames. These frames are used to discover
other devices on the network.
Counts the number of data frames expected by the device that did not arrive within the
time allowed.
Counts any attempts to transmit or receive a data frame that is longer than allowed by the
device or by MS/TP.
Indicates the number of mapped BACnet objects that are currently polled on a periodic
basis. This attribute applies only to non-FEC series devices.
Port Status
Indicates the theoretical time in milliseconds needed for the token to complete one circuit
of the MS/TP field bus.
The object derives this value from the defined bus baud rate, number of devices on the
bus, and an estimate of the type and amount of messages transmitted on the bus during
this time. This object compares the value of this attribute with that of the Token Loop Time
attribute to help calculate the value of the Bus Performance Index attribute.
Counts the number of data frames sent at the device that requires an immediate reply
where the destination device requests additional time to prepare the reply. This may happen
normally if the reply involves a large amount of data. It may also indicate that a device on
the network is overloaded.
Counts the number of data frames received at the device that requires an immediate reply
where this device requests additional time to prepare the reply. This may happen normally
if the reply involves a large amount of data. It may also indicate that this device is
overloaded.
Counts the number of Reply to PFM frames the device receives. On a clean network in
normal operation, the device receives only one Reply to PFM frame when either the device
comes online or the next higher numbered device comes online during normal operation.
These frames announce the presence of this device on the network.
Counts the number of Reply to PFM frames the device transmits. On a clean network
during normal operation, only one Reply to PFM frame needs to be sent when the device
first comes online. These frames are used to announce the presence of other devices on
the network.
Reply Too Slow Application Errors Counts the number of data frames received at this device that requires an immediate reply
where the device cannot assemble reply data within the time allowed and cannot internally
detect the need for additional time. These errors generally indicate an overloaded device
if they occur frequently.
Reply Too Slow Datalink Errors
Counts the number of data packets sent by the device that requires an immediate reply
from the destination device, but do not receive any reply within the time allowed. This
number does not include Reply Postponed responses. The affected frames likely require
a retry and bus performance is reduced when this happens.
Reset Date
Contains the date of the last Clear Statistics command (when the statistics for the device
were last reset).
261
Contains the time of the last Clear Statistics command (when the statistics for the device
were last reset).
Retries
Displays the number of times the device tried to pass a token as the next node did not
start using it within the time allowed by BACnet protocol.
Displays the number of Test Request Frames the device receives. Test Request Frames
are a normal part of bus analysis, but should not be received during normal operation. A
Test Response Frame should be sent in reply to each Test Request Frame received.
Displays the number of Test Request Frames the device transmits. Test Request Frames
are a normal part of bus analysis, but should not be sent during normal operation. A Test
Response Frame should be received in response to each test Request Frame sent to an
online device. Test Request Frames may also be sent to offline devices where no response
is received.
Displays the number of Test Response Frames the device receives. Test Response Frames
are a normal part of bus analysis, but should not be received during normal operation. A
Test Response Frame should be received in response to each test Request Frame sent
to an online device.
Displays the number of Test Response Frames transmitted by this MS/TP port. Test
Response Frames are a normal part of bus analysis, but should not be sent during normal
operation. A Test Response Frame should be sent in response to each test Request Frame
received.
Displays the number of Token Frames the device receives. In MS/TP, each master device
passes a logical token to the next device during normal operation. Only the master device
currently holding the token is allowed to initiate a message; thus, the number of Token
Frames sent or received should be large. Normally the number of Token Frames received
should be almost the same as the number of Token Frames transmitted.
Displays the number of Token Frames the device transmits. In MS/TP, each master device
passes a logical token to the next device during normal operation. Only the master device
currently holding the token is allowed to initiate a message, thus the number of Token
Frames sent or received should be large. Normally the number of Token Frames received
should be almost the same as the number of Token Frames transmitted.
Indicates how much time passes between the periods when the device allows initiation of
messages on the network. This time is a strong indicator of network performance and is
associated strongly with the amount of traffic or errors on the network. Shorter times
indicate a more responsive network. Longer times indicate an increasingly busy and slow
network.
The object compares the value of this attribute with that of the Predicted Token Loop Time
attribute to help calculate the value of the Bus Performance Index attribute.
Displays the number of data frames of an illegal type the device receives. During normal
operation, only certain kinds of MS/TP data frames are allowed to be sent during each
phase of operation. If the device receives some other kind of data frame (other than the
allowed types for the current phase of operation), the device counts the data frame as an
Unexpected Frame. The device may often detect Unexpected Frames when connecting
running devices to a live MS/TP bus.
262
None
Clear Statistics
None
Latch Statistics
None
None
263
For general information on Microsoft system objects, see the Object Help section.
LON Integration Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 122: LON Integration Attributes - Diagnostic Tab
Attribute Name
Data Type
Description
Bind Retry Count
Number
Indicates the number of objects for which the LON Integration code is still
verifying with the field controller that it has the correct type information.
Count
Number
Displays the number of LONWORKS network point object defined for the trunk.
Error Log
Shows the error log according to the last standard LONWORKS network Query
Status message.
Date
Number
Time
Lost Messages
Number
Shows the number messages lost according to the last standard LONWORKS
network Query Status message.
Missed Messages
Number
Neuron Model
Shows the Neuron model according to the last standard LONWORKS network
Query Status message.
Node State
Shows the state of the node according to the last standard LONWORKS network
Query Status message.
Offline
True or False
Number
Number
Displays the calculated number of seconds the server takes to read all defined
points.
Number
Number
Number
Number
Indicates how often the items in the Priority 1 list are polled.
Number
Indicates how often the items in the Priority 2 list are polled.
Number
Indicates how often the items in the Priority 3 list are polled.
Number
Shows the number of times the transaction full message appeared in the last
standard LONWORKS network Query Status message.
264
One cause from a Shows the cause of the last reset according to the last standard LONWORKS
set
network Query Status message.
Reset Date
Date
Contains the date stamp of the last local Neuron statistics reset command.
Reset Time
Time
Contains the time stamp of the last local Neuron statistics reset command.
Number
Displays the number of READATTRIBUTE calls that occurred while the object
was already being polled.
Number
Displays the number of READATTRIBUTE calls that occurred while the object
was not being polled.
Number
Transaction Timeouts
Number
Shows the timeouts that appeared in the last standard LONWORKS network
Query Status message.
Transmit Errors
Number
Shows the number of transmit errors that appeared in the last standard
LONWORKS network Query Status message.
Number
Version Number
Number
Shows the version number according to the last standard LONWORKS network
Query Status message.
XIF Present
True or False
Indicates whether the XIF is present. The XIF is a resource file required for
the NAE to understand a particular device type. This attribute is not used in
the SCT.
C - Configurable, W - Writable
Disable
None
None
Resets the statistics for the integrated LONWORKS network. The contents of the
Query Status message reflect these statistics:
Transmit Errors
Transaction Timeouts
Lost Messages
Missed Messages
Reset Cause
Node State
Version Number
Error Log
Neuron Model
265
None
Latch Statistics
None
Updates the displayed statistics with the current values. The following attributes
reflect the statistics:
Transmit Errors
Transaction Timeouts
Lost Messages
Missed Messages
Reset Cause
Node State
Version Number
Error Log
Neuron Model
N1 Migration Object
Note: This object is for use with the NIEx5 only. For more information on N1 migration, see the Related
Documentation table in the Welcome section.
The N1 Migration object contains all the necessary information to communicate with points on an existing Metasys
network. Add the new Metasys system hosting the migration server to the existing Metasys network as an operator
workstation (OWS) at a fixed IP Address. All existing Metasys networks are defined as N1 Migration objects in the
host NIE. Many of the existing point objects are defined as mapped devices to the NIE.
For general information on Metasys system objects, see the Object Help section.
N1 Migration Concepts
Migration Overview
When you add a new Metasys system N1 Migration object, the N1 migration component establishes communication
with the N1 network. The N1 Migration object is only an object on the new Metasys system controller to which it was
added.
After the N1 Migration object establishes communication with the existing Metasys system, the N1 Migration object
creates 2 new calendars that are a portal to the existing NCM calendar. (See Todays Schedule in the Scheduling
section.) One calendar is a list of alternates, and one calendar is a list of holidays.
Note: An Ethernet connection is the only method for the NIE to connect to the N1 network. ARCnet jobs must use
an Ethernet router.
See the N1 Migration Attributes section for more information on N1 migration attributes.
Mapped Points
Existing features of the Metasys system are supported by moving their functionality to the host NIE. These features
are: trend, totalization, point history, and scheduling. When possible, existing objects maintain their configuration
parameters in the new Metasys system. For example, alarm limits, alarm state, and units. The table below lists points
specific to the Metasys system.
266
Accumulator Object
Analog Input
Analog Output
Analog Data
Binary Input
Binary Output
Binary Data
Control System
Multistate Input
Multistate Output
Multistate Data
Multiple NIEs
Migration can be split across multiple NIEs with the following constraints:
Only one N1 Migration object can exist per NIE per N1 network.
Multiple NIEs can reference the same N1 network.
Only one NCM object can exist per NCM per N1 Migration object.
Multiple NCM objects can reference the same NCM as long as they exist on different NIEs.
Only one point object can exist per NIE per N1 object.
Multiple point objects can reference the same N1 object as long as they exist on different NIEs.
N1 Migration Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 125: N1 Migration Object Attributes - Focus/Configuration Tab
1
Attribute Name
Notes Description
Broadcast Address
CW
Connected Status
Device Name
Edits the address to use directed broadcasts. The user typically does not edit this attribute.
Displays if the NIE communicated with the Metasys N1 network for the object mapping service
and UI service. This attribute drives the status of the object.
CW
Discovery IP Address CW
Displays the defined case-insensitive device name. The device name is required for the
existing Metasys system to detect the On-Line status and Off-Line status of the NIE. This
attribute must match the name of the NIE in the existing N1 network.
Displays the defined NCM IP address of the existing Metasys system. Use for self discovery
of the existing Metasys system. You need at least 1 NCM in the existing N1 network that the
NIE can talk to, to find the other N1 devices and get N1 points.
267
CW
Displays the defined NCM Gate address on the existing Metasys system. Use for self discovery
of the existing Metasys system. You need at least 1 NCM in the existing N1 network that the
NIE can talk to, to find the other N1 devices and get N1 points.
Discovery Node
Number
CW
Displays the defined NCM Node address on the existing Metasys system. Use for self discovery
of the existing Metasys system. You need at least 1 NCM in the existing N1 network that the
NIE can talk to, to find the other N1 devices and get N1 points.
Duty-Standby
CW
Displays whether the existing Metasys system is a Duty/Standby network. The NIE has to
know if the existing N1 network is a Duty/Standby.
Enable Polling
CW
When True, this attribute causes the integration in the NIE to place any system into a 20
second fast polling table being viewed. This attribute also places a system into this table on
an objects Focus view. This provides faster updates to objects being viewed in any Metasys
system UI. When viewing points from several systems, the Service Time for the NCM
increases. Take care when enabling this fast polling feature as it may affect the service times.
Note: To prevent delays in event reporting due to the fast scan operation, follow the existing
report routing guidelines.
Note: Do not set this attribute to True when for NIEs used with validated environments (that
is, when Trend data must be collected within 2 minutes).
Gate Number
CW
Displays how the NIE is defined in the existing N1 network. This attribute is read from the
NCM.
Message Timeout
CW
Displays the reply timeout in seconds. The reply timeout is how long the NIE waits for a reply
from an NCM. The user typically does not edit this attribute.
Migrate Object
Configuration
CW
When True, this attribute displays the basic object configuration from the existing Metasys
system object used to write basic configurations for newer Metasys objects. For example,
units or descriptor. This attribute (when True) tells the new Metasys system to bring alarm
setup information from the existing N1 network and creates Alarm Extensions (Analog Alarm
and Multistate Alarm) for new objects that are added.
Migrate Schedules
CW
Displays the attached existing Metasys system schedules used to create the newer Metasys
system Schedule. The schedules that appear in the new Metasys systems are portals to the
schedules in the existing N1 network. Schedules appear in the new format and offer the same
functionality. Changes made to the schedules in the new Metasys system are also made to
the N1 schedules in the NCM.
Migrate Totalization
Configuration
CW
Displays the totalization configuration from the existing Metasys system object used to create
the newer Metasys system Totalization Extensions when an existing object is mapped to a
newer object.
Migrate Trend
Configuration
CW
Displays the trend configuration from the existing Metasys system object used to create the
newer Metasys system Trend Extension when an existing object is mapped to a newer object.
This attribute creates one or more trend extensions for existing N1 network trends.
Network Name
Note Number
CW
Poll Delay
CW
Displays the polling time for non-triggerable attributes in milliseconds. The poll delay is the
time between NIE polls to the N1 network points.
268
CW
Contains the number of retry attempts made. The NIE waits for the Message Timeout, then
retries sending messages the number of times defined in this attribute.
CW
Contains the time between communication retries (in seconds). This attribute is the time the
NIE waits for a low-level Ack from the NCM. The user typically does not edit this attribute.
Synchronize Time
CW
Displays whether the NIE is the master time keeper for the existing N1 network system. Time
updates are sent to the existing system once daily and when the time changes.
UDP Port
CW
Command Count
Count
065,535
COV-COS Count
04,294,967,295
Framing Errors
Hardware Overflows
065,535
Seconds
269
065,535
Seconds
Message Receives
04,294,967,295
Message Transmits
04,294,967,295
NAK Errors
04,294,967,295
Offline Occurrences
04,294,967,295
Offline Polls
04,294,967,295
Online Polls
04,294,967,295
Parity Errors
065,535 Seconds
Reset Date
Reset Time
Retry Attempts
04,294,967,295
04,294,967,295
04,294,967,295
04,294,967,295
None
Latch Statistics
None
270
CW
Offline
1
True
True
C - Configurable, W - Writable
Errors In
Errors Out
Function Time
Exceeded
Message Receives
Message Transmits
Indicates how often the items in the Priority 1 list are polled. Units
= Seconds
Reset Date
Reset Time
Transmits In
Transmits Out
C - Configurable, W - Writable
271
Disable
Enable
Latch Statistics
Indicates the UDP Port on the NAE used to communicate to the Ethernet to RS-485 converter.
The port must be 1024 or higher, but cannot be equal to the BACnet UDP Port, the N2 Trunk
UDP Port, or 9999.
Displays the number of times the device tried to pass a token as the next node did not start
using it within the time allowed by the protocol.
Specifies the time in milliseconds between BACnet object polls for attribute values. The
polls start at the time specified in the Periodic Update attribute. As the poll delay increases,
the overall time in the Execution Time attribute increases.
It is useful to specify a Poll Delay on sites where the rate of reading the remote objects
causes too high of a burden on the Metasys network or third-party device. The initial value
of the Poll Delay attribute is blank (zero).
Specifies the delay in milliseconds between the last character going out and the first character
received.
Note: The Message Timeout attribute is writable only if is not zero. If User Datagram Protocol
(UDP) Port is zero and you attempt to write Message Timeout, an error message appears.
272
Indicates if any wireless sensors defined as children of the Wireless Receiver Objects have
a low battery. The Low Battery status is an advanced warning that can occur many days
before a wireless sensor ceases to function. You can configure an alarm for this attribute
to allow the building operator time to locate the sensor and change the battery.
The Alarm State attribute indicates that the object transitioned into alarm or unreliable
conditions. This attribute does not appear in the SCT UI.
Description
Clear Statistics
Resets all the attributes containing diagnostic statistics for this Wireless
Receiver Supervisor and all its Wireless Receiver Objects and Wireless Sensor
Objects.
CW
Offline
True
If True, allows integration between the XL5K system and the Metasys system
extended architecture.
False
Number
Indicates the number of scannable points for all XL5K Controller objects defined for this
object.
Reset Date
Indicates the date of the last Clear Statistics command or due to automatic midnight
rollover.
Date
273
Time
Indicates the time of the last Clear Statistics command or 12:00:00 if due to automatic
midnight rollover.
Transaction
Timeout
Number
Indicates the number of transmissions (packets) since the last Clear Statistics command
where no response data was obtained and the transmission was retried.
Transmit Error
Number
Indicates the number of transmissions (packets) since the last Clear Statistics command
that have errors (for example, bad data was returned).
Transmits Per
Minute
Number
None
Disable
None
Enable
None
Latch Statistics
None
Field Device
Menu Selection: Insert > Field Device
Inserts one of the following types of field device objects under the selected integration:
MS/TP Field Bus Integration - MS/TP Field Bus Integration Object (FEC Family BACnet Device) BACnet Device
Object (any other BACnet Device)
N2 Integration (N2 Trunk) - N2 Controller Object (for example, AHU and VMA)
VND Controller (Vendor) - 3rd party vendor controller, offered through Systems Integrations Services (SIS)
274
a. Select Assisted Device Definition and click the Invoke Auto Discovery button to discover existing controllers
or devices on the network. This is available in the Site Management Portal (SMP) only.
Note: In the Wizard Auto Detect Utility window, if Results are from a previous discovery appears next to
the Close button, the displayed results are from the last time a discovery was run. These cached
results may not reflect all items currently on the network. To clear the old results and perform a new
auto discovery, click Restart. Click any column header to sort discovered devices.
b. Select Manual Device Definition and select the desired address from the menu.
3. In the Identifier selection, enter a unique identifier.
4. In the Configure selection, click any tabs that may appear for further device configuration.
5. Click Finish to confirm the field device configuration.
Note: If the navigation tree does not automatically update for defined points after adding a field device using
Auto Discovery (+ sign appears next to device in tree) select Refresh All Tabs on the Action Menu to
update.
See one of the following sections for more information:
Related Documentation
N1 Migration Object
VND Controller
The Johnson Controls NAE Device object includes attributes and methods not required by the BACnet
Device object. For information on the NAE Device object, see the Engine Device Object section.
The Object Type for this object is labeled Non-FEC BACnet Device in the software.
The BACnet Device object defines a standardized BACnet object with attributes that represent the external, visible
characteristics of a device. Only one Device object exists in each BACnet Device.
For general information on Metasys system objects, see the Object Help section.
For detailed information on the BACnet Device object, see BACnet Device Attributes.
BACnet Device Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
275
False
APDU Retries
4,000
See next
column
Active VT Sessions
120
Configuration Files
Identifies the files within the device that determine what device image
can be backed up. The contents of this attribute are only required to
be valid during the backup procedure. If the device supports the
BACnet backup and restore procedure, this attribute is supported.
DST Status
Database Revision
Description
Firmware Version
Graphic
CW
Graphic Alias
CW
Interval Offset
CW
277
Local Time
Location
CW
Automatic
Greater or equal to 50
Max Info Frames
10 (FEC)
20 (NxE)
Max Master
127
Model Name
Offline
Profile Name
False
278
Protocol Revision
Indicates the minor revision level of the BACnet standard. This starts
at 1 and increases for each subsequent release.
If the Protocol Version attribute changes, this number reverts to zero.
This attribute is required for all devices with BACnet Protocol Version
1, Protocol Revision 1 and above. If this attribute is not present, the
device is Protocol Version 1, Protocol Revision 0.
Protocol Version
Restart Notification
Recipients
CW
Segmentation
Time Synchronization
Interval
CW
279
VT Classes Supported
Vendor ID
Vendor Name
1
2
3
4
5
6
7
8
None
Resets the States Text across a supervisory device by rediscovering text strings
from all mapped BACnet objects.
Note: When the Rediscover Text Strings command is sent from the Site Director
device UI to another supervisory device and the UI is running on the supervisory
device, you must close and restart the UI on the supervisory device in order for
the text to appear correctly.
Password
Sync Field Device None
Times
280
For general information on Metasys system objects, see the Object Help section.
BACnet Protocol Engine Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 137: BACnet Protocol Engine Attributes - Diagnostic Tab
Attribute Name
Data Type Notes1
Description
Abort Rcv
Number
Abort Tx
Number
Ack Rcv
Number
Ack Tx
Number
Number
Clear Statistics
True or False W
Number
Conf Req Tx
Number
Error Rcv
Number
Error Tx
Number
Latch Statistics
True or False W
Local Abort Tx
Number
Number
Net Messages Tx
Number
Number
Number
Number
Number
Number
Number
Indicates the largest number of client requests that were queued for
transmission.
281
Number
Number
Number
Number
Record Count
Number
Reject Rcv
Number
Reject Tx
Number
Req Retries Tx
Number
Reset Date
Date
Reset Time
Time
Number
Seg Ack Tx
Number
Number
Number
Seg Retries Tx
Number
Number
Segment Ack Tx
Number
Segment Rcv
Number
Segment Tx
Number
Number
Simple Ack Tx
Number
Transaction Timeouts
Number
Number
282
Number
Tx Record Count
Number
Unconfirmed Rcv
Number
Unconfirmed Tx
Number
Number
283
Latch Statistics
Updates the displayed statistics with the current values.
Local Abort Tx
Contains the number of application layer abort messages generated locally (for example, messages that used up
all allowed retries and did not get an acknowledge from the remote device).
Net Messages Rcv
Contains the number of messages received at the network layer.
Net Messages Tx
Contains the number of messages transmitted at the network layer.
Net Rejects Rcv
Contains the number of reject messages received at the network layer.
Net Routed Messages
Contains the number of messages routed through the network layer from one network (for example, IP) to another
(for example, MS/TP).
Net Routes Busy
Contains the number of messages not sent because the network route is busy or not initialized.
Net Unknown Msg Rcv
Contains the number of unknown messages received at the network layer.
Net Unknown Routes
Contains the number of messages not sent due to unknown route information.
Peak Pending Queue Count
Indicates the largest number of client requests that were queued for transmission.
Peak Unknown Queue Count
Indicates the largest number of client requests the unknown queue contained at one time.
Pending Queue Count
Indicates the number of client requests currently queued for transmission.
Rcv Messages Discarded
Indicates the number of messages received from the network that were not processed due to lack of resources or
because there were too many requests for the Metasys Engine to process.
Rcv Msg Rate
Indicates the number of messages received in the last minute.
284
285
Segment Tx
Contains the number of segment messages sent.
Simple Ack Rcv
Contains the number of simple acknowledgment messages received.
Simple Ack Tx
Contains the number of simple acknowledgment messages sent.
Transaction Timeouts
Indicates the number of MS/TP Postpone messages sent due to a late reply to a received Confirmed Request
message (that is, this devices applications could not process the request before a low-level MS/TP answer was
required).
Transmits Per Minute
Displays the calculated number of transmissions per minute.
Tx Messages Discarded
Indicates the number of client requests aborted due to lack of resources. Usually, this situation occurs due to memory
issues in the controller.
Tx Record Count
Indicates the number of active state machines currently in use for transmission of client requests.
Unconfirmed Rcv
Contains the number of unconfirmed messages received.
Unconfirmed Tx
Contains the number of unconfirmed messages sent.
Unknown Queue Count
Indicates the number of current client requests that need network address resolution.
BACnet Protocol Engine Commands
The following table lists the commands supported by the BACnet Protocol Engine Object.
Table 138: BACnet Protocol Engine Commands
Command Name
Parameters
Clear Statistics
None
Latch Statistics
None
286
Latch Statistics
Updates the displayed statistics with the current values.
CW
Graphic
CW
True
If True, allows integration between the Metasys system and the LON controller.
Indicates the graphic associated with the object.
Graphic Alias CW
Indicates a portion of the graphics item reference, up to and including the name of
the folder containing this object or the controller containing this point.
Offline
False
Displays the offline or online status of connected hardware. The LONWORKS network
server updates this attribute value.
Present
Value
Offline
XIF Present
1
Indicates whether a XIF file matching this controllers Program ID was found.
C - Configurable, W - Writable
Error Log
NOERROR
Shows the error log according to the last standard LONWORKS network Query
Status message.
Lost Message
Shows the number messages lost according to the last standard LONWORKS
network Query Status message.
Missed Messages
Neuron Model
Node State
Offline Poll Count
Metasys SMP Help: Insert Menu
Shows the state of the node according to the last standard LONWORKS network
Query Status message.
0
Displays the total number of times this controller was sent a poll while offline.
287
Shows the number of times the transaction full message appeared in the
last standard LONWORKS network Query Status message.
Reset Cause
Clear
Shows the cause of the last reset according to the last standard LONWORKS
network Query Status message.
Reset Date
Contains the date stamp of the last local Neuron statistics reset command.
Reset Time
Contains the time stamp of the last local Neuron statistics reset command.
Total Messages to
Device
Displays the total number of failures for single messages sent to this
controller.
Transaction Timeouts
Shows the timeouts that appeared in the last standard LONWORKS network
Query Status message.
Transmit Errors
Shows the number of transmit errors that appeared in the last standard
LONWORKS network Query Status message.
Version Number
Shows the version number according to the last standard LONWORKS network
Query Status message.
C - Configurable, W - Writable
288
Neuron Model
Shows the Neuron model according to the last standard LONWORKS network Query Status message.
Node State
Shows the state of the node according to the last standard LONWORKS network Query Status message.
Offline
Displays the offline or online status of connected hardware. The LONWORKS network server updates this attribute
value.
Offline Poll Count
Displays the total number of times this controller was sent a poll while offline.
Present Value
Displays the communication status of the object.
Receive Transaction Full
Shows the number of times the transaction full message appeared in the last standard LONWORKS network Query
Status message.
Reset Cause
Shows the cause of the last reset according to the last standard LONWORKS network Query Status message.
Reset Date
Contains the date stamp of the last local Neuron statistics reset command.
Reset Time
Contains the time stamp of the last local Neuron statistics reset command.
Total Messages To Device
Displays the total number of messages sent to this controller.
Total Single Message Failures
Displays the total number of failures for single messages sent to this controller.
Transaction Timeouts
Shows the timeouts that appeared in the last standard LONWORKS network Query Status message.
Transmit Errors
Shows the number of transmit errors that appeared in the last standard LONWORKS network Query Status message.
Version Number
Shows the version number according to the last standard LONWORKS network Query Status message.
XIF Present
Indicates whether a external interface file (XIF) file matching this controllers Program ID was found.
Metasys SMP Help: Insert Menu
289
None
Resets the statistics for the integrated LONWORKS network. The contents of the Query Status
message reflect these statistics:
Transmit Errors
Transaction Timeouts
Lost Message
Reset Cause
Node State
Version Number
Error Log
Neuron Model
Disable
None
Disables the entire LONWORKS network integration. No requests are made to the field trunk and
no data broadcasts to the network are processed.
Enable
None
Latch
Statistics
None
Resets the statistics for the integrated LONWORKS network. The contents of the Query Status
message reflect these statistics:
Transmit Errors
Transaction Timeouts
Lost Message
Reset Cause
Node State
Version Number
Error Log
Neuron Model
Transmit Errors
Transaction Timeouts
Lost Messages
Missed Messages
Reset Cause
Node State
Version Number
290
Error Log
Neuron Model
For information on gathering this statistical information, see the Latch Statistics command.
Disable
Disables the entire LONWORKS network integration. No requests are made to the field trunk and no data broadcasts
to the network are processed.
Enable
Allows the integration to function normally.
Latch Statistics
Updates the displayed statistics with the current values. The following attributes reflect the statistics:
Transmit Errors
Transaction Timeouts
Lost Messages
Missed Messages
Reset Cause
Node State
Version Number
Error Log
Neuron Model
For information on clearing this statistical information, see the Clear Statistics command.
N2 Controller Object
The N2 Controller object defines a physical device such as a DX-9100, VAV Modular Assembly (VMA), or Unitary
(UNT) controller on the N2 Bus of the NAE and is required for mapping data from the controller into the system. The
N2 Controller object monitors the device and reports online/offline transitions. This object also allows you to access
information about the N2 controllers.
For general information on Metasys system objects, see the Object Help section.
N2 Controller Concepts
Supported Controllers
This table lists all N2 controllers supported by the system.
Metasys Integrator units, VAV, UNT, and AHU controllers are supported at all revision levels.
291
Protocol Type
Comments
DR-9100
Sys91
Room Controller
DR-9101
Rev 2.x
Sys91
Room Controller
DC-9100
Sys91
Plant Controller
DO-9100
Rev 1.x
Sys91
Digital Optimizer
DX-9100 (V.1)
Rev 1.x
Sys91
Digital Controller
DX-9100 (V.2)
Rev 2.x
Sys91
Digital Controller
TC-9100
Sys91
Temperature Controller
XT-9100
Rev 1.x
Sys91
Extension Module
XTM-101
Rev 1.x
Sys91
Extension Module
XTM-105
Rev 1.x
Sys91
Extension Module
XTM-905
Rev 1.x
Sys91
Extension Module
LCP-100
Revs all
Sys91
N2 Open
UNT
N2 Open
Unitary Controller
TC-9102
TC-9109
Revs all
VAV
Revs all
N2 Open
AHU
Revs all
N2 Open
PHX
Revs all
N2 Open
VMA (VMA14)
Revs all
N2B
VND
N2 Open
ILC
N2 Other
N2 Controller Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 143: N2 Controller Object Attributes - Focus/Configuration Tab
1
Attribute Name
Data Type
Notes Description
Graphic
Object
Reference
CNW
Graphic Alias
Text
CW
292
True or False
Present Value
Enable
Brings the controller from the offline state to the online state (Comm. Enabled).
VND Controller
The VND (Vendor) Controller object defines a physical vendor device on a bus of the NAE and is required for mapping
data from the controller into the system.
For general information on Metasys system objects, see the Object Help section.
293
True or False
CW
True
Graphic
Object
Reference
CNW
Null
Graphic Alias
Text
CW
Offline
True or False
Present Value
True
Maximum 256
characters
Count
Number
Errors In
Number
Errors Out
Number
294
Reset Date
Date
Reset Time
Time
Transmits In
Number
Transmits Out
Number
C - Configurable, W - Writable
295
Reset Date
Contains the date stamp of the last Clear Statistics command.
Reset Time
Contains the time stamp of the last Clear Statistics command.
Transmits In
Indicates the rate of transmissions received by the vendor device.
Transmits Out
Indicates the rate of transmissions sent by the vendor device.
VND Controller Commands
The table below lists the commands supported by the VND Controller.
Table 147: VND Controller Object Commands
Command Name
Parameters
Clear Statistics
None
Disable
None
Enable
None
Latch Statistics
None
296
For general information on Metasys system objects, see the Object Help section.
Wireless Receiver Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 148: Wireless Receiver Object Attributes - Focus/Configuration Tab
1
Attribute Name
Data Type
Initial Value Values/Options/Range Attribute Description
Notes
Disable Automatic
Alarming
True or False
CW
Graphic
Object
reference
CW
Graphic Alias
Text
CW
Host Name
Text
IP Address
Set of values
Low Battery
True or False
False
False
True
Maximum 256
characters
CW
0.0.0.0
xxx.x.x.xxx
297
Number
Present Value
CW
150
C - Configurable, W - Writable
mmyy
Firmware Version
Number
Hardware Version
Number
C - Configurable, W - Writable
298
Host Name
Indicates the host name of the wireless receiver. When a host name is given, the system attempts to resolve the
Host Name and IP Address using domain name system (DNS)/Dynamic Host Configuration Protocol (DHCP)
(assuming that the installer assigned a host name to the wireless receiver and enabled DHCP). If the device can be
located using the ping hostname command, the system can resolve the host name to an IP address. After resolving
the host name, the system updates the IP address.
IP Address
Indicates the IP Address of the wireless receiver.
Low Battery
Indicates if any wireless sensors defined as children of the Wireless Receiver object have a low battery. The Low
Battery status is an advanced warning that can occur many days before a wireless sensor ceases to function. You
can configure an alarm for this attribute to allow the building operator time to locate the sensor and change the
battery.
Max Data Life
Indicates the maximum amount of time in seconds that the wireless receiver module waits for a transmission from
a wireless sensor before generating a report that tells the NAE that the Wireless Sensor Object is unreliable due to
Data Life Timeout.
Present Value
Indicates the online/offline state of the wireless receiver.
Status
Indicates the following status of the object:
Offline Communication with the physical hardware has failed.
299
Object
Reference
Max Value
Real value
CW
3.0
Real value
-3.0
Occupancy
Request
Object
Reference
CW
Occupancy Time
Number
Uses Unocc Occ (Set Changes to Occupied after pushing the Temporary
106).
Occupied button on the Transmitter, if supported by
that model. The Occupied state is held for the
minutes defined by the Occupancy Time attribute,
or until cancelled by a release command.
CW
Range = 2240
minutes
300
Attribute
Reference
CNW
Offset
Real value
CW
Range = +/- 3
degrees
Units from the Units
attribute.
Units from the Units Indicates the zone temperature reading at the
attribute and reliability wireless sensor.
from the Reliability
attribute.
Present Value
Real value
Property Code
Number
CW
Range = 131
Reliability Action
One state
from a set
CW
None
Uses Reliability
Action (Set 14).
301
Real value
None
Attribute
Reference
CNW
Number
Transmitter Id
Number
CW
Units = Minutes
Range = 1511
302
One type
from a set
CW
CNW
Number
RF Quality
Number
303
Number
Signal Strength
Object
Reference
304
Occupancy Status
Changes to Occupied after pushing the Temporary Occupied button on the Transmitter, if supported by that model.
The Occupied state is held for the minutes defined by the Occupancy Time attribute, or until cancelled by a release
command.
Occupancy Time
Indicates the time in minutes that the Occupied Output (if defined) is overridden to the Occupied state after pushing
the Temporary Occupied button on the Transmitter.
Occupied Output
Provides an optional reference to a binary object located anywhere on the Metasys network. The binary object is
commanded to Occupied/Unoccupied when the Occupancy Status attribute changes states.
Note: The Present Value attribute of the referenced object at the Priority Scheduling optimal start (OST) priority
writes to the output commands.
The Present Value attribute of the referenced object at the Priority Scheduling OST priority writes the None
Data Type value to the release commands.
These operations assume that the referenced object is an output object that has a Present Value that can
be written to. Keep this in mind when mapping objects from controllers. You would normally map these points
as input points (Active Interconnect (AI), BI, Metasys System Integrator (MSI), but for proper operation you
must map the points as output points (AO, BO, multistate object output (MSO)).
Offset
Indicates the offset value that is added to the zone temperature reading before updating the Present Value, forcing
the Present Value to match a calibrated temperature measured at the wireless sensor.
Present Value
Indicates the zone temperature reading at the wireless sensor.
Property Code
Indicates the Property Code address of the wireless sensor. This setting must match the Property Code address
switch setting of the wireless temperature sensor.
Reliability Action
Indicates the action taken on the three output references ( Zone Temp Output, Setpoint Output, and Occupied
Output) when the wireless sensor object goes Unreliable. The actions are No Action or Release commands.
RF Quality
Indicates the signal quality level with respect to unwanted wireless noise or interference. This attribute displays a
number from 0 to 100. A number less than 50 indicates too much interference.
Rx Data Life Errors
Indicates the diagnostic measure of the number of Data Life detected by the receiver module. Data Life errors occur
when a wireless sensor does not report its status to the wireless receiver before the Max Data Life timer expires.
The Wireless Receiver Supervisor Objects Clear Statistics command resets this attribute.
305
Setpoint
Indicates the Setpoint based on three variables: the Setpoint Adjustment reading (the setpoint adjust dial position)
at the wireless sensor, the Min Value, and the Max Value.
The wireless sensor model determines the Setpoint Adjustment. Options include:
None
Warmer/Cooler (Range = +/- 5 Deg F)
Remote Setpoint (Range = 55 to 85 Deg F/13 to 29 Deg C)
If the Min Value is greater than the Max Value, the Setpoint is forced to the Min Value. Otherwise, these attributes
are all used to compute the Setpoint with the following formula:
SP = [(Max Value - Min Value) x (dial position x 0.01)] + Min Value
Setpoint Output
Provides an optional reference to a temperature Setpoint object located anywhere on the Metasys network. The
temperature Setpoint object is commanded when the wireless sensor reports an updated Setpoint value.
Note: The Present Value attribute of the referenced object at the Priority Scheduling OST priority writes to the
output commands.
The Present Value attribute of the referenced object at the Priority Scheduling OST priority writes the None
Data Type value to the release commands.
These operations assume that the referenced object is an output object that has a Present Value that can
be written to. Keep this in mind when mapping objects from controllers. You would normally map these points
as input points (AI, BI, Metasys System Integrator (MSI)), but for proper operation you must map the points
as output points (AO, BO, MSO).
Signal Strength
Indicates the wireless signal strength of the wireless sensor as recorded by the wireless receiver module.
Time Remaining
Indicates the time remaining before the Occupied Output (if defined) is released from the Occupied state.
Transmitter Id
Indicates the sensor transmitter Id address of the wireless sensor. This setting must match the transmitter Id address
switch setting of the wireless sensor.
Units
Indicates the engineering units displayed on the user interface (Deg F or Deg C). All temperature and Setpoint values
convert to the proper units.
Zone Temp Output
Provides an optional reference to a temperature input object located anywhere on the Metasys network. The
temperature input object is commanded when the wireless sensor reports an updated Present Value.
306
Note: The Present Value attribute of the referenced object at the Priority Scheduling OST priority writes to the
output commands.
The Present Value attribute of the referenced object at the Priority Scheduling OST priority writes the None
Data Type value to the release commands.
These operations assume that the referenced object is an output object that has a Present Value that can
be written to. Keep this in mind when mapping objects from controllers. You would normally map these points
as input points (AI, BI, MSI), but for proper operation you must map the points as output points (AO, BO,
MSO).
Wireless Sensor Commands
The table below lists the commands supported by the Wireless Sensor Object.
Table 152: Wireless Sensor Object Commands
Command Name
Parameters
Release
None
True or False
Graphic
Object reference CW
Graphic Alias
Text
CW
CW
True
True or False
Present Value
Uses
Controller
Status
C - Configurable, W - Writable
Error Percent
Number
Errors Today
Number
Packets Today
Number
Number
Retries Today
Number
Transmits Per
Minute
Number
C - Configurable, W - Writable
308
Graphic Alias
Indicates a portion of the graphics item reference, up to and including the name of the folder containing this object
or the controller containing this point.
Offline
Indicates the offline/online state of the connected hardware.
Packets Today
Indicates the number of transmissions (packets) since midnight.
Point Scan Time
Indicates the total amount of time to scan for point data from this controller.
Present Value
Indicates the communication status of the device.
Retries Today
Indicates the number of transmissions (packets) since midnight where no response data was obtained, causing the
transmission to be retried.
Status
Indicates the following status of the object:
Parameters
Clear Statistics
None
Disable
None
Enable
None
Latch Statistics
None
309
Disable
Disables the XL-5000 controller integration. No requests are made to the field trunk for that controller and all packets
received from the Honeywell field device are ignored.
Enable
Allows the integration to function normally.
Latch Statistics
Updates the displayed statistics with the current values.
Field Point
Menu Selection: Insert > Field Point
Inserts one of the following types of field points into a field device under an integration:
N2 Trunk
Analog Input Object (AI), Analog Output Object (AO), Accumulator Objects, Binary Input Object (BI), Binary
Output Object (BO), Multistate Input Object (MI), Multistate Output Object (MO)
BACnet
All field points listed for the N2 trunk plus Analog Value Object (AV), Averaging Extensions, Binary Value Object
(BV), Calendar Object, Electric Demand Control Object, Electric Demand Monitoring Object, Event Enrollment
Object, Generator Load Control Object, Group Object, Life Safety Point Object, Life Safety Zone Object, Multistate
Value Object (MV), Notification Class Object, Schedule Object, Trend Log
MS/TP Field Bus Integration
Accumulator Objects, Analog Input Object (AI), Analog Output Object (AO), Analog Value Object (AV), Binary
Input Object (BI), Binary Output Object (BO), Binary Value Object (BV), Multistate Value Object (MV), Calendar
Object, Schedule Object, Notification Class Object, Trend Log
LON Trunk
Analog Input Object (AI), Analog Output Object (AO), Accumulator Objects, Binary Input Object (BI), Binary
Output Object (BO), Multistate Input Object (MI), Multistate Output Object (MO), Generic Integration Object (GIO)
Note: You can no longer manually add a GIO to a LON trunk; however, the GIO is still supported in existing
databases, even after upgrading to the next software release.
N1 Migration
All field points listed for the N2 trunk plus Generic Integration Object (GIO) and N1 PID Loop Object.
VND Integration (Vendor)
Analog Input Object (AI), Analog Output Object (AO), Accumulator Objects, Binary Input Object (BI), Binary
Output Object (BO), Multistate Input Object (MI), Multistate Output Object (MO)
Wireless Supervisor Integration
310
Tip: On the Select Definition Mode screen, select Assisted Point Definition to automatically discover existing points
on the network. Or on the Select Definition Mode screen, select Manual Point Definition.
Tip: Specifying the Instance Number for a field device point is different depending on if you are defining the point
online or offline with SCT. If you are inserting the point online, you specify the Instance Number on the Select
Data Source screen. If you are inserting the point offline with SCT, the Select Data Source screen is blank,
and you define the Instance Number on the Configure screen under the Hardware tab, which is two screens
later in the Insert Point Wizard.
Tip: When adding a LONWORKS point manually, the Target Reference appears blank. Manually type the path for
the Target Reference (path into the controller for the data being mapped by the object) in the text box on the
Select Data Source screen.
Tip: Select the Hardware tab on the Configure screen for further configuration.
See one of the following sections for more information:
Related Documentation
N1 Migration Object
CW
BW
0.1
Device Type
CNW
CNW
Null
Descriptions
311
Descriptions
Display Precision CW
CW
10ths
Max Value
CW
BW
1.7E38
Min Value
CW
BW
-1.7E38
Out of Service
CW
BW
False
Present Value
DNRW
DNRW
Reliability
BW
Resolution
Status Flags
Reliable
Indicates the smallest possible change in
Present Value (in engineering units) and is
equal to the Display Precision. This
attribute has the data type required by the
standard BACnet property.
False,
False,
False,
False
Units
CW
Deg F
312
Use Remote
Alarming
1
2
Descriptions
Indicates the time period (in hundredths of
a second) between updates to Present
Value when the input is not overridden or
out of service.
False
BCW
False
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, N - Value Not Required, R Affected by Object Reliability, W - Writable
For MS/TP Analog Inputs, COV Increment may not be writable, based on its configuration.
313
Out of Service
Used to de-couple the object from the physical input. When Out of Service is True, the object de-couples the Present
Value and Reliability from the hardware. The Reliability is writable when Out Of Service is True. When de-coupled,
the Present Value can be changed to simulate specific conditions or for test purposes.
Additionally, the Out of Service state of the Status Flags attribute is set to True and the Fault state is decoupled from
the physical input when Out of Service is True.
Present Value
Indicates the current value of the analog input object in the defined Units. When Out of Service is True, this attribute
is writable.
Reliability
Indicates whether the Present Value is unreliable.
Examples:
When Out of Service is True, the Reliability attribute may be written directly.
Resolution
Indicates the smallest possible change in Present Value (in engineering units) and is equal to the Display Precision.
This attribute has the data type required by the standard BACnet property.
Status Flags
Indicates the general status of the Analog Input object in BACnet terms and contains four independent states.
The four flags are:
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by
BACnet Intrinsic Alarming.)
Fault - True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is True if the Present Value is overridden at the hardware source level.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Units
Indicates the engineering measurement units used by the object.
Update Interval
Indicates the time period (in hundredths of a second) between updates to Present Value when the input is not
overridden or out of service.
314
315
When an Out Of Service command is issued, the NxE does not communicate subsequent changes (operator or
system) to the field device.
Note:
For BACnet objects, this command is dependent on the ability to write the Out Of Service attribute of the
BACnet Analog Input object in the remote BACnet device. Objects in the N30, for example, do not support
this command.
For integrated N2 objects, this command is dependent on the ability to set the AI point in the N2 controller
to an override state. System 91 controllers, for example, do not support this command.
a consistent interface to point objects for all controller types, so they appear as a homogenous set to the user
interface
flexibility in point mapping
permanent update of setpoints in controllers. The user has the ability to write to the permanent memory of some
controllers.
support for all Metasys controllers
For example, this object allows you to command a damper to a given position from a supervisory controller.
For general information on Metasys system objects, see Common Object Attributes.
Analog Output Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 158: Analog Output Object Attributes - Focus/Configuration Tab
Attribute Name Data Type Notes1
BACnet Initial Value Values/Options/Range
1
Notes
Description
COV Increment
Real value
CW
BW
0.1
Specifies the
minimum change
in Present Value
required for the
object to report a
change.
Device Type
Text
CW
Null
Limit: 20 characters
Contains a
description of the
physical device
connected to the
object.
316
Description
CW
CW
10ths
Defines the
decimal rounding
and the decimal
places to display of
the Present Value
and associated
attributes.
Max Value
Real value
CW
BW
100.0
Min Value
Real value
CW
BW
0.0
Out of Service
True or False CW
BW
Used to de-couple
the object from the
physical output.
When Out of
Service is True, the
object de-couples
the Present Value
and Reliability from
the hardware. The
Reliability is
writable when Out
Of Service is True.
When de-coupled,
the Present Value
can be changed to
simulate specific
conditions or for
test purposes.
Additionally, the
Out of Service
state of the Status
Flag attribute is set
to True and the
Fault state is
decoupled from the
physical input
when Out of
Service is True.
Present Value
Real value
Priority Array
Set of values
DNRW
BW
0.0
Lists values of the
object in level of
importance.
317
One value
from a set
Resolution
Real value
BW
0.1
Description
318
Series of True
or False states
False,
False,
False,
False
Description
Units
One value
from a list
CW
Overridden Overridden
flag is True if
the Present
Value is
overridden at
the hardware
source level.
Out of Service
- Out of
Service flag is
True if the Out
of Service
attribute value
is True;
otherwise, the
Out of Service
flag is False.
319
True or False W
Use Remote
Alarming
True or False
Description
False
BCW
False
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, N - Value Not Required, R Affected by Object Reliability, W - Writable
320
For MS/TP Analog Outputs, COV Increment may not be writable, based on its configuration.
When Out of Service is True, the Reliability attribute may be written directly.
Resolution
Indicates the smallest possible change in Present Value (in engineering units) and is equal to the Display Precision.
This attribute has the data type required by the standard BACnet property.
321
Status Flags
Indicates the general status of the Analog Output object in BACnet terms and contains four independent states.
The four flags are:
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by
BACnet Intrinsic Alarming.)
Fault - True if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is True if the Present Value is overridden at the hardware source level.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Units
Indicates the engineering measurements units used by the object.
Use COV Min Send Time
Configures the object to send COV messages on a periodic basis instead of on every change of value that exceeds
the COV Increment. This attribute is typically set to True for objects with values that fluctuate greatly, such as air
pressure, to decrease the number of COV messages. The change of value still must exceed the COV Increment to
be reported. This attribute is available only on Metasys system field devices, such as the MS/TP field devices.
Use Remote Alarming
When the attribute Intrinsic Alarming Defined is set to True, determines where alarms for the object originate. If the
remote integrated object contains attributes for originating alarms, then Use Remote Alarming defaults to True,
causing the local mapper object to accept alarms from the remote integrated object that are routed to the NxE. If
the remote integrated object does not contain attributes for originating alarms, then Use Remote Alarming defaults
to False causing the local mapper object to originate alarms. When Use Remote Alarming is false, any alarms from
the remote integrated object are ignored at the NxE. If the value of Use Remote Alarming is changed, a restart of
the NxE may be required to assure correct operation. This attribute applies only to BACnet integrations.
Analog Output Commands
The table below lists the commands supported by the Analog Output Object.
Table 159: Analog Output Commands
Command Name
Parameters
Adjust
The value to be written to the Present Value. The value must be less than Max
Present value and greater than Min Present Value.
Disable Alarms
None
Enable Alarms
None
In Service
None
Operator Override
Out of Service
Release Operator Override
Release
None
1
None
Attribute name
Command priority
322
Attribute name
None
For the Release Operator Override, Release, and Release All commands, if all Command Priorities have been released and
a Relinquish Default is not defined, the supervisory controller gives control to the actual hardware.
Setpoint command is supported by N2 protocol only.
323
For BACnet objects, support of this command is dependent on the ability to write the Out Of Service attribute.
Release Operator Override
Releases Command Priority Operator Override (8) from Present Value.
Release
Releases the identified Command Priority from the specified attribute and allows the next highest priority to control
it.
Release All
Releases Command Priorities 3 through 16 (Default), from the specified, writable attribute. Command Priorities 1
and 2 remain.
Important: The Release All command may not cause an immediate return to automatic operation. The Release
All command clears all command priorities, including those that come from applications and features.
When this happens, the output point goes to its Relinquish Default condition. In some cases, the
application or feature may have sent a command that does not match Relinquish Default. In this instance,
the output point does not end in the state that the applications or features intended. This situation can
cause unexpected operation to occur; for example, a space could overcool or overheat, a fan might
run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
Setpoint
Writes the value to the permanent memory of the field device and may change the Present Value if there is no
override.
324
Real Value
CW
BW
0.01
Display
Precision
One value
from a set
CW
CW
10ths
Max Value
Real value
CW
BW
1.7E38
Min Value
Real value
CW
BW
-1.7E38
False
Always False
DRW
DRW
Contains prioritized commands
in effect for the object. The
highest priority command is sent
to the Present Value attribute.
Reliability
One value
from a set
BW
Reliable
325
Series of
True or False
values
False,
False,
False,
False
326
One type
from a set
Use Remote
Alarming
True or False
1
2
Blank
BCW
False
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, R - Affected by Object Reliability,
W - Writable
This attribute is required if the object supports COV reporting.
327
Min Value
Defines the lowest reliable value (in engineering units) for the Present Value.
This value is not writable for Analog Value objects in the FEC.
This value is writable if the AV is the ZN-SP on a Net Sensor. This method is the only way to set the range for the
Net Sensor.
Out of Service
This attribute is always False for this object due to the absence of hardware.
Present Value
Indicates the current value of the analog value. Present Value is optionally commandable. The optional Priority
Array must be present for Present Value to be commandable. Values written to Present Value are compared with
the Min Value and Max Value attributes and set the Reliability.
Priority Array
Contains prioritized commands in effect for the object. The highest priority command is sent to the Present Value
attribute.
Reliability
Indicates whether the Present Value is unreliable.
Examples:
When Out of Service is True, the Reliability attribute may be written directly.
Status Flags
Indicates the general status of the Analog Input object in BACnet terms and contains four independent states.
The four flags are:
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by
BACnet Intrinsic Alarming.)
Fault - True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is True if the Present Value is overridden at the hardware source level.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Units
Indicates the engineering measurement units used by the object.
328
The value to be written to the Present Value attribute. The value must be less
than Max Present value and greater than Min Present Value.
Disable Alarms
Enable Alarms
Operator Override
1. Attribute name
2. Command priority
Release All
Attribute name
329
Disable Alarms
Disables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet Event Enrollment objects.
Enable Alarms
Enables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet Event Enrollment objects.
Operator Override
Updates the Present Value at Command Priority Operator Override (8).
The Operator Override command sends the specified command to the internal NxE object, which is then only sent
to the field device when not Out Of Service.
Release Operator Override
Releases Command Priority Operator Override (8) from Present Value.
Release
Releases the identified command priority from the specified, writable attribute, and allows it to be controlled by the
next highest priority.
Release All
Releases Command Priorities 3 through 16 from the specified, writable attribute. Command Priorities 1 (Manual
Emergency) and 2 (Fire Application) remain.
Important: The Release All command may not cause an immediate return to automatic operation. The Release
All command clears all command priorities, including those that come from applications and features.
When this happens, the output point goes to its Relinquish Default condition. In some cases, the
application or feature may have sent a command that does not match Relinquish Default. In this instance,
the output point does not end in the state that the applications or features intended. This situation can
cause unexpected operation to occur; for example, a space could overcool or overheat, a fan might
run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
Accumulator Objects
Menu Selection: Insert > Object > Accumulator
The accumulator object allows you to count pulses, which are often provided by energy meters. The accumulator
objects can feed their Present Values to the Pulse Meter Object.
Note: The Accumulators Interface Value updates when the hardware is read by the Pulse Meter Object or when
the hardwares current value changes.
Table 162 describes the types of accumulator objects and how to add them to the Metasys system. The Integration
(Device) Type column indicates the type of integration and device in which the accumulator object resides.
330
IP BACnet
Integration
(BACnet Device)
331
Provides integration of the wide variety of N2 To add an accumulator from an N2 device on an N2 trunk:
controller binary input/pulse counters, resulting
1. From the SMP UI or SCT UI, add an N2 trunk.
in a consistent interface for point mapping any
2. Add an N2 device type compatible with the field
N2 controller types.
device.
Note: An N2 accumulator or pulse counter is
3. Map the accumulator (Accumulator or Pulse Counter
mapped at the engine via the Insert Point
type) at the engine (that is, add the Accumulator point
Wizard.
to the N2 device using the Insert Point Wizard).
4. Define the Rollover Limit:
You must set the rollover limit in the N2 accumulator
to match the rollover limit of the N2 field device
selected. For example, AHU or UNT devices have a
rollover limit of 4,294,967,295. A DX-9100 CNT point
has a rollover limit set by the GX-9100 configuration
tool. An XT-9100 or XTM CNT point has a rollover
limit set by either the GX-9100 configuration tool or
XTM configuration tool.
Map BI7 or BI8 for an AHU, BI4 for a UNT or VAV, or
analog data integer (ADI) network point types for a
DX-9100 or XTM.
Figure 38 illustrates the interaction between the different types of accumulators and the accumulator in the engine,
showing the key attributes and functionality.
332
An FEC family BACnet device that resides on the MS/TP field bus has a binary input with a Dry Contact Pulse signal
(MISC-MTR) created in CCT. This provides an FEC accumulator. A BACnet device that resides on either the BACnet
integration or the MS/TP field bus has an accumulator. Both the FEC accumulator and BACnet accumulators have
BACnet Prescale, Units, and Limit Monitoring Interval attributes that interact with the accumulator in the engine via
the prescaled Present Value.
333
An N2 controller resides on the N2 trunk, and has an attribute that counts. Similarly, other devices that reside on
other integrations (for example, a LONWORKS device on a LONWORKS integration) that have attributes that count may
take advantage of the accumulator functionality. The accumulator in the engine uses the count value.
The accumulator in the engine uses the prescaled Present Value or counts from the devices with the key engine
accumulator attributes listed in the figure. For details on the calculations used by and functionality of these attributes,
see the Accumulator Attributes section.
The accumulators prescaled Present Value is used by the Pulse Meter, DLLR, or IEIEJ objects. You can trend the
prescaled Present Value, which may then be used by Energy Essentials. You also can trend the accumulators Pulse
Rate, Scaled Present Value, or Value Before Change attributes.
Note: The prescaled Present Value, as well as its associated commands and attributes (Preset Value, Value Before
Change, Max Value, Value Set), do not necessarily have the same units as Scaled Present Value or the
Units attribute.
The header of the focus window shows the Scaled Present Value after the scale factor has been applied to the
Present Value, as well as the units that apply to the Scaled Present Value.
For general information on Metasys system objects, see the Object Help section.
Accumulator Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
334
N2
CW
Other
When True, causes the object to use the first good input count value
received after previously being unreliable as strictly an initial value.
Any archived or last known value for input count is ignored. If the input
device resets or loses power, uncontrolled changes to the input count
value are filtered out and do not result in a spike in accumulator values.
Use this setting in cases where the input device is not known to
preserve its count value over a power loss (for example, in a LONWORKS
integration an LN-PRG20 GPI, and in an N2 integration a UNT).
When False, causes the object to use the first good input device count
value received after previously being unreliable as a valid change from
the archived or last known value for input count. This means the first
good input device value is used to catch up on any counts that were
missed while the input device was unable to communicate due to either
an NAE restart or communication loss. Do not set this value to False
unless the input device is known to preserve its count value during a
power loss (for example, in an N2 integration, an XTM-105 with a
XPB-821 or in a LONWORKS integration LN-PRG300-2, LNPRG400-2,
LN-PTRG500-2, LN-PRG600, or in a vendor integration BTR Netcom
GmbH device LC14 [Model # 11045013-US], an IDEC SX5L-SBCN081,
or an WATANBE Electric Industry WRBC-DI16F-A002).
Note:
Any mapper object used to deliver a raw count value to the
Accumulator must provide an unreliable value during startup if the
value was not updated from the field controller at the time it is read
by the accumulator. For example, a LON counter mapped as an
AI point object reports as unreliable until it reads a value from the
field controller. If the LON counter is mapped as an AO point object,
it reports as reliable even if the value is not initialized, causing
improper values to be recorded at the accumulator. This may occur
regardless of the value of Anti Spike.
When replacing the input device, set Anti Spike to True before the
replacement is brought online for the first time. This setting prevents
the accumulator value from spiking upward due to an uncontrolled
count value change at the input device. Failure to set Anti Spike
to True can upset the accumulator value. You can use a manual
preset to restore the correct value after the new device is online.
Device Type
All
CNW
Display Precision
All
CW
Interface Value
N2
Internal Units
All
Contains the engineering units for the Present Value, Value Set, Max
Value, and Value Before Change attribute.
335
CW
All
CW
All
CW
336
All
Max Value
All
CW
Indicates the maximum value allowed for the Present Value. The
Present Value is not allowed to exceed this value, and wraps back to
zero when this value is passed. Accumulation does not stop.
Note: If the present value of the Accumulator object is being trended
and its data is sent to the ADS/ODS repository, change this value to
32,767 so that the historian database (JCIHistorianDB) can properly
store its value.
Out of Service
All
337
FEC
CW
N2
Other
This attribute only appears in the snapshot view of the mapper object
and on the Engineering tab of the integration. This attribute applies to
all integrations, except for BACnet integrations. Represents the time,
in seconds, between successive COV messages issued by the local
Accumulator object at a field device, or updates made to the
Accumulator object on the UI.
The field device Accumulator object pushes its Present Value count
up to the Supervisory controller through the COV mechanism. By
requiring a minimum time between successive COVs, the Update
Interval ensures that the integration does not get flooded with COVs
from the Accumulator.
Prescale
All
CW
Present Value
All
NW
Reliability
All
Rollover Limit
N2
CW
Other
Allows you to reset the Present Value. This command writes a supplied
value to the Value Set attribute. The Present Value attribute then gains
its value from the value written to the Value Set attribute. The Value
Before Change takes on the previous value of the Present Value
attribute (that is, the original value before the write processed), and
the Value Change Time is set to the current date and time. This
preserves the Present Value before the command took place. Use this
command to change Present Value if the Accumulator object is in or
out of service.
Represents the actual rollover value of the input pulse counter. This
attribute applies to N2 and Other Accumulators. This value is used to
compute a change rate, which is added to the Accumulator property
to calculate the Pulse Rate and Present Value.
You must set the rollover limit in the N2 accumulator to match the
rollover limit of the N2 field device selected. For example, AHU or UNT
devices have a rollover limit of 4,294,967,295. A DX-9100 CNT point
has a rollover limit set by the GX-9100 configuration tool. An XT-9100
or XTM CNT point has a rollover limit set by the either the GX-9100
configuration tool or XTM configuration tool.
Scale
Scale As Float
All
All
This BACnet property does not appear in a view in the Metasys system.
Indicates the conversion factor to be multiplied with the value of the
Present Value attribute to provide a Scaled Present Value in the units
indicated by the Units attribute. By default, the Present Value and
Scaled Present Value are equal. These values remain equal if you do
not use the accumulators Scale attribute.
CNW
338
All
CNW
All
Status Flag
All
Indicates the power of ten to be multiplied with the value of the Present
Value attribute to get Scaled Present Value. This attribute only applies
if Scale As Float is zero. For example, when Scale As Integer is set to
two, the Present Value is multiplied by 100; while setting Scale As
Integer to -1 multiplies the Present Value by 0.1. When zero (the default
value), the Present Value and Scaled Present Value are equal (see
Scaled Present Value).
All
CW
Contains the engineering units for the Scaled Present Value attribute.
BACnet
CW
All
Indicates the Present Value prior to the last write to the Value Set
property or Present Value command.
All
Indicates the time of the last change to the Value Before Change
attribute or Preset Value command.
Value Set
All
1
2
3
4
BACnet (Third-Party BACnet Device), FEC (FEC Family BACnet Device), N2, Other (LONWORKS , N1, VND, and XL5K, for
example), or All
C - Configurable, D - Default Attribute for Display, N - Value not Required, W - Writable
This attribute only appears in the snapshot view of the mapper object and on the Engineering tab of the integration.
This attribute does not appear in a view; it is a BACnet property.
339
Any mapper object used to deliver a raw count value to the Accumulator must provide an unreliable value
during startup if the value was not updated from the field controller at the time it is read by the accumulator.
For example, a LON counter mapped as an AI point object reports as unreliable until it reads a value
from the field controller. If the LON counter is mapped as an AO point object, it reports as reliable even
if the value is not initialized, causing improper values to be recorded at the accumulator. This may occur
regardless of the value of Anti Spike.
Any mapper object used to deliver a raw count value to the accumulator must be allowed to count up
without disruption from manual commands, schedules, interlocks, or any other function that may change
its value outside the normal counting process. Any such changes may cause the Accumulator to record
improper values regardless of the value of Anti Spike.
When replacing the input device, set Anti Spike to True before the replacement is brought online for the
first time. This setting prevents the accumulator value from spiking upward due to an uncontrolled count
value change at the input device. Failure to set Anti Spike to True can upset the accumulator value. You
can use a manual preset to restore the correct value after the new device is online.
Device Type
Contains a description of the physical device connected to the object.
Display Precision
Determines how many decimal places to display in the Scaled Present Value.
Input Ref
Identifies the attribute reference to the object property that is the pulse count input for the Accumulator object (for
the Other integrations type: LONWORKS , N1, VND, and XL5K, for example). This must be a continuously increasing
positive numeric attribute of another object, such as the present value of a totalization extension to an analog meter.
Interface Value
Indicates current value from the hardware interface. This attribute is the same as input count, but is specific to the
N2 accumulator.
Internal Units
Contains the engineering units for the Present Value, Value Set, Max Value, and Value Before Change attribute.
Metasys SMP Help: Insert Menu
340
Timestamp - Indicates the local date and time when the data was acquired.
Present Value - Indicates the value of the Present Value attribute.
Accumulated Value - Indicates the short-term accumulated value of the counter. The algorithm used to calculate
the accumulated value is a function of the value of accumulator status. If this is the initial read, the value returned
is zero.
Accumulator Status - Indicates the reliability of the data in this list of values. The accumulator status values
include:
-
Normal - Indicates that no event affecting the reliability of the data has occurred during the period from the
preceding to the current qualified reads of the Logging Record attribute (Accumulated Value = current Present
Value - previous Present Value).
Starting - Indicates that the data of the Logging Record attribute is either the first data acquired since startup
by the object identified by Logging Object (that is, timestamp has no wildcard values) or that no data has
been acquired since startup by the object identified by Logging Object (that is, timestamp has all wildcard
values).
Recovered - Indicates that one or more writes to Value Set or changes to Value Before Change occurred
since the Logging Record was acquired by the object identified by Logging Object (Accumulated Value =
[current Present Value - Value Set] + [Value Before Change - previous Present Value]).
Abnormal - Indicates that the accumulation has been carried out, but some unrecoverable event such as
the clocks time changing a significant amount since the Logging Record was acquired by the object identified
by Logging Object.
Failed - Indicates that the accumulation value is not reliable due to some problem.
341
Max Value
Indicates the maximum value allowed for the Present Value. The Present Value is not allowed to exceed this value,
and wraps back to zero when this value is passed. Accumulation does not stop.
Note: If the present value of the Accumulator object is being trended and its data is sent to the ADS repository,
change this value to 32,767 so that the historian database (JCIHistorianDB) can properly store its value.
Out of Service
When set to True, indicates that the object is not tracking pulse count or rate.
Used to de-couple the object from the physical input. When Out of Service is True, the object de-couples the Present
Value and Reliability from the hardware. The Reliability is writable when Out Of Service is True. When de-coupled,
the Present Value can be changed to simulate specific conditions or for test purposes.
When the Accumulator object is placed Out of Service, the current value of the Present Value is saved. While Out
of Service, an N2, FEC, or Other Accumulator continues to track the count of this saved value in the background,
thereby ensuring that no counts are lost. When placed back in service, this new count is copied to the Present Value
attribute.
A third-party BACnet accumulator behaves according to the design of the third-party vendor.
Periodic Update
This attribute only appears in the snapshot view of the mapper object and on the Engineering tab of the integration.
This attribute applies to all integrations, except for BACnet integrations. Represents the time, in seconds, between
successive COV messages issued by the local Accumulator object at a field device, or updates made to the
Accumulator object on the UI.
The field device Accumulator object pushes its Present Value count up to the Supervisory controller through the
COV mechanism. By requiring a minimum time between successive COVs, the Update Interval ensures that the
integration does not get flooded with COVs from the Accumulator.
Prescale
Indicates the coefficients used to convert the accumulated pulses into the Present Value. This attribute uses
moduloDivide integer division (where 5/2 is 2). The algorithm used is:
Present Value = (prescale.multiplier x accumulated-pulses)/
prescale.moduloDivide.
Present Value
Represents the value of the Accumulator object, prescaled via the Prescale attribute. The Present Value falls in the
range between 0 and the Max Value. When the Present Value reaches the Max Value, it rolls over to zero. You can
write to Present Value when it is out of service and you can reset the Present Value by updating the Value Set, or
you can use the Present Value command to do so. The Scaled Present Value is the value of the object displayed
in the UI, not the Present Value. If Scale As Float and Scale As Integer are both zero (the default value), the Present
Value and Scaled Present Value are equal.
Reliability
Indicates whether the Present Value is reliable and why. You can write to Reliability when it is out of service.
342
Rollover Limit
Represents the actual rollover value of the input pulse counter. This attribute applies to N2 and Other Accumulators.
This value is used to compute a change rate, which is added to the Accumulator property to calculate the Pulse
Rate and Present Value.
You must set the rollover limit in the N2 accumulator to match the rollover limit of the N2 field device selected. For
example, AHU or UNT devices have a rollover limit of 4,294,967,295. A DX-9100 CNT point has a rollover limit set
by the GX-9100 configuration tool. An XT-9100 or XTM CNT point has a rollover limit set by the either the GX-9100
configuration tool or XTM configuration tool.
Scale
This BACnet property does not appear in a view in the Metasys system. Indicates the conversion factor to be multiplied
with the value of the Present Value attribute to provide a Scaled Present Value in the units indicated by the Units
attribute. By default, the Present Value and Scaled Present Value are equal. These values remain equal if you do
not use the accumulators Scale attribute.
Scale As Float
Indicates the floating conversion factor to be multiplied with the value of the Present Value attribute to calculate the
Scaled Present Value for the chosen units. If set to zero (the default value), the Scale As Integer value is used and
Scale As Float is ignored.
Scale As Integer
Indicates the power of ten to be multiplied with the value of the Present Value attribute to get Scaled Present Value.
This attribute only applies if Scale As Float is zero. For example, when Scale As Integer is set to two, the Present
Value is multiplied by 100; while setting Scale As Integer to -1 multiplies the Present Value by 0.1. When zero (the
default value), the Present Value and Scaled Present Value are equal (see Scaled Present Value).
Scaled Present Value
Indicates the value of the Present Value attribute conversion. The Present Value is multiplied by the Scale as Float
value when that attribute contains a value (not zero). Otherwise, the Present Value is multiplied by 10 to the power
of the Scale As Integer value (for example, if Scale As Integer is 3, it is multiplied by 1,000 and if Scale As Integer
is -2, it is multiplied by 0.01). This is the actual value of the object.
Status Flags
Indicates the general status of the Accumulator object in BACnet terms and contains four independent states.
The states are:
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True.
Fault - True if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is always False.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of Service
flag is False.
Units
Contains the engineering units for the Scaled Present Value attribute.
343
None
Enable Alarms
None
None
In Service
None
Out of Service
Preset Counter
The value to be written to the N2 device accumulator or pulse counter hardware point.
Preset Value
344
Note: The object specified by the Logging Object Reference can be a Multiple Command object or an Interlock
object. Both are capable of issuing the Get Monitor Data command.
The Accumulator object and the object specified by the Logging Object Reference must reference one another for
the Get Monitor Data command to work.
On the Action Tables tab of the object specified by the Logging Object Reference, the Accumulator object must
be set to receive the Get Monitor Data command.
In the JCI Logging Object Reference field of the Accumulator object, the object issuing the Get Monitor Data
command must be selected. When the JCI Logging Object Reference is specified, the Logging Object Reference
takes on the object type and instance of the specified object.
In Service
Cancels the effect of an Out of Service write or command. The Present Value and Reliability revert to the values
obtained from the physical input. The Present Value attribute continues to receive inputs from the hardware input
while in the Out of Service state and continues to increment its count internally. When the Out of Service is cancelled,
the Present Value attribute of the N2, FEC, or Other Accumulator updates with this new internal count.
A third-party BACnet accumulator behaves according to the design of the third-party vendor.
Out of Service
Allows a user to override the objects hardware input for simulation or other purposes. The Out Of Service command
writes the Present Value to the value of the command parameter and writes the Reliability attribute to Reliable. The
Present Value and Reliability no longer track the physical input, but the N2, FEC, or Other Accumulator continues
to track pulses while out of service. When placed back in service, the Present Value resumes counting pulses.
When an Out Of Service command is issued, the NxE does not communicate subsequent changes (operator or
system) to the field device.
A third-party BACnet accumulator behaves according to the design of the third-party vendor.
Preset Counter
Allows you to set the value to write to the N2 device accumulator or pulse counter hardware point. You cannot adjust
this attribute for a UNT or AHU. This attribute may be used with DX-9100, XTM, or XT hardware.
Preset Value
Allows you to reset the Present Value. This command writes a supplied value to the Value Set attribute. The Present
Value attribute then gains its value from the value written to the Value Set attribute. The Value Before Change takes
on the previous value of the Present Value attribute (that is, the original value before the write processed), and the
Value Change Time is set to the current date and time. This preserves the Present Value before the command took
place. Use this command to change Present Value if the Accumulator object is in or out of service.
345
The Binary Input object integrates N1, N2, and BACnet controllers into supervisory controllers, resulting in:
a consistent interface to point objects for all controller types, so they appear as a homogenous set to the user
interface
flexibility in point mapping
support for all Metasys controllers. See the N2 Controller Object section.
For example, this object allows you to map a fan status into a supervisory controller.
For general information on Metasys system objects, see Common Object Attributes.
Binary Input Concepts
BACnet Polarity Relationships
The relationship between the Present Value of an object and the physical state of the object is determined by the
Polarity attribute.
The table below describes this relationship as defined by BACnet standards. Johnson Controls Polarity is always
Normal. Johnson Controls N2 protocol does not support changes to the Polarity attribute.
Table 165: BACnet Polarity Relationships
Present Value
Polarity
Physical State of the Hardware Physical State of the Monitored
Input
Device
Inactive
Normal
Off or Inactive
not running
Active
Normal
On or Active
running
Inactive
Reverse
On or Active
not running
Active
Reverse
Off or Inactive
running
Limit: 20 characters
COS Time
04,294,967,295
Device Type
CW
Elapsed Active
Time
Inactive Text
BW
Null
Limit: 20 characters
Null
04,294,967,295
Units = seconds
Limit: 20 characters
Out of Service
CW
BW
False
347
BW
Normal, Reverse
Present Value
DNRW
BW
Reliability
BW
Reliable
No Fault Detected
(Reliable), No Sensor,
Open Loop, Shorted
Loop, Unreliable Other,
Communication Failure
Represents the date and time the COS Count
attribute was most recently set to a zero value.
If COS Time or Change
CW
Off
On
348
False,
False,
False,
False
In Alarm, Fault,
Overridden, Out of
Service
Use Remote
Alarming
1
2
3
4
BCW
False
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, N - Value Not Required, R Affected by Object Reliability, W - Writable
If either Inactive Text or Active Text is present, both are present.
If either Elapsed Active Time or Time of Active Time Reset is present, both are present.
If Change of State Time, Change of State Count, or Time of State Count Reset is present, all are present.
349
350
Examples:
When Out of Service is True, the Reliability attribute may be written directly.
State Count Reset
Represents the date and time the COS Count attribute was most recently set to a zero value. If COS Time or Change
of State Count is present, both are present.
States Text
Indicates the displayed strings for the Present Value.
Status Flags
Indicates the general status of the input object in BACnet terms and contains four independent states.
The four flags are:
In Alarm - False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by
BACnet Intrinsic Alarming.)
Fault - True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False.
Overridden - Overridden flag is True if the Present Value is overridden from the hardware source level.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Number of Parameters
Disable Alarms
None
Enable Alarms
None
In Service
None
Out of Service
351
a consistent interface to point objects for all controller types, so they appear as a homogenous set to the user
interface
flexibility in point mapping
support for all Metasys controllers. See N2 Controller Object.
For example, this object allows you to start or stop a fan from a supervisory controller.
For general information on Metasys system objects, see Common Object Attributes.
Binary Output Concepts
BACnet Polarity Relationships
The relationship between the Present Value of an object and the physical state of the object is determined by the
Polarity attribute.
Note: The table below describes this relationship as defined by BACnet standards. Johnson Controls Polarity is
always Normal. Johnson Controls does not support changes to the Polarity attribute.
352
Inactive
Normal
Off or Inactive
not running
Active
Normal
On or Active
running
Inactive
Reverse
On or Active
not running
Active
Reverse
Off or Inactive
running
Limit: 20 characters
COS Count
04,294,967,295
COS Time
Device Type
Limit: 20 characters
04,294,967,295
Units = seconds
353
CW
Not
supported
Range: 0255 Seconds Indicates the amount of time that this output point
adds to the Accumulated Delay attribute of the
Heavy Equipment Controller (HEC) object when
this point is started. The next output point is
delayed by that amount of time of the HEC
Accumulated Delay is not already decremented
to zero.
The NAE devices five internal Heavy Equipment
Controller objects (see HED Controller) time their
delays independently of one another. For example,
HED 1 and HED 4 can count down their delays at
the same time.
HED Controller
CW
Not
supported
15
Inactive Text
Limit: 20 characters
CW
0604,800
Units = seconds
Min On Time
CW
0604,800
Units = seconds
Out of Service
False
True
354
Present Value
Normal, Reverse
DRW
Priority Array
Reliability
States Text
DRW
CW
355
In Alarm, Fault,
Overridden, Out of
Service
BCW
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Objects Reliability, W - Writable
356
COS Count
Represents the number of times the Present Value attribute changed state since the COS Count attribute was last
set to zero. A change of state is any event that alters Present Value. This attribute persists in the archive.
COS Time
Represents the date and time at which the most recent change of state occurred. A change of state is any event
that alters the Present Value attribute. When Out of Service is False, a change to the Polarity attribute alters Present
Value and is considered a change of state. Changes to Polarity do not cause changes of state.
Device Type
Contains a description of the physical device connected to the object.
Elapsed Active Time
Represents the accumulated number of seconds Present Value is Active since the Elapsed Active Time attribute
was last set to zero. This attribute value updates automatically a minimum of once a day.
Heavy Equip Delay
Indicates the amount of time that this output point adds to the Accumulated Delay attribute of the Heavy Equipment
Controller (HEC) object when this point is started. The next output point is delayed by that amount of time of the
HEC Accumulated Delay is not already decremented to zero.
The NAE devices five internal Heavy Equipment Controller objects (see HED Controller) time their delays
independently of one another. For example, HED 1 and HED 4 can count down their delays at the same time.
HED Controller
Identifies the Heavy Equipment Controller (HEC) object managing the delays.
The NAE device has five internal Heavy Equipment Controller objects for use by BO and Multistate Output (MO)
objects. The BO and MO objects reference the heavy equipment delay (HED) controller objects by number (1-5).
All BO and MO objects on an NAE share the five internal HED controller objects. For example, if BO1 and MO3 on
NAE-1 reference HED controller 1, they are using the same HED controller.
Also see Heavy Equip Delay.
Inactive Text
Characterizes the intended effect of the Inactive state of Present Value attribute from the viewpoint of the operator.
The content of this string is a local matter, but it is intended to represent a readable description of the Inactive state.
For example, if the physical output is connected to a switch contact, then the Inactive Text attribute is assigned a
value such as Fan 1 Off. If either the Inactive Text or Active Text attribute is present, then both are present.
Intrinsic Alarming Defined
Enables the definition of the intrinsic alarm related attributes.
Min Off Time
Represents the fewest number of seconds Present Value remains in the Inactive state after entering the Inactive
state.
357
Min On Time
Represents the fewest number of seconds Present Value remains in the Active state after entering the Active state.
Out of Service
Used to decouple the object from the physical output. When out of service is True, the object will decouple Present
Value and Reliability from the hardware. The Reliability will be writable when Out Of Service is True. Not all devices
support setting this attribute to True.
Polarity
Indicates the relationship between the physical state of the output and the logical state represented by Present
Value. If the Polarity attribute is Normal, then the Active state of the Present Value attribute is also the Active or On
state of the physical output as long as Out fo Service is False. If the Polarity attribute is Reverse, then the Active
state of the Present Value attribute is in the Inactive or Off state of the physical output as long as Out of Service is
False. If Out of Service is False for a constant physical output state, a change in the Polarity attribute produces a
change in Present Value. If Out of Service is True, the Polarity attribute has no effect on Present Value. The N2
Polarity attribute is always Normal.
Present Value
Indicates the current value of the binary output. Polarity determines the relationship between Present Value and the
state of the output.
Priority Array
Lists values of the object in level of importance.
Reliability
Indicates whether the Present Value is unreliable and why. When Out of Service is True, the Reliability may be
written directly.
State Count Reset
Represents the date and time the COS Count attribute was last set to a zero value. If the COS Time, Change of
State Count, or State Count Reset attribute is present, all of these attributes are present.
States Text
Indicates the displayed strings for the Present Value.
Status Flags
Represents four true or false flags that indicate the general health of an analog output. Three flags are associated
with the values of other attributes of the object.
The four flags are:
In Alarm - In Alarm flag is False (0) if the Event State attribute value is Normal; otherwise, the In Alarm flag is
True (1).
Fault - Fault flag is True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False (0).
358
Overridden - Overridden flag is Logical 1 if the Present Value is decoupled from the hardware output because
operator intervention provided a different value or local override is active.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
Parameters
Disable Alarms
None
Enable Alarms
None
In Service
None
Operator Override
Out of Service
Release Operator Override
Release
None
1
None
1. Attribute name
2. Command priority
Release All
State0. . . State1
1
Attribute name
None
For the Release Operator Override, Release, and Release All commands, if all Command Priorities have been released and
a Relinquish Default is not defined, the supervisory controller gives control over to the actual hardware.
359
Note: For BACnet objects, support of this command is dependent on the ability to write the Out Of Service attribute.
Operator Override
Updates the Present Value at Command Priority equal to Operator Override (8).
The Operator Override command sends the specified command to the internal NxE object, which is then only sent
to the field device when one of the following conditions is met:
Out of Service
Allows a user to override the objects hardware output for simulation or other purposes. The Out of Service command
changes the Out of Service attribute to True. The Present Value and Reliability no longer track the physical output.
No commands are sent to the actual hardware. When the Out of Service attribute is set to False, the current Present
Value is sent to the actual hardware.
When an Out Of Service command is issued, the NxE does not communicate subsequent changes (operator or
system) to the field device.
For BACnet objects, support of this command is dependent on the ability to write the Out Of Service attribute.
Release Operator Override
Releases Command Priority Operator Override (8) from Present Value.
Release
Releases the identified command priority from the specified, writable attribute, and allows it to be controlled by the
next highest priority.
Release All
Releases Command Priorities 3 through 16 (Default) from the specified, writable attribute. Command Priorities 1
and 2 remain.
Important: The Release All command may not cause an immediate return to automatic operation. The Release
All command clears all command priorities, including those that come from applications and features.
When this happens, the output point goes to its Relinquish Default condition. In some cases, the
application or feature may have sent a command that does not match Relinquish Default. In this instance,
the output point does not end in the state that the applications or features intended. This situation can
cause unexpected operation to occur; for example, a space might overcool or overheat, a fan might
run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
State0. . . State1
Releases Command Priorities 9 through 15 (Scheduling) and then writes to the Present Value at the Default (16)
command priority. If this is the highest, it is sent to the controller. The state command names and number of commands
are dependent on the States Text attribute.
360
Important: Be aware that an operator state command releases the actions of any processes running to the object
in the NxE or FEC controllers that use Priorities 9 through 16. Consider this behavior when creating
control strategies.
If Local Control is True, this command is rejected.
Text
Limit: 20 characters
COS Count
Number
04,294,967,295
361
Date/Time
Null
Elapsed Active
4
Time
Number
Null
04,294,967,295
Units = seconds
Inactive Time
Text
Limit: 20 characters
Number
CW
04,294,967,295
Units = seconds
Min On Time
Number
CW
04,294,967,295
Units = seconds
Out of Service
Present Value
True or
False
5
Multistate
Priority Array
Set of
values
Reliability
Multistate
W
DRW
DRW
False
Always False
Inactive, Active States
Text attribute identifies
the value set for this
attribute.
Reliable
No Fault Detected
(Reliable), Unreliable
Other, Communication
Failure
362
One state
from a set
Status Flag
Series of
True or
False states
Use Remote
Alarming
True or
False
1
2
3
4
5
CW
Inactive,
Active
In Alarm, Fault,
Overridden, Out of
Service
BCW
False
363
Min On Time
Represents the least number of seconds Present Value remains in the Active state after entering the Active state.
Out of Service
Indicates the offline/online state of the connected hardware. This attribute exists for compatibility with BACnet protocol
and indicates whether the physical input that the object represents is in service. When out of service, the physical
input is not coupled to changes in the Present Value. The object does not send commands to the hardware. This
attribute is always False due to the absence of hardware.
Present Value
Indicates the current value of the binary value. When Out of Service is True, Present Value is writable. Present
Value is optionally commandable. If Present Value is commandable, Priority Array and Relinquish Default are both
present.
Priority Array
Lists values of the object in level of importance. If Priority Array or Relinquish Default is present, both are present.
If Present Value is commandable, Priority Array and Relinquish Default are both present and Present Value is
writable.
Reliability
Indicates whether the Present Value is unreliable and why.
State Count Reset
Represents the date and time the COS Count attribute was last set to a zero value. If COS Time, Change of State
Count, or Time of State Count Reset is present, all are present.
States Text
Indicates the displayed strings for the Present Value. For BACnet compliant objects, if no States Text is specified
when the object is created, the Inactive Text and Active Text are used to derive the equivalent States Text if possible.
Status Flags
Contains four true or false flags that indicate the general health of the object. Three of the four flags are associated
with the values of other attributes within the same object. By reading these attributes, you can achieve a clearer
picture of the object status.
The four flags are:
In Alarm - In Alarm flag is False (0) if the Event State attribute value is Normal; otherwise, the In Alarm flag is
True (1).
Fault - Fault flag is True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False (0).
Overridden - Overridden flag is Logical 1 if the Present Value has been overridden by some mechanism local
to the BACnet device or because operator intervention provided a different value.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
364
Parameters
Disable Alarms
None
Enable Alarms
None
Operator Override
None
Release
1. Attribute name
2. Command priority
Release All
Attribute name
State0
None
State1
None
365
Release
Releases the identified command priority from the specified, writable attribute, and allows it to be controlled by the
next highest priority.
Release All
Releases Command Priorities 3 through 16 from the specified, writable attribute. Command Priorities 1 (Manual
Emergency) and 2 (Fire Application) remain.
Important: The Release All command may not cause an immediate return to automatic operation. The Release
All command clears all command priorities, including those that come from applications and features.
When this happens, the output point goes to its Relinquish Default condition. In some cases, the
application or feature may have sent a command that does not match Relinquish Default. In this instance,
the output point does not end in the state that the applications or features intended. This situation can
cause unexpected operation to occur; for example, a space could overcool or overheat, a fan might
run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
State0
Releases Command Priorities 9 through 15 (Scheduling) and then writes to the Present Value at the Default (16)
command priority.
Important: Be aware that an operator state command releases the actions of any processes running to the object
in the NxE or FEC controllers that use Priorities 9 through 16. Consider this behavior when creating
control strategies.
State1
Releases Command Priorities 9 through 15 (Scheduling) and then writes to the Present Value at the Default (16)
command priority.
Important: Be aware that an operator state command releases the actions of any processes running to the object
in the NxE or FEC controllers that use Priorities 9 through 16. Consider this behavior when creating
control strategies.
Calendar Object
Menu Selection: Insert > Object > Calendar
The Calendar object is used behind the scenes by the Scheduling feature by maintaining a list of dates designated
as exceptions to the normal schedule. Exception Schedule days are days when you do not want the Schedule to
operate, such as holidays. They can be defined as specific dates or ranges of dates. Typically, a Schedule object
references a Calendar object, which lists the days the weekly schedule should not operate. A Schedule object
working from a chosen Calendar reads the Present Value of the Calendar object, which indicates if the current day
is within the Date List (Entry Detail) of the Calendar.
A different set of activities from those in the weekly schedule can be defined in the Schedule object to occur on these
exception days. Multiple Schedule objects can reference a single Calendar object so that only the Calendar object
needs to be changed to affect all schedules.
366
This object allows you to accommodate for a special day or days, like a holiday, in which the building controls should
run differently from usual, in accordance with the change in the number of people and the amount of activity in the
building.
For general information on Metasys system objects, see Common Object Attributes.
For more information on the Scheduling feature and how to create a calendar, refer to the Scheduling section in the
Metasys SMP Help (LIT-1201793) or Metasys ODS Help (LIT-12011942). For more information on Global Calendars
reference the Metasys SMP Help (LIT-1201793). For detailed information on the Calendar object, see the following
table.
Calendar Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
Table 173: Calendar Attributes - Calendar Tab
1
Attribute Name
Data Type
BACnet
Notes
1
Notes
Date List (Entry Detail) Date/Time
CW
CW
Initial
Value
Values/Options/Range
True or False
False
367
Present Value
Indicates the current value of the Calendar. Present Value is True if the current date is in the Date List (Entry Detail)
and False if the current date is not in the Date List.
Scheduling
The scheduling feature allows you to automate routine functions such as changing the operating mode of a room
from occupied to unoccupied for heating or cooling needs and helping perform energy optimization strategies. Each
schedule consists of a list of weekly scheduled events as well as a list of exception events. Each event consists of
a value to write to a list of Scheduled Items at a particular time. The event by default ends at midnight unless ended
earlier. The scheduling features user interface provides a graphical view for configuring the schedule and displaying
when events are scheduled to occur.
Scheduling Concepts
Calendar
The Calendar Object resides in an Engine or FAC and is the internal basis for the calendar functionality of the
scheduling feature. Create a Calendar and use it to define a list of holidays or special events that can be used in
multiple schedule objects to define different events that need to occur. The schedule executes an exception schedule
based on the list of dates defined in the calendar. For example, use a calendar to define different building operations
on days such as holidays when the building is not occupied.
A schedule can reference calendars on any Engine or FAC on the site.
Use the calendar feature to:
toggle the calendar view between a graphical, one-month view, or 12-month view
The following table describes the functions of the Calendar Views buttons.
Table 174: Calendar Button Functions
Button
Function
Opens Edit mode
Shows the Date, Date Range, and Week and Day details of the calendar entries
and allows you to create new entries or edit existing entries when in Edit mode.
Increases or decreases the currently displayed year by one year.
Increases or decreases the currently displayed month by one month.
368
Schedule
The Schedule Object resides in an Engine or FAC and is the internal basis for the Scheduling feature. Create a
Schedule and use the Scheduling feature to define the items and times when the Schedule writes values to the
referenced attributes of the Scheduled Items. Each schedule includes the following:
a view of todays schedule that shows what actions the schedule is currently configured to perform today, including
the Default Schedule Command. This view is not available in the SCT.
a weekly schedule that uses events for each day (Monday through Sunday) to configure the times when the
Schedule writes values to its referenced attributes (Scheduled Items)
an exception schedule that uses events to configure exceptions to the weekly schedule (optional)
a list of items that the schedule controls (referenced by the schedule, called Scheduled Items) (optional)
an effective period that optionally allows you to activate or inactivate the schedule for a selected period of time
copy and paste a schedule to another device or item (offline mode), only in Engines
The following tables describe the functions of the Schedule Views buttons and attributes and right-click menu.
Table 175: Schedule Button Functions
Button
Function
Opens Edit mode
Effective Period
Click the
button to open the Effective Period dialog box which allows you to
369
Binary, Analog, Multistate, Derived from Values each of these choices brings
up unique choices in the Default Schedule Command and State Text fields.
States Text
Allows you to specify the state of the selected event, which is unique for each
Schedule Output Type.
Allows you to toggle between views: Today's Schedule, Weekly Schedule,
Exception Schedule, or Scheduled Items.
1
The States Text selection controls the right-click menu. For example, select between
Off and On, Off and Reset, Absent and Present, Active and Inactive, or Alarm and
Normal.
Add Event(s)
Opens the Define New Event(s) dialog box and allows you to add an event to the
schedule.
End Event
Allows you to specify an event end time. The end time corresponds to the location of
your mouse cursor when you opened the menu. Drag the end of the event to adjust
the end time.
Analog
Right-click and select Add Event(s), or select an event, right-click, and select Modify
Selected Event(s). Add Event(s) allows you to specify the Day or Days, Hours, Minutes
and Value of a new event. Modify Selected Event(s) allows you to modify the Hours,
Minutes, and Value of an existing event.
Add Event(s)
Opens the Define New Event(s) dialog box and allows you to add an event to the
schedule.
End Event
Allows you to specify an event end time. The end time corresponds to the location of
your mouse cursor when you opened the menu. Drag the end of the event to adjust
the end time.
Multistate
The States Text selection controls the right-click menu. For example, toggle between
Not Operating, Normal Start, Heating, Cooling, Fan Only, or Minimum DAT Control.
Opens the Modify Event(s) dialog box and allows you change the times and value of
the selected event. You can also double-click an event to access the Modify Event(s)
dialog box.
370
Todays Schedule
The scheduling feature includes a view called Todays Schedule. Todays Schedule is a read-only view that shows
the schedule timeline for the current day. The timeline displays the projected schedule output that is written to the
scheduled objects for the current day, combining the default Schedule Command with events from both the Weekly
Schedule and Exception Schedule. Todays Schedule also displays a table of times and values, which details the
changes in the schedules output for the current day.
Weekly Schedule
The scheduling feature has a weekly schedule that provides a schedule for each day of the week, Monday through
Sunday. Each daily schedule begins at 00:00 and ends at 23:59. Each day consists of events that initiate the writing
of values to the referenced attributes of the scheduled items based on the day of the week. For example, you can
schedule a fan to start at 7:00 and stop at 22:00 on Mondays.
To edit the weekly schedule, double-click or right-click the weekly schedule. Right-clicking brings up the context
menu (see Table 176).
Exception Schedule
The exception schedule provides a list of exceptions to the weekly schedule. Exceptions define a different set of
events that supersede the events for particular days in the weekly schedule. An exception can be defined for a date,
a date range, a week and day, or a reference to a Calendar. The following table contains information on the four
types of exceptions. Wild cards can also be used to define exceptions; see Wildcards for more information.
Table 177: Exception Types
Exception Type
Description
Date
Date Range
Occurs on certain weekdays during certain weeks of certain months. For example, the second
Tuesday in any month or any Wednesday in June.
Calendar Reference
Occurs during all dates selected in the referenced calendar. Associating an exception with a
calendar allows you to reference a large number of dates.
Note: The N1 exception schedule only supports the Date exception. For example, to schedule the same exception
3 days in a row using an N1 Exception schedule requires the use of three separate date exception entries.
Date range, week and day, and calendar reference exceptions are not supported.
Each exception can have one or more events that run during the exception time period. Recall the example in the
Schedule topic where you scheduled a fan to start at 7:00 and stop at 22:00 on all Mondays. You can create a date
type exception to this weekly schedule if you want the fan to start and stop at different times on a certain day. For
example, you can create an exception for Monday, May 26, and define an Off event at the start of the day (00:00),
an On event at 9:00 in the morning (instead of 7:00), and another Off event at 17:00 in the evening (instead of 22:00).
371
You can assign a precedence level (116, where 1 receives the highest precedence) to each exception, regardless
of type, to determine the order of execution. If you define two or more exceptions for the same date, the exception
with the highest precedence executes. For example, an exception with a precedence of 2 executes over an exception
with a precedence of 8 if they are both defined for the same date.
If all exceptions for the same date have the same precedence, the exception that appears first in the exception list
executes first; therefore, if you have multiple exceptions defined for one day, the exceptions apply by precedence
level and then by the order of the items in the exception list.
Double clicking the exception schedule allows you to edit the exception schedule.
The JCI Exception Schedule attribute for the engine object (also an FAC mapped to an engine) allows you to set
how long exception schedules are kept after the exception date has expired. The default value is Auto Delete 31
days. Two options, Auto Delete 7 days and Manual Delete are available for this attribute. See the JCI Exception
Schedule attribute configuration in the Engine Device Object section for more information.
Note: Manual Delete is needed for locations like Japan where the local standards state that only the BACnet
workstation can delete exception schedules.
Events
An event describes the time when the scheduling feature writes user-defined values to the referenced item attributes
(Scheduled Items). Weekly schedules and exception schedules use an event to define when the scheduling feature
should change its output.
Each day of a weekly schedule and each exception day of an exception schedule has its own set of events. Days
can have multiple events (for example, a start event and a stop event). When the time defined by an event arrives,
the scheduling feature writes the value for the defined event to the referenced attribute of each item in the list of
scheduled items. Unless specified to end earlier, all events end at midnight. If an event is ended before midnight,
and no other events are scheduled, the scheduling feature writes the Default Schedule Command to the referenced
item attributes. If the Default Schedule Command is set to Release, the scheduling features control over the scheduled
items ends. Values are sent to the referenced attributes at priority 15.
Note: Release should only be used for the Default Schedule Command if the scheduled items support the Release
command.
Scheduled Items
Scheduled items are the objects and attributes that the event values are written to. A schedule can operate with an
empty Scheduled Items list. The scheduling feature writes the defined value to the scheduled items at the time
defined by an event. Schedules defined in an NAE can reference any item that can be mapped into an Engine or
ADS/ADX . Schedules defined in an FAC can reference items only within that FAC, even if those items are not
mapped to an Engine. Adding items to a schedule involves selecting the item and then selecting the attribute of the
item that you want the schedule to change. At the times defined by an event, the schedule writes the defined values
to the scheduled attribute associated with each referenced item.
When there are no events active in the weekly schedule or exceptions, the schedule writes the Default Schedule
Command to the referenced attributes. If the Default Schedule Command is set to Release, the schedules control
over the scheduled items ends.
Note: Release should only be used for the Default Schedule Command if the scheduled items support the Release
command.
372
The table of scheduled items provides the Status Log entry for each scheduled item. The status log indicates any
errors that occurred when the scheduling feature attempted to write values to the scheduled items.
A single schedule can only apply values of one data type to all items in its list of scheduled items; therefore, the first
item in the Scheduled Items list becomes the key item. The key item determines the data type of the values that the
schedule writes to the attributes of all scheduled items.
See the following example scenario for a description of how scheduled items work.
Example Scenario
If you use CCT and create a mixed air single duct (MASD) air handling system in a field controller, you can select
the OCC-SCHEDULE multi-state value as the scheduled item. The state selection modes for this item include
Occupied, Unoccupied, and Standby. The application automatically manages the setpoint and logic changes when
the unit switches between Occupied and Unoccupied.
Dates - Calendar Entry and Exception Schedule
You can use the following date formats for defining exceptions to the weekly schedules using calendar entries or
exception schedules:
Date
Date Range
a specific date has all fields filled with specific values, including the Day of Week
a date pattern has some fields filled with odd, even, last, or the any wildcard
For a Calendar object Date Range entry, the new rules restrict each part (start date and end date) to be one of the
following:
Note: For Date Range, the Metasys system currently allows partial wildcard fields for the start and end dates, which
leads to unpredictable operation in some cases. Therefore, to avoid undesired results, do not use partial
wildcard fields for the start date or end date. The examples in Table 178 illustrate valid date range entries
and their meanings. The examples in Table 179 show three invalid date range entries. Be sure to follow the
new BACnet rules to avoid these kinds of entries.
373
Day of Week
Meaning
From
Aug
30
2015
Sunday
To
any
any
any
any
From
any
any
any
any
To
Jul
2015
Saturday
From
Jan
2015
Thursday
To
April
30
2015
Thursday
Year
Day of Week
From
any
any
any
To
any
any
any
From
any
any
any
Saturday
To
any
any
any
Sunday
From
May
any
2014
Saturday
To
September
any
2014
Sunday
Note: No partial wildcard (any) fields for start date or end date are allowed in order to eliminate cases that could
not be clearly interpreted and implemented. See BACnet Clarification for Date Entries section for more
information.
Date and Date Range
You can use a single date or a range of dates when defining exceptions to a weekly schedule. The following table
describes the options available for defining a single date or a range of dates entry for a calendar or exception
schedule.
Table 180: Date and Date Range Format
Menu
Date
Month
Date Range
any
any
any
any
1 through 31
1 through 31
374
Date Range
Year
any
any
20062048
20062048
any
any
Day of Week
Tip: If you specify a single date (that is, you define the specific day, month, and year), the system figures out the
Day of Week for you. For example, if you enter July 9, 2015 and leave the Day of Week entry as any, the
system fills in Thursday. Also see Data Consistency Checking.
Note: For exception schedule entries, you also need to define the Precedence at which the schedule executes the
exception schedule.
Week and Day
You can use a week and day entry when defining exceptions to the weekly schedule. The following table describes
the options available for defining a week and day calendar or exception schedule entry (for example, the Saturday
of the first week in May). A mixture of any and specified entries is allowed. Week and day entries apply to all years.
Table 181: Week and Day Format
Menu
Options
Month
Any, January through December, Odd (odd numbered months), Even (even numbered months)
Week of Month
Any
1 = Days 1 through 7
2 = Days 8 through 14
3 = Days 15 through 21
4 = Days 22 through 28
5 = Days 29 through 31
6 or last = Last seven days of the month
Day of Week
Note: For exception schedule entries, you also need to define the Precedence at which the schedule executes the
exception schedule.
Wildcards
You can use wildcards to define date entry calendar or exception schedule exceptions. You can also program special
dates, such as even or odd months, or the last day of the month. Wildcards are the fields of an exception schedule
or calendar entry date specified by the any selection. For example, an exception date of December 25, any year,
and any day of week means the events defined in the exception schedule occur on December 25 of every year
regardless of the events defined in the weekly schedule. To use wildcards, select any from the drop-down menu of
the Exception Detail or Calendar Entry dialog box.
375
For exceptions, the wildcard part of the date appears as any in the list of exceptions. For example, December 25,
any year Precedence 8 appears in the list of exceptions after saving the selections described in the following table
for a single Date entry.
Table 182: Schedule Wildcard Example - Single Date
Parameter
Value
Month
December
Day
25
Year
any
Day of Week
any
Precedence
For calendars, the wildcard part of the date appears as any in the calendar entries list. For example, Month =
February, Day = 2, Year = any appears in the calendar entries list after saving the selections described in the
following table for a single Date entry.
Table 183: Calendar Wildcard Example - Single Date
Parameter
Value
Month
February
Day
Year
any
Day of Week
any
You can use wildcards for the following types of exceptions and calendar entries:
Date
Date Range (all Start Date or End Date fields must be set to any)
Wildcards - Date
For a single date, a wildcard opens a particular field to the full range of possible values for that field. The following
table describes the meaning for each type of unspecified wildcard or special date field.
Table 184: Unspecified Wildcard Date Field Meanings
Unspecified Field
Meaning
Month
Day of Month
Any = every day of the month (unless limited by Day of Week entry)
6 or Last = last day of the month
Odd = only odd numbered days of the month (1, 3, 5, 7, 9, 11, and so on)
Even = only even numbered days of the month (2, 4, 6, 8, 10, 12, and so on)
376
Day of Week
Any = every day of the week, unless a particular day of the month is specified by the Day of Month
field
The following table shows some sample wildcard dates or special dates and their meanings.
Table 185: Sample Wildcard Date Meanings
Month
Day of Month Year
Day of Week Meaning
any
01
any
any
Mar
05
any
any
Mar
any
2010
any
any
any
any
any
Every day
any
any
any
Friday
Every Friday
any
any
2010
Friday
Mar
any
2010
Friday
Mar
12
2010
Friday
Apr
13
any
Monday
Even
2010
any
any
last
2010
any
May
odd
any
any
May
even
any
any
377
any
any
any
Monday
Days 17
Jan
any
Tuesday
Feb
any
Days 814
any
any
Wednesday
Mar
any
any
any
any
Thursday
any
Saturday
Days 1521
Apr
4
Days 2228
any
5
Days 2931
Jun
6 or Last
Last seven days
Effective Period
The effective period defines the active or inactive date range for a schedule (weekly and exception schedule) using
the date range rules. In Edit mode, the
always active.
For example, you can create two schedules with the same items/objects and configure one for the heating season
and the other for the cooling season. Then you can define the effective period of the heating schedule from October
through March and the cooling schedule from April through September of each year.
Trend Scheduling
Use the Schedule feature to configure time and day periods for recording trend data for object trend extensions. In
the schedule, add the trend extension to the Scheduled Items list and select the desired trend extension attribute.
Make sure the trend extension is the Key Item in the Scheduled Items list. Then use the weekly schedule to define
the days and times you want to record trend data for the selected object trend extension.
For more information on trend extensions and trending, see the examples below and click one of the following:
Extensions
Trend Extensions
Trend Studies
For instructions on how to schedule a trend extension, see Scheduling a Trend Extension.
378
Example 1:
To collect trend samples starting at 6:00 A.M. Monday through Friday and at 8:00 A.M. on Saturday and Sunday,
and stopping trend collection at 8:00 P.M. on all days, configure a schedule as follows:
In the Scheduled Items list, add the desired object trend extension and select the trend extensions Enabled attribute
as the Scheduled Attribute. Make sure the trend extension is the key item.
On the Weekly Schedule tab, set the Default Schedule Command to False and configure the event to begin and
end according to the following table:
Table 187: Example 1 - Event Configuration
Time
Value
True
True
Example 2:
You may want to define how many trend samples are collected during specific periods of time. You can use a shorter
trend sampling interval to collect more trend samples during the day when there is more activity in the building, and
use a longer trend sampling interval to collect fewer trend samples at night when there is less activity in the building.
To take samples every 60 seconds from 6:00 A.M. to 6:00 P.M. Monday through Friday, every 600 seconds from
6:01 P.M. to 5:59 A.M. Monday through Friday, and every 600 seconds from 12:00 Midnight to 11:59 P.M. on Saturday
and Sunday, configure a schedule as follows:
In the Scheduled Items list, add the desired object trend extension and select the trend extensions Sample Interval
attribute as the Scheduled Attribute. Make sure the trend extension is the key item.
On the Weekly Schedule tab, set the Default Schedule Command to 600 seconds and configure the event to start
and end according to the following table:
Table 188: Example 2 - Event Configuration
Time
Value
60 (seconds)
Fast Clock
A device that includes schedules activates the fast clock feature when the current date and time are changed in the
device, the device restarts following a power failure or reset, or the device is put into simulation mode. The fast clock
feature ensures the schedule and its associated scheduled items are in the correct state based on day and time of
the device.
The fast clock evaluates the events scheduled for the current day from midnight to the current time, to find the last
scheduled time and value for the current day. If the fast clock does not find any scheduled events, then the value
associated with the latest time for the current day is used. Then the fast clock writes this value to all scheduled
attributes of all items referenced by the schedules list of scheduled items.
379
Exception and calendar dates have all four fields defined and do not use wildcards (Month, Day of Month, Year,
and Day of Week). For example, if you entered Monday, January 10, 2010, in the Exception Detail or Calendar
Entry Detail dialog box, a warning message appears because January 10, 2010, is not a Monday.
Exception and calendar dates have Month, Day of Month, and Year defined and use a wildcard for the Day of
Week field. For example, if you entered February 29, 2010, and any in the Day of Week field of the Exception
Detail or Calendar Entry Detail dialog box, a warning message appears because there is no 29th day in February,
2010.
Exception and calendar date ranges have all fields of both the start and end dates defined. For example, if you
entered a start date of Tuesday, July 2, 2010, and an end date of Monday, July 6, 2010, in the Exception Detail
or Calendar Entry Detail dialog box, a warning message appears because July 2, 2010, is not a Tuesday.
Exception and calendar date ranges have Month, Day of Month, and Year defined and use a wildcard for the
Day of Week field for both the start and end dates. For example, if you entered a start date of August 27, 2010,
and any in the Day of Week field, and an end date of August 6, 2010, and any in the Day of Week field in the
Exception Detail or Calendar Entry Detail dialog box, a warning message appears because the end date occurs
before the start date.
Because the Schedule can reference Calendars residing in another device, the scheduling feature performs the
following calendar reference verification:
If a schedule references a calendar in another device and that device goes offline, the schedule assumes that while
the device is offline, the calendars Present Value does not change. For example, a schedule residing on NAE1
refers to a calendar residing on NAE2 and the Calendar Objects Present Value attribute is True; however, if NAE2
is offline at midnight, the schedule assumes the calendars Present Value changes to False at midnight. This means
that the exception schedule is not active.
If a schedule refers to a calendar and that calendar is deleted, the schedule assumes the Calendar object Present
Value is False and the exception schedule is not active.
When the date changes, the daily schedule ends and the Schedule object executes the next days regular schedule,
exception schedule, or Default Schedule Command.
Global Calendar
The Global Calendar allows you to make facility-wide changes to calendars, such as defining holidays. These
changes are tedious if you need to edit many calendars. To solve this problem, you can reference a Global Calendar
object in each FAC or NxE. When you edit the values of the Global Calendar object, the dates automatically download
into all the local calendars.
Note: If a local calendar references a global calendar, the local calendar date list is not writable and the Edit button
is unavailable. However, if a local calendar writes to a BACnet attribute, the calendar may be edited. In this
case, do not write to the local calendar date list, because this overrides the dates in the global calendar.
To reference a Global Calendar object:
1. In the Configuration tab, click
or Calendar.)
380
and click
381
Scheduling Steps
Creating a Schedule or Calendar
Note: The procedure for creating a schedule or a calendar in offline mode (using SCT) is the same as the online
procedure using the Object. See Metasys Modes for more information about the modes of operation.
You cannot create schedules or calendars in an FAC from SCT or SMP.
1. From the Insert menu, select Object. The Insert Object Wizards appears.
2. Select Schedule or Calendar and follow the Insert Object Wizard instructions.
Note: Add extensions to the schedule or calendar at the wizard prompt, if desired. See Extensions.
Displaying an Existing Schedule or Calendar
To display an existing schedule or calendar, drag and drop the item from the navigation tree into a display frame or
double-click the item in the navigation tree.
Note: Alternatively, you can right-click the item and select View from the menu that appears.
Displaying Scheduled Events
1. Display a Schedule.
2. From the Display Mode drop down menu, select the view you want to see (Todays Schedule, Weekly Schedule,
Exception Schedule, or Scheduled Items).
3. Place the cursor over a leading or trailing edge of a time bar segment. The time-of-day appears in 24-hour format
in a small pop-up window.
Adding Weekly Scheduled Events
1. Display a Schedule.
2. From the Display Mode drop down menu, select Weekly Schedule.
3. Click Edit.
4. Click the new (green plus) button or double-click a time bar segment and the Define New Event(s) dialog box
appears.
Note: Alternatively, you can right-click a time bar segment and select Add Event(s). The Define New Event(s)
dialog box allows you to define the new event for multiple days.
5. Select one or more days, the starting time (hour and minute), and a value for the event using the check boxes
and drop-down menus and click OK.
6. Repeat Step 4 through Step 5 as necessary.
7. To specify an event end time, make sure no event is selected, right-click where you want the event to end and
select End Event from the pop-up menu. Drag the end of the event to adjust the end time.
8. Click Save.
Note: Once you click Save, the schedule object goes into effect and writes the new value to the scheduled
items if necessary.
Editing Scheduled Events
1. Display a Schedule.
2. From the Display Mode drop-down menu, select Weekly Schedule.
3. Click Edit.
Metasys SMP Help: Insert Menu
382
4. Double-click the time bar segment. The Modify Event(s) dialog box appears.
Note: Alternatively, you can select and right-click the event on the time bar and select Modify Selected Event(s)
from the menu.
5. Adjust the starting time (hour and minute) and value as desired for the event using the check boxes and drop-down
menus and click OK.
Note:
You can also change the value of an event by selecting and right-clicking the event and selecting a
value from the menu, if the value type is Boolean (True/False), binary, or multistate with less than
eight states.
To specify an event end time, make sure no event is selected, right-click where you want the event
to end, and select End Event from the pop-up menu. Once you specify an end time, you can drag the
tail edge right or left to adjust the end time.
You can adjust start times and end times of events by dragging the edges of the time bar segment
to the right or left. When adjusting a time, a small pop-up window shows the digital time of day based
on a 24-hour clock, and adjusts in 5-minute increments.
You cannot drag the end of an event that ends at midnight. To do this, first right-click and select the
End Event. Once the event ends prior to midnight, you can then drag to adjust the end time.
If you have a gap in the schedule between two events, you can drag the edge of one to meet the edge
of the other. Once you do, the events become locked together so that the second begins as soon as
the first ends, the begin/end points move together, and the gap is removed from the schedule.
Display a Schedule.
From the Display Mode drop down menu, select Exception Schedule.
Click Edit.
Click the new (green plus) button to add exception schedules. The Exception Detail dialog box appears. You
can add exception schedules to the list using one of the following exception types:
383
5.
Date/Date Range
button and
Make your selections from the drop-down menus or for the Calendar Reference, click the
select a calendar from the Select Items dialog box and click OK.
7. Click OK on the Exception Detail dialog box.
8. Select the exception schedule in the exception list.
9. Click the new event (green plus) button above the time bar or right-click the time bar and select Add Event(s).
The Define New Event(s) dialog box appears.
10. Select the starting time (hour and minute), and a value for the event using the check boxes and drop-down
menus and click OK.
11. To specify an event end time, make sure no event is selected, right-click where you want the event to end and
select End Event from the pop-up menu. Drag the end of the event to adjust the end time.
6.
9.
Make your modifications using the drop-down menus or for the calendar reference, click the
button and
select a calendar from the Select Items dialog box and click OK.
Click OK on the Exception Details dialog box.
Select the exception schedule in the exception list.
Select and right-click the event in the time bar and select Modify Selected Event(s) from the menu. The Modify
Event(s) dialog box appears.
Note: Alternatively, you can double-click an event to open the Modify Event(s) dialog box.
Select the starting time (hour and minute), and a value for the event using the check boxes and drop-down
menus and click OK.
384
11. Adjust the start and end times of events by dragging the edge of the event to the right or left.
12. Click Save.
Note: Once you click Save, the schedule object goes into effect and writes the new value to the scheduled
object if necessary.
Removing Exception Schedules
1. Display a Schedule.
2. From the Display Mode drop down menu, select Exception Schedule.
3. Click Edit.
4. Select the exception in the exception list.
5. Click the delete (red minus) button (or press the Delete key).
6. Click Save.
Adding Scheduled Items
1. Display a Schedule.
2. From the Display Mode drop-down menu, select Scheduled Items.
3. Click Edit.
4. Click the add (green plus) button.
5. Select one or more items from the Select Item dialog box and click OK.
Note: To select multiple items, use the Control or Shift key.
6. The system automatically chooses the default attribute for each item you selected. To choose a different attribute,
click the
button and select the attribute that you want to schedule.
7. Click Save.
Note: The first item in the list of scheduled items (Table of Scheduled Items) determines the data type used
when the schedule writes values to the attributes of the scheduled item.
Editing Scheduled Items
1. Display a Schedule.
2. From the Display Mode drop-down menu, select Scheduled Items.
3. Click Edit.
4. Right-click the item name and select an option from the pop-up menu. For example, select make key item to
promote the selected item to the key item of the schedule. When you add a key item, or choose the Make Key
Item menu option for an item, the States Text (or Display Units) is updated to match the key item.
Important: When you add the first item to the Scheduled Items list, or if you promote an item to key item, the
values in the scheduled events change to a default value if they are incompatible with the new key
item. The default for numeric values is 0 or 0.0. The default for attributes that support multiple values
is the first value available in the set of possible values (for example, False or Off). After changing
the key item, we strongly recommend reviewing and adjusting the values for all events in the
schedule as necessary.
385
5. The system automatically chooses the default attribute for each item you selected. To choose a different attribute,
button and select the attribute that you want to schedule. For example, selecting Present Value
click the
means that the schedule writes a value to the Present Value attribute of that item.
6. Click Save.
Removing Scheduled Items
1. Display a Schedule.
2. From the Display Mode drop-down menu, select Scheduled Items.
3. Click Edit.
4. Select the item name.
5. Click the remove (red minus) button or right-click and select remove object from the pop-up menu.
Editing the Effective Period of a Schedule
1. Display a Schedule.
2. On the Schedule tab, click Edit.
3. Click the
4.
5.
6.
7.
button of the Effective Period attribute. The Effective Period dialog box appears.
Select the start and end dates using the drop-down menus.
Click Apply.
Click OK.
Click Save.
Alternatively, create date and date range calendar entries visually by selecting an individual calendar
date or by selecting and dragging the mouse over a range of dates.
Wildcard date entries appear with a contrasting blue background on the calendar and have an asterisk
next to the date. Once you create a wildcard entry, visually selecting and deselecting it does not
change the entry. To edit the entry, click Entry Detail on the calendar display frame.
386
3.
4.
5.
6.
7.
8.
Click Entry Detail. The Calendar Entry Detail dialog box appears.
Select the entry from the calendar entries list.
Use the drop-down menus to edit the entry.
Click Apply.
Click OK.
Click Save.
Note:
Alternatively, edit Date and Date Range calendar entries visually by selecting an individual calendar
date or by selecting and dragging the mouse over a range of dates.
Wildcard date entries appear with a contrasting blue background on the calendar and have an asterisk
next to the date. Once you create a wildcard entry, visually selecting and deselecting it does not
change the entry. To edit the entry, click Entry Detail on the calendar display frame.
387
In offline mode, select the schedule or calendar from the navigation tree.
Select Copy from the Edit menu.
Select the desired destination for the copied schedule or calendar in the navigation tree.
Select Paste from the Edit menu. The Paste Object Wizard appears.
Edit the name of the schedule or calendar as desired and click Paste.
388
4. Right-click the highlighted name of any target day and select Paste from the pop-up menu. The copied schedule
overwrites the schedule for the selected days.
389
The Event Enrollment objects attributes represent and contain information for managing events. Events are changes
in the value of an object that meet specific criteria. The Event Enrollment object defines the event criteria and provides
a connection between an event and a notification message sent to recipients. A recipient device is enrolled for
notification if:
it is one of the recipients in a Notification Class Object referenced by the Event Enrollment object
a Notification Class object is not referenced and it is the recipient of the Event Enrollment object
For general information on Metasys system objects, see the Object Help section.
Event Enrollment Concepts
Event Relationships
Event Types, Event States, and Event Parameters are interrelated attributes:
Table 189: Event Relationships
Event Type
Event State
Event Parameters
Change of Bitstring
Normal
Time Delay
Offnormal
Bitmask
Normal
Time Delay
Offnormal
List of Values
Normal
Time Delay
2
Bitmask
COV Increment
Command Failure
Floating Limit
Normal
Time Delay
Offnormal
Normal
Time Delay
High Limit
Setpoint Reference
Low Limit
Out of Range
Normal
Time Delay
High Limit
Low Limit
Low Limit
High Limit
Deadband
1
2
Any Event Type generates a Fault Event State if the object referenced in the Object Property Reference becomes unreliable
and the Object Property Ref attribute is linked to Reliability.
Only one of these parameters is used.
Event Parameters
The table below lists the parameters in the Event Parameters attribute. For a description of the algorithms to which
these parameters apply, refer to ANSI/ASHRAE BACnet Standard 135 - 1995.
390
This parameter applies to the Change of Bitstring event algorithm and the Change of Value event
algorithm in the special case where the referenced attribute is a Bit String data type. It represents a
bitmask that is used to indicate which bits in the referenced attribute are monitored by the algorithm.
A value of one in a bit position indicates that the bit in this position in the referenced attribute is
monitored by the algorithm. A value of zero in a bit position indicates that the bit in this position in
the referenced attribute is not significant for the purpose of detecting this Change of Bitstring or
Change of Value. A Bitmask must contain 4 bits.
Deadband
These parameters apply to the Floating Limit and Out of Range event algorithms.
This parameter (BACnet Object Property Reference) applies to the Command Failure algorithm.
Feedback Property Reference identifies the object and attribute that provides the feedback to ensure
that the commanded attribute changes value. This attribute may reference only object properties
that have lists of true and false values.
This is a list that applies to the Change of Bitstring event algorithm. This list defines the set of states
for which the referenced attribute is Offnormal. Only the bits indicated by the Bitmask are significant.
If the value of the referenced attribute changes to one of the values in the List of Bitstring Values,
then the Event State attribute of the Event Enrollment object makes a transition To Offnormal and
sends the appropriate notifications. This list must contain 4 bits.
List of Values
This is a list of BACnet Property States that applies to the Change of State event algorithm. This
event algorithm applies to referenced properties that have discrete or lists of values. The List of
Values is a subset of the possible values that the attribute may have. If the value of the referenced
attribute changes to one of the values in the List of Values, then the Event State attribute of the
Event Enrollment object makes a transition to To Offnormal and sends the appropriate notifications.
COV Increment
This parameter applies to the Change of Value event algorithm. It represents the increment by which
the referenced attribute must change in order for the event to occur.
Setpoint Reference
This parameter (BACnet Object Property Reference), applies to the Floating Limit event algorithm.
Setpoint Reference indicates the setpoint reference for the reference attribute interval.
Time Delay
This parameter applies to all event types and represents the seconds that the conditions monitored
by the event algorithm persist before an event notification is issued.
Referenced Property
Increment
This parameter represents the increment by which the referenced property must change for an event
to occur.
391
Conveys three separate flags that each indicate if the most recent To Offnormal,
To Fault, and To Normal event transitions have been acknowledged (if the transition
requires acknowledgement).
Alarm Message
Text
CW
Not
supported
Event Enable
CW
Conveys three flags that determine if notifications are enabled for To Offnormal,
To Fault, and To Normal transitions. When a flag is set, this means that the
corresponding transition causes notification to be sent to all enrolled devices. When
a flag is cleared, this means that the corresponding transition is not reported. The
objects Event State continuously updates, regardless of the value of the Event
Enable attribute.
Event State
Indicates the current state of the event. The permitted values for Event State are
specific to the Event Type. The value of Event State is independent of the Event
Enable flags.
Event Time
Stamp
Conveys the times of the last event notifications for To Offnormal, To Fault, and
To Normal events. Time stamps of type Time or Date have * in each octet. Sequence
number time stamps have 0 if no event notification of that type has generated since
the object was created.
Execution Priority CW
CW
Indicates the relative importance of performing the function of the object within the
device.
Graphic
CW
CW
Graphic Alias
CW
CW
Indicates a portion of the graphics item reference, up to and including the name
of the folder containing this object or the controller containing this point.
Specifies the notification class used when handling and generating event
notifications for the object. This attribute implicitly refers to the Notification Class
Object that has a Notification Class attribute of the same value.
Conveys if the notifications generated by the object are Events or Alarms. This
attribute is required if the object supports intrinsic reporting.
CW
Determines the numeric handle of a process within the recipient device that is
enrolled for event notification when a Notification Class object is not used.
Recipient
CW
Designates the recipient device that is enrolled for event notification when a
Notification Class object is not used.
Notification
CW
Object Reference
2
Notify Type
1
2
CW
CNW
C - Configurable, W - Writable
The Notification Class attribute is used if the Recipient attribute is not used. We recommend using the Notification Class
attribute.
CW
Determines the method used to monitor the referenced object. This attribute
provides the parameter values used for the algorithm. See the Event Parameters
section for descriptions of the parameters.
C - Configurable, W - Writable
392
Generates an offnormal transition when the value of the referenced property is equal to one of the
user-defined Bitstring Values (List Elements after applying the Bitmask) and the values are equal for
the amount of seconds defined by the Time Delay attribute youre using. The Bitmask defines the bits
important for monitoring.
Change of State
Generates an offnormal transition when the value of the referenced property is equal to one of the
values in the List of Values (List Elements) and the values are equal for the number of seconds defined
by the Time Delay attribute of the object youre using.
Change of Value
Generates a normal transition when the value of the referenced property changes by an amount equal
to or greater than the referenced property increment (Change of Value [COV] Increment) for the number
of seconds defined by the Time Delay attribute of the object youre using.
Command Failure
Generates an offnormal transition if the values of the referenced property and the Feedback Reference
are not equal for a time greater than the number of seconds defined by the Time Delay attribute of the
object youre using.
393
Generates a transition to high or low limit alarm if the value of the referenced property is higher or lower
than the range of values determined by the current value of the Setpoint Reference, High Limit, Low
Limit, and Deadband for a time greater than the number of seconds defined by the Time Delay attribute
of the object youre using.
Out of Range
Generates a transition to high or low limit alarm if the value of the referenced property is higher or lower
than the range of values determined by the High Limit and Low Limit for a time greater than the number
of seconds defined by the Time Delay attribute of the object youre using.
Execution Priority
Indicates the relative importance of performing the function of the object within the device.
Graphic
Indicates the graphic associated with the object.
Graphic Alias
Indicates a portion of the graphics item reference, up to and including the name of the folder containing this object
or the controller containing this point.
Notification Object Reference
Specifies the notification class used when handling and generating event notifications for the object. This attribute
implicitly refers to the Notification Class Object that has a Notification Class attribute of the same value.
Notify Type
Conveys if the notifications generated by the object are Events or Alarms. This attribute is required if the object
supports intrinsic reporting.
Process Identifier
Determines the numeric handle of a process within the recipient device that is enrolled for event notification when
a Notification Class object is not used.
Recipient
Designates the recipient device that is enrolled for event notification when a Notification Class object is not used.
Event Enrollment Commands
The table below lists the commands supported by the Event Enrollment Object.
Table 194: Event Enrollment Commands
Command Name
Parameters
BACnet Support
Disable
None
No
Enable
None
No
394
Group Object
Menu Selection: Insert > Object > Group
Note: Click the Add button to select the items belonging to this group from the Select Item dialog box.
Click the item in the group list and use the up and down arrows to move the item in the list.
Click the item in the group list and click Remove to remove the item from the group.
Do not add a Group object to an equipment definition for the Metasys UI. The Metasys UI does not support
the Group object.
The Group objects attributes represent a collection of other objects and one or more of their attributes. This object
provides the user with the ability to customize the organization of objects within the site. The Group object simplifies
the exchange of information between objects by calling all members of the group at once. A group consists of any
combination of object types. For example, you can use the Group object to monitor the temperature in different
rooms throughout a floor of a building.
For general information on Metasys system objects, see Common Object Attributes.
For detailed information on the Group object, see Group Attributes.
For more information on the wizard used to create the Group object, see Insert Object - Group.
Group Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
Table 195: Group Object Attributes - Group Tab
1
Attribute Name
Data Type
BACnet
Notes
1
Notes
List of Group
Members
Set of types
Present Value
Set of values
CW
Initial Value
Options/Range
C - Configurable, W - Writable
395
All members of the group are objects that reside in the same device that maintains the Group object. Nesting is not
allowed.
Present Value
Lists the values of all the attributes specified in the List of Group Members. This is a read-only attribute; it cannot
be used to write a set of values to the members of the group. The Present Value list reconstructs each time the
attribute is read by fetching the member attributes.
Direct Reading
Float
Event State
Uses BAC Event State (Set 5). Indicates if an active event state is associated
with the object. If the object supports intrinsic
reporting, this attribute indicates the event
state of the object. If not, the attribute is
Normal.
396
Maintenance
Required
Operation
Expected
Out of Service
True or False
BCW
Reliability
BW
Setting
Byte
Units = No Unit
Silenced
397
Uses BAC LifSfty State (BACnet Reflects the non-latched state of the Life
Lifesafety State) (Set 186).
Safety Point object. This attribute continuously
tracks changes in the latched state of the
object.
Units
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, N - Value Not Required, O BACnet Optional, Q - BACnet Required, R - Affected by Object Reliability, W - Writable
398
Present Value
Indicates the current value of the Life Safety Point object in the defined Units. When Out of Service is True, this
attribute is writable.
Reliability
Indicates whether the Present Value is unreliable. When Out of Service is True, the Reliability attribute may be
written directly.
Setting
Specifies the next operation expected by this object to handle a specific life safety situation.
Silenced
Indicates whether the most recently occurring transition for this object produced an audible or visual indication that
has been silenced by the recipient of a Life Safety Operation service request or a local process.
Tracking Value
Reflects the non-latched state of the Life Safety Point object. This attribute continuously tracks changes in the latched
state of the object.
Units
Indicates the units of the quantity represented by Direct Reading.
Life Safety Point Commands
The table below lists the commands supported by the Life Safety Point Object.
Table 197: Life Safety Point Commands
Command Name
Number of Parameters
In Service
Out of Service
399
Event State
Maintenance
Required
Boolean
parameter-determined maintenance,
such as a dirtiness value for an
associated detector.
Operation
Expected
Uses BAC LifSfty Oper (Set 190). Specifies the next operation expected
by this object to handle a specific life
safety situation.
400
True or False
BCW
Present Value
Reliability
Silenced
Uses BAC LifSfty SilState (BACnet Indicates whether the most recently
Life Safety Silent State) (Set 188). occurring transition for this object
produced an audible or visual indication
that
has been silenced by the recipient of a
Life Safety Operation service request or
a local process.
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, N - Value Not Required, O BACnet Optional, Q - BACnet Required, R - Affected by Object Reliability, W - Writable
List of
Indicates the Life Safety Zone objects of which this Life Safety
Point is considered to be a zone member. Each object in the
Member Of list is a Life Safety Zone object.
Zone Members
List of
Indicates which Life Safety Point and Life Safety Zone objects
are members of the zone represented by this object.
B - Exposed as Standard BACnet Property, C - Configurable, D - Default Attribute for Display, N - Value Not Required, O BACnet Optional, Q - BACnet Required, R - Affected by Object Reliability, W - Writable
401
402
Loop Object
Menu Selection: Insert > Object > Loop
The Loop object allows a third-party BACnet workstation to represent a control loop in a standard way. If you use
the Site Management or Ready Access Portals as the primary mechanisms to view system information, you do not
need to use the Loop object.
The Loop object represents the key information from a logic module. The object does not execute the PID algorithm
but simply allows you to represent the key parameters of a PID logic module in a Focus tab view.
The Loop object uses the data provided by mapped field points to execute the BACnet intrinsic alarming algorithm.
First, create a folder and map the field points representing the loop information. Then use the Insert Object Wizard
to add the Loop object to the same folder and configure references to the mapped points representing the loop
information. The Loop object reads the information indicated by the references, and presents the values received
in the Focus tab of the Loop object.
The behavior of the Loop objects intrinsic alarming algorithm is as follows:
The loop object generates a TO OFFNORMAL event when the difference between the Setpoint Value and the
Controlled Variable Value remain outside the band defined by the Error Limit and the Time Delay has been
exceeded.
The loop object generates a TO NORMAL event when the difference between the Setpoint Value and the
Controlled Variable Value is within the band defined by the Error Limit.
403
Note: You must configure references to the BACnet required properties to successfully create the Loop object.
These references appear red in the wizard until configured. You may optionally configure references for the
BACnet optional properties. If you do not define the optional references for some reason, the Loop object
responds to a read for the corresponding value with an Unknown Property error. These BACnet required and
optional properties are noted with footnotes in the attribute table. See Loop Attributes.
For general information on Metasys system objects, see the Object Help section.
Loop Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 201: Loop Attributes - Focus/Configuration Tab
1
Attribute Name
Data Type
Values/Options/Range Description
Notes
Action
Direct
Reverse
Alarm State
Bias
Number
Bias Reference
Object reference
Uses BACEventState
set.
CNW
Restricted to field
mapper points.
Controlled Variable
3
Reference
Object reference
COV Increment
Real Value
Derivative Constant
Number
CW
404
Object reference
Display Precision
Integral Constant
Number
Integral Constant
2
Reference
Object reference
CNW
Manipulated Variable
3
Reference
Object reference
CW
Max Output
Number
Maximum Output
2
Reference
Object reference
CNW
CNW
405
Number
Minimum Output
2
Reference
Object reference
Present Value
Number
Proportional Const
Number
Proportional Constant
2
Reference
Object reference
Reliability
CW
CNW
406
Number
Setpoint Variable
3
Reference
Object reference
Units
Update Interval
Number
Units = milliseconds
1
2
3
407
Derivative Constant
Indicates the value of the derivative gain parameter used by the loop algorithm. If the Derivative Constant Reference
does not contain a value, a read of the Derivative Constant attribute returns an Unknown Property error.
Derivative Constant Reference
Provides the object reference for the Derivative Constant attribute. The Loop object reads and signs up for changes
in the Present Value attribute of the object referenced by the Derivative Constant Reference. The value received is
stored as the Derivative Constant.
Display Precision
Indicates the rounded position and the number of decimal places to display for this object.
Integral Constant
Indicates the value of the integral gain parameter used by the loop algorithm. If the Integral Constant Reference
does not contain a value, a read of the Integral Constant attribute returns an Unknown Property error.
Integral Constant Reference
Provides the object reference for the Integral Constant attribute. The Loop object reads and signs up for changes
in the Present Value attribute of the object referenced by the Integral Constant Reference. The value received is
stored as the Integral Constant.
Manipulated Variable Reference
Defines the field point mapper that represents the destination of the output of the control loop.
Max Output
Indicates the maximum value of the output (Present Value) as limited by the PID loop algorithm. This value is normally
used to prevent the algorithm from controlling beyond the range of the controlled device, and to prevent integral
term wind up. If the Maximum Output Reference does not contain a value, a read of the Max Output attribute returns
an Unknown Property error.
Maximum Output Reference
Provides the object reference for the Max Output attribute. The Loop object reads and signs up for changes in the
Present Value attribute of the object referenced by the Maximum Output Reference. The value received is stored
as the Max Output.
Min Output
Indicates the minimum value of the output (Present Value) as limited by the PID loop algorithm. This value is normally
used to prevent the algorithm from controlling beyond the range of the controlled device, and to prevent integral
term wind up. If the Minimum Output Reference does not contain a value, a read of the Min Output attribute returns
an Unknown Property error.
Minimum Output Reference
Provides the object reference for the Min Output attribute. The Loop object reads and signs up for changes in the
Present Value attribute of the object referenced by the Minimum Output Reference. The value received is stored as
the Min Output.
408
Present Value
Indicates the current output value of the loop algorithm.
Present Value Reference
Provides the object reference for the Present Value attribute. The Loop object reads and signs up for changes in
the Present Value attribute of the object referenced by the Present Value Reference. The value received is stored
as the Present Value.
Proportional Const
Indicates the value of the proportional gain parameter used by the loop algorithm. If the Proportional Constant
Reference does not contain a value, a read of the Proportional Const attribute returns an Unknown Property error.
Proportional Constant Reference
Provides the object reference for the Proportional Const attribute. The Loop object reads and signs up for changes
in the Present Value attribute of the object referenced by the Proportional Constant Reference. The value received
is stored as the Proportional Const.
Reliability
Reflects the Reliability attribute of the object referenced by the Present Value Reference attribute, providing an
indication of whether the Present Value of the loop in question is reliable. This attribute may have a value of Reliable
or Open when the field point mappers Reliability is Reliable or Open. This attribute may have a value of Unreliable
when the field point mappers Reliability is a value other than Reliable or Open.
Setpoint
Reflects the Present Value of the field point mapper defined by the Setpoint Variable Reference.
Setpoint Variable Reference
Defines the field point mapper that represents the setpoint for the control loop.
Units
Reflects the Units attribute of the object referenced by the Present Value Reference attribute.
Update Interval
Indicates the time period, in milliseconds, between updates to the Present Value attribute.
Loop Commands
The table below lists the commands supported by the Loop Object.
Table 202: Loop Commands
Command
Parameters
Name
Description
Disable
Alarms
None
Disables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet
Event Enrollment objects. This command restores the previous Event Enable values.
Enables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet
Event Enrollment objects. This command sets the Event Enable values to False, False,
False.
409
For example, this object allows you to display the speeds of a multispeed fan at a supervisory controller.
For general information on Metasys system objects, see Common Object Attributes.
Multistate Input Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
Table 203: Multistate Input Object Attributes - Focus/Configuration Tab
1
Attribute Name
Data Type
BACnet
Initial
Values/Options/Range
Notes
1
Value
Notes
Device Type
Text
CW
Null
Limit: 20 characters
Intrinsic Alarming
Defined
True or False
Not Supported
False
False
Number of States
Number
True
CW
Minimum Value = 2
Maximum Value = 16
Out of Service
True or False
CW
False
False
True
410
DNRW
Reliability
State Text
Set of Values
States Text
Present Value
Status Flags
Off Low
Med Hi
Series of True or
False states
False
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Objects Reliability, W - Writable
This attribute is required to be writable if Out of Service is True.
411
State Text
Represents descriptions of all possible states of Present Value. The number of descriptions matches the number
of states defined in Number of States. Present Value (an integer) serves as an index into this attribute.
States Text
Indicates the displayed strings for the Present Value.
Status Flags
Contains four true or false flags that indicate the general health of the object. Three of the four flags are associated
with the values of other attributes within the same object. By reading these attributes, you get a clearer picture of
the object status. The four flags are:
In Alarm - In Alarm flag is False (0) if the Event State attribute value is Normal; otherwise the In Alarm flag is True
(1).
Fault - Fault flag is True (1) if the Reliability attribute is not reliable; otherwise the Fault flag is False (0).
Overridden - Overridden flag is Logical 1 if the Present Value is decoupled from the hardware output because
operator intervention provided a different value.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise the Out of Service
flag is False.
Use Remote Alarming
When the attribute Intrinsic Alarming Defined is set to True, determines where alarms for the object originate. If the
remote integrated object contains attributes for originating alarms, then Use Remote Alarming defaults to True,
causing the local mapper object to accept alarms from the remote integrated object that are routed to the NxE. If
the remote integrated object does not contain attributes for originating alarms, then Use Remote Alarming defaults
to False causing the local mapper object to originate alarms. When Use Remote Alarming is false, any alarms from
the remote integrated object are ignored at the NxE. If the value of Use Remote Alarming is changed, a restart of
the NxE may be required to assure correct operation. This attribute applies only to BACnet integrations.
Multistate Input Commands
The table below lists the commands supported by the Multistate Input Object.
Table 204: Multistate Input Object Commands
Command Name
Parameters
Disable Alarms
None
Enable Alarms
None
In Service
None
412
Enable Alarms
Enables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet Event Enrollment objects.
In Service
This command cancels the affect of an Out of Service (Command) command and returns the Out of Service attribute
to False. The Present Value and Reliability will revert back to the values obtained from the physical input.
Note: For BACnet objects, support of this command is dependent on the ability to write the Out Of Service attribute.
Out of Service
This command allows a user to override the object's hardware input for simulation or other purposes. The Out Of
Service command changes the Out of Service attribute to True, write the Present Value to the value of the command
parameter and write the Reliability attribute to Reliable. The Present Value and Reliability will no longer track the
physical input.
When an Out Of Service command is issued, the NxE does not communicate subsequent changes (operator or
system) to the field device.
For BACnet objects, support of this command is dependent on the ability to write the Out Of Service attribute.
For example, this object allows you to command the modes of an access control device from a supervisory controller.
Note: The N1 migration Multiple Command object maps to this Multistate Output object.
For general information on Metasys system objects, see Common Object Attributes.
Multistate Output Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
413
Text
CW
Limit: 20 characters
CW
Not supported 0
HED Controller
Number
CW
Not supported
15
Intrinsic Alarming
Defined
True or False
False
Number of States
Number
CW
Out of Service
True or False
CW
True
4
216
False
True
Present Value
Priority Array
Set of values
Reliability
DRW
Reliable
State Text
Off Low
Med Hi
States Text
CW
Off Low
Med Hi
Status Flags
Use Remote
Alarming
1
True or False
BCW
False
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Objects Reliability, W - Writable
414
HED Controller
Identifies the Heavy Equipment Controller object managing the delays.
The NAE device has five internal Heavy Equipment Controller objects for use by Binary Output and Multistate Output
objects. The BO and multistate output (MO) objects reference the HED controller objects by number (15).
All BO and MO objects on an NAE share the five internal HED controller objects. For example, if BO1 and MO3 on
NAE-1 reference HED controller 1, they are using the same HED controller.
Also see Heavy Equip Delay.
Intrinsic Alarming Defined
Enables the definition of the intrinsic alarm related attributes.
Number of States
Defines the number of states possible for Present Value.
Out of Service
Used to decouple the object from the physical output. When Out of Service is True, the object decouples Present
Value and Reliability from the hardware. The Reliability will be writable when Out Of Service is True. Not all devices
support setting this attribute to True.
Present Value
Indicates the current value of the output as one of n states, where n is the number of states defined in Number of
States.
Priority Array
Lists object commands in level of importance.
Reliability
Indicates if the Present Value is unreliable and why. When Out of Service is True, the Reliability may be written
directly.
State Text
Represents descriptions of all possible states of Present Value. The number of descriptions matches the number
of states defined in Number of States. Present Value (an integer) serves as an index into this attribute.
States Text
Indicates the displayed strings for the Present Value.
Status Flags
Contains four true or false flags that indicate the general health of the object. Three of the four flags are associated
with the values of other attributes within the same object. By reading these attributes, you get a clearer picture of
the object status. The four flags are:
In Alarm - In Alarm flag is False (0) if the Event State attribute value is Normal; otherwise, the In Alarm flag is True
(1).
Fault - Fault flag is True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False (0).
Metasys SMP Help: Insert Menu
415
Overridden - Overridden flag is Logical 1 if the Present Value is decoupled from the hardware output because
operator intervention provided a different value or local override is active.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of Service
flag is False.
Use Remote Alarming
When the attribute Intrinsic Alarming Defined is set to True, determines where alarms for the object originate. If the
remote integrated object contains attributes for originating alarms, then Use Remote Alarming defaults to True,
causing the local mapper object to accept alarms from the remote integrated object that are routed to the NxE. If
the remote integrated object does not contain attributes for originating alarms, then Use Remote Alarming defaults
to False causing the local mapper object to originate alarms. When Use Remote Alarming is false, any alarms from
the remote integrated object are ignored at the NxE. If the value of Use Remote Alarming is changed, a restart of
the NxE may be required to assure correct operation. This attribute applies only to BACnet integrations.
Multistate Output Commands
The table below lists the commands supported by the Multistate Output Object.
Table 206: Multistate Output Object Commands
Command Name
Parameters
Disable Alarms
None
Enable Alarms
None
In Service
None
Operator Override
Out of Service
None
None
Release
1. Attribute name
2. Command priority
Release All
Attribute name
State0. . . StateN
None
Note: For the Override Release, Release, and Release All commands, if all Command Priorities have been released
and a Relinquish Default is not defined, the supervisory controller gives control over to the actual hardware.
Multistate Output Command Details
Disable Alarms
Disables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet Event Enrollment objects.
Enable Alarms
Enables all types of alarming: alarm extensions, BACnet intrinsic alarming, and BACnet Event Enrollment objects.
In Service
Cancels the effect of an Out of Service command and returns the Out of Service attribute to False. The Present
Value and Reliability will revert back to the values obtained from the physical hardware output.
Note: For BACnet objects, support of this command is dependent on the ability to write the Out Of Service attribute.
Metasys SMP Help: Insert Menu
416
Operator Override
Updates the Present Value at Command Priority Operator Override (8).
The Operator Override command sends the specified command to the internal NxE object, which is then only sent
to the field device when one of the following conditions is met: a) NOT Local Control and NOT Out Of Service, or b)
NOT Local Control and after issuing the In Service command.
Out of Service
Allows a user to override the object's hardware output for simulation or other purposes. The Out of Service command
changes the Out of Service attribute to True. The Present Value and Reliability no longer track the physical output.
No commands are sent to the actual hardware. When the Out of Service attribute is set to False, the current Present
Value is sent to the actual hardware.
When an Out Of Service command is issued, the NxE does not communicate subsequent changes (operator or
system) to the field device.
For BACnet objects, support of this command depends on the ability to write the Out Of Service attribute.
Release
Releases the identified command priority from the specified, writable attribute, and allows it to be controlled by the
next highest priority.
Release All
Releases Command Priorities 3 through 16 (Default) from the specified, writable attribute. Command Priorities 1
and 2 remain.
Important: The Release All command may not cause an immediate return to automatic operation. The Release
All command clears all command priorities, including those that come from applications and features.
When this release happens, the output point goes to its Relinquish Default condition. In some cases,
the application or feature may have sent a command that does not match Relinquish Default. In this
instance, the output point does not end in the state that the applications or features intended. This
situation can cause unexpected operation to occur; for example, a space might overcool or overheat,
a fan might run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
Release Operator Override
Releases Command Priority Operator Override (8) from Present Value.
State0. . . StateN
Releases Command Priorities 9 through 15 (Scheduling) and then writes to the Present Value at the Default (16)
command priority. If this is the highest priority, it is sent to the controller. Both the state command names and the
number of commands are dependent on the States Text and Number of States attributes.
Important: Be aware that an operator state command releases the actions of any processes running to the object
in the NxE or FEC controllers that use Priorities 9 through 16. Consider this behavior when creating
control strategies.
If Local Control is True, this command is rejected.
417
True or False
Number of States
Number
Out of Service
True or False
CW
Present Value
Priority Array
Set of values
Reliability
Not
supported
False
232
False
Always False
True
DRW
False
Reliable
State Text
Set of values
States Text
CW
418
Series of True or
False states
BCW
False
419
States Text
Indicates the displayed strings for the Present Value.
Status Flags
Contains four true or false flags that indicate the general health of the object. Three of the four flags are associated
with the values of other attributes within the same object. By reading these attributes, you get a clearer picture of
the object status.
The four flags are:
In Alarm - In Alarm flag is False (0) if the Event State attribute value is Normal; otherwise, the In Alarm flag is
True (1).
Fault - Fault flag is True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False (0).
Overridden - Overridden flag is Logical 1 if the Present Value has been overridden by some mechanism local
to the BACnet device or because the operator provided a different value.
Out of Service - Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of
Service flag is False.
None
Enable Alarms
None
Operator Override
State0StateN
None
Release
1. Attribute name
2. Command priority
Release All
State0 . . . StateN
1
Attribute name
1
None
The MS/TP Multistate Value supports an equivalent Set State command which takes State0-StateN as parameters.
420
421
Note:
On the Configure screen, click the Recipient List tab for further configuration.
Click the Add button to add a BACnet device as a recipient item to the list. The Notification Recipient
dialog box appears. See the Tips for the Notification Recipient section that follows.
Click the check box next to an item in the list and click Remove if you want to remove the item from the
list.
Click the check box next to an item in the list and click Details to view that items Notification Recipient
dialog box information.
Select an item in the list and use the up and down arrows to change the order of the item in the list.
422
The destination also defines the recipient device that receives the notification. The recipient device is specified by
either its unique Device Object Identifier or by its Network Address and MAC Address. In the latter case, a unicast
address or a broadcast, local/remote, or global address is used. The destination information specifies whether the
notification is sent using a confirmed or unconfirmed event notification.
The Ack Required attribute of the Notification Class object and the type of event transition determine whether the
event notification message requires acknowledgement.
Notification Class Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
Table 209: Notification Class Object Attributes - Focus/Configuration Tab
1
Attribute Name Data Type
BACnet
Initial Value Values/Options/Range
Notes
1
Notes
Ack Required
Series of True
and False
states
CW
False,
To Offnormal
False,
To Fault
False
To Normal
Uses BAC Event Bits (Set 525).
04,294,967,295
List of numbers CW
120
To Offnormal
200
To Normal
70
To Fault
Range = 0255
CW
True, False
CW
True, False
C - Configurable, W - Writable
List of value
sets
CW
C - Configurable, W - Writable
423
From Time, To Time (Start and Stop Times) - The window of time (inclusive) during which the destination
may be used. To specify all times, use 00:00:00 for Start Time and 23:59:59 for Stop Time.
IP Address - The 4 byte IP Address of the destination if routing by IP address. This value is ignored when
Network Number is set to 65,535. When set to 255.255.255.255 IP Address or the broadcast IP Address,
notifications are broadcast based on the Network Number. A value of 0 sends a local broadcast. A value of
165,534 sends a remote broadcast.
Issue Confirmed Notifications (Confirmed, Unconfirmed) - Indicates whether to send Confirmed or Unconfirmed
event notifications via radio button selection. This selection is ignored when using global broadcast notifications.
MSTP Address - The MS/TP address of the destination if routing by MS/TP address.
Network Number - The network number for the destination if routing by IP or MS/TP address:
-
Route to Metasys
Determines whether or not the Notification Class object routes alarms to the Metasys alarming system.
Metasys SMP Help: Insert Menu
424
BACnet Supported
Add Recipient
Yes
Disable
No
Enable
No
Yes
Remove Recipient
1
Schedule Object
The Schedule object works behind the scenes of the Scheduling feature. The Schedule object updates attribute
values of objects according to the time of day. These times can be specified for days of the week and as exceptions.
For general information on Metasys system objects, see the Object Help section.
Schedule Object Attributes
The display of the Schedule object uses two tabs, the Schedule Object Schedule Tab and the Schedule Object
Focus/Configuration Tab. If you add extensions, see Extensions for information on the extension tabs.
425
Label
The name or label that appears in the Navigation Tree.
Value
The Present Value or the Value indicates the current value of the Schedule object. This value is written to each of
the scheduled items.
Status
The status of the Schedule object. The possible statuses include:
Normal
Inactive - Today is not within the effective period
Unreliable - Data in Schedule is not consistent. This is a rare occurrence.
Disabled
Out of Service
426
Select this option to set the schedules Value type to Binary (one of two states, such as Off
and On).
Analog
Select this option to set the schedules Value type to Analog (for example, 72.0).
Multistate
Select this option to set the schedules Value type to Multistate (one of a set of states, such
as Off, Low, Medium, and High).
Select this option to set the schedules Value type to match the Value type of the attribute
scheduled for the Key Item. For example, all values are Boolean (True/False) if the Key
Items Enabled attribute is scheduled.
This type is only set by the system - it cannot be manually selected. This type indicates that
the current schedule type matches preexisting values.
427
Weekly Schedule
Contains a timeline of events for each day of the week - Monday, Tuesday, . . . Sunday. Each event has a time and
value that the Schedule writes to the scheduled objects. An event ends at midnight, but it can be ended earlier by
specifying an end time or by scheduling another event to start. Events in the Exception Schedule override times and
values in this Weekly Schedule. If the Weekly Schedule has no events defined on a particular day and time, and
there are also no exception events scheduled, the Default Schedule Command takes effect.
Note: Weekly Schedule does not display for third-party schedules that do not support a weekly schedule.
Exception Schedule
Contains a list of exceptions to the weekly schedule. The times and values in the exception replace anything that is
in the weekly schedule. If more than one exception is scheduled on the same day, the highest priority (precedence)
exception takes effect. If all exceptions are of the same precedence, they are executed in time order. Exceptions
override the Weekly Schedule only when events are scheduled for the exception. Any time that an exception event
is not in effect, such as when an event is ended before midnight (or no exception events are defined), the Weekly
Schedule takes effect. If the Weekly Schedule also has no scheduled events at that time, the Default Schedule
Command takes effect.
Note:
By default, exception schedules which have already occurred are deleted after 31 days. You can disable
automatic deletion of exception schedules or change the number of days until the exception schedules
are deleted to 7 days by configuring the JCI Exception Schedule attribute. For more information, see JCI
Exception Schedule in the Engine Device Object section.
Exception Schedule does not display for third-party schedules that do not support exceptions.
Scheduled Items
Contains the list of items to be commanded by the schedule object. If empty, the Schedule does not directly command
objects but its Present Value can still be used as an input to other logic, such as an Interlock or Control System.
The online display also includes a Status Log that shows the status of the schedules attempts to control each of
the scheduled items. If no objects are scheduled, the Schedule Output Type determines what type of command may
be scheduled.
Schedule Object Focus/Configuration Tab
The online UI displays the Focus tab. The SCT displays the Configuration tab.
Object Attributes
Name
The Name attribute contains a freely definable user-friendly Name for the object that is independent of the Item
Reference or the location of the object in the physical network. The Name is used as the label in the All Items
navigation tree. The Name is shown in alarm reports, the event and audit viewers, and in summaries. The Name
does not need to be unique to the site.
The Name defaults to the object identifier you used during manual object creation, but can be edited later. For
integrated BACnet objects, the name defaults to the BACnet Object Name in the remote BACnet device. For integrated
N1 network objects, the name defaults to the System.Object Name in the NCM.
Example: ConferenceCenter-Room2-LightingSchedule
The Name attribute allows up to 400 characters, but 40 or less is best for the display layout.
Metasys SMP Help: Insert Menu
428
Name is a common object attribute; for more information, see Common Object Attributes.
Description
The Description attribute contains a user-defined description of the object. The Description attribute allows up to 40
characters before Release 8.0 and up to 64 characters at Release 8.0 and later, but is not required. Description is
a common object attribute; for more information, see Common Object Attributes.
Object Type
The Object Type attribute indicates the type of object as displayed in the Metasys software and as exposed to a
BACnet network. The Object type of the Schedule object is Schedule. The Schedule object is a standard BACnet
schedule object and conforms to the BACnet protocol 135-2004 specification. Object Type is a common object
attribute; for more information, see Common Object Attributes.
Authorization Category
The Authorization Category attribute classifies the object by the category of system or equipment that it monitors to
aid in the determination of user access privileges and alarm routing.
Examples: HVAC, Fire, Security
Status Attributes
Enabled
Setting the Enabled attribute to False stops the object from updating its Present Value and stops the object from
commanding the referenced attributes. Setting the Enabled attribute to False does not change the Out of Service
attribute.
Status Flags
The Status Flags indicate the general health of the object. This attribute does not appear in the SCT.
Table 214: Status Flag Descriptions
Status Flag
Description
In Alarm
Fault
False means that the Reliability attribute is reliable, otherwise the flag is True.
Overridden
Out of Service
True means that the Out of Service attribute is also True, otherwise the flag is False.
Reliability
The Reliability attribute indicates the reliability of the object. If there are data type mismatches in the weekly schedule,
exception schedules, or Default Schedule Command, the object reports that it is unreliable. This attribute does not
appear in the SCT.
Out of Service
When True, the object no longer updates the Present Value itself. This attribute does not appear in the SCT.
Note: Disabling the object does not impact the ability to put the Schedule Out Of Service and write to its Present
Value and thus to its Outputs.
Metasys SMP Help: Insert Menu
429
Error Status
The Error Status attribute indicates whether the Present Value was successfully written to the list of property values
in the Scheduled Items list. The Error Status displays Ok if the object was able to send its latest Present Value to
every object in the Scheduled Items list. Otherwise, the Error Status displays the error of the first failed command.
See the status log in the Scheduled Items view for the status for each attempted command. This attribute does not
appear in the SCT, and does not appear for mapped third-party schedules.
Alarm State
The Alarm State attribute indicates that the object transitioned into alarm or unreliable conditions. This attribute does
not appear in the SCT.
Engineering Values Attributes
Item Reference
The Item Reference attribute contains a unique reference name for the object that is the full path name of the object
through the All Items navigation tree using the unique identifier you specified when you manually created the object.
Item Reference is a common object attribute; for more information, see Common Object Attributes.
Version
The Version attribute displays the version number of the object software code. Version is a common object attribute;
for more information, see Common Object Attributes.
Execution Attributes
Execution Priority
The Execution Priority attribute indicates the relative importance of performing the function of the object within the
device.
Priority for Writing
The Priority for Writing attribute defines the priority at which the referenced attributes are commanded. Seven is the
highest priority and 16 is the lowest supported by the Schedule object, with the default of 15.
Note: We do not recommend using priorities 7 or 8 as they may interfere with the operator override functionality.
Scheduled Commands
Disable
The Disable command stops all future scheduled events. Neither the Weekly Schedule nor the Exception Schedule
run again until the Schedule object is re-enabled. While disabled, the status log in the Scheduled Items view lists
the object as disabled. The schedule remains disabled until re-enabled.
Enable
The Enable command allows the Schedule object to resume normal scheduling operation. The Schedule object
starts the schedule as soon as it is enabled. When it is re-enabled, the Schedule object writes its current value to
the scheduled items.
430
Folder
Menu Selection: Insert > Folder
Inserts a folder into the navigation tree of the system for grouping and categorizing items and information in the
navigation tree.
Control System
Menu Selection:Insert > Control System
Inserts a control system into the site. See Logic Connector Tool (LCT) for more information on control systems and
the Logic Connector Tool.
Text
Enabled
True or False
Instance Of
Text
Program Change
Values/Options/Range
CW
Ready
0 = Ready
1 = Load
2 = Run
3 = Halt
4 = Restart
5 = Unload
Program Location
Text
Program State
0 = Idle
1 = Loading
2 = Running
3 = Waiting
4 = Halted
5 = Unloading
431
Values/Options/Range
0 = Normal
1 = Load Failed
2 = Internal
3 = Program
4 = Other
Reliability
1
C - Configurable, W - Writable
Ready - Specifies that the LCT control system is ready for a change request (normal state).
Load - Enables the LCT control system.
Run - Enables the LCT control system.
Halt - Disables the LCT control system.
Restart - Disables, then Enables, the LCT control system.
Unload - Disables the LCT control system.
Program Location
Indicates the location of the program/control system.
Program State
Reflects the current state of the LCT application.
432
Reliability
Indicates whether the connections between logic blocks are reliable.
433
For mouse shortcuts in Edit mode, see Mouse Shortcuts: Edit Mode.
View Mode
The Logic Connector Tool displays in the View mode when you are browsing a site running Metasys software in
offline mode (using the SCT) or online mode. (See Metasys Modes.) See Errors in View Mode.
In View mode, you have access only to a limited number of items on the toolbar. The System and Logic blocks do
not appear in this mode. The LCT opens in View mode. You must enter the Edit Mode to edit any of the control
system logic.
The View mode allows you to edit Program (Control System) Object attributes (from the Configuration tab) and send
commands to any of the input reference blocks in the diagram.
Dynamic values display on the connection line between two logic blocks. Values refresh every 15 seconds unless
you click the Refresh button on the Toolbar. Click the Trace mode icon on the toolbar and the tool displays online
values, but hides logical connections between blocks. If you click a block, the tool traces all connections to and from
that block (from the first input to the last output).
Right-clicking in View mode has no effect.
For mouse shortcuts in View mode, see Mouse Shortcuts: View Mode.
Toolbar
The Logic Connector Tool uses the toolbar described here:
Table 216: LCT Toolbar
Icon
Command
Visible In
Edit Mode
(Standard
Windows Icons not
Shown)
Action
View Mode
Edit Mode
Refresh
Save
Cancel
Print Preview
Cut
Copy
Paste
434
Visible In
Edit Mode
(Standard
Windows Icons not
Shown)
View Mode
Undo
Redo
No Grid
Lines Grid
Points Grid
Select
Text
Pan
Zoom
Interactive Zoom
Trace Mode
(123)
Action
Selective Zoom
Logic Checker
Sequence (Show
Sequence Order)
Overview
When using a zoom tool in View mode, if you click outside of the display panel containing the logic system, the zoom level
automatically changes back to the default.
435
Logic
Logic contains the following components:
Once a logic process completes, it runs again in approximately 5 seconds. For example, if a logic process starts at
10:00:00 and completes at 10:00:04, it runs again at 10:00:09. It is important that control applications that require
particular timing use internal logic to determine time between execution.
If your logic references multiple Engines or multiple ADS/ADX s, and one device needs to be downloaded, upload
all Engine/ADS/ADX s prior to making changes in SCT. This procedure ensures your logic works consistently.
System Blocks
System blocks support drag and drop functionality. When you deposit a System block onto the workspace, a
configuration wizard guides you through the configuration of the control system. System blocks are useful when you
have complex logic because they allow you to nest one control system in another control system. When you create
a System block, the Metasys software creates a Program (Control System) Object under the first Program object in
the navigation tree.
See Adding Items to Logic.
Logic Blocks
Logic blocks support drag and drop functionality. If the list of Logic blocks is too long to fit into the Logic block list
area, use the scroll bar to expose additional blocks.
Logic blocks are not visible on the navigation tree. If the LCT window is not large enough to show all the logic blocks,
you cannot scroll down to see the hidden blocks. To make sure you see them all, enlarge the panel displaying the
logic by dragging the borders or reducing the number of panels.
See the following table for a list of Logic blocks.
Table 217: Logic Blocks
Logic Block Name Description
Math
Bool
Performs Boolean functions on 28 inputs, producing a single output. This category also includes the
Latch function.
Statistical
Selector
Performs multiplexing for 28 inputs, producing a single output. Based on the current mode assigned
to each input, the selector chooses which input to pass through to the output.
Control
Psychro
(Psychrometric)
Attributes
Gives the user the ability to expose values from within their control logic, either as an input or output.
These blocks are considered attributes of the Program (Control System) Object in which they are
included, and may be viewed or configured from the standard Focus view. A control system is limited
to a combination of 24 inputs and 24 outputs. See the Program (Control System) Object for more
information.
436
Calculation
Controls the amount an output can change per control system execution or extrapolates an output using
two inputs for reference.
Timing
Passes its input to its output at the next execution of the control system (every 5 seconds). Timing
blocks are used to break up feedback loops. The Timing category also includes the Time and Timer
blocks.
Math Category
Math blocks perform calculations on input. See the following table for details.
Table 218: Math Blocks
Block
Math Type
Inputs
Multiply
28
Add
28
X/Y
Divide
X-Y
Subtract
Neg
Negative
Abs
Absolute
Sqr
Square Root
Cos
Cosine
Sin
Sine
Tan
Tangent
ATan
Arc Tangent
ACos
Arc Cosine
ASin
Arc Sine
Exp
Exponent
LN
Natural Log
LOG
Log
X^Y
X^Y
The number of inputs to a Math logic block depends on the number of inputs supported by the type of math function.
The Logic Connector Tool allows you to add multiple connections to the output of the block.
See Editing Blocks in Edit Mode for information on editing Math blocks.
Bool Category
Bool blocks apply Boolean functions to input. The number of inputs to a Bool logic block depends on the number of
inputs supported by the type of Boolean function. The Logic Connector Tool allows you to add multiple connections
to the output of the block.
437
Inputs
AND
28
OR
28
XOR
NOT
LTCH
See Editing Blocks in Edit Mode for information on editing Bool blocks.
LTCH (Latch)
The Latch block holds a binary value until you command it to reset. Latch blocks help capture rapidly changing binary
states that might otherwise be missed. The Input of the Latch block is a binary attribute, sampled every time the
logic system runs (every 5 seconds). Use an Attribute Reference block to create the Input for Latch.
Reset determines if the Output of the block changes with a change in the value of the Input. When Reset is True,
the Output of the Latch block stays its original value, even if the Input changes value. Reset is also a binary attribute.
To change the value of Reset, double-click the binary attribute block in View Mode and issue an Inactive or Active
command.
This table translates the value of the Input or Reset binary attribute into True and False values for the Latch block:
Table 220: Latch Blocks
Binary Attribute Value
Command/State
True or False
1.0
Active
True
0.0
Inactive
False
The following table and figure summarize the operation of the Latch block:
Table 221: Latch Block Operation
Input
Reset
Output
True
False
Even if the Input goes to False, the Output stays True as long
as Reset is False.
Goes from False to True
True
False
False
True
Even if the Input goes to True, the Output stays False as long
as Reset is False.
True
False
438
Statistical Category
Statistical blocks perform statistics on input. The number of inputs to a Statistical logic block depends on the number
of inputs supported by the type of statistic. The Logic Connector Tool allows you to add multiple connections to the
output of the block.
Table 222: Statistical Block Connections
Statistical Type
Inputs
AVG
28
MAX
28
MIN
28
See Editing Blocks in Edit Mode for information on editing Statistical blocks.
Selector Category
Selector logic blocks (Mux) have 28 inputs, one mode input, and one output. Depending on the current value of
the mode input, the Selector chooses which input passes through to the output. The Logic Connector Tool allows
you to add multiple connections to the output of the block.
See Editing Blocks in Edit Mode for information on editing Selector blocks.
Control Category
Most control logic blocks have three inputs, and you can add multiple connections to the output of the block. The
blocks compare input number 1 with input number 2 using the differential (input number 3). The type of control
depends on the statistical type. The Sequencer functions differently. See SEQ (Sequencer) for details.
439
Statistical Type
Inputs
X>Y
greater than
X<Y
less than
X<=Y
X>=Y
<>
not equal
equal
SEQ
Sequencer
See Editing Blocks in Edit Mode for information on editing Compare blocks.
SEQ (Sequencer)
Sequencer blocks activate devices in a sequential order based on the rank of the device and whether the device is
enabled. Lower ranked devices are activated before higher ranked devices, and higher ranked devices are deactivated
before lower ranked devices.
The Input value at which the sequencer activates or deactivates each device is based on the make and break limits
configured for the Sequencer. See Editing SEQ (Sequencer) Blocks for information on configuring the make and
break limits. The defaults for a 3-stage Sequencer with a range of 0100 are the following:
Table 224: SEQ (Sequencer Blocks)
Make Limits (Activation Points)
Stage 1
33
Stage 2
67
34
Stage 3
99
68
Sequencer blocks can output a value for minimum of 2 and maximum of 8 devices. The following table describes
the components of a Sequencer block:
Table 225: Sequencer Block Components
Component
Description
Input
Instant Shutdown
Rotate Now
Activates reordering of output sequence. The manner in which the outputs Device 1 Output through
Device 8 Output are reordered for activation is based on a combination of two factors: the ranking
defined for each device, and whether the device is enabled. All enabled outputs are scheduled for
output selection prior to disabled outputs. And, within each of these categories (enabled and disabled
outputs), the selections are ordered beginning with the lowest ranked and proceeding on through to
the highest ranked output. Unlike all other reordering scenarios, the issue of whether or not a device
is currently active is not taken into account in this situation.
Use a binary object attribute (1.0=Rotate now, 0.0=Do not rotate now).
440
Establishes whether or not the output is enabled. Use a binary object attribute
(1.0=Enabled, 0.0=Disabled).
Device 18 Rank
Establishes the order in which device outputs are activated. Use an analog object attribute (reference
block) or a Constant block.
True or False
1.0
Active
True
0.0
Inactive
False
See Editing SEQ (Sequencer) Blocks for information on editing Sequencer blocks.
Psychrometric Category
Psychrometric logic blocks have 2 inputs, and you can add multiple connections to the output of the block.
Table 227: Psychrometric Blocks
Symbols
Description
Upper Input
Lower Input
EN-DP (EnDp)
DB
DP
EN-RH (EnRh)
DB
RH
RH-DP (RhDp)
DB
DP
RH-WB (RhWb)
DB
WB
WB-DP (WbDp)
DB
DP
WB-RH (WbRh)
DB
RH
ABH
Absolute Humidity
DB
RH
DP
Dew Point
DB
RH
See Editing Blocks in Edit Mode for information on editing Psychrometric blocks.
Attributes Category
Attribute blocks let you expose values in your logic and configure inputs and outputs. Control systems can contain
a maximum of 24 inputs and 24 outputs.
Input and Output Attributes
In View Mode, a double-click on an Attribute Input or Output block has no effect. In the Edit Mode, when you drag
and drop an attribute block from the palette, configuration wizards launch to help you configure the attribute.
Attributes support a maximum of 24 input or 24 output blocks of Numeric, Enum, or Bool. Attributes expose values
at different stages of the Metasys system for a user to see at a glance or connect to/from.
See Editing Blocks in Edit Mode for information on editing Attribute blocks.
Note: Once an attribute is configured as Numeric, Enum, or Boolean, it cannot be changed.
Metasys SMP Help: Insert Menu
441
Attribute Reference
After inserting an attribute reference (Input Ref or Output Ref), you can edit which object/attribute is being referenced.
See Editing Blocks in Edit Mode. If you double-click in View mode, a Command dialog box appears for Input refs
only.
Constant Category
Constant logic blocks can have multiple connections to the output of the block. Constant logic blocks can be any
one of the following:
Table 228: Constant Blocks
Block
Statistical Type
Enum
Enumeration
Float
Float
Rel.
Release
Note: Sends the Release command at a specific priority based on the connection.
See Editing Blocks in Edit Mode for information on editing Constant blocks.
Calculation Category
RL (Rate Limiter)
The Rate Limiter block controls the rate at which its Output changes with variations in its Input value. If rate limiting
is disabled, this block passes the value of the Input to the Output. If rate limiting is enabled, this block limits changes
to its Output to an increment determined by the Step Equation, executed according to the rate limit. This table
describes the components of the Rate Limiter block:
Table 229: RL (Rate Limiter Blocks)
Symbol
Description
IN
Input
EN
Enabled
Enables rate limiting. Use a binary object attribute reference for EN:
0 = Disabled (Inactive command)
1 = Enabled (Active command)
Rate Limiter blocks use the Step Equation to determine the maximum increment (step) the Output can change to
match the Input if the two differ. The Step Equation recalculates the step every time system logic executes (every
5 seconds).
The Step Equation looks like this:
Step = Rate Limit/60,000 * Actual Period
Where:
442
Rate Limit:
Rate per minute to increase or decrease the Output until it matches the Input
Actual Period:
Time in milliseconds since the last execution of the block. The system logic and Step Equation execute
every 5 seconds (5,000 milliseconds).
Description
IN
Input
IL
Input Low
OL
Output Low
IH
Input High
OH
Output High
The Span block creates a linear relationship between the low input/output and high input/output pair. If the Input for
the Span block falls between the low and high input, the Output of the Span block is found on the line between the
low and high pairs.
The following example shows a graphical picture of how the Span block works:
443
The line connecting the low and high pairs (blue line) represents the linear relationship between them. When you
enter an Input for the Span block, the logic finds where the line crosses that input and provides the corresponding
output. (The output must lie on the thick blue line.) Using the figure above, if you enter 5 for the Span block Input,
the block would find 5 on the Input axis and provide an output of 5.5 because that is where the line crosses an Input
value of 5. (The green line shows this relationship.)
If the Span block is set up to Clamp (see Editing Span Blocks) the value of the Output, the Output of the block is
restricted to the range between (and including) the low and high Output you enter for the block. Range clamping is
the default setting. For example, assume you are using the values in the figure below and have clamping set to True.
If you enter an Input of 5, you still generate an Output of 5.5, because the original line crosses an Input of 5 at 5.5,
which is between 4 and 8 (low and high output). If you enter an Input of 12, you generate an Output of 8, because
where the original line crosses an Input of 12 is higher than the high output (see where thin blue and thin green lines
intersect). If clamping is True for both high and low, the output must lie on the newly drawn thick blue line.
Figure 44: Span Block Example 2
The Span block works for the reverse span as well (if the Output High is lower than the Output Low). See Editing
Blocks in Edit Mode for information on editing Span blocks.
444
Timing Category
Delay blocks have one input and one output and are commonly used to break up feedback loops.
The Timing category also includes the TMR (Timer) and Time blocks.
See Editing Blocks in Edit Mode for information on editing Timing blocks.
TMR (Timer)
This table describes the components of the TMR blocks:
Table 231: TMR (Timer) Blocks
Output
Description
IN
Input
RS
Reset. Cancels the timer. Reset does not apply to Minimum On or Minimum Off timers. Use a binary
object attribute for Reset (1.0=Reset Active, 0.0=Reset Inactive).
The LCT contains five different types of timers. Each type uses a Duration (how long the timer is active) and unique
functions to generate an Output. The different types of timers are listed below. Click the name of the timer for a
description and figure of timer operation.
For information on setting Duration and the type of Timer, see Editing Timing Blocks.
Pulse Timer Function
The following table and figures illustrate the function of the Pulse timer.
Table 232: Pulse Timer Function
Feature
Description
Activation
Goes active if the Input goes from low to high in two consecutive executions (logic executes every 5
seconds. The Pulse timer remains active for the amount of time specified in Duration, then goes to
inactive. High to low transitions do not activate this timer.
Output
Stays high as long as the timer is active. After the Duration expires, the Output goes low at the next
logic execution.
Reset
Cancels timer activity and makes the output low. If the Reset goes from high to low, the timer
re-evaluates the Input at the next low to high transition.
Example
Captures a short pulse on a binary input and keeps the Output True long enough so that the logic can
react to it.
445
446
Goes inactive in a low to high Input transition, depending on the state of the input during the duration
period. If the Input returns to a low state (inactive), the timing cycle is canceled and the Output remains
inactive. If the Input remains in a high state, the Output goes to the high state at the next execution of
logic.
In a high to low Input transition, the Output becomes inactive the next time the logic executes (logic
executes every 5 seconds).
Output
Reset
Cancels timer activity and makes the output inactive. If the Reset goes from active to inactive, the
timer re-evaluates the Input at the next low to high transition.
Example
Delays the supply fan start 20 seconds after the return fan starts.
447
448
In a low to high Input transition, the Output becomes active the next time the logic executes (logic
executes every 5 seconds).
Goes inactive in a high to low Input transition, depending on the state of the input during the duration
period. If the Input returns to a high state (active), the timing cycle is canceled and the Output remains
active. If the Input remains in a low state, the Output goes to the low state at the next execution of
logic.
Output
Reset
Cancels timer activity and makes the output inactive. If the Reset goes from active to inactive, the timer
re-evaluates the Input at the next low to high transition.
Example
Keeps the fan running to purge the coils after a heating or cooling system is turned off. Off Delay is
useful when your building contains electrical heat and/or DX cooling.
449
Output
Goes active when there is a low to high Input transition when the timer executes (logic executes every
5 seconds). The Output remains active until the time specified in Duration passes AND the Input
returns to inactive.
Reset
Example
Keeps a chiller running for a minimum time after startup to stabilize equipment.
450
451
Output
Goes inactive when there is a high to low Input transition when the timer executes (logic executes
every 5 seconds). The Output remains inactive until the time specified in Duration passes AND the
Input returns to active.
Reset
Example
Keeps a chiller off from a minimum time after shutdown to equalize refrigerant.
452
Time
A Time block has no configurable input because it extracts time and date information from the network. Network
time/date is set at the site director. The outputs of a Time block are six time/date values:
Table 237: Time Blocks
Output
Description
Format
HH
Hour
MM
Minute
059
YR
Year
four-digit year
MO
Month
112
DA
Day
131
DOW
1=Monday
2=Tuesday
3=Wednesday
4=Thursday
5=Friday
6=Saturday
7=Sunday
453
Connections
Connection lines connect blocks in the logic. The LCT does not do a datatype check; that is, you can connect Boolean
and Constant values, and any other combination. But, the tool does not allow inputs to connect to inputs, or outputs
to outputs. The tool determines the connection line routing, and the only way to change the routing is to move the
blocks or use the hide feature.
Control Systems
Control systems are collections of subsystems and/or Logic Blocks that may be connected together.
General Logic Connector Tool Rules
Table 238: General LCT Rules
What Are You Doing? What Components Are You
Using?
Moving, Sizing, Typing
Connecting
Connecting
All blocks
System blocks
Attribute Properties:
Read Only
Output
Writable
Input or Output
Prioritized Write
Math, Bool, Statistical, Selector, All inputs should be connected for these Logic blocks. If you
attempt to save logic that is missing inputs, an error message
Control, Psychrometric,
displays. You may save anyway or supply inputs where
Calculation
necessary. We do not recommend saving with missing inputs.
In the Edit view, blocks with missing inputs have red input points.
When the inputs are connected, the connection point turns blue.
Logic Checker
The Logic Checker is not the same logic check run with a LCT save. It must be selected from the Toolbar. The Logic
Checker scans the control system logic and reports any configuration issues it finds.
Table 239: Logic Checker
Condition
Message Text
454
Printing
The Logic Connector Tool supports printing of the following paper sizes in either landscape or portrait orientation:
The Logic Connector Tool supports printing of just the existing control system.
Mouse Shortcuts
Use mouse shortcuts to speed up LCT use.
Mouse Shortcuts: Edit Mode
The following table lists the mouse shortcuts you can use in the Edit Mode of the LCT.
Table 240: Edit Mode Mouse Shortcuts
Component
Single
Double Left-Click
Left-Click
Right-Click
System Block
Select
Math Block
Select
Lets you edit the block (Editing Math Blocks). Cut, Copy, Paste, Duplicate, Delete
Bool Block
Select
Lets you edit the block (Editing Bool Blocks) Cut, Copy, Paste, Duplicate, Delete
(except for LTCH blocks).
Statistical Block
Select
Selector Block
Select
Control Block
Select
Psychrometric
Block
Select
Lets you edit the block (Editing Psychrometric Cut, Copy, Paste, Duplicate, Delete
Blocks).
Attribute Block
Select
Attribute
Reference Block
Select
Constant Block
Select
455
Right-Click
Timing Block
Select
Lets you edit the block (Editing Timing Blocks) Cut, Copy, Paste, Duplicate, Delete
(except for Time blocks).
Connection:
Prioritized
Select
Hide, Delete
Connection:
Non-Prioritized
Select
Has no action.
Hide, Delete
Text Block
Select
Workspace
Select (drag to
lasso items)
Double Left-Click
Right-Click
System Block
Select
Math Block
Select
Bool Block
Select
Statistical Block
Select
Selector Block
Select
Control Block
Select
Psychrometric Block
Select
Attribute Block
Select
Select
Constant Block
Select
Timing Block
Select
Calculation Block
Select
Connection
Select
Text Block
456
3. Drag and drop the program/control system to the workspace. The LCT opens in View Mode.
4. Change to Edit mode (Changing LCT Modes) to add or edit items in the workspace.
5. Add symbol blocks (Adding Items to Logic) and add text blocks (Adding Text Blocks) to the workspace.
6. Connect the blocks (Connecting Blocks).
7. Edit blocks (Editing Blocks in Edit Mode).
8. Save the program/control system (Saving a Control System).
9. Download the program/control system to the online controller, if you created or edited the logic in offline mode
(using the SCT).
Note:
You must create a unique name for each program/control system created under the same folder. You
can create programs/control systems with the same names as long as they are stored in different folders.
When defining logic with scientific notation where the number of digits to the left of the decimal point is
large, the system extends the range of values displayed without scientific notation to include all values
with an absolute value less than 10 million and greater than or equal to one millionth (0.000001 <= |value|
< 10,000,000.0).
If the item is a System block, a configuration wizard appears. Answer the questions to set up the new
object/system or create a reference to an object or control system.
There is not interaction between the user navigation tree and logic.
2. Edit the block to match your needs. See Editing Blocks in Edit Mode.
Copy and Paste
Note: You can copy and paste existing objects into the workspace from the workspace only.
To add items to a control system using the copy and paste method:
1. Right-click an existing object and select Copy.
2. Right-click in the workspace and Paste the object.
Note: The copy and paste method supports copying and pasting of multiple blocks. To copy and paste more
than one block, hold down the Shift key while selecting blocks with the cursor or use the select tool to
lasso the blocks.
Metasys SMP Help: Insert Menu
457
Connecting Blocks
1. Make sure the Logic Connector Tool is running in Edit Mode.
2. Place the cursor over the starting connection point until it changes shape from an arrow to a magic wand and
click the point.
3. Click the ending connection point.
Note:
If the connection is valid, the cursor is a magic wand. If the connection is not valid, a circle with an X
through it appears, and the tool does not connect the points.
After you successfully connect two points, the line between them turns blue until you click somewhere
else in the workspace.
You do not need to click the exact connection point. If you click in the block, the tool automatically
creates a connection to/from the nearest blocks connection point. To cancel the connection after
clicking the first block, click anywhere in the workspace.
4. The Priority Connection dialog box appears. Choose a priority from 116 (1 is the highest priority).
Note: To change the priority at a later time, you must delete the connection and reinsert it.
Re-Routing a Connection
1. Make sure the LCT is running in Edit Mode.
2. Place the cursor over an existing end connection point until the cursor changes into a cursor with lines protruding
from the tip.
Note: You may only move the destination point. To completely change the connection, see Deleting Connections.
3. Click the connection point. The tool removes the connection.
4. Click a new connection point. The tool creates the newly routed connection.
Hiding Output Connections
1. Make sure the LCT is running in Edit Mode.
2. Place the cursor over the output connection point and right-click and a menu appears.
3. Select Hide from the menu. The tool removes all connections from the output and replaces the lines with numbered
symbolic representations of the connections.
4. To see the connections again, right-click the starting connection point and select Unhide.
Note: Double-click the hidden connection to label it. If multiple connections are from the same hidden input, it
is shown as Label: number where number is the number of connections.
Do not start labels with a number and then follow it with any of these characters: $ . - ,
Deleting Connections
1. Make sure the LCT is running in Edit Mode.
2. Select the connection and right-click.
3. Select Delete from the menu.
OR
1. Select the connection.
2. Press the Delete key on the keyboard.
458
Select the Add button to add an attribute to configure. To remove attributes from the System, select
the check box next to one or more attributes and click the Remove button.
To view the control system for the System block, drag and drop the control system from the Navigation
Tree to the Panel Layout.
The number of inputs depends on the type of Math block you use. You cannot reduce the input count
lower than the number of current connections.
OK
Accepts changes.
Cancel
Cancels changes.
The number of inputs depends on the type of Bool block you use. You cannot reduce the input count
lower than the number of current connections.
OK
Accepts changes.
Cancel
Cancels changes.
459
2. Edit the fields and configure the type of statistical block and number of inputs.
Table 244: Statistical Block Configuration
Field
Description
Type
Input
You cannot reduce the input count lower than the number of current connections.
OK
Accepts changes.
Cancel
Cancels changes.
Enum Category
Enum Set
Input 1 Mode(s)
Click the button and a dialog box appears that allows you to select which modes associate with each
input. In the dialog box, select the check box next to the desired mode(s). If a mode is already assigned
to another input, the mode appears dimmed. Select Default to select all modes for an input that are
not currently selected by any other input.
Input 2 Mode(s)
Click the button and a dialog box appears that allows you to select which modes associate with each
input. In the dialog box, select the check box next to the desired mode(s). If a mode is already assigned
to another input, the mode appears dimmed. Select Default to select all modes for an input that are
not currently selected by any other input. There is one of these per input (28).
OK
Accepts changes.
Cancel
Cancels changes.
The Type of comparison performed by the block. This field defaults to what was dragged over, but may
be changed.
OK
Accepts changes.
Cancel
Cancels changes.
460
Min On Time
Specifies the minimum time an output must be on before being deactivated to an off condition. When
an output is activated, a timer starts. Until the timer reaches the minimum time, the output cannot be
deactivated.
Specifies the minimum time an output must be off before being reactivated to an on condition. When
an output is deactivated, a timer starts. Until the timer reaches the minimum time, the output cannot
be activated.
Interstage On Delay Defines the minimum time that must elapse between the sequential activation of Sequencer stages.
Interstage Off Delay Defines the minimum time that must elapse between sequential deactivation of Sequencer stages.
Make/Break Limits
The box next to Make/Break indicates if Proactive is selected and, when you click, launches the
Make/Break Dialog box.
In the Make/Break Dialog box:
Default check box: Disables all make/break limit text boxes and uses the default values. The
default values are set so that each device is on for a proportional amount of time.
Proactive check box: Disables the Stage 1 make/break limit boxes (because that stage is always
on) and shifts all the make/break limits down one stage.
Make Limit: Turns on the stage when the input value to the block reaches this limit.
Break Limit: Turns off the stage when the input value to the block decreases to this value.
The current stage make limit must be less than the next stage make limit.
The current stage break limit must be less than the current stage make limit,
OR
the current stage make limit must be greater than the current stage break limit.
The current stage break limit must be less than the next stage break limit.
OK
Accepts changes.
Cancel
Cancels changes.
461
Allows you to configure the current elevation of the site (in feet or meters).
Unit Type
Allows you to choose International System of Units (SI) or Imperial (IP) units.
OK
Accepts changes.
Cancel
Cancels changes.
Units
Display Precision
Tells the Metasys software what precision to use when formatting data.
This field only appears for floating inputs.
Note: Display Precision is used in the Focus view of data, not the graphical view.
Enum Category
Set category determined by the user interface (either Two State or Multi State).
This field only appears for Enum inputs.
Enum Set
Trigger
This is checked if you want the attribute to trigger the control system to execute if its value changes by
more than the defined increment.
OK
Accepts changes.
Cancel
Cancels changes.
Units
Display Precision
Tells the Metasys software what precision to use when formatting data.
This field only appears for floating outputs.
Note: Display Precision is used in the Focus view of data, not the graphical view.
462
Set category determined by the user interface (either Two State or Multi State).
This field only appears for Enum outputs.
Enum Set
OK
Accepts changes.
Cancel
Cancels changes.
Object
Browses to the object to which the reference is linked. Leaving this field blank leaves a placeholder for a
future reference. The dragged object's name appears in this field and the object's attributes appear in the
drop-down list in the attribute field.
Attribute
The attribute to which the reference is linked. When you are configuring for an Input reference, the drop-down
list contains numeric attributes only.
Units
Trigger
This is checked if you want the attribute to trigger the control system to execute immediately instead of
waiting for the next control system scan if the value changes by more than the defined increment. Otherwise,
the control system executes normally.
Increment
OK
Accepts changes.
Cancel
Cancels changes.
463
Object
Browses to the object to which the reference is linked. Leaving this field blank leaves a placeholder for a
future reference. The dragged objects name appears in this field and the objects attributes appear in the
drop-down list in the attribute field.
Attribute
The attribute to which the reference is linked. When you are configuring an Output reference, the drop-down
list contains numeric, writable attributes only.
OK
Accepts changes.
Cancel
Cancels changes.
Set category determined by the user interface (either Two State or Multi State).
Enum Set
Enum
OK
Accepts changes.
Cancel
Cancels changes.
Units
OK
Accepts changes.
Cancel
Cancels changes.
464
Specifies the rate per minute to increase/decrease the Output until it matches the Input.
Startup Value
Specifies the value the rate limiter block will start at when the engine is restarted and block enable
is true.
OK
Accepts changes.
Cancel
Cancels changes.
Selects whether (True) or not (False) to clamp the Output at the Output High (OH). For more
information on clamping, see Span.
Clamp Low
Selects whether (True) or not (False) to clamp the Output at the Output Low (OL). For more information
on clamping, see Span.
OK
Accepts changes.
Cancel
Cancels changes.
OK
Accepts changes.
Cancel
Cancels changes.
465
Specifies the length of the timer function in seconds. The range is 586,400 seconds.
Setup
Pulse
On Delay
Off Delay
Minimum On
Minimum Off
OK
Accepts changes.
Cancel
Cancels changes.
Click the workspace to select a location for the text. The text block appears.
Select the Select icon on the toolbar.
Double-click the text block to display the text editor. Edit the text and click OK.
Select the text block and drag the sides to resize the block.
Note:
To edit the text, double-click the block. The block opens for editing.
To change the text properties, right-click the text block and select Properties from the menu. You can
change the font (type, size, bold, italic, bold italic), text color, background color, and border
visibility/color.
Colon (:) and quote () characters cannot be entered by the user in this field.
466
The logic check done with the Save command is not the same as the Logic Checker run from the toolbar.
If inputs are missing, an error message appears asking if you want to continue with the save. Click No
to return to the logic. Click Yes to save anyway. We do not recommend saving with errors.
Object
The Insert Object wizard inserts one of the following object types.
467
List of Object
Reference
Enabled
True or False
True
Execution Priority
Normal
Present Value
Off
Reliability
Shutdown State
Startup Delay
Number
States Text
List of states
CW
CW
On = 1
Off = 0
Units = Minutes
468
Dependents
Uses each dependent object identified in this list of object references to locate the Alarm object that is to have its
alarm reporting controlled by the control point.
Enabled
Indicates whether the Auto Shutdown object is enabled (True) or disabled (False).
Execution Priority
Indicates the relative importance of performing the function of the object within the device.
Present Value
Represents the current value of the Auto Shutdown object. When the state is On, the object has disabled the Alarm
objects. When the state is Off, the object has enabled the Alarm objects.
Reliability
Reflects the reliability of the control point. When the control point is not reliable, the Reliability attribute becomes
Input Unreliable.
Shutdown State
Determines the definition of the shutdown state. When the control point goes to the state defined as the shutdown
state, Auto Shutdown disables alarms from the point.
Startup Delay
Represents the time in minutes that must elapse before alarm reporting is re-enabled, once the control point changes
from the Shutdown State to any other state.
States Text
Indicates the displayed strings for the Present Value.
Auto Shutdown Commands
The table below lists the commands supported by the Auto Shutdown Object.
Table 260: Auto Shutdown Commands
Command Name
Parameters
Disable
None
Enable
None
469
Enable
Allows the Auto Shutdown object to respond once again to any changes occurring at the control point. Immediately
following receipt of this command, the control point current state is re-evaluated, and the appropriate action is taken
on the items in the Dependents list.
470
Number
Message Transmits
Number
Reliability
Input Unreliable
CNW
Null
Units = seconds
471
None
Enable
None
472
Focus/Configuration Tab
Object Attributes
Name
The Name attribute contains a freely definable user-friendly name for the object that is independent of the Item
Reference or the location of the object in the physical network. The Name is used as the label in the All Items
navigation tree. The Name is shown in alarm reports, the event and audit viewers, and in summaries. The Name
does not need to be unique to the site.
The Name defaults to the object identifier you used during manual object creation but can be edited later.
Description
The Description attribute contains a user-defined description of the object.
Object Type
The Object Type attribute indicates the Object Type as displayed in the Metasys software and as exposed to a
BACnet network.
Example: DLLR (Demand Limiting Load Rolling).
AuthorizationCategory
The AuthorizationCategory classifies the object by the category of system or equipment that it monitors to aid in the
determination of user access privileges and alarm routing.
Examples: Energy, HVAC, Fire, Security
Status Attributes
Enabled
The Enabled attribute provides a mechanism to stop DLLR operation. When disabled, DLLR releases all shed loads
except those that are locked shed. Also, DLLR does not perform any calculations, report alarms, or issue any
commands to any loads when disabled. DLLR attributes can be changed, but no actions are taken until DLLR is
enabled.
When enabled, DLLR operation starts again. If Shed mode is active, the configured DLLR strategies begin shedding
loads as needed. If Monitor Only mode is configured, simulated load shedding begins.
Alarm State
Indicates the current Warning or Alarm state of an object. This attribute is set by an Alarm Extension associated
with the object.
DLLR Status
The DLLR Status attribute indicates the current DLLR status. The statuses include:
473
EOI Off Normal - an end of interval (EOI) attribute is defined, but it is offline or its value is not reliable. This also
indicates that the EOI Attribute is replaced with the fixed window algorithm.
Disabled - the DLLR object is not being used to shed (or simulate the shedding of) loads.
No meter defined for DL - a meter is not currently defined for DL; a requirement if the Shed Strategy includes
Demand Limiting.
Meter Status
The Meter Status attribute indicates the status of the meter, if the meter is defined. The meter status includes:
Undefined
Normal
Off Normal
EOI Status
The EOI Status attribute indicates the status of the EOI object, if the EOI object is defined. The EOI Status attribute
uses the same status set as Meter Status.
Operational Data Attributes
Energy Rate
The Energy Rate attribute displays the current rate from the meter, if a meter is defined.
Interval Demand
The Interval Demand attribute displays the average energy demand over the current interval.
Amount Shed
The Amount Shed attribute indicates how much energy is currently shed. It is the default attribute of the DLLR object
and is displayed near the top of the DLLR object window.
Calculated Demand
When DLLR is in Monitor Only mode, the Calculated Demand attribute indicates the energy rate when DLLR is in
Shed mode (energy rate - amount shed). This attribute is blank when DLLR is in Shed mode.
Setup Attributes
Mode
The Mode attribute controls whether DLLR is actively shedding Loads (Shed mode) or is simulating Load shedding
(Monitor Only mode). The mode pertains to both the Demand Limiting and Load Rolling strategies simultaneously.
The Modes include:
Monitor Only - simulated shedding occurs, where loads appear shed but output points are not actually commanded
or turned off.
Shed - true shedding occurs where output points are commanded.
474
Shed Strategy
The Shed Strategy attribute allows you to specify which shedding strategy the DLLR uses. The Shed Strategies
include:
Meter Object
The Meter Object identifies the Metasys object (for example, Pulse Meter, AI, AV) that is used for the energy rate if
the Demand Limiting strategy is configured. If only the Load Rolling strategy is used, a meter is not required.
The Meter Object should be defined on the same supervisory controller as the DLLR Object. Do not use an N1
Integration object for the meter unless you can guarantee that the NCM Service Time is always less than 60 seconds
because the DLLR algorithm requires an updated meter value every minute.
DLLR Startup Behavior
The DLLR Startup Behavior attribute selects which mode the feature is set to whenever the supervisory controller
is restarted or its database is downloaded. Two selections are offered:
Startup in Monitor Only mode - DLLR starts in Monitor Only mode, even if it had been commanded or configured
to Shed mode before the restart or download. Also, if the DLLR object was disabled while in Shed mode, it reverts
to Monitor Only mode when enabled.
Startup in last commanded mode - DLLR starts in the mode that was active at the time the controller was
restarted or its database downloaded.
Any Comfort Override commands that were in place before the startup are persisted.
Any previous Shed commands are not automatically persisted to loads on startup. DLLR evaluates the current
situation and completes all calculations before issuing any new Shed commands to loads.
When DLLR starts issuing Shed commands to loads, it resumes where it left off with the first eligible, lowest-priority
load.
Release Immediately
Release After Min Shed Time
475
Manual
Hourly
Daily
Weekly
Monthly
Table 264 describes when the start and end times are set based on the tracking period.
Table 264: Profile Tracking Periods
Profile Tracking
Start Time
Period
End Time
Hourly
Daily
Weekly
Monthly
Manual
There are three exceptions to when the Start Times and End Times can vary from what is shown in Table 264. The
Start Times and End Times differ when:
a Reset Profile command is issued to the DLLR object while in Shed or Monitor Only mode
a Reset Initialization Parameters command is issued to the DLLR object while in Monitor Only mode
the controller is downloaded or reset
Note: The Start Times and End Times are not reset when DLLR changes from Monitor Only mode to Shed mode.
Also, when the DLLR object is disabled, the current profile is copied to the previous profile, the current profile
values are all set to 0, and the times are all set to undefined.
Stop DLLR Audits in Monitor Only Mode
The Stop DLLR Audits in Monitor Only Mode attribute specifies whether an audit entry is created each time a load
is shed or released when DLLR is in Monitor Only mode and the NAEs Enabled Audit Level is set to 3 or 4. (When
DLLR is in Active mode, an audit entry is always created to record that event.) The default is False, but if you set it
to True, no audit entries are created in Monitor Only mode.
476
Continuous
Off-Peak
On-Peak
Semi-Peak
Shoulder
Summer Off-Peak
Summer On-Peak
Winter Off-Peak
Winter On-Peak
Summer Semi-Peak
Winter Semi-Peak
Summer Shoulder
Winter Shoulder
Active DL Target
The Active DL Target specifies which of the defined Demand Limiting targets is currently active. When this attribute
changes, the Active DL Target Changed attribute indicates True until the start of the next interval. This attribute
uses the Target Description enumeration set.
Current Demand Limit
The Current Demand Limit attribute represents the demand limiting target that is set by the user (DL Tariff Targets
indexed by Active DL Target). This attribute defines the maximum allowed average demand during the current
elapsing interval, and allows you to change the value of the demand limiting target. To change the value of the
demand limiting target, write a new value to this attribute.
Algorithm
The Algorithm attribute specifies which algorithm is used for the Demand Limiting strategy (Fixed Window or Sliding
Window). In most cases, the Sliding Window Algorithm is required by North American utilities, while the Fixed Window
Algorithm is used by European utilities.
477
A permanent communication path must exist between this attribute and the DLLR object; therefore, the EOI point
and DLLR object should reside on the same supervisory controller.
The attribute must be a numerical attribute, in which a change from 0 to 1 indicates the end of interval and the
beginning of the next interval. The EOI Status attribute is set to Off Normal when the object supplying the EOI
pulse becomes offline or unreliable to the DLLR object.
478
Continuous
Off-Peak
On-Peak
Semi-Peak
Shoulder
Summer Off-Peak
Summer On-Peak
Winter Off-Peak
Winter On-Peak
Summer Semi-Peak
Winter Semi-Peak
Summer Shoulder
Winter Shoulder
Active LR Target
The Active LR Target attribute specifies which of the defined Load Rolling targets is currently active. When this
attribute changes, the Active LR Target Changed attribute indicates True until the start of the next interval if demand
limiting is configured, or the next minute if load rolling only is configured. This attribute uses the Target Description
enumeration set.
Current LR Target
The Current LR Target attribute represents the load rolling target that is set by the user (LR Tariff Targets indexed
by Active LR Target). This target defines the amount of energy that should be shed each minute for the load rolling
strategy. You can change the value of the load rolling target by writing to this attribute.
Current Amount Shed by LR
The Current Amount Shed by LR attribute indicates how much energy is currently shed for the Load Rolling strategy.
When Shed Strategy is set to Demand Limiting and Load Rolling, this attribute indicates how much of the Amount
Shed is due to Load Rolling alone.
Display Attributes
Rate Units
The Rate Units attribute specifies the energy units used for instantaneous energy demand attributes and referenced
in the DLLR Profile and Load Summary (for example, kW). If a meter is defined, the Rate Units attribute indicates
the units of the meter.
479
Consumption Units
The Consumption Units attribute specifies the consumption energy units (for example, kWh).
Display Precision
The Display Precision attribute defines the decimal display precision for all real values (floating values) in the DLLR
object.
Advanced Operational Data Attributes
Minutes Since Meter Failure
If the Meter is offline or unreliable, the Minutes Since Meter Failure attribute indicates the number of minutes (up to
the interval length) since the meter was last reliable.
Advanced Demand Limiting Attributes
Unreliable Meter Options
The Unreliable Meter Options attribute allows you to specify what should happen to Demand Limiting if the meter
becomes unreliable or goes offline. These options are as follows:
Stop Shedding - no more shedding occurs until the meter is again reliable. Currently, shed loads continue to
be shed until their Max Shed Time expires.
Maintain the Current Shed Rate - as loads are released, DLLR sheds other Loads to maintain the current
amount of shed load.
Use Unreliable Meter Shed Rate - sheds or releases loads as needed to maintain the amount of load specified
in the Unreliable Meter Shed Rate.
The second and third options cause Demand Limiting to act similarly to the Load Rolling strategy. If the Demand
Limiting strategy is not defined, an offline or unreliable meter prompts no actions.
Also, when the meter goes offline or unreliable, DLLR sets its Meter Status attribute to Off Normal and continuously
updates its Minutes Since Meter Failure attribute (up to the interval length) until the meter is again reliable. The
Minutes Since Meter Failure value is listed under the Operational Data section of the DLLR object - Advanced view.
Unreliable Meter Shed Rate
The Unreliable Meter Shed Rate attribute specifies how much load the DLLR object should keep shed if the meter
goes unreliable, provided the Use Unreliable Meter Shed Rate option is selected for the Unreliable Meter Options
attribute.
DL to Shed
The DL to Shed attribute indicates how much energy needs to be shed to meet the current Demand Limit target for
this minute. A negative value indicates how much energy can be released this minute.
DL Not Shed
The DL not Shed attribute indicates how much energy was unable to be shed (this minute) to meet the current
Demand Limit target for this minute. A positive value indicates a potential problem that Demand Limiting might not
be able to meet its target during this interval.
480
Low setting - allows you to start shedding loads later and shedding loads over a shorter period of time. This
setting reduces the amount of equipment that is turned off; however, it increases the possibility of exceeding the
target.
Medium setting - (default) allows you to start shedding slightly earlier than a low setting and later than a high
setting. This setting turns off equipment earlier than with a low setting, but does not have to turn off as much
equipment at once as with the high setting.
High setting - allows you to begin shedding sooner into the demand peak. This setting decreases the possibility
of exceeding the target; however, it increases the amount of equipment that is turned off.
481
As shown in Figure 55, the demand limit profile specifies for each minute the maximum allowed average power
during the whole interval. If too much energy is consumed during the first half of the interval, because the limit
elevation allowed this consumption, then more loads are shed during the second half of the interval, even though
the actual metered power is then below the demand limit profile. In other words, the net effect of limit elevation is to
defer aggressive load shedding to the second half of the fixed demand interval.
Figure 55: Use of Limit Elevation on a Demand Limit Profile
Active Elevation
The Active Elevation attribute indicates the amount (in percent) by which the demand limit was increased during the
elapsing interval to obtain the starting value of the demand limit profile. The Active Elevation represents the Limit
Elevation that is used for the current interval.
Time Until EOI
The Time Until EOI attribute indicates the number of minutes until the expected end of the interval.
Time Since EOI
The Time Since EOI attribute indicates the number of minutes since the latest EOI.
Energy Since EOI
The Energy Since EOI indicates the consumed energy since the latest EOI.
Demand Since EOI
The Demand Since EOI indicates the average power since the latest EOI.
Max Allowed Peak Until EOI
The Max Allowed Peak Until EOI attribute indicates the maximum allowed average power until the next EOI.
482
483
The Start Time is also reset if the Profile Tracking Period is changed, a Reset Profile command is issued to the
DLLR object while in Shed or Monitor Only mode, a Reset Initialization Parameters command is issued to the DLLR
object while in Monitor Only mode, or the controller is downloaded. Note that the Start Time is not reset when DLLR
changes from Monitor Only mode to Shed mode.
See the How Daylight Saving Time Affects Start Times and End Times section.
End Time
The End Time for current profile indicates the predicted end time. The End Time for the previous profile indicates
the actual end time. If the Profile Tracking Period is set to Manual, the End Time indicates Unspecified for the Current
Profile.
See the How Daylight Saving Time Affects Start Times and End Times section.
Energy Consumption
Energy indicates the calculated total energy consumption.
Peak Interval Demand
Peak Interval Demand indicates the total Peak Interval Demand with date and time.
Peak
Peak indicates the highest measured energy demand.
Projected Peak
Projected Peak indicates the highest energy demand that would have occurred if DLLR had not been enabled and
had not shed any loads.
Targets
The Targets list the Energy Consumption, Peak Interval Demand, Peak, and Projected Peak for each target that is
active during the current profile tracking period. Only configured targets are listed.
Load Summary Tab
In the Runtime view, the Load Summary provides real-time information about each load associated with the DLLR
object, as well as the Energy Rate and Current LR Target values. By default, all of the loads associated with this
DLLR object are displayed in the order in which they were added to the object. They are sorted by priority, starting
with the lowest Shed priority (10) at the top of the list. This matches the order in which DLLR seeks eligible loads to
shed. Clicking on column headers allows you to sort the information. Reordering is available for all columns except
Status and Load Rating.
Note: The entry Unspecified in the Last Shed Time column means that the load has never been shed or has not
been shed since the last controller download.
The Load Summary is automatically refreshed at the standard UI refresh rate. You can command one or more loads
directly from the Load Summary by selecting them and right-clicking the mouse to display the appropriate command
window. Right-clicking a single load also allows you to command the output or navigate to the outputs focus view.
The Setup option on the Load Summary changes the view to allow editing of some of the fields.
484
When the Setup view for the Load Summary is displayed, the Associate Load(s) button is used to add new loads to
the table. The Remove Load(s) button removes loads from the table. The MultiEdit button edits more than one load
at a time when several loads are highlighted.
Energy Rate and Current LR Target
The top portion of the Load Summary indicates current values for the Energy Rate and Current LR Target.
Status
Status displays an icon to indicate the current status of the load. Table 265 provides icon descriptions.
Table 265: Load Summary Icons and Their Status
1
Load Status
Status Icon
Load appears to be offline; system is awaiting confirmation.
Load is offline.
Load is disabled.
Load is shed.
Load is locked.
Load is in comfort override.
<no icon>
1
Load is released.
White
Overridden
Orange
Offline
Black
Trouble/Warning
Yellow
Alarm
Red
The actual colors used are set in the Status Colors section of Metasys Preferences > Graphic Settings. For details, refer to
the ADS/ADX Commissioning Guide (LIT-1201645) or NAE Commissioning Guide (LIT-1201519).
Load Priority
The priority of the load affects the order in which it is shed. Priority 10 loads are the lowest priority and are shed first.
Priority 1 loads are not shed unless no higher priority loads are available for shedding.
485
Shed Strategy
Shed Strategy indicates whether the load can be shed for Demand Limiting, Load Rolling, or both.
Minimum Shed Time
Minimum Shed Time specifies the minimum number of minutes that a load must be shed before it can be automatically
released. A load can be manually released before this value expires. The range is 0 to 65,535 minutes.
Maximum Shed Time
Maximum Shed Time (optional) specifies the maximum number of minutes that a load can be shed before it is
automatically released. If the Maximum Shed Time value is not defined, the default value of 65,535 is used. The
range is 0 to 65,535 minutes.
Minimum Release Time
Minimum Release Time specifies the minimum number of minutes that a load must be released from shed before
it can be shed again. Although DLLR does not shed a load before this time expires, a load can be manually shed
before this value expires. The range is 0 to 65,535 minutes.
Load Rating
Load Rating indicates how much energy is saved when the load is shed. This is specified in the same units as the
Rate Units.
Output Present Value
The Output Present Value indicates the current value of the loads output.
Ineligibility
Ineligibility indicates the reason that the load cannot be shed at this time. This field is blank if the load is eligible to
be shed.
Active Timer
The Active Timer displays the shed or release timer if one is in effect.
Time Remaining
The Time Remaining displays the minutes remaining if a shed or release timer is in effect.
Last Shed Time
The Last Shed Time displays the last time that the load was shed.
DLLR Object Commands
After a DLLR Object is defined, an authorized user can issue one of several commands (see DLLR Object
Commanding). Metasys objects with a Load extension are intended for use with the DLLR feature permit operator
or scheduled commands.
DLLR Object Commanding
After a DLLR object is defined, an authorized user can issue one of several commands to the object.
486
Monitor Only
Shed
Set Target
Type
Demand Limiting
Load Rolling
1
Target Level
Value
New value
Selects between Monitor Only mode and Shed mode for the Demand Limiting
and Load Rolling strategies. The selected mode applies to both strategies; in
other words, you cannot put DL in Monitor Only mode and keep LR in Shed
mode.
Sets the active Target Level used for either the Demand Limiting or Load Rolling
strategy. Optionally, you can specify a new value for the target and select a
Target Description. The Target Description is an element of the DL Targets and
LR Targets attributes, which describes the purpose of the target. Examples
include Continuous, Off-Peak, On-Peak, and Semi-Peak.
You also can:
Change the value of the current target by writing to the Current Demand
Limit and Current LR Target attributes.
Set which target is active using the Active DL Target and Active LR Target
attributes.
Reset Profile
None
Copies the current DLLR profile to the previous DLLR profile and starts a new,
current profile. Use this command if DLLRs Profile Tracking Period is set to
Manual. It is not necessary to use this command if a definitive tracking period
is selected, such as Monthly, because DLLR resets the profile automatically.
Reset Interval
None
Restarts the Demand Limiting calculations associated with the current interval
- Fixed Window Algorithm only.
You can specify a new start of a demand interval for the Demand Limiting
strategy. If you are using the Fixed Window Algorithm, and there is no EOI input
defined, issue this command at the start of the utility companys interval, the first
time that DLLR runs. It synchronizes DLLR to the start minute of the utility
companys billing interval (15, 30, or 60 minutes). Thereafter, DLLR uses a
pseudo EOI pulse, so that the start of each subsequent interval is synchronized.
If an EOI input is defined, DLLR automatically starts each interval at the correct
time.
When the Reset Interval command is received, the DLLR object resets interval
parameters and starts a new Demand Interval.
Note: If the Sliding Window Algorithm is used, do not use this command, as the
interval is reset each minute.
Disable
None
Stops DLLR operation. When disabled, DLLR releases all shed loads except
those that are locked shed. Also, DLLR does not perform any calculations, report
alarms, or issue any commands to any objects when disabled. DLLR attributes
can be changed, but no actions are taken until DLLR is enabled.
487
None
Starts DLLR operation. If Shed mode is active, the configured DLLR strategies
begin shedding loads as needed. If Monitor Only mode is configured, simulated
load shedding begins.
Reset Initialization
Parameters
None
Initializes DLLR as if it were running the demand limiting algorithm for the first
time. Use it in Monitor Only mode for testing new potential demand tariff targets
without using any data from a previous test. It releases all shed loads, clears all
load timers, reinitializes DLLR, and clears the Energy Profile.
Note: Since these actions would adversely affect a smoothly running DLLR
feature, you cannot issue this command while in Shed mode unless you manually
set the Allow Reset in Shed Mode attribute to True. If you issue the Reset
Initialization Parameters command while in Shed mode, the Allow Reset in Shed
Mode attribute reverts to False immediately after the command is issued.
Possible target descriptions: Continuous, Off-Peak, On-Peak, Semi-Peak, Shoulder, Summer Off-Peak, Summer On-Peak,
Winter Off-Peak, Winter On-Peak, Summer Semi-Peak, Winter Semi-Peak, Summer Shoulder, Winter Shoulder.
Attribute
reference
Execution Priority
CNW
None
Normal
488
Real value
CW
Master
Attribute
reference
CW
Present Value
Master
Number
CW
15
16 (lowest priority) to 7
(highest priority)
Refresh Timer
Number
CW
2 min
Contains an attribute
reference. The value
associated with this attribute
is written to each of the
designated slave destinations.
n=4
0 = Master, 1 = Alt Master,
2 = Last Reliable, 3 = Fail
Soft
489
Setup
Last Reliable
None
Slaves List
n=2
490
If this attribute is set to zero instead, updates are only sent upon receipt of additional COV reports.
Reliability
Indicates whether a value is questionable. This attribute value equals Input Unreliable only if both the configured
Master and Alternate Master inputs are unreliable.
Setup
Defines whether the Fail Soft or Last Reliable value needs to be the output if the object becomes unreliable.
Slaves List
Contains a list of attribute references. Each slave identified in this list of attribute references receives its value from
the Master.
Global Data Sharing Commands
The table below lists the commands supported by the Global Data Sharing Object.
Table 269: Global Data Sharing Object Commands
Command Name
Parameters
Disable
None
Enable
None
Interlock
Menu Selection: Insert > Object > Interlock
The Interlock object provides a means to establish conditional control over one or more other objects. It consists of
an IF conditional statement, True command statements, and False command statements. Through these statements,
the user specifies a set of conditional checks (using one or more points) for which a series of commands is used to
control a collection of one or more other objects.
Three essential parameters of the IF conditional statement, shown in the following list, determine the Interlock objects
mode of operation:
This object allows a user to place a VAV controller in the occupied mode whenever the main fan is on and in the
occupied mode.
Metasys SMP Help: Insert Menu
491
Note: On the Configure screen, click the Interlock Definition and Action Tables tabs for further configuration.
Tips for the Interlock Definition tab of the Configure screen:
Click the Add button to add items to the list from the Select Item dialog box.
Click the check box next to an item in the list and click Delete to remove the item from the list.
Select the type of logic to use for the items in the list from the Logic menu. See the Interlocks Logic attribute
description for the types of logic.
Tips for the Action Tables tab of the Configure screen:
Check the All Commands Priority check box if you wish to use the same priority for all commands in the action
tables. Clear the All Commands Priority check box to enable individual priority selection for the commands in
the action tables.
For the Actions for Condition: True and Actions for Condition: False tables, click the Add button to add items
to the table from the Select Item dialog box.
For the Actions for Condition: True and Actions for Condition: False sections, click the check box next to
an item in the table and click Delete if you want to remove the item from the table.
For general information on Metasys system objects, see Common Object Attributes.
For information on the logic used in the interlock object, see the Logic attribute description.
Interlock Configuration
Configure the attributes of the Focus/Configuration, Interlock Definition, and Action Tables tabs of the Interlock
object. See the Interlock Attributes section for descriptions of the attributes on these tabs.
On the Focus/Configuration tab, click the Advanced radio button to view and edit all the attributes available on
this tab.
On the Interlock Definition tab, define the items/objects to control and the desired conditional logic.
Tips for this tab include:
Click the Add button to add items to the list from the Select Item dialog box. You can also select items from the
All Items tree or from the Global Search results and drop them into the Interlock Definition table.
Click the check box next to an item in the list and click Delete to remove the item from the list.
Select the type of logic to use for the items in the list from the Logic menu. See the Logic attribute description
for the types of logic.
On the Action Tables tab, define the commands and the priority for the items/objects under control.
Figure 56: Example of Interlock Action Table Headers and Options
492
Check the All Commands Priority check box if you wish to use the same priority for all commands in the action
tables. Clear the All Commands Priority check box to enable individual priority selection for the commands in
the action tables.
Check the Add New Items to All Conditions check box if you wish to add new items to both the Actions for
Condition: Trueand Actions for Condition: False tables. The Add New Items to All Conditions is selected
by default.
For the Actions for Condition: True and Actions for Condition: False tables, click the Add button to add items
to the table from the Select Item dialog box. You can also select items from the All Items tree or from the Global
Search results and drop them into the Interlock Action tables.
For the Actions for Condition: True and the Actions for Condition: False tables, click the check box next to
an item in the table and click Delete if you want to remove the item from the table.
To select all items within a table, click the Select All column header. To unselect all items within a table, click
the Select All column header again.
To mass command items in the Actions for Condition: True or the Actions for Condition: False, select similar
items that have the same configured attributes and enumerations (for example, select multiple BVs). Right-click
. The Set Command for Selected
the Command column header and click Set Command. Or, click
Items appears.
Figure 57: Right-Click Set Command Option
To mass set delay, select multiple items (can be dissimilar items), input a delay in the Set Delay field, and click
.
Interlock Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 270: Interlock Object Attributes - Focus/Configuration Tab
1
Attribute Name
Description
Notes
Executing
Specifies the current execution status of the object. It is True when the object
receives a state command and starts
sending commands. When all actions are completed for a given state, this flag
is set to False.
Execution Priority
CW
Indicates the relative importance of performing the function of the object within
the device.
Indicates the date stamp for the beginning of executing the current state.
Indicates the time stamp for the beginning of executing the current state.
493
DRW
Represents the current value of the object. Present Value is set based on the
relationships set up in the Interlock
definition.
Priority Array
Reliability
Restore Command
Priority
CW
Selects which commands (at a selected priority) persist through a device restart.
When the bit is set, the command
(at a selected priority) is saved at shutdown and restored at startup.
Indicates the success or failure of the slave commands. If any slave commands
failed, this attribute is set to False.
Send OK
When a send error is detected, a five minute timer is set. When the timer
expires, the interlock is reevaluated and
all commands are sent again. Commands may fail if the slave object is off-box
and offline or if the slave object is
set for local control.
States Text
1
CW
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Object Reliability, W - Writable
494
CW
Logic Equation
CW
Source
CW
Lists objects whose attributes are used for input into the logic expression to
decide if the condition is True or False.
Information needed:
Item - Name of the source object
Attribute - Varies according to object. Default = Present Value
Relation - Equal, Not Equal, Greater Than, Less Than, Greater Than or Equal,
Less Than or Equal
Value - The value used in the Relation. Varies according to the object.
Differential - Accounts for variations in the value. Required (and only used) if
the value is analog.
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Object Reliability, W - Writable
495
CW
CW
Commands Priority
CW
496
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Object Reliability, W - Writable
Item - The name of the object to be commanded. Do not use any object that contains special characters, such
as the ampersand (&), because the Interlock may not function properly.
Command - The type of command to send to the object.
Priority - The priority at which to send the command.
Delay - The amount of time, in seconds, each command waits to be sent, after a change in condition.
Parameters - These vary according to command.
Any object capable of accepting commands can be defined in either action table. The available commands depend
on the type of object and the users access capability. An object may be sent more than one command by identifying
the object more than once and specifying a different command. The user does not have to specify objects for both
the True and False Action Tables. If no command is specified for an object, no command is sent.
Action Tbl 2 (False)
Lists commands issued by this object when the condition is false:
Item - The name of the object to be commanded. Do not use any object that contains special characters, such
as the ampersand (&), because the Interlock may not function properly.
Command - The type of command to send to the object
Priority - The priority at which to send the command
497
Delay - The amount of time, in seconds, each command waits to be sent, after a change in condition
Parameters - These vary according to command.
Any object capable of accepting commands can be defined in either action table. The available commands depend
on the type of object and the users access capability. An object may be sent more than one command by identifying
the object more than once and specifying a different command. The user does not have to specify objects for both
the True and False Action Tables. If no command is specified for an object, no command is sent.
Commands Priority
Determines the order by importance for all commands sent. If the All Commands Priority option is not selected, the
commands are sent at each individual priority specified in the Action Tbl attribute. If the All Commands Priority option
is selected, then every item in the Action Table is sent a command at the priority specified. For example, if the
command chosen is Operator Override, the command priority automatically sets to Operator Override (8) for every
item listed in the Action Table. When the All Commands Priority option is selected, you cannot change the command
priority within the Action Table.
An object defined in the Action Tables must use commands greater than Priority 16 (default) if no Relinquish Default
attribute is defined for that object. Otherwise, commands sent at Priority 16 to objects without a Relinquish Default
will not be accepted by that object. Commands with a lower priority number are of higher priority (importance) or are
more critical than commands with a higher priority number. For example, Manual Life Safety (1) is of higher priority
than Scheduling (15).
If the Commands Priority is defined as 16 (Default), then any existing commands from Scheduling (15) through
Priority 9 (9) will be released when the command is sent.
The Commands Priority uses the priorities in the Write Priority (Set 1).
Executing
Specifies the current execution status of the object. It is True when the object receives a state command and starts
sending commands. When all actions are completed for a given state, this flag is set to False.
Execution Priority
Indicates the relative importance of performing the function of the object within the device.
Last Executed Date
Indicates the date stamp for the beginning of executing the current state.
Last Executed Time
Indicates the time stamp for the beginning of executing the current state.
Logic
Specifies the Boolean logic (And/Or) to be employed in combination with source inputs in deriving a True or False
outcome.
When the source input operator is unreliable, the interlock operates according to the following rules:
Complex - Uses the equation defined by the Logic Equation attribute. If any input is unreliable, the expression
cannot be evaluated; therefore, the interlock is unreliable and does not execute.
Match All (AND) - Every one of the source conditions must be True. If an input is reliable, it is evaluated. If the
result is False, the interlock evaluates to False and executes. All inputs are checked for trouble (Reliability !=
498
Reliable). If any input is not reliable, the expression cannot be evaluated; therefore, the interlock is unreliable
and does not execute.
Match Any (OR) - One or more of the source conditions must be True. If an input is reliable, it is evaluated. If
the result is True, the interlock evaluates to True and executes. All inputs are checked for trouble (Reliability !=
Reliable). If no inputs are reliable, the expression cannot be evaluated; therefore, the interlock is unreliable and
does not execute.
Logic Equation
Contains a logic equation when the Logic attribute is set to Complex.
Use the logic equation to define the relationship between the master conditions using logic operators and parentheses
for determining precedence.
Valid characters in the Logic Equation string are:
*AND operator
+OR operator
(Open parenthesis (for grouping)
)Closed parenthesis (for grouping)
numbersMaster condition numbers
spacesSpaces are allowed for readability
Equation Syntax
Correct
1+2+3*4
1+2+(3*4) or (1+2+3)*4
1*2+3*4
(1*2)+(3*4) or 1*(2+3)*4
1*2*3+4
(1+2)*(3+4)+(6*7)
((1+2)*(3+4))+(6*7) or (1+2)*((3+4)+(6*7))
(3*4)(1*2)
(3*4)*(1*2)
(3*+1)
(3*1)
(3*
(3*1)
499
States Text
Indicates the displayed strings for the Present Value.
Interlock Commands
The table below lists the commands supported by the Interlock.
500
Description
Disable
None
Enable
None
Ensures object reacts to any changes it may have missed while it was
disabled, and returns it to normal operation.
Release Operator
Override
None
Re-command
None
Release
Attribute name
Releases the identified command priority from the specified, writable attribute,
and allows it to be controlled by the
Command priority
Attribute name
501
Re-Command
Reissues the commands for the current state.
Release
Releases the identified command priority from the specified, writable attribute, and allows it to be controlled by the
next highest priority.
Release All
Releases Command Priorities 3 through 16 from the specified, writable attribute. Command Priorities1 and 2 remain.
Note: The Release All command may not cause an immediate return to automatic operation. The Release All
command clears all command priorities, including those that come from applications and features. When this
happens, the output point goes to its Relinquish Default condition. In some cases, the application or feature
may have sent a command that does not match Relinquish Default. In this instance, the output point does
not end in the state that the applications or features intended. This situation can cause unexpected operation
to occur; for example, a space could overcool or overheat, a fan might run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
On the Configure screen, click the Action Tables tab for further configuration.
Select or enter the desired value for the Relinquish Default. Edit the States Text and Number of States
attributes on the Focus tab.
Check the All Commands Priority check box if you wish to use the same priority for all commands. Clear
the All Commands Priority check box to enable individual priority selection for the commands.
- For each of the Actions for Condition (State 0 - State N) tables, click the Add button to add items
to the table from the Select Item navigation tree.
For each of the Actions for Condition (State 0 - State N) tables, click the check box next to an
item in the table and click Delete to remove the item from the table.
The Multiple Command object issues a series of commands to multiple objects by means of a single command
action. Commanding this object results in the execution of the commands for the given state. This object supports
States 132.
This object allows a user to start building controls for the day with one command or to prevent selected points from
generating change-of-state (COS) and alarm messages when a control point is in a specified state (Auto Shutdown).
For example, based on a single input, such as Room Occupied, a defined set of actions can occur: setpoint goes
to 72, a fan comes on, lights come on, and the door unlocks.
For general information on Metasys system objects, see the Common Object Attributes section.
Multiple Command Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
Metasys SMP Help: Insert Menu
502
True or False
Executing
True or False
Execution Priority
Date
Time
Present Value
Send OK
True or False
False
False, True
Command Priority
Relinquish Default
CW
16
503
Command Priority
Determines the order by importance for all commands sent. If it is set to Priority None, commands will be sent at
each individual priority specified in the Action Table attribute.
Enabled
Indicates whether the Multiple Command object is enabled or disabled.
Executing
Specifies the current execution status of the object. It is True when the object receives a state command and starts
sending commands. When all actions are completed for a given state, this flag is set to False.
Execution Priority
Indicates the relative importance of performing the function of the object within the device.
Last Executed Date
Indicates the date stamp for the beginning of executing the current state.
Last Executed Time
Indicates the time stamp for the beginning of executing the current state.
Number of States
Specifies the number of possible states this object can have.
Present Value
Indicates the current value of this object.
Relinquish Default
Specifies the default value to be used for the Present Value attribute when no commands are currently controlling
this object. If this attribute is configured to any value other than None, the object sends commands for the value
immediately.
Metasys SMP Help: Insert Menu
504
Send OK
Indicates the success or failure of the slave commands. If any slave commands failed, this attribute is set to False.
When a send error is detected, a 5-minute timer is set. When the timer expires, the object is reevaluated and all
commands are sent again. Commands may fail if the slave object is off-box and offline or if the slave object is set
for local control.
States Text
Indicates the displayed strings for the Present Value.
Multiple Command Commands
The table below lists the commands supported by this object.
Table 277: Multiple Command Object Commands
Command Name
Parameters
Disable
None
Enable
None
Multistate0.. Multistate31
None
Operator Override
State 031
Release
1. Attribute name
2. Command priority
Release All
Attribute name
None
505
Release
Releases the identified command priority from the specified, writable attribute, and allows it to be controlled by the
next highest priority.
Release All
Releases Command Priorities 3 through 16 from the specified, writable attribute. Command Priorities 1 (Manual
Emergency) and 2 (Fire Application) remain.
Important: The Release All command may not cause an immediate return to automatic operation. The Release
All command clears all command priorities, including those that come from applications and features.
When this happens, the output point goes to its Relinquish Default condition. In some cases, the
application or feature may have sent a command that does not match Relinquish Default. In this instance,
the output point does not end in the state that the applications or features intended. This situation can
cause unexpected operation to occur; for example, a space could overcool or overheat, a fan might
run longer than expected, and so on.
If an operator has overridden an input, use the Release Operator Override command.
Release Operator Override
Releases Command Priority Operator Override from Present Value.
consistent interface to N1 point objects for all controller types, so they appear as a homogenous set to the user
interface
flexibility in point mapping
This object allows you to read pulses from an electric or gas meter at a supervisory controller.
Note: The Pulse Counter object may feed its Present Value to the Pulse Meter Object.
For general information on Metasys system objects, see the Object Help section.
N1 Pulse Counter Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Click the attribute name in the table for a description of the attribute.
506
Number
Reliability
DRW
04,294,967,295
Uses Reliability (Set 503).
507
The PID Loop object generates outputs for closed loop control by using a collection of inputs and other variables to
perform calculations and issue commands. Each PID Loop object can accept up to six analog inputs, and issue
commands to a maximum of eight analog outputs. Inputs come from AI objects. Outputs are sent to analog output
digital object (AOD) objects or other PID Loops.
A primary function of the PID Loop object is to perform Proportional plus Integral plus Derivative calculations in order
to maintain steady and accurate control of a closed loop. PID calculations take into account the past, present, and
future (forecasted) performance of loop inputs for the purpose of adjusting outputs to correct levels. You can configure
the PID Loop object to compute any or all of the following:
Proportional Only: Present performance is analyzed by computing the difference between the PID Loop setpoint
and its feedback. This difference is called an error. With proportional control, the output signal is directly
proportional to the difference between the input and the setpoint (that is, the error).
Proportional plus Integral: Present and past performance are analyzed in this calculation to affect the output.
The error computed in the proportional calculation is now integrated (that is, accumulated over time). If the loop
failed to reach setpoint in the past, the integration causes the output to increase or decrease to maintain setpoint.
Proportional plus Integral plus Derivative: This calculation uses past, present, and future (forecasted)
performance. The derivative part of the computation analyzes the rate of change of the feedback to predict the
future value of the feedback. As the feedback changes faster, the PID Loop issues outputs that slow down the
rate of change.
You can use the PID Loop object with a variety of control schemes, including sequencing a number of physical
devices to maintain control of a closed loop. Additional functions of the PID Loop object include Self-tuning PID
Control, bumpless transfer, and an auxiliary switch. Self-tuning PID Control automatically and continually self-tunes
the PID Loop to ensure correct feedback levels. The auxiliary switch allows another PID Loop object or a control
process to take control of the closed loop. When control of a closed loop is turned over to the PID Loop object, the
bumpless transfer function provides for a smooth and predictable transition.
For general information on Metasys system objects, see the Object Help section.
N1 PID Loop Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 280: N1 PID Loop Object Attributes - Focus/Configuration Tab
Attribute Name Data Type Notes1 Initial Value Values/Options/Range Attribute Description
COV Increment
Real value
CW
Device Type
Text
CNW
CW
0.1
10ths
20 Character Limit
508
Real value
Max Value
Real value
CW
1.7E38
Min Value
Real value
CW
-1.7E38
Out of Service
True or False CW
Present Value
(Value)
Real value
DNRW
Reliability
One value
from a set
Real value
Units
C - Configurable, D - Default Attribute for Display, N - Value Not Required, R - Affected by Object Reliability, W - Writable
509
Device Type
Contains a description of the physical device connected to the object.
Display Precision
Defines the decimal rounding and the decimal places to display for the Present Value and associated attributes.
Feedback
Indicates the Feedback value, which results from the PIDL Input Conditioning process. This process scales each of
the six PIDL inputs and determines a sum, a maximum, or a minimum.
Max Value
Defines the highest reliable value (in engineering units) for the Present Value.
Min Value
Defines the lowest reliable value (in engineering units) for the Present Value.
Out of Service
De-couples the object from the physical input. When Out of Service is True, the object de-couples the Setpoint and
Reliability from the hardware. The Reliability is writable when Out of Service is True. When de-coupled, the Setpoint
can be changed to simulate specific conditions or for test purposes.
Present Value (Value)
Represents the current value of the object.
Reliability
Indicates whether the Setpoint is unreliable.
Examples:
When Out of Service is True, the Reliability attribute may be written directly.
Setpoint
Indicates the desired value for the control loop feedback signal.
Units
Contains the engineering units for the Present Value attribute.
N1 PID Loop Commands
The following table lists the commands supported by the N1 PID Loop Object.
510
Command Description
The value to be written to the Setpoint. The Releases Command Priorities 9 through 15
value must be less than Max Value and
(Scheduling) and then writes to the Setpoint at the
greater than Min Value.
Default (16) command priority. The value must be
less than Max Value and greater than Min Value.
If Local Control is True, this command is rejected.
The command is only sent when one of the following
conditions is met: a) NOT Local Control and NOT
Out of Service, or b) NOT Local Control and after
issuing the In Service command.
Disable Alarms
None
Enable Alarms
None
In Service
None
Operator Override
Out of Service
None
511
Attribute name
Command priority
Release All
Attribute name
Command Description
Releases the identified Command Priority from the
specified attribute and allows the next highest priority
to control it.
Releases Command Priorities 3 through 16 (Default),
from the specified, writable attribute. Command
Priorities 1 and 2 remain.
For the Release Operator Override, Release, and Release All commands, if all Command Priorities have been released and
a Relinquish Default is not defined, the supervisory controller gives control to the actual hardware.
512
513
Optimal Start
The goal of Optimal Start Object is to reach either the Heating Setpoint or Cooling Setpoint at occupancy. The
Optimal Start object selects the appropriate setpoint depending on the temperature before starting the equipment.
To meet this goal, the Optimal Start object calculates:
Heating Constant and Cooling Constant represent the rate at which the temperature inside the building changes
when the heating or cooling equipment is running
the temperature difference between the Zone Temperature and the Heating Setpoint or Cooling Setpoint before
occupancy
how many minutes of precooling (cooldown) or preheating (warmup) are required based on the above difference
optimal start time when the Zone WC Mode Obj (BO or BV only) is controlled by the optimal start process
The Optimal Start object interacts with a Schedule Object, binary objects, and analog objects in an Optimal Start
application. See the Object Help section for information on these objects. See the Optimal Start Object section for
attribute information on the Optimal Start object.
Figure 59 illustrates optimal start.
Figure 59: Optimal Start - Heating
[(Heating or Cooling Constant/100) x Temperature Difference ] + Heating or Cooling Deadtime = Optimal Start Time
514
This variable is the value of the Heating or Cooling Constant attribute of the OST object and
represents the rate of warmup or cooldown in the zone after equipment startup. If Adaptation
Enabled is Yes, the Optimal Start object learns each day and sets a new value. This variable can
be edited by the user.
Temperature Difference
This variable is the difference between the Zone Temperature and the value of the Heating Setpoint
or Cooling Setpoint attribute before the warmup or cooldown period.
Units = delta deg F or delta deg K
Heating or Cooling
Deadtime
This variable is the value of the Heating or Cooling Deadtime attribute of the OST object and is
the amount of time required to raise or lower the Zone Temperature 1.0 degree.
Units = minutes. If Adaptation Enabled is Yes, the Optimal Start object learns each day and sets
a new value. This variable can be edited by the user.
The Zone Occ Mode Obj is scheduled to be occupied at 7:00 A.M. and unoccupied at 5:00 P.M.
Zone Temperature = 55F before the warmup period
Heating Setpoint (since in Heating mode) = 70F
Heating Deadpoint (since in Heating mode) = 5 minutes
Heating Constant (since in Heating mode) = 10 (The optimal start process has run for several days, and the
Heating Constant has been adjusted to 10 based on past performance.)
Temperature Difference = 70F - 55F = 15F
Therefore:
2
= (0.1 x 15 ) + 5
= (0.1 x 225) + 5
= 22.5 + 5
= 27.5
= 28 minutes
The optimal start process turns on the Zone WC Mode Obj at 6:32 A.M. (28 minutes prior to the scheduled 7:00
A.M. start time.)
Adaptation
Each day, at occupancy, the optimal start process adapts the Heating or Cooling Constant. It checks the Zone
Temperature at occupancy time. If the Zone Temperature did not reach a value within the range defined by the Temp
Differential and the Heating Setpoint or Cooling Setpoint before the occupancy time, the Heating Constant or Cooling
Constant is increased. This increase moves the optimal start time closer to the earliest start time defined in the OST
object. If the Zone Temperature reached a value within the range defined by Temperature Differential and the Heating
Setpoint or Cooling Setpoint prior to occupancy, the Heating Constant or Cooling Constant is decreased. This
decrease moves the optimal start time closer to the occupancy start time defined in the Schedule Object.
Metasys SMP Help: Insert Menu
515
Optimal Stop
The goal of optimal stop is to set the zone to the unoccupied mode prior to actual zone vacancy. The OST must do
this while the zone is still occupied, without causing comfort level alarms. The Optimal Start object calculates the
number of minutes before the zone is scheduled to change from occupied to unoccupied. The OST then uses the
same equation (Optimal Start Equation) for deriving the optimal start time to determine the earliest stop time, except
for two differences:
To ensure occupancy comfort, the OST sets the Temperature Difference factor to the Temp Differential attribute.
The Deadtime is set to 0.
2
(Heating or Cooling Constant/100) x (Temperature Difference) + Heating or Cooling Deadtime (always = 0) = Optimal
Stop Time
Object Interaction
Different objects interact in an Optimal Start application. The following figure illustrates a sample Optimal Start
application. The table describes the objects and their role in an Optimal Start application.
Figure 60: Optimal Start Object Interaction
Receives temperature, setpoint, and scheduling data to determine optimal start and optimal
stop times for the building zone.
Schedule Object
Zone Occupancy
Mode
Refers to the binary object (Binary Output, Binary Value, for example) that commands a zone
to occupied or unoccupied. It is commanded by the Schedule object to occupied and by the
Optimal Start to unoccupied, possibly earlier than scheduled if the Maximum Prestop Time
attribute is non-zero.
516
Zone Warmup or
Cooldown Mode
Refers to the binary object (Binary Output, Binary Value, for example) that commands the
zone to warm up or cool down. It is commanded by the Optimal Start object at the optimal
start time and released at the occupied time. It will not be released if the Zone Warmup or
Cooldown (WC) Mode and the Zone Occupancy Mode objects are the same.
5-8
Zone Temperature,
Refers to the analog attributes (within Analog Input objects, Analog Value objects, for example)
that are referenced by the Optimal Start object and provide the temperatures and setpoints
for use in calculations.
Cooling Setpoint,
Heating Setpoint,
Outdoor Air
Temperature
Object/Attribute Involvement
Building an Optimal Start application means that the OST object and its associated Schedule object must have their
attributes configured to reference the appropriate objects in order to achieve the desired operation. The following
table lists the objects and attributes involved and guidelines for data entry.
517
Enter the Object Name of the Schedule object that schedules occupied
and unoccupied times for the binary object controlling the zone occupancy
mode of the heating and cooling equipment for the zone.
This object must be defined in the schedule and have valid start and stop
times for the current day for the Optimal Start object to run. Only one
start time and stop time can be defined per day, and the start time must
precede the stop time.
Enter the Object Name of the binary object controlling the occupancy
mode of the heating and cooling equipment for the zone.
Enter the Object Name of the binary object (BO or BV only) controlling
the warmup and cooldown mode of the heating and cooling equipment
for the zone. This may be the same object as the Zone Occ Mode Object.
Cooling Setpoint
Enter the Object/Attribute Name of the analog value that represents the
cooling setpoint.
Heating Setpoint
Enter the Object/Attribute Name of the analog value that represents the
heating setpoint.
Zone Temperature
Enter the Object/Attribute Name of the analog value that represents the
temperature in the zone being controlled.
Enter the Object/Attribute Name of the analog value that represents the
outdoor air temperature.
If this attribute is not defined, or the referenced analog attribute is offline,
the outdoor air temperature is assumed to be within the design
temperatures limits for the OST calculations.
If an analog attribute reference is defined for the outdoor air temperature,
its value determines if the Optimal Start object should adapt heating and
cooling constants and deadtimes.
If its value is outside the design temperature limits, deadtime and constant
calculations are skipped.
If its value is outside the design temperatures before the warmup or
cooldown period, the optimal start time is set to the maximum prestart
time.
If its value is outside the design temperatures before the unoccupied
period, Prestop does not occur.
Schedule Object
Enter the Object Name of the binary object controlling the occupancy
mode of the heating and cooling equipment for the zone as one of the
Property References.
518
CW
True
Calc Prestop
Time
Time
CoolDown
Command
Set redirected to
ZWC States
Text; Number of
States redirected
to ZWC Nbr
States
CW
75.0
1999
Cooling Dead
Time
CW
10 minutes
1480
Number
519
Real value
Cooling Stpt
Status
CW
35.0 deg C or
95.0 deg F
-20 to 120
Units =
Temperature
Units
CW
Offline = 0
Online = 1
Uses Offline
Online (Set 91).
0.1
Uses Display
Precision (Set
0).
CW
75.0
1999
CW
10 minutes
1480
Heating Design
Temp
Real value
CW
CW
520
Offline = 0
Online = 1
CW
120 minutes
5480
CW
0 minutes
060
CW
20 minutes
0240
OST Type
CW
521
CNW
522
Idle
Idle = 0
Prestart Heating
=1
Prestart Cooling
=2
Calculating
Deadtime = 3
Calculating
Constant = 4
Occupied = 5
Prestop = 6
Not Operational
=7
Set redirected to
zone occupied
mode (ZOM)
States Text;
Number of
States redirected
to ZOM Nbr
States
Only available in
the online UI
Prestart Heating
Command
523
Relative Temp
Units
One type of
C
units from a set
Reliability
Reliable
Schedule
Occupied
Command
Set redirected to
ZOM States
Text; Number of
States redirected
to ZOM Nbr
States
Schedule
Unoccupied
Command
Set redirected to
ZOM States
Text; Number of
States redirected
to ZOM Nbr
States
Send OK
True or False
Stpt Reached
Time
Time
CW
Set redirected to
ZOM States
Text; Number of
States redirected
to ZOM Nbr
States
Deg F
Warmup
Command
Set redirected to
ZWC States
Text; Number of
States redirected
to ZWC Nbr
States
Object
Reference
CW
Time
Zone Schedule
Obj
Object
Reference
Zone Schedule
Status
CW
Offline = 0
Online = 1
Zone
Temperature
Attribute
Reference
CW
Zone Temp At
Start
Real value
525
Offline = 0
Online = 1
Zone WC Mode
Obj
Object
Reference
526
CoolDown Command
Specifies the command sent to the Zone WC Mode Obj point at prestart time when in cooling mode. The enumeration
set and number of states for this attribute are redirected and filled in at runtime from the Zone WC Mode Obj point.
The default value is set to a value of 1 upon creation so the attribute requires no configuration.
Cooling Constant
Defines the rate at which the zone cools down after equipment startup. If adaptation is enabled, this constant is
adapted without user intervention. If adapting and the OST object Cooling Setpoint and Heating Setpoint attributes
reference the same object on a field controller, then the cooling constant is adapted even if the mode is not cooling,
meaning both constants change.
Cooling Deadtime
Indicates the time required after startup to lower the temperature by one degree. This value is adapted by the OST
algorithm, if adaptation is enabled. If adapting, cooling, and heating setpoints are the same attribute, the Cooling
Deadtime is adapted even if the mode is not cooling, meaning both deadtimes change.
Cooling Design Temp
Indicates the highest outside temperature at which the cooling system maintains zone comfort in the cooling mode.
Cooling Setpoint
Identifies the attribute of an object used to define the zone occupied target cooling temperature. This attribute may
be the same as the Heating Setpoint attribute.
Cooling Stpt Status
Identifies the OST objects connection status to the Cooling Setpoint attribute. If this status is Offline, the Present
Value is set to Not Operational.
Display Precision
Indicates the rounded position and decimal places to display for this object.
Heating Constant
Defines the rate at which the zone heats up after equipment startup. If adaptation is enabled, this constant is adapted
without user intervention. If adapting and the OST object Cooling Setpoint and Heating Setpoint attributes reference
the same object on a field controller, then the heating constant is adapted even if the mode is not heating, meaning
both constants change.
Heating Deadtime
Indicates the time required after startup to raise the temperature by one degree. This value is adapted by the OST
algorithm, if adaptation is enabled. If adapting, cooling, and heating setpoints are the same attribute, the Heating
Deadtime is adapted even if the mode is not heating, meaning both deadtimes change.
Heating Design Temp
Indicates the lowest outside temperature at which the heating system maintains zone comfort in the heating mode.
527
Heating Setpoint
Identifies the attribute of an object used to define the zone occupied target heating temperature. This attribute may
be the same as the Cooling Setpoint attribute.
Heating Stpt Status
Identifies the OST objects connection status to the Heating Setpoint attribute. If this status is Offline, the Present
Value is set to Not Operational.
If this attribute is not defined, or is offline, the outdoor air temperature is not used in the OST calculations and is
assumed to be within the design temperatures.
If an Analog attribute reference is defined for the outdoor air temperature, it aids in determining if the Optimal
Start object should adapt constants and deadtimes.
If the attribute is defined and outside the design temperatures, deadtime and constant calculations are skipped.
If the attribute is defined and is outside the design temperatures during Prestart, the optimal start time is set to
early start time.
If the attribute is defined and outside the design temperatures during Prestop, do not Prestop.
528
Present Value
Represents the current value of the object:
Idle - Waiting for next occupied time for a supported mode (heating or cooling).
Prestart Heating - Heating optimal start time is pending.
Prestart Cooling - Cooling optimal start time is pending.
Calculating Deadtime - Valid only if Adaptation Enabled.
Calculating Constant - Valid only if Adaptation Enabled.
Occupied
Prestop - Waiting to reach optimal stop time. If Max Prestop Time = 0, then mode is Occupied, not Prestop.
Not Operational - Optimal Start object is not operational due to errors in its connection status to other required
objects. The specific problem can be determined by viewing the other status attributes. The Optimal Start object
could also be Not Operational (or Unreliable) if the Zone Occ Mode Obj is in the schedule but there are no valid
start and stop times for that day (due to holiday or schedule offline, for example).
529
Send OK
Indicates if the status of the last command was sent to the Zone WC Mode Obj, Zone Occ Mode Obj, or Zone
Schedule Obj.
Stpt Reached Time
Indicates the time at which the zone temperature was equal to (within differential) the zone setpoint. This point is
set between the optimal start time and occupied. If this point is not reached during that time, then it continues to be
monitored during the occupied time until the zone temperature reaches the setpoint.
Temp Differential
Indicates the value added and subtracted to the zone setpoint to define a temperature range.
Temperature Units
Indicates the units associated with the attributes for temperatures.
WarmUp Command
Specifies the command sent to the Zone WC Mode Obj point at prestart time when in heating mode. The enumeration
set and number of states for this attribute are redirected and filled in at runtime from the Zone WC Mode Obj point.
The default value is set to a value of 1 upon creation so the attribute requires no configuration.
Zone Occ Mode Obj
Identifies the object used to command a zone to occupied or unoccupied. This object must be specified in the Zone
Schedule Obj. This is commanded by scheduling to occupied and by OST if prestop is enabled.
Note: If the Zone Occ Mode Obj and the Warmup/Cooldown Mode Obj are the same point, then the point is
commanded by the Prestart Cooling/Heating Command at the prestart time and by the Scheduling at the
scheduled time.
Zone Occ Time
Indicates the scheduled zone occupied time, obtained from the Zone Schedule Obj.
Zone Schedule Obj
Identifies the Schedule object, which schedules the Zone Occ Mode Obj. This object must be defined in the schedule
and have valid start and stop times for the current day in order for OST to run. Otherwise, the OST objects Present
Value is Not Operational. Only one Start and Stop time can be defined per day, and the Start time must precede
the Stop time. The Start time must be defined as binary State ON (1) and Stop time must be defined as binary State
OFF (0).
Zone Schedule Status
Identifies the OST objects connection status to the Zone Schedule Obj. If this status is Offline, the Present Value
is set to Not Operational.
Zone Temperature
Identifies the attribute of an object used to determine the zone temperature.
530
Command Description
Cancel Prestart
None
Delays pending start until latest prestart time. Only valid during Prestart
and before the optimal start time.
Cancel Prestop
None
Cancels the pending stop. Only valid during Prestop and before the
optimal stop time.
Disable
None
Enable
None
531
The Optimal Start objects Present Value attribute may indicate Not Operational because
of errors in its connection status to other required objects.
To verify the Optimal Start objects connection status to other required objects:
Verify that the required Schedule object, binary objects, and analog objects are all
defined and online.
Verify that the binary object controlling Zone Occupancy Mode is in the List of Prop
Refs for the Schedule Object.
Verify that valid occupied and unoccupied times for the current day are defined in
the Schedule object.
Optimal Start Object is not adapting To ensure the Optimal Start object is adapting constants and deadtimes:
Verify that the Adaptation Enabled attribute indicates True.
Constants and Deadtimes
Verify that the value of the Zone Temperature attribute is not within the value of the
Temp Differential attribute relative to the Heating or Cooling Setpoint (plus or minus
one degree) before the warmup or cooldown period.
Verify that the value of the Outdoor Air Temp attribute is within the values of the
Cooling Design Temp and Heating Design Temp attributes.
532
Multiple Pulse Meter objects may share the same counter/accumulator object, and must reside on the same device
as the counter/accumulator hardware device.
Note: The Pulse Meter object only handles counters that count forward.
Each Pulse Meter object may have different purposes, such as one calculates the rate over a 60-second period,
while others calculate the rate over a 5-minute period. For example, some Pulse Meters are supposed to run only
during certain times of the day.
For general information on Metasys system objects, see the Object Help section.
Pulse Meter Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 288: Pulse Meter Object Attributes - Focus/Configuration Tab
1
Attribute Name Data Type
Initial Value Values/Options/Range Attribute Description
Notes
0
Number
Consump
Unreliable
True or False
False
Consumption
Real value
(double)
Units = Consumption
Units
kWh
Object
Reference
Display Precision
10ths
Execution Trigger
True or False
False
Meter Active
True or False
CW
True
Present Value
Real value
DR
Previous
Consumption
Real value
(double)
Pulse
Consumption
Real value
(double)
CW
04,294,967,295
Calculation
CW
Units = Consumption
Units
1.000000
Units = Consumption
Units
533
Number
04,294,967,295
Rate Constant
Real value
(double)
CW
3600.000000
Rate Default
Real value
CW
0.0
Rate Limit
Real value
CW
3.402823466
E38
Rate Units
kW
Rate Unreliable
True or False
False
Reliability
Reliable
Reset
True or False
False
Reset Date
Date
Reset Time
Time
Rollover Limit
Number
CW
32767
04,294,967,295
Sample Time
Number
CW
60
534
535
Rate Limit
Specifies the highest allowed Present Value before using Rate Default.
Rate Units
Indicates the measurement units for all rate attributes.
Rate Unreliable
Indicates that the Present Value is unreliable because of a misreading of a counter.
Reliability
Indicates if a value is questionable.
Reset
When written to True, it transfers the current value of the Consumption attribute into the Previous Consumption
attribute before resetting Consumption to zero.
Reset Date
Indicates the date of the last resetting of Consumption attribute.
Reset Time
Indicates the time of the last resetting of Consumption attribute.
Rollover Limit
Specifies the highest counter value before the pulse counter rolls over to zero. This value must match that of the
counter, or the Max Value of the Accumulator.
Sample Time
Specifies the period of automatic executions of the algorithm in seconds.
Pulse Meter Commands
The table below lists the commands supported by the Pulse Meter Object.
Table 289: Pulse Meter Object Commands
Command Name
Parameters
Command Description
Enable
None
Enables the calculation of the pulse count and consumption for the Pulse
Meter object.
Disable
None
Disables the calculation of the pulse count and consumption for the Pulse
Meter object.
Reset
None
Start Meter
None
Resumes metering.
Stop Meter
None
Stops metering.
536
537
Attribute
reference
Execution Priority
Failsoft
Real Value
CW
High OR
Attribute
reference
CNW
Input List
List of attribute
references
CW
Low AND
Attribute
reference
CNW
Point Type
CNW
None
Normal
None
Analog
538
Reliability
Setup
Master
N=3
0 = Calculated, 1 =
Last Reliable, 2 = Fail
Soft
Reliable or Input
Unreliable
Last Reliable
n=2
0 = Last Reliable, 1 =
Fail Soft
539
Reliability
Indicates a value of Unreliable only if all of the configured inputs in question are unreliable.
Setup
Defines whether the Failsoft or Last Reliable value needs to be the output if the object becomes unreliable.
Signal Select Commands
The table below lists the commands supported by the Signal Select Object.
Table 291: Signal Select Object Commands
Command Name
Parameters
Disable
None
Enable
None
540
Latitude
Longitude
43.037507
-87.904456
Paris, France
48.854212
2.347641
-34.903488
18.411073
Sydney, Australia
Opera House
-33.857184
151.215176
Beijing, China
Tiananmen Square
39.06514
116.391213
For general information on Metasys system objects, see Common Object Attributes.
Solar Clock Object Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Note: For correct sunrise and sunset calculations, you must apply north/south and east/west rules. North latitudes
are preceded by a plus, South latitudes are preceded by a minus. West Longitudes are preceded by a minus,
East Longitudes are preceded by a plus. See Table 292.
Table 293: Solar Clock Object Attributes - Focus/Configuration Tab
1
Attribute Name Data Type
Initial Value Values/Options/Range Attribute Description
Notes
Present Value
Enumeration
1 = Day
0 = Night
Latitude
Float
WCA
Units = Degrees
Angular
Range = -9090
Longitude
Float
WCA
Periodic Update
Signed16
WCA
Units = Minute
Range = 260
541
Float
Units = Degrees
Angular
Elevation
Float
Units = Degrees
Angular
Sunrise
Time
Display = HH:MM
Solar Noon
Time
Display = HH:MM
Sunset
Time
Display = HH:MM
Offset
Signed16
Units = Minutes
WA
Range = -6060
542
Float
Units = Minutes
Solar Declination
Float
Units = Degrees
543
Elevation
Defines the angle between the direction of the geometric center of the sun's apparent disk and the idealized horizon.
Sunrise
Defines the time of apparent sunrise in hours and minutes. Sunrise may not occur in the same calendar day as
sunset. Due to changes in air pressure, relative humidity, and other factors, we cannot predict the exact effects of
atmospheric refraction on sunrise time. The error may increase with higher latitudes (closer to the poles).
Solar Noon
Defines the time when the sun crosses the meridian of the observer's location. At solar noon, a shadow cast by a
vertical pole points either directly north or directly south, depending on the observer's latitude and the time of year.
Sunset
Defines the time of apparent sunset in hours and minutes. Sunset may not occur in the same calendar day as sunrise.
Due to changes in air pressure, relative humidity, and other factors, we cannot predict the exact effects of atmospheric
refraction on sunset time. The error may increase with higher latitudes (closer to the poles).
Offset
Defines an offset to the computed Sunrise and Sunset times. The offset value is used to compute Present Value. A
positive value makes the day longer and a negative value makes the day shorter.
Equation of Time
Represents an astronomical term accounting for changes in the time of solar noon for a given location over the
course of a year. Earth's elliptical orbit and Kepler's law of equal areas in equal times are the factors behind this
phenomenon.
Solar Declination
Defines the declination of the Sun. The declination varies from 23.44 at the winter solstice in the northern hemisphere,
through 0 at the vernal equinox, to +23.44 at the summer solstice. The variation in the solar declination is the
astronomical description of the sun going south in the northern hemisphere for the winter. For a ground-based view
of the seasonal solar paths for different latitudes, use 0 for the Equator, 23N for the Tropic of Cancer, 40N for
Boulder, CO, 71N for the Arctic Circle, and 90 for the North Pole.
Solar Clock Object Commands
This object has no commands.
For managing outside lighting schedules, use the day/night present value status of this object with an Interlock
Object's definition to drive the Action Tables for the Actions of Conditions setup.
Object Help
The Object Help describes each object in the system, the attributes of the objects, and the characteristics and
functions of each attribute. The Object Help provides detailed information to aid in creating objects, entering values
for configuring attributes, understanding how to read attributes, and defining the interaction between objects via the
attributes.
544
545
Data Type
Lists the data type of the attribute value. The following table defines the various data types used in the Metasys
system.
Table 294: Data Types
Data Type
Formal Name
Definition
Attribute Reference
Attribute Reference
Date
Date
List
List
Number
Byte
Number
Unsigned Integer
Short
Number
Unsigned Long
Number
Signed Integer
Signed number that is also an integer with no decimal point. The value may
be positive or negative. Allowable range appears in column headed
Values/Options/Range.
Examples:
DLLR: Shed Pending, Shed Lost
Object Reference
Object Reference
One State/Type/Node
from a Set
Enumeration
Real Value
Float
Structure
Bit String
Set of Values
Array
Text
String
Time
Time
True or False
Boolean
546
Notes
The Notes column lists specific characteristics of the attribute and its value. The characteristics (or flags) in Notes
specify how the attribute is used in the object and how it can be set within the Metasys system.
Table 295: Notes
Note
C - Configurable
Definition
Indicates if the value of the attribute is defined by the user when first creating the object and cannot be
changed by the object itself. Configurable (C) attributes that are writable (W) can be changed by the
user online or by a process or feature in the running system after the object has been created.
D - Default Attribute Indicates that this is the primary value of this object, and is used when the user interface needs to display
for Display
a single value from the object. For example, this attribute is displayed in the header bar of the display
panel for an object.
N - Value Not
Required
Indicates that this configurable attribute may contain a blank value. (Other configurable [C] attributes
without N must contain a valid value for the object to function.) For example, a value for a high or low
limit attribute is not required and a blank value indicates that the alarm processing is not required.
R - Affected by
Object Reliability
Indicates that the reliability of the value of this attribute is dependent on the object being in a reliable
state.
W - Writable
Indicates that the user can edit the value of the attribute online or by a process or feature in the running
system or network. A write to a configurable (C) attribute replaces the existing value. A write to other
attributes is handled as an override to the value calculated by the object or as a command for some
action by the object.
BACnet Notes
The BACnet Notes column specifies if the attribute is exposed as a standard BACnet property and if it can be modified
from a BACnet network.
Table 296: BACnet [System] Notes
Note
Definition
B - Exposed as
Standard BACnet
Property
Indicates that the attribute can be accessed as a standard BACnet Property of the equivalent BACnet
Object Type from a BACnet network.
W - Writable
Indicates that the value of the attribute can be modified by a message from a device on the BACnet
network.
The types listed in Table 295 may also appear in the Note column, as applicable.
Initial Value
A configurable attribute takes the initial value when the object is being created if the user does not enter another
value. Other attributes take the initial value on startup and until the object calculates a new value.
Values/Options/Range
Based on the attributes data type, this column may show the range of valid values or a reference to the set of
possible values for this attribute. If the complete set of values for the attribute is small, all possible values are shown
in this column.
547
548
Object Deletion
Objects can be deleted offline in the system database on the SCT and later downloaded to the host device as part
of the edited database. You can also delete objects online with a browser if you have the Access Privileges to
configure objects using the Security Administrator System. The user interface screens and procedures are similar
in either case. Deleting an object involves selecting it in the Navigation Tree and using the Delete Items command.
See the Deleting Objects or Items section for more information.
Note: Before deleting an object, you should delete all references to the object within other objects and reconfigure
any objects that are referenced in the object to be deleted. If the references are not edited or deleted, the
referenced objects may not operate correctly. See the Engine Device Object for an example of how to locate
incomplete references.
Indicates the date of the last successful archive of object instances. The
value of this attribute is valid if a valid archive exists and during the archive
download process. The value of this attribute is 0xFF at all other times.
Alarm State
Description
Normal
CNW
BNW
Enabled
No text
True
549
CW
Item ID
Authorization
Category
CW
General
Object Count
Object Name
Indicates the number of object instances within the device. This count
includes objects of any type.
B
Object Type
550
Normal
Note: The value of the Status attribute displays next to the Default
Attribute for Display (typically Present Value) in the header bar of the
Display panel.
Displays the highest priority Status for the object.
Examples: (in order of priority - supported states depend on Object Type)
Out Of Service: The Out Of Service attribute value is True.
Offline: Communication with the physical hardware has failed.
Unreliable: Reliability attribute is not reliable.
Alarm: Object or alarm extension has an alarm state.
Normal: No abnormal condition for this object detected.
User Name Is
CW
BACnet Obj Name
CW
Version
False
Controls whether the objects User Name attribute is also the Object
Name attribute. The Object Name attribute is not writable, so the only
way to change the Object Name attribute is to edit the User Name attribute
and set the User Name Is BACnet Obj Name attribute to True.
Displays the version number of the object software code. As the
functionality of objects is enhanced, the version numbers are incremented.
Example: 3.1 where 3 is the major revision and 1 is a minor revision
551
You define the identifier of each object as it is created and the system builds the Item Reference automatically. Once
the object is defined, the Item Reference cannot be changed directly. But, the Computer Name attribute of a Site
Director or device is the object identifier. If you change the Site Director or device Computer Name attribute, the
Item Reference then updates to show the new Computer Name.
If a device has a domain specified in the Domain Name attribute, the name for the domain appears in the Item
Reference after the Computer Name:
Computer Name.Domain Name
The following characters are not allowed in references:
@.,?*#:\/[]<>|
Figure 61 shows an example for a field point object in an N2 integration.
Figure 61: Example of Item Reference
Name
Contains a freely definable user-friendly Name for the object that is independent of the Item Reference or the location
of the object in the physical network. The Name is used as the label in the All Items navigation tree. The Name is
shown in alarm reports, the event and audit viewers, and in summaries. The Name does not need to be unique to
the site unless the name is used as the BACnet Object Name. When the name is used as the BACnet Object Name,
it must be unique among the BACnet Object Names in the device (if it is not a Device object) or unique among the
other device objects (if it is a Device object).
The Name defaults to the object identifier you used during manual object creation, but can be edited later. For
integrated BACnet objects, the name defaults to the BACnet Object Name in the remote BACnet device. For integrated
N1 network objects, the name defaults to the System.Object Name in the NCM.
Example: ConferenceCenter-Room2-SpaceSetPoint
For devices, both the Computer Name and Name attributes default to the object identifier you used during manual
object creation. But, do not confuse the Computer Name attribute with the Name attribute. Changing the NAE Name
attribute does not impact the object references or network communication with other devices on the site.
Changing the Computer Name online breaks any existing references between the NAE object and other objects on
the site, and may break the existing network connection to other devices on the network. We do not recommend
changing the Computer Name online. If you change the Computer Name attribute in the SCT (right-click the NAE
in the navigation tree and select Rename), both the Computer Name and Name attributes are changed to the new
name you select. The Item Reference then updates to show the new Computer Name.
552
Authorization Category
Classifies the object by the category of system or equipment that it monitors to aid in the determination of user
access privileges and alarm routing.
Examples: HVAC, Fire, Security
Object Count
Indicates the number of object instances within the device. This count includes objects of any type.
Object Name
Indicates the Object Name as exposed to a BACnet network. This attribute is equivalent to the Item Reference
without the site identifier. You cannot edit this attribute, but it changes when the Item Reference attribute updates.
In addition, you can change the Object Name attribute by editing the User Name attribute and setting the User Name
Is BACnet Obj Name attribute to True.
Example: NAE3/N2 Trunk1.AHU4.Supply Temp
Object Type
Indicates the Object Type as displayed in the Metasys software and as exposed to a BACnet network.
Example: AI (Analog Input)
Status
Note: The value of the Status attribute displays next to the Default Attribute for Display (typically Present Value) in
the header bar of the Display panel.
Displays the highest priority Status for the object.
Examples: (in order of priority - supported states depend on Object Type)
553
Note: This section contains detailed information about the tabs used by multiple objects/features. When a tab only
appears for a specific object/feature, the details of that tab are defined in that object/feature section. However,
this section includes a brief description of such tabs and provides links to the detailed object/feature sections.
Action Tables Tab
The Action Tables tab appears on Interlock and Multiple Command objects. See the Interlock Object and Multiple
Command Object sections for details.
Alarm Tab
The Alarm tab appears on an object that has an alarm extension. See Alarm Extensions in the Extensions section.
Associated Graphic Tab
The Associated Graphic tab appears when a graphic is referenced from the object using the Graphic attribute. See
the User Graphics Tool (UGT) section for details on working with this tab.
Averaging Tab
The Averaging tab appears on an object that has an averaging extension. See Averaging Extensions in the Extensions
section.
BACnet Alarm Tab
Attributes associated with the BACnet Intrinsic Alarming for an object are shown under the BACnet Alarm tab of the
display panel. This tab appears when the site is defined as a BACnet site and the object has intrinsic alarming
enabled (that is, Intrinsic Alarming Defined set to True).
Table 298: BACnet Alarm Tab
Attribute Name
Data Type
Acked Transitions
Notes
Series of True or
False states
BACnet
1
Notes
Values/Options/Range
CW
CW
Alarm Values
CW
Inactive, Active
States Text attribute identifies the value set for this
attribute.
Applies to BI, BV, MI, and MV objects.
For MI and MV objects, you can select multiple
values from a list, unlike the other objects that are
limited to one value.
BACnet Deadband
Real value
Error Status
Event Enable
Series of True or
False states
Event State
CW
BW
CW
BW
554
Notes
Set of values
BACnet
1
Notes
Values/Options/Range
Fault Values
List of numbers
(see Values/
Options/Range
column)
CW
Numbers: 065,535
States Text attribute identifies the value set for this
attribute.
The list of numbers come from a list of the Alarm
Values.
Applies to MI and MV objects.
CW
Feedback Value
CW
Inactive, Active
Graphic
Object reference
CW
CW
Graphic Alias
Text
CW
CW
High Limit
Real value
List of
CW
BW
Limit Enable
Series of True or
False states
CW
BW
Low Limit
Real value
CW
BW
Notification Class
Number
CW
BW
04,294,967,295
This is the BACnet Object Identifier of the
Notification Class Object used for routing.
Applies to all point objects and the Accumulator.
Notification Object
Reference
Object reference
CW
Notify Type
CW
BW
Alarm, Event
Applies to all point objects and the Accumulator.
Pulse Rate
Number
CW
Time Delay
Number
CW
065,535
Units = seconds
Applies to all point objects and the Accumulator.
555
The Present Value maintains the value(s) specified by Alarm Value(s) for a minimum period of time, specified
in the Time Delay attribute.
The To Offnormal flag is enabled in the Event Enable attribute.
Once equal to the Alarm Value(s), the Present Value must become not equal to Alarm Value(s) before a To
Normal event is generated under these conditions:
The Present Value remains not equal to the Alarm Value(s) for a minimum period of time, specified by the Time
Delay attribute.
The To Normal flag is enabled in the Event Enable attribute.
BACnet Deadband
Defines the value by which the Present Value must change below the High Limit or above the Low Limit before the
object generates a To Normal event.
Error Status
Indicates whether the Present Value was successfully written to the object defined by the Feedback Reference. The
Error Status displays Ok if the object was able to send its latest Present Value to the feedback object. Otherwise,
the Error Status displays the error of the first failed command.
Event Enable
Contains three states that independently enable To Offnormal, To Fault, and To Normal events. Transitions to High
Limit and Low Limit Event States are considered Offnormal events. An unreliable condition generates a Fault event.
Event State
Indicates the active alarm state of the Intrinsic Alarming feature if enabled for the object. In BACnet terms, High Limit
and Low Limit states are Offnormal.
Event Time Stamps
Indicates the times of occurrence of the last To Offnormal, To Fault, and To Normal event transitions. Time and Date
time stamps are shown as * if no transition of that type has been generated. Sequence time stamps are 0 if no
transition of that type has been generated. If intrinsic reporting is supported by the object, this attribute is required.
Metasys SMP Help: Insert Menu
556
Fault Values
Specifies any states the Present Value must equal before a To Fault event issues. If Present Value becomes equal
to any of the states in the Fault Values list, and no physical fault is detected for any inputs represented by the Present
Value attribute, then the Reliability attribute has the value Multistate Fault. If the object supports intrinsic reporting,
the Fault Values attribute is required.
Feedback Reference
Indicates the object reference of the feedback object.
Feedback Value
Indicates the status of a feedback value from which Present Value must differ before an event generates. The amount
Present Value differs from Feedback Value to generate an event is locally determined. This attribute is required if
the object supports intrinsic reporting.
A To Offnormal event generates under these conditions:
The Present Value differs from the Feedback Value for a minimum period of time, specified in Time Delay.
The Event Enable attribute enables the To Offnormal flag.
Once equal to the Feedback Value, the Present Value must become different from the Feedback Value before a To
Normal event generates under these conditions:
The Present Value remains not equal to the Feedback Value for a minimum period of time, specified by Time
Delay.
The Event Enable attribute enables the To Normal flag.
Graphic
Indicates the graphic associated with the alarm extension.
Graphic Alias
Indicates a portion of the graphics item reference, up to and including the name of the folder containing this object
or the controller containing this point.
High Limit
Defines the high limit that the Present Value attribute must exceed before an event is generated.
The object generates a To Offnormal event when the Present Value exceeds the High Limit for a minimum period
of time, defined in the Time Delay attribute; the High Limit Enable is True in the Limit Enable attribute; or the To
Offnormal is True in the Event Enable attribute.
The object generates a To Normal event when the Present Value falls below the High Limit minus the Deadband
for a minimum period of time, specified in the Time Delay attribute; the High Limit Enable flag is set in the Limit
Enable attribute; or the To Normal flag is set in the Event Enable attribute.
For the Accumulator object, this attribute indicates the upper limit of the range.
Life Safety Alarm Values
Specifies any states that the Present Value must equal before the point generates a To Offnormal event and enters
the Life-Safety-Alarm event state.
557
Limit Enable
Contains two flags that independently enable and disable reporting of High Limit and Low Limit events and their
return to Normal. This attribute is required if the object supports intrinsic reporting.
Low Limit
Defines the low limit that the Present Value attribute must fall before an event generates.
The object generates a To Offnormal event when the Present Value falls below the Low Limit for a minimum period
of time, defined in the Time Delay attribute; the Low Limit Enable is True in the Limit Enable attribute; or the To
Offnormal is True in the Event Enable attribute.
The object generates a To Normal event when the Present Value exceeds the Low Limit plus the Deadband for a
minimum period of time, specified in the Time Delay attribute; the Low Limit Enable flag is set in the Limit Enable
attribute; or the To Normal flag is set in the Event Enable attribute.
For the Accumulator object, this attribute indicates the lower limit of the range.
Notification Class
Defines the notification class for handling and generating event notifications for the object. This attribute implicitly
refers to the Notification Class Object that has a Notification Class attribute of the same value.
Notification Object Reference
Allows selection of a Notification Class object. When the Notification Object Reference is written, the value of the
Notification Class attribute is updated to reflect the referenced objects instance number. The value of the Notification
Object Reference attribute is restricted to Notification Class objects on the same device as the Alarming object.
Notify Type
Defines whether the transitions generated by the object are Events or Alarms.
Pulse Rate
Indicates the number of input pulses received during the most recently completed period specified by the Limit
Monitoring Interval. This value is monitored by the Intrinsic Alarming logic for this object. This attribute is writable
only when the object is out of service.
Time Delay
Defines the minimum number of seconds that the Present Value must remain outside the range defined by the High
Limit and Low Limit attributes before the object generates a To Offnormal event.
Also defines the minimum time the Present Value must remain within the range defined by the High Limit and Low
Limit attributes, including the Deadband attribute value, before the object generates a To Normal event.
When used with the Feedback Value, this value specifies the minimum number of seconds that the Present Value
must remain equal to the Feedback Value before a To Offnormal event generates or different from the Feedback
Value before a To Normal event generates.
For the Accumulator object, this value defines the minimum number of seconds that the must remain outside of
the range defined by the High Limit and Low Limit attributes before the object generates an event or alarm.
Calendar Tab
The Calendar tab appears on Calendar objects, which are used behind the scenes by the Scheduling feature.
Metasys SMP Help: Insert Menu
558
Communications Tab
The Communications tab appears on Engine Device objects.
Configuration Tab
The Configuration tab appears when you define an object in the SCT or in a Wizard. The Configuration tab shows
operation attributes available for the object type to which the object belongs. The attributes displayed on the
Configuration tab vary by object type. For example, the Analog Input objects Configuration tab has different attributes
than the ADS/ADX objects Configuration tab. See the specific object section for details on its Configuration tab.
Note: This tab is called the Focus tab in the online Site Management Portal.
Diagnostic Tab
The Diagnostic tab only appears for objects containing diagnostic data. The attributes displayed on the Diagnostic
tab vary by object type. For example, the Diagnostic tab of the BACnet Protocol Engine Object has different attributes
than the Engine Device Object. See the specific object section for details on its Diagnostic tab.
Email Tab
The Email tab appears on Engine or Server objects. The Email DDA Attributes appear on the Shared Configuration
section of the Email Tab. The Email DDA Destination Configuration Attributes appear when you edit a specific Email
destination on the Email tab.
Note: At Release 7.0 Email Tab Destinations and all DDA communications feature alphabetical sorting. Clicking
icon sorts destinations in alphabetical order. Clicking the
icon sorts destinations in reverse
the
alphabetical order.
Table 299: Email DDA Shared Configuration Attributes
Attribute Name
Description
SMTP Server Host
Specifies either a host name or IP address of a server. A host name can be specified only if a DNS
is available to the device. This attribute is used in conjunction with Email DDA attribute. If no Email
DDA destinations are configured, this attribute is ignored.
SMTP Port
Signifies the TCP port on which Email DDA should connect to deliver an email message. By default,
this field is set to 25 (SMTP); however, some internal SMTP servers may be set up to non-standard
ports which require that this field be changed to match the listening port of the mail exchanger. If no
Email DDA attribute exists, this attribute is ignored.
Authentication Type
Specifies the type of authentication used to send and receive emails. Depending on the selection
you make, the fields on the Email tab become enabled or disabled to help you fill in only the fields
required for that authentication type. If you select SMTP, the SMTP User Name and SMTP Password
attributes become enabled. If you select POP-before-SMTP, the POP User Name and POP Password
attributes become enabled.
Specifies a user name for the SMTP server. This attribute is ignored if the SMTP Server Host is
empty. This attribute applies only when using SMTP authentication. If no Email DDA destinations
are configured, this attribute is ignored. See SMTP Password.
SMTP Password
Specifies the password for the SMTP user name. This attribute is ignored if the SMTP Server Host
is empty. This attribute applies only when using SMTP authentication. If no Email DDA destinations
are configured, this attribute is ignored. See SMTP User Name.
Specifies the hostname for the POP server. This attribute applies only when using POP authentication.
If no Email DDA destinations are configured, this attribute is ignored.
Specifies a user name for the POP server. This attribute is ignored if the POP Server Hostname is
empty. This attribute applies only when using POP authentication. If no Email DDA destinations are
configured, this attribute is ignored.
559
Specifies the password for the POP user name. This attribute is ignored if the POP Server Hostname
is empty. This attribute applies only when using POP authentication. If no Email DDA destinations
are configured, this attribute is ignored.
Specifies the email address from which all emails are sent. The From Email Address is a required
field. If this attribute is not populated, the Email DDA does not attempt to send an email message.
When enabled or set to True, emails attempt to send over an SSL encrypted connection. If SSL is
not supported, the email sends unencrypted unless SSL Email Ignoring Errors option is set to False.
This attribute is disabled by default.
When True, the email is still sent even if the email server certificate appears to be invalid. When
false, the email is sent only if the operating system can verify that the server sent a valid SSL
certificate. The feature is only enabled if SSL Email Enabled is True.
Email Diagnostics
Displays diagnostic information regarding the communication between the Email DDA (SMTP Client)
and the SMTP Server. This attribute displays both successful and unsuccessful email message
deliveries.
Identifies the user-friendly destination name in the list of Email DDAs. Maximum characters: 80
Email Address
Specifies the email address of one or more recipients. You must use valid email addresses set up
on an email server for the device to successfully send the email alarms. When entering more than
one email address, separate the addresses with a comma (for example,
Jonathan.Smith@jci.com,Jane.Smith@jci.com).
Click
to select email addresses defined by the user accounts in the Security Administrator
system. See the section for more information on the Email DDA and selecting email addresses.
Maximum characters: 256
Priority
Specifies the priority of the outbound email message. This attribute defines the X-Priority field within
the emails MIME header. X-Priority is one of several ways to define the significance of an email.
Not all email clients interpret it the same way. Please refer to your email clients documentation for
more information.
You can choose from the following values:
High
Normal
Low
See the Hi Normal Low (Set 100).
Subject
Specifies the user-defined text that appears in the subject field of the email message.
Maximum characters: 256
Retries
Specifies the number or attempts made to send a message if there is a failure before the system
discards it.
Range: 010
Enabled
Defines whether or not the destination is enabled. When this attribute is False, the Engine or Server
does not deliver alarms to the configured recipients.
560
Specifies the rules to filter alarms. This attribute uses Alarm Value (Set 108).
See Filters for more information.
Format
Defines the format of the message, indicating which fields are present in the received message.
The following fields are optional:
Acknowledge Required (not an option for pager)
Item Category
Item Description
Message
Previous Status
Priority
Site Name
Value
Values
Acknowledge Required
== or !=
True or False
Current Status
== or !=
Start Time
Time
End Time
Time
Item Type
== or !=
Item Category
== or !=
Previous Status
== or !=
Priority
Number value
If you define multiple filters for a destination, the DDA combines all the criteria with an AND condition (all filter criteria
must be met).
561
Engineering Tab
The Engineering tab appears on integration objects in the system. This tab allows you to view and edit attributes of
items such as devices and points on an integration.
To use the Engineering tab to view and edit attributes:
1. Right-click the integration object on the Navigation tree and select View. The Integration object appears.
2. Click the Engineering tab, and navigate to an item in the Integration Tree.
Note: You may need to click Relearn to discover the integrated devices and points on the network and populate
the Integration Tree with the data.
3. Double-click the selected item. The Details screen for the selected item appears.
4. Click the Edit button.
5. Make the desired changes and click Save.
Event Tab
The Event tab appears on Event Enrollment objects.
See the and in the section.
Focus Tab
The Focus tab appears when you define an object in the online Site Management Portal. The Focus tab shows
operation attributes available for the object type to which the object belongs. The attributes displayed on the Focus
tab varies by object type. For example, the Analog Input objects Focus tab has different attributes than the ADS/ADX
objects Focus tab. See the specific object section for details on its Focus tab.
Note: This tab is called the Configuration tab in the SCT or in a Wizard.
Graphic Tab
The Graphic tab appears on a device object that has an associated Graphic defined. See the for details on working
with this tab.
Group Tab
The Group tab appears on Group objects.
Hardware Tab
The Hardware tab shows hardware-related attributes associated with the hardware source of an integration, device,
or a point (for example, when an object has a reference to a physical input or output).
Note: Each Hardware attribute table is organized and divided into sections of Integration Hardware attributes,
Device Hardware attributes, and Point Hardware attributes (calling out when attributes are shared between
these object types). These sections are indicated by headings that span across the table.
BACnet Hardware Tab
Attributes associated with the hardware source for object data are shown under the Hardware tab of the display
panel. These attributes are not exposed to a BACnet network.
Note: Each Hardware attribute table is organized and divided into sections of Integration Hardware attributes,
Device Hardware attributes, and Point Hardware attributes (calling out when attributes are shared between
these object types). These sections are indicated by headings that span across the table. Attributes marked
with the letter C are configurable and attributes marked with the letter W are writeable.
562
Initial Value
Values/Options/Range
False
False
True or False
CW
True
Number
None
065,535
Series of
numbers
None
Text
None
Values/Options/Range
Text
01
Maximum Length = 12
Category = Default
Hex bytes of length 0,1,3, or 6
Driver Name
Text
Ipcdrv
Maximum Length = 30
Category = Default
563
Values/Options/Range
File Filter
Maximum Length = 40
Text
Category = Default
LNS Database Name
Text
CW
Maximum Length = 30
Category = Default
Resource File
Language
Text
CW
ENU
Maximum Length = 3
Category = Default
CW
CW
60
True or False
Device Class
Text
CW
True
False
True
Maximum Length = 40
Category = Default
Device Subclass
Text
Maximum Length = 40
Category = Default
Disable Automatic
Alarming
True or False
DSN 1
Text
CW
False
False
True
Maximum Length = 30
Category = Default
DSN 2
Text
Maximum Length = 30
Category = Default
Location Label
Text
Maximum Length = 30
Category = Default
Manufacturer
Text
Maximum Length = 40
Category = Default
Number
Program ID
Text
CW
Range = 015
0
Number of Elements = 40
Category = Default
Transceiver
Text
Maximum Length = 40
Category = Default
XIF Present
True or False
564
Values/Options/Range
Neuron ID
Fixed Length = 6
Text
Category = Default
LONWORKS Point Hardware Attributes
Command Status
Mapping Table
Text
CW
Custom Scale/Offset
Text
CW
Enable Polling
True or False
CW
Field Units
One unit of
CW
measure from a
set
Interface Value
Manual Control
True or False
Offline
True or False
Overridden
True or False
Priority
Number
Target Reference
Text
Trouble
True or False
Update Interval
Number
13
C
Applies to BI and BO objects.
CW
Units = Seconds
065,535
Applies to AO, BO, and MO objects only.
C - Configurable, W - Writable
565
Device Subclass
Indicates the device subclass usage of a device. The LONWORKS network server is responsible for populating the
(which includes the Manufacturer, Device Class, Device Subclass, Transceiver, and Model). If no standard Program
ID exists, the value is n/a.
Disable Automatic Alarming
Specifies whether automatic online/offline device event reporting is disabled (True) or enabled (False). This attribute
only applies to the device and not to the devices mapped objects. Devices with the Disable Automatic Alarming
attribute set to True suppress the alarm event but still indicate they are offline in the navigation tree with a red X.
Alarm extensions are not affected by this attribute.
Domain ID
Defined by Metasys system Connectivity to LONWORKS network (MCL) software for the particular LONWORKS network
trunk. The validation code checks for proper format (zero, one, three, or six hexadecimal bytes).
Driver Name
Displays to the name of the installed LONWORKS network driver.
DSN 1
Displays the native LONWORKS network address (in Domain-Subnet-Node format). DSNs must be unique on the
LONWORKS network. DSN 1 is required. Use the format xx/xx/xx.
DSN 2
Displays the native LONWORKS network address (in Domain-Subnet-Node format). DSNs must be unique on the
LONWORKS network. DSN 1 is required, but DSN 2 can be left blank. Use the format xx/xx/xx.
Enable Polling
Indicates whether polling is enabled or disabled when the Engine is in complete control of this item.
Field Units
Lists the engineering units that pertain to the LONWORKS network data. This attribute is for AI and AO objects only.
File Filter
Lists the types of files that can be used as file extensions to the LON Integration object. The list includes:
eng
enm
enu
fmt
fpt
typ
xif
File Filter can be edited for alternate languages and must be in the xxx file format.
566
Interface Value
Indicates the current value from the hardware interface. The Interface Value updates when the hardware is read or
when the hardwares current value changes.
Location Label
Describes the location of the controller.
LNS Database Name
Displays the name of the LONWORKS Network Services (LNS) database used to build the LONWORKS network trunk.
Manual Control
Indicates that an Hand-Off-Auto (HOA) switch on the referenced item is set to Hand or Off.
Manufacturer
Indicates the manufacturer of a device. The LONWORKS network server is responsible for populating the Program
ID (which includes the Manufacturer, Device Class, Device Subclass, Transceiver, and Model). If no standard
Program ID exists, the value is n/a.
Message Retry Count
Indicates the number of retry attempts to use when communicating with this controller.
Model
Indicates the model number of a device. The LONWORKS network server is responsible for populating the Program
ID (which includes the Manufacturer, Device Class, Device Subclass, Transceiver, and Model). If no standard
Program ID exists, the value is n/a.
Neuron ID
Displays the Neuron ID of the local LONWORKS network interface board or contains the Neuron ID of the remote
LONWORKS network controller. The Neuron ID must be unique to the LONWORKS network.
Offline
Indicates whether the connected LONWORKS network hardware is online or offline.
Overridden
Indicates if the hardware is overridden (if supported).
Priority
Indicates the Priority (13) at which to poll this item.
Program ID
Displays the Standard Program ID for the device in hex characters. The LONWORKS network server is responsible
for populating the Program ID (which includes the Manufacturer, Device Class, Device Subclass, Transceiver, and
Model). If no standard Program ID exists, the value is n/a.
Resource File Language
Defines the language extracted from the resource file.
Metasys SMP Help: Insert Menu
567
Notes
Initial Value
Values/Options/Range
One state/type/
mode from a set
CW
Number
CW
Network Address
165,534
0 = Local network
65,535 = Reserved for broadcast
Trunk Number
Number
True or False
Instance Number
Number
CW
False
False
True
568
Notes
MAC Address
Number
Initial Value
Values/Options/Range
1255
Text
Number
Offline
True or False
Number
Slot
Number
Slot A
Number
Slot B
Number
Use baud rate of running network. This value is the recommended setting for everything on the FC bus except
the bus supervisor port.
1200
Use 1200 baud only. This value is not recommended and may not be allowed on some devices.
9600
Use 9600 baud only. This value is the lowest standard MS/TP baud rate.
19200
38400
Use 38400 baud only. This value is the recommended baud rate for bus supervisor ports.
76800
Device Type
Indicates the type of device. This value comes from CCT.
Disable Automatic Alarming
Specifies whether automatic online/offline device event reporting is disabled (True) or enabled (False). This attribute
only applies to the device and not to the devices mapped objects. Devices with the Disable Automatic Alarming
attribute set to True suppress the alarm event but still indicate they are offline in the navigation tree with a red X.
Alarm extensions are not affected by this attribute.
FC Bus MAC Address
Displays the MAC address of the device on which the object exists (if the object physically resides on a device on
the FC bus) or the FEC/VMA field controller MAC Address that the point is connected to (if the object physically
resides on the SA bus).
Metasys SMP Help: Insert Menu
569
Instance Number
Displays the Instance Number of the object on the remote field device. The Instance number, along with the object
type, defines the remote objects BACnet Object Identifier. The BACnet Object Identifier is used to establish
communication with the object.
MAC Address
Indicates the MAC address of the device on the field bus.
Network Address
Contains the network number of the MS/TP bus used for BACnet message addressing. A value of 0 indicates a local
network (the device is not intended as a router). Do not change this number after you start device mapping or
discovery because it may invalidate the devices that have been found.
Offline
Specifies whether or not the point is offline.
Trunk Number
Displays the trunk number where the device (on which the point resides) is located.
SA Bus MAC Address
Displays the MAC address of the device on which the object exists (if the object physically resides on a device on
the SA bus).
Slot
Defines the physical location of a point data source on the device.
Slot A
Defines the physical location of a point data source on the device.
Slot B
Defines the physical location of a second data point source on the devices (if present). Only a PAO would have Slot
B defined.
N1 Hardware Tab
Attributes associated with the hardware source for object data are shown under the Hardware tab of the display
panel. These attributes are not exposed to a BACnet network. Attributes marked with the letter C are configurable
and attributes marked with the letter W are writeable.
Table 306: N1 Hardware Tab Attributes
Attribute Name
Data Type
Notes
Initial Value
Values/Options/Range
NCM Name
Text
None
8 characters maximum
Network Name
Text
None
8 characters maximum
570
Initial Value
Offline
True or False
False
Overriden
True or False
Reference
Text
CW
Values/Options/Range
False
None
<system>.<object>
None
<system>.<object>
8 characters each maximum
571
Notes
Initial Value
Values/Options/Range
Message Timeout
Number
See
250
2503,000
Milliseconds
Poll Delay
Number
100
065,535
Milliseconds
Retries
Number
Trunk Number
Number
UDP Port
Number
310
065,535
Disable Automatic
Alarming
True or False
Host Name
Text
Net N2 Address
Number
Number
CW
CW
False
True
1254
Range = 08
Units = Minutes
Offline
True or False
Overridden
True or False
Trouble
True or False
Controller has reset and is waiting for the Identify Yourself command
Data field error: size of message not correct for command type
Invalid Data: one of the fields contains a value that is out of the expected range
Invalid command for data type: command not appropriate for this field or record
572
Command not accepted due to problems with the controller, the command is ignored
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Counters unreliable
25
26
27
28
29
30
31
32
33
34
35
36
37
573
574
Overridden
Indicates whether the hardware device is currently overridden.
Poll Delay
Specifies the time to wait in milliseconds for a response to an offline poll.
Note: The Poll Delay attribute is writable only if UDP Port is not zero. If UDP Port is zero and you attempt to write
Poll Delay, an error message appears.
Retries
Specifies the number of message retries allowed when the device is online, including the initial attempt. Only one
retry is attempted to an offline device.
Note: The Retries attribute is writable only if is not zero. If UDP Port is zero and you attempt to write Retries, an
error message appears.
Trouble
Indicates whether the hardware device is currently under a trouble condition. Applies to BI and BO objects.
Trunk Number
Specifies the number of the trunk on which the object resides.
UDP Port
Indicates the Ethernet UDP Port used for N2 communication over the IP network. The recommended UDP Port for
N2 Trunk 1 is 4096 and for N2 Trunk 2 is 4097. Only valid on NAE5512 and NAE5513 models.
VND Hardware Tab
Attributes associated with the hardware source for object data are shown under the Hardware tab of the display
panel. Attributes marked with the letter C are configurable and attributes marked with the letter W are writeable.
Table 309: VND Hardware Tab Attributes
Attribute Name
Data Type
Notes
Initial Value
Values/Options/Range
True or False
CW
False
Protocol Description
Text
VendorDriver
Protocol Revision
Text
Date
Time
Number
CW
Vendor DLL
Text
Units = Seconds
CW
065,535
Date
VENDOR.DLL
Units = bytes
C
575
Time
Initial Value
Values/Options/Range
List
Vendor Reference
Text
CW
Maximum characters = 80
Maximum entries = 128
Text
Interface Value
Max Value
Real value
CW
250.0 deg F
Min Value
Real value
CW
-50.0 deg F
Offline
True or False
Overridden
True or False
Priority
Number
Troublet
True or False
CW
C - Configurable, W - Writable
576
Offline
Specifies whether or not the point is offline. Applies to only AI, AO, BI, BO, MI and MO objects.
Overridden
Indicates whether the hardware device is currently overriden. Applies to only AI, AO, BI, BO, MI and AO objects.
Priority
Specifies the priority for polling the vendor point. Applies to only AI, AO, BI, BO, MI and MO objects.
Protocol Description
Indicates the protocol supplied by the Vendor DLL.
Protocol Revision
Indicates the revision of the protocol for reference purposes.
Protocol Revision Date
Indicates the date the Vendor DLL protocol was compiled.
Protocol Revision Time
Indicates the time the Vendor DLL protocol was compiled.
Temporary Status Item Expiration Time
Indicates how long a point remains in the polling list.
Trouble
Indicates whether the hardware point is currently under a trouble condition. Applies to only BI and BO objects.
Vendor Configuration Data
Contains data for proper configuration of the integration.
Vendor DLL
Specifies the name of the vendor DLL to load at startup.
Vendor Integration Size
Indicates the size, in bytes, of the vendor integration.
Vendor Reference
Specifies the address of the vendor device.
Vendor Revision Date
Indicates the date of the Vendor integration revision.
Vendor Revision Time
Indicates the time of the Vendor integration revision.
577
Notes
Initial Value
CW
9600
Values/Options Ranges
Number
Data Bits
Driver Name
Text
XL5Kdrvr
Parity
Protocol Revision
Text
Stop Bits
Trunk Number
Uses Databits
Even
Uses Parity
Uses Stopbits
Number
Range = 06
True or False
Device Database OK
True or False
Device Health
OK or Fault
Device Type
Text
Disable Automatic
Alarming
True or False
CW
Download Date
Date
Download Time
Time
Firmware Version
Text
Hardware Version
Text
Reset Date
Date
Reset Time
Time
False
True
Number
CW
30
Range = 130
Text
CW
Undefined
578
579
Hardware Version
Indicates the hardware version of the receiver module.
Parity
Indicates the parity used by the XL-5000 equipment. The valid parity for Honeywell protocol is Even.
Protocol Revision
Indicates the current version number of the XL5K Protocol Engine (PC104).
Remote Name
Indicates the existing name of the Honeywell field device.
Remote Object Type
Indicates the type of remote object (for example, Analog Input, Digital Output, and Pulse Input).
Reset Date
Indicates the date of the last Clear Statistics command.
Reset Time
Indicates the time of the last Clear Statistics command.
Stop Bits
Indicates the stop bits used by the XL-5000 integration. The valid value for Honeywell protocol is 8/1.
Trunk Number
Indicates the trunk number used for the integration. This number is typically 1.
Input Category Tab
The Input Category tab appears on GIO objects and includes the status, description, and value of the items in the
category. See the Generic Integration Object section for details.
Interlock Definition Tab
The Interlock Definition tab appears on Interlock objects.
Load Tab
The Load tab appears on an object that has a load extension.
Load Summary Tab
The Load Summary tab appears on DLLR objects.
Logic Tab
The Logic tab appears on Program (Control System) objects, which are used for the LCT feature.
Members Tab
The Members tab appears on Life Safety Point and Life Safety Zone point objects.
Metasys SMP Help: Insert Menu
580
Network Tab
The Network tab appears on Engine Device objects.
Options Tab
Attributes associated with the default state, control source, and restart options for an object are shown under the
Options tab of the display panel. Attributes marked with the letter C are configurable and attributes marked with the
letter W are writeable.
Table 311: Options Tab
Attribute Name
Data Type
Notes
Initial Value
Values/Options/Range
Auto Restore
True or False
CW
True
CW
True
Local Control
CW
True
True or False
CW
Restore Command
Priority
Set of values
CW
581
Pager Tab
The Pager tab appears on Engine or Server objects. The Pager DDA Attributes appear on the Shared Configuration
section of the Pager Tab. The Pager DDA Destination Configuration Attributes appear when you edit a specific Pager
destination on the Pager Tab.
Table 312: Pager DDA Shared Configuration Attributes
Attribute Name
Data Type
Initial Values
Description
Connect Using
Access Number
Text
Redial Attempts
Number
1 Second (0)
1 Minute (1)
True or False
True
Databits
Parity
Even
Stopbits
Password
Text
000000
Pager Diagnostics
Text
Identifies the user-friendly name for a pager destination in the list of Pager DDAs.
Max Characters
Specifies the maximum number of characters supported by the pager service provider.
Retries
Specifies the number or attempts made to send a message if there is a failure before the
system discards it.
Range: 010
Enabled
Defines whether or not the destination is enabled. When this attribute is False, the Engine or
Server does not deliver pager messages to the configured recipients.
582
Format
Defines the format of the message, indicating which fields are present in the received message.
The following fields are optional:
Acknowledge Required (not an option for pager)
Item Category
Item Description
Message
Previous Status
Priority
Site Name
Value
Font Face
Font Size
Orientation
Line Out
Defines how many lines of data are required before the Printer DDA routes reports to the printer.
Setting this value to 0 enables tractor-feed/line printing. See the topic in the section.
Range: 060
Timeout
Timer (in minutes) that begins when the first alarm is stored in the DDA line out buffer (Line Out).
Upon expiration, the contents of the line out buffer prints.
583
Specifies the priority for printing alarm messages. You can print multiple alarms in a normal priority
range at once using the Line Out and Timeout attributes. You also can set the Printing Priority
Threshold to print the contents of the line out buffer immediately when a higher priority alarm (such
as a fire alarm) is detected. You can set the Printing Priority Threshold to a value from 0 to 255.
When an alarm is received that has a lower priority number than the Printing Priority Threshold (lower
priority numbers have a higher alarm priority), the contents of the line out buffer print immediately
when the higher priority alarm (such as a fire alarm) is detected, thus printing the high priority alarm
in addition to the contents of the line out buffer.
For example, if the Printing Priority Threshold is set to 20, alarms with a priority number of 20 or
greater are buffered using the Line Out and Timeout attributes. Receiving an alarm with a priority
number of 19 or less forces an immediate printout of the currently buffered alarms plus the new high
priority alarm.
This functionality applies when the Line Out attribute is set to 1 or greater. Also see the the topic in
the section.
See the Hi Normal Low.
Retries
Specifies the number or attempts made to print a report if there is a failure before the system discards
it.
Range: 010
Enabled
Defines whether or not the destination is enabled. When this attribute is False, the Server does not
deliver reports to the configured printer.
Filters
Format
Defines the format of the message, indicating which fields are present in the received message.
The following fields are optional:
Acknowledge Required (not an option for pager)
Item Category
Item Description
Message
Previous Status
Priority
Site Name
Value
See the Event Message Routing, Filtering, and Destinations section of the Metasys SMP Help (LIT-1201793) for
more information on this DDA.
See for more information on this DDA.
Profile Tab
The Profile tab appears on DLLR objects.
Recipient List Tab
The Recipient List tab appears on Notification Class objects.
584
Values/Options/Ranges
Connection Status
Offline
Offline
Online
Authentication Status
Disconnected
Disconnected
Authenticating
Authentication succeeded
Authentication failed
Number
Units = Seconds
Account ID
Text
Account Password
Text
Connection Enabled
True or False W
Proxy Address
Number
Number
Proxy Username
Text
Proxy Password
Text
https://identity.johnsoncontrols.com/issue/oauth2/token
Remote Services
Text
Connection End Point
https://rsc.johnsoncontrols.com
Application Key
Number
False
True or False
585
Authentication Status
Specifies one of the following authentication statuses of the site:
Disconnected
Authenticating
Authentication succeeded
Authentication failed
586
Specifies whether the SNMP feature is enabled. Once this attribute is enabled, the
ability to send and receive messages (Traps and Gets) can be enabled or disabled on
an individual basis using the other SNMP DDA attributes.
Specifies the version used to send SNMP traps. The versions are v1, v2c, and v3.
Specifies an IP address or Host Name on which to filter Get requests. SNMP only
responds to requests from the device listed in this attribute. If this attribute is 0.0.0.0,
SNMP responds to all requests.
Specifies the port on which SNMP communication occurs. Setting this attribute to 0
disables the Get feature of SNMP.
Contact Person
A case-sensitive string used to authenticate v1 and v2c Get and Get Next messages.
This attribute contains the community string used by the Network Management System
to edit data in objects maintained by managed devices.
Defines the message format used for generating SNMP Traps, including the startup
Trap. The options are:
String Based (default) - SNMP Traps are sent as a string of characters
MIB Based - SNMP Traps are sent using the object identifier (OID) defined in the
Johnson Controls MIB (called, JCI MIB).
A case-sensitive string used to authenticate v1 and v2c SNMP Traps. This attribute
contains the community string used by the Network Management System to edit data
in objects maintained by managed devices.
IP Address
Specifies the IP address or host name of the system that receives the traps.
Specifies the port number from which the destination machine is expecting to receive
traps.
Enabled
587
Specifies the rules to filter alarms. This attribute uses Alarm Value (Set 108). See Filters
for more information.
Format
Allows you to select which attributes of a Metasys event are in the SNMP Trap.
The following fields are optional:
Acknowledge Required (not an option for pager)
Item Category
Item Description
Message
Previous Status
Priority
Site Name
Value
See the Event Message Routing, Filtering, and Destinations section of the Metasys SMP Help (LIT-1201793) for
more information on this DDA.
See for more information on this DDA.
For detailed information on SNMP, refer to the SNMP Agent Protocol Implementation appendix located in the
following documents:
Network and IT Guidance for the BAS Professional Technical Bulletin (LIT-12011279)
Syslog Tab
The Syslog tab appears on Engine or Server objects. The Syslog DDA Attributes appear on the Shared Configuration
section of the Syslog Tab. The Syslog DDA destination Configuration Attributes appear when you edit or create a
new Syslog Destination on the Syslog tab.
Syslog has one Share Configuration attributeSyslog Reporting Enabled. When the Syslog Reporting Enabled
attribute is set to True, the feature is active and your error logging is forwarded to your destination server.
Table 318: Syslog DDA Destination Configure Attributes
Attribute
Value / Description
Label
Destination name
Syslog Server
The designated port on the device for error transmitting to your server.
The designated port on your server for receiving the error transmits.
Event Filters
Audit Filters
588
Summary Tab
The Summary tab provides summary data for items in the navigation tree. For example, the Summary tab of the
MSTP Field Bus object shows summary data for the devices on the field bus. The Summary tab shows the status,
icon, item, value, and description information of the items. You can view and edit items on this tab using the right-click
menu options.
Note: Data appears in the Status column of the Summary tab when the status is not Normal (for example, High
Alarm).
Summary Definition Tab
The Summary Definition tab appears on Summary Definition objects used by the Tailored Summary feature. This
tab allows you to view and edit the Summary Definition object. See the Tailored Summaries section in the Metasys
SCT Help (LIT-12011964) for more information on this object and feature.
Tailored Summary Tab
The Tailored Summary tab appears when you view the folder containing the Tailored Summary in the associated
User View. This tab allows you to view the Tailored Summary you defined using the User View and the Summary
Definition tab. See the Tailored Summaries section in the Metasys SCT Help (LIT-12011964) for more information
on this feature.
Totalization Tab
The Totalization tab appears on an object that has a totalization extension.
Tree View Tab
The Tree View tab appears on User Navigation Tree objects, which are used by the User Views feature.
Trend Tab
The Trend tab appears on an object that has a trend extension.
Trend Study Tab
The Trend Study tab appears on the Trend Study feature.
User Defined Enumeration Editor Tab
The User Defined Enumeration Editor provides the user interface for the quick modification, creation, or deletion of
User Defined Enumerations on a Metasys Site. Authorized users can modify one or more User Defined Enumerations.
This tool provides a solution for various change requests, and satisfies requirements for new and future Metasys
system features that need to provide the user with the ability to define the displayed text for multiple User Defined
Enumerations. The User Defined Enumeration Editor is available in both the online (runtime) and offline (SCT) modes
of the Metasys system supervisory user interface. Access the tool by selecting the Custom Enumeration Tab of the
Site Object.
For Release 5.2 and later, the Rediscover Text Strings operation generates custom enumerations from all mapped
BACnet and MS/TP objects. These custom enumerations are backed up when the site director is uploaded in
the Release 5.2 database. During the upgrade process, a restored, upgraded, or downloaded Release 5.2
database maintains these custom enumerations during the upgrade process.
For Release 6.5 and later, the User Defined States Text attribute will be set to true whenever an object has a
custom enumeration set assigned to it.
Engines at Release 8.0 and later will automatically read custom state set's text created in CCT and display them
in the SMP user interface, instead of the generic State 0 to State X text.
589
Add and Delete Custom Enumeration Add new or Delete existing User Defined Enumeration Sets.
buttons.
When you select the Custom Enumeration tab there is an Edit button here,
upon selecting edit the button is replaced by the Save and Cancel buttons.
Name
Size
Enumeration set size. This is the number of values within the selected
enumeration. You may not see optimal performance if this exceeds 5
members.
Enumeration Entries
Displays the current list of User Defined Enumerations. This list is limited
to 256 entries.
Graphic
Menu Selection: Insert > Graphic
Inserts a graphic into the site.
590
Symbols
The Edit Mode allows you to edit an existing graphic or create new graphics.
The View Mode allows you to view existing graphic to monitor and command all systems integrated into the
Metasys network.
The UGT is available with the NAE, NIE, ADS, ADX , and SCT. You can access the UGT when you are logged in
to the Metasys user interface via any web browser. The Group Object represents user graphics in the All Items
navigation tree and can be displayed in any active display panel.
Note: If your graphics reference multiple Engines or multiple ADS/ADXs , and one device needs to be downloaded,
upload all Engine/ADS/ADXs prior to making changes in SCT. This procedure ensures your graphics work
consistently.
For information on default preferences for graphics (such as status colors, fan colors, state colors, and alarm flashing
settings), see Graphic Settings Tab in the Preferences section.
For more information on configuring an NAE or NIE and for details on user access configuration, see the Related
Documentation table.
User Graphics Tool Concepts
Graphic Workspace
When viewing an existing graphic or creating new graphics, the User Graphics Tool (UGT) runs in the Graphics
Workspace, which is displayed in an active display panel. The background for the workspace defaults to a gray
background. The graphic workspace displays all graphical symbols and a user-selectable Static Background. The
UGT Toolbar shows only the appropriate tools for the UGT Modes you are working in View Mode or Edit Mode.
UGT Modes
The User Graphics tool runs in either Edit Mode or View Mode. When you are generating new graphics or editing
graphics, the User Graphics tool is in Edit mode. When you finish editing and click save and the UGT switches to
View mode.
Note: You can generate graphics in the Metasys system online mode or offline mode. See the following scenarios:
Online: If your web browser is connected to an Engine or ADS/ADX . In this case, a new graphic is generated
online in the device where the graphic resides during normal operation. When you are finished creating or
editing graphics, Upload the database to the archive database in the SCT.
Offline: If your web browser is connected to the SCT. If this case, the new graphic is generated offline and
stored in the archive database. When you are finished creating or editing graphics, Download the database
to the device where the graphic resides during normal operation.
591
Edit Mode
Edit mode is the mode used by the UGT to design and edit graphics. Access the Edit mode by clicking the Edit
button on the UGT Toolbar. In Edit mode, you have access to all toolbar items/symbols and you can bind symbols
to objects and link graphics to other graphics.
Right clicking in Edit mode brings up basic choices for editing graphics such as copy, paste, delete, duplicate, hide,
and zoom, depending on the type of item you select. Double clicking in Edit mode brings up the binding information
for a symbol.
For a list of mouse shortcuts, see the Mouse Shortcuts: Edit Mode topic.
View Mode
Graphics display in the View mode when you are navigating using graphics and when you first open a graphic.
Graphics appear in an active display panel. You must enter the Edit Mode (by clicking the Edit button) to design or
edit a graphic. In View mode, you have access only to a limited number of items on the UGT Toolbar. The symbols
in the palette on the left do not appear in this mode.
The View mode allows you to command an object bound to a Value Display Box or Analog Fill Bar Graph and to
click on Hyperlinks to access linked graphics. Double clicking on a bound symbol in View mode displays the Focus
view of the bound object.
For binary point objects, the value and status update every 10 seconds. For analog point objects, the value and
status update every 10 seconds. Commands and value changes return a new state/value or error message within
10 seconds or less. The error message could be related to priority (if the system cant perform the requested function
now) or failure to reach a commanded state or value. Error messages appear in dialog boxes.
For a list of mouse shortcuts, see the Mouse Shortcuts: View Mode topic.
Toolbar
The UGT toolbar shows only the appropriate tools for the current mode of the UGT. The table below shows the
toolbar options available in Edit Mode and View Mode.
For information on mouse shortcuts, see Mouse Shortcuts.
Table 320: UGT Toolbar Options in Edit Mode and View Mode
Icon
Description
Visible In:
Action Performed
(Standard
Windows Icons
not Shown)
Save
Cancel
Edit
592
Table 320: UGT Toolbar Options in Edit Mode and View Mode
Icon
Description
Visible In:
Action Performed
(Standard
Windows Icons
not Shown)
Print Preview
Cut
Copy
Paste
Undo
Redo
Bind
Select
Text
Pan
Marquee Zoom
Interactive Zoom
Overview
Selective Zoom
593
Static Background
Backgrounds are static images displayed in the background of a graphic. Backgrounds represent buildings, floor
plans, mechanical equipment, and any other picture that represents the location or function of the equipment in the
graphic. By default, a newly created graphic has a gray background. You can insert a background image using a
file based on SVG, SVGZ, or JPEG graphic format.
You can create SVG/SVGZ background images with graphic drawing packages or from established libraries of
images. We recommend using the Professional or Standard edition of Microsoft Visio 2003, 2007 or 2010 (32 bit)
software and the AGSL to create background images. Alternatively, you can use Microsoft Visio 2002 software with
the Graphics Stencil Library (GSL). SVGZ and SVG images must be created in positive space (quadrant 1, on the
positive X and positive Y axis).
Background images in JPG format are usually created with cameras or scanners. You cannot resize a UGT background
in JPG format, and if an area of the graphics workspace is not fully covered by the JPG image, the exposed area
defaults to gray.
Access available backgrounds with the background icon on the Toolbar.
For information on how to edit an existing background image, see Editing a Background Image.
Managing Graphic Creation
In general, you should store your graphic files on the Site Director. The Site Director provides you with a uniform
point of entry and traffic control. The Site Director allows information sharing between users while minimizing network
traffic.
NAE35/NAE45 Graphic Size Limitation
When you create or edit graphics with an online UI to an NAE35 or NAE45, changes you make do not save if the
graphic is too large. The total size of the graphic background, dynamics, and static text must not exceed 700K bytes.
A typical size for an SVGZ graphic is 100200K. You do not receive a warning that the graphic is too large to save.
Transactions larger than 1 MB are rejected by the NAE. The size limitation includes a 40% overhead from the HTML
wrapper around the save transaction.
Note: This size restriction does not apply to graphics that are created and saved through the online UI to an NAE55,
NAE85, or SCT.
When you work with NAE35/NAE45 graphics, use the following equation to help keep your graphics at a manageable
size:
(background image size x 140%) - 1 MB (1,048,576 bytes) = available space for graphic dynamic symbols and text
blocks
Note: Each graphic symbol is 3,000 bytes.
Example:
Background size: 700,000 bytes
Background + overhead: 700,000 x 140% = 980,000
Total Space for symbols and text = 1,048,576 - 980,000 = 68,576
Total symbol and text elements = 68,576 / 3,000 = 22
594
Symbols
Symbols are graphic elements or components that are inserted into graphics to represent the value or status of
equipment in your system. The UGT contains the set of symbols described in the table below. In Edit mode, the
symbols appear in a palette to the left side of the graphic workspace.
Symbols support drag and drop functionality. For more information, see Drag and Drop Shortcuts.
Table 321: Symbol Descriptions
Symbol
Description
Buttons
Buttons allow you to hyperlink from one graphic to an item, URL, or application.
Value Display Boxes display the value and status of bound objects and allow you to
access the Focus view of the bound object. Value Display Boxes also show the units
used by the value.
Gauges
Gauges display the value and status of bound objects with graphs, dials, and standard
colors. UGT offers the following gauge categories:
Analog Fill Bar Graph
Dial Gauge
Dynamics
Dynamic symbols indicate the value of bound objects. Some of these symbols move as
the object change. Members of this category are:
Fans
Basic Shapes (Block)
Switch (2 or 3 State)
Button Symbols
Button symbols are useful when browsing to another graphic, object, or a website. Buttons support the drag and
drop functionality, allowing you to drag items from the navigation tree and drop them in the graphic workspace with
the following rules:
If you select multiple objects in the Navigation Tree and then drag a button to the Graphic Workspace, the UGT
creates buttons that Alias the selected objects.
If you select a graphic/object in the navigation tree and then drag a button to the graphic workspace, the UGT creates
a button bound to the selected graphic/object.
In Edit mode, after you drag and drop a button, click on it to add a label. If you double click on a Button in the Edit
mode, the Hyperlink Information box appears. Using this box, you can specify to link the graphic to a graphic, object,
or web page, choose display properties, and choose to hide the button. See the Button Symbols topic for more
information.
Only buttons support Hyperlinks.
In the View mode, left click on the Button to navigate to the bound object, graphic, or web page. When your cursor
passes over a button, the cursor changes into a finger pointer.
See the Buttons step section for information on binding Buttons.
595
Hyperlinks
Hyperlinks are links from one graphic to other items (graphics or other objects), URLs, or applications using buttons.
If you click on a button hyperlinked to an item, your view switches from the current graphic to the hyperlinked graphic
or object. If you click on a hyperlink to a URL, the website appears in a separate browser window. If you click on a
hyperlink to an application, the application opens.
Only buttons support hyperlinks. Set hyperlinks when you bind a button symbol.
Note: You cannot link to items in the system, such as Tailored Summaries, unless you are also using Ready Access
Portal software. To link to a Tailored Summary, use the Ready Access Portal UI URL as the link destination
in the graphic. If you are not logged in to the Ready Access Portal UI, you are asked for your username and
password after clicking the link.
Value Display Boxes
Value Display Boxes are useful for displaying the value and status of a large number of objects in a single graphic.
The Value Display Box supports drag and drop functionality. If you select a single item or multiple items in the
navigation tree and then drag and drop a Value Display Box, the box/es automatically binds to the selected item/s.
If a Value Display Box is configured to display the Status of the bound object, the text and box background appear
in the standard Status Colors.
In View mode, Value Display Boxes appear as if they are editable boxes, but they are not. Double click on the Value
Display Box to display the Focus view for the bound object and right click to show the command menu.
See the Value Display Boxes step section for information on binding Value Display Boxes.
Gauges Category
Gauges provide an indication of the present value and status for the bound objects. If you select a single item or
multiple items in the navigation tree and drag a gauge to the workspace, the UGT creates one gauge per item and
binds each symbol to an item.
The following table lists the gauges included in the UGT.
Table 322: Gauges
Gauge Type
Symbol
Animation
Dial Gauge
596
597
Symbol
Animation
Fans
Colors change.
Switch (2 or 3 State)
Fans
Fan symbols display rotational movement when bound to an object. Use this dynamic component to provide animation
capabilities for fans or pumps that appear in the background image. You can choose either a clockwise or a
counter-clockwise spin. We recommend using Fans with binary objects.
In View mode, if the bound object has a value of 0, the fan appears stationary. If the bound object has a value greater
than 0, the fan/pump blade spins. The fan/pump color shows the state of the bound object (red for Off, green for
On).
If the fan is spinning, the bound object has a normal status or is unreliable, and the device that the bound point
resides on is online, the color of the fan is set to the color defined in the system preferences for the On state. If the
fan is not spinning, the bound object has a normal status or is unreliable, and the device that the bound point resides
on is online, the color of the fan is set to the color defined in the system preferences for the Off state. If neither of
these scenarios apply, the color of the fan is defined by the status colors defined in the system preferences.
In the View mode, a double click on a fan symbol displays the Focus view of the bound object. A right-click shows
the command dialog box.
See the Dynamics: Fans step section for information on binding Fans.
Basic Shapes
Basic Shapes show the status of the bound object. Any basic shape can be bound to either an analog, binary, or
multistate object. You can resize these symbols, which include a square, triangle, and circle.
If a basic shape is bound to an analog object, in the View mode, the color of the shape indicates the status of the
bound object. White is normal, but other colors are listed. See Status Colors.
If a basic shape is bound to a binary object, in the View mode, the color of the shape indicates the state of the bound
object. By default, if the state is 0, the shape is white and if the state is greater than 0, the shape is green. These
can be configured by the user when you bind the symbol.
Double click on the shape to display the Focus view for the bound object. Right-click to display the commands.
598
Tip: Use the circles to depict temperature sensors on a floor plan graphic. Circles and rectangles can be used as
status lights.
See the Dynamics: Basic Shapes step section for information on binding basic shapes.
Switch (2 or 3 State)
The Switch is a dynamic symbol that can be bound to an object, and can be configured to be either a 2 or 3 state
switch). User-defined text appears at the top of the Switch to show what state the point is in. You can resize Switches.
We recommend you bind a Switch to a binary or multistate object.
In View mode, Switch symbols show the state of the bound object. Double click on the shape to display the Focus
view for the bound object. Right-click to show the command dialog box.
See the Dynamics: Switches step section for information on binding switches.
Binding Symbols to Objects
In the UGT you can bind symbols to objects, which allows the symbol to display the condition of the bound object.
Refer to each symbol section for details about which object type can be bound to each symbol.
To speed up the binding process, select one item or several items (using the Shift or Control key) in the navigation
tree and then drag and drop a symbol into the graphic workspace. The symbol automatically binds to the item or
items selected in the tree.
To bind graphics in Edit Mode, see Binding Symbols to Objects in Edit Mode.
For information on drag and drop binding shortcuts, see Drag and Drop Shortcuts.
Status Colors
Status colors are used by symbols such as Value Display Boxes, Analog Fill Bar Graphs, and Basic Shapes to
indicate the status of a bound object. The following table lists the default status colors used by the UGT.
Table 324: Status Colors
Status
Symbol Text Color
Normal
Black
White
Alarm
Black
Red
Warning
Black
Yellow
Trouble
Black
Yellow
Offline
White
Black
Operator Override
Black
Orange
Out of Service
Black
Light Brown
Note: All status color defaults can be changed in the Graphic Settings Tab in the Preferences chapter.
See Binding Symbols to Objects in Edit Mode for information on binding graphics.
599
Alias
Aliases simplify the process of binding symbols to objects during graphic generation when a site has several graphics
that contain a common set of objects. The Alias feature allows you to use a wildcard character (*) to represent a
single string of characters that may be part of the complete object reference as part of the binding information for a
symbol. When a graphic is displayed in View Mode, the alias symbol (*) is replaced with the text from the alias box
of the symbol you used to access the graphic. If you navigate to a graphic using an aliased button, you cannot edit
the graphic. To edit the aliased graphic, access it via the navigation tree.
For example, aliasing allows you to use a single aliased graphic for multiple field controllers, such as VAV Modular
Assemblies (VMAs), with similar configurations. See Creating Aliases.
Figure 63 shows an example of a main graphic and an aliased graphic. In the figure, the top panel contains the main
graphic, which has several buttons bound to the aliased graphic. Each button has its alias string set to the reference
for a different field device. The bottom panel shows the aliased graphic, displayed directly from the navigation view
(that is, with no alias strings passed in).
Figure 64 show the aliased graphic as it displays when the user clicks the corresponding buttons in the main graphic
(that is, with field device-specific values).
Figure 63: Alias Example - Main and Aliased Graphics
600
For more information on binding graphics, see Binding Symbols to Objects in Edit Mode.
Navigation
You can navigate between graphics by using hyperlinked Button Symbols or by selecting graphics from the navigation
tree and displaying them in the Display Frame. You can restrict user access to specific graphics by setting security
levels in the Security Administrator System.
You can also create user views that contain only graphics (hierarchy of graphics references).
Commands
You can command objects that are bound to symbols by right clicking on the symbol in View Mode. If you are not
authorized to command the object, the command is disabled in the command dialog box.
Mouse Shortcuts
Use mouse shortcuts to speed up User Graphics Tool use. See Mouse Shortcuts: Edit Mode and Mouse Shortcuts:
View Mode.
Mouse Shortcuts: Edit Mode
The following table lists the mouse shortcuts you can use in the Edit Mode of the User Graphics Tool.
Table 325: Edit Mode Mouse Shortcuts
Item
Single Left Click
Right-Click
Static Background
Image
Remove Background
Button
Select
601
Right-Click
Select
Bind Information dialog box appears. Cut, Copy, Paste, Duplicate, Delete,
Format, Align
Select
Bind Information dialog box appears. Cut, Copy, Paste, Duplicate, Delete,
Format, Align
Gauge: Dial
Select
Bind Information dialog box appears. Cut, Copy, Paste, Duplicate, Delete,
Format, Align
Dynamics: Fan
Select
Bind Information dialog box appears. Cut, Copy, Paste, Duplicate, Delete,
Format, Align
Bind Information dialog box appears. Cut, Copy, Paste, Duplicate, Delete,
Format, Align
Dynamics: Switches
Bind Information dialog box appears. Cut, Copy, Paste, Duplicate, Delete,
Format, Align
Select
Format
The Format menu choice contains the choices listed in the following table.
Table 326: Format Menu Options
Choice
Description
Copy Binding
Copies the selected symbols binding information, which you can then paste to a new symbol.
With this feature, you can easily bind several symbols to one object.
Paste Binding
Copy Format
Copies the selected symbols formatting (size and font information), which you can then paste
onto another symbol. This allows you to easily format multiple symbols in the same way.
Paste Format
Align
The Align menu choice contains the choices listed in the following table.
Table 327: Align Menu Options
1
Choice
Description
Align Top
Aligns all symbols to the top most edge of the first symbol you selected.
Align Bottom
Aligns all symbols to the bottom most edge of the first symbol you selected.
Align Left
Aligns all symbols to the left most edge of the first symbol you selected.
Align Right
Aligns all symbols to the right most edge of the first symbol you selected.
Aligns all symbols to the horizontal center of the first symbol you selected.
Aligns all symbols to the vertical center of the first symbol you selected.
When you select multiple objects by dragging the mouse across them, the first selected symbol is not based on the symbol's
location within the graphic, but on the order in which it was originally added to the graphic. We recommend that you first click
on the symbol with which you want to align other symbols. Once you have selected that symbol, hold down the Shift key
while you drag the mouse across additional symbols to select them (you can also use Shift + click to select additional symbols).
602
Right-Click
Button
Navigate to hyperlink.
Navigate to hyperlink.
Select
Select
Gauge: Dial
Select
Dynamics: Fan
Select
Select
Dynamics: Switches
Select
If you select a Graphic Object in the navigation tree and then drag a button to the graphics workspace, the UGT
creates a button already bound to the selected Graphic object.
If you select multiple field points in the Navigation Tree and drag a Value Display Box to the graphics workspace,
the UGT creates multiple Value Display Boxes each bound to a field point.
If you select multiple field points in the navigation tree and drag a dynamic symbol or gauge to the graphics
workspace, the UGT creates multiple symbols each bound to a field point.
If you select multiple field controllers along with a Graphic object in the navigation tree and drag a button to the
graphics workspace, the UGT creates buttons for all the controllers. All buttons have the appropriate Alias string
already entered.
To change the binding information for a symbol or to add binding information (if you drag and drop a symbol
without selecting anything in the navigation tree), see Binding Symbols to Objects in Edit Mode.
603
Item/URL/Application
If you link the button to a URL, type the address here. If you link to an item or application, click
and see below. Applications configured using the Metasys Preferences Applications Tab
appear on the drop-down menu.
604
Hides the button in the View mode, creating a virtual hyperlink on the background image.
Alias
Passes the defined Alias string to the linked graphic when you press the button.
Properties
Displays a dialog box to change font size and text justification for the button label text.
OK
Accepts changes.
Cancel
Cancels changes.
Allows you to type in the Item Reference of the object you want to bind to the Value Display
Box. Or, lets you click
Display Box.
Attribute
Allows you to select the specific attribute to bind to the Value Display Box. The bound attribute
is initially set to the object's Default attribute, which varies per object type, but is typically
Present Value.
If an object does not have a Default attribute, the value box displays ???? on the graphic until
you change the binding to a different attribute.
You can bind to string values or to numeric values.
Units
Shows the Units for the bound object in the Value Display box.
Status
Shows the Status for the bound object by color-coding the text and background for the Value
Display box.
Properties
Allows you to configure the text properties for the Value Display Box text.
OK
Accepts changes.
Cancel
Cancels changes.
Note: In the View mode, double clicking on the Value Display box displays the focus view for the bound object.
Right-click displays the commands.
605
Allows you to type in the Item Reference of the object you want to bind to the Analog Fill
Gauge. Or, lets you click
Fill Gauge.
Attribute
Fill Color
Launches the fill color selector to select the color displayed by the bar graph.
Orientation
High Limit
Sets the high number for the display range of the gauge.
Low Limit
Sets the low number for the display range of the gauge.
Units
Status
Displays the status of the object in the display box of the symbol.
Properties
Allows you to configure the text properties for the text in the display box of the gauge.
OK
Accepts changes.
Cancel
Cancels changes.
Allows you to type in the Item Reference of the object you want to bind to the Dial Gauge. Or,
lets you click
to launch a tree browser to select the object to bind to the Dial Gauge.
Attribute
Gauge Color
Launches the color selector for the gauge to select the color displayed in the center of the
gauge.
High Limit
Sets the high number for the display range of the gauge.
Low Limit
Sets the low number for the display range of the gauge.
Units
Status
Displays the status of the bound object in the display box of the gauge.
Properties
Allows you to configure the text properties for the text in the display box of the gauge.
OK
Accepts changes.
Cancel
Cancels changes.
606
Dynamics: Fans
To bind Fan symbols to objects:
1. Double-click the Fans symbol. The Binding Information dialog box appears.
2. Use the information in the following table to edit the fields.
Table 333: Fan Dynamics Options
Field
Description
Allows you to type in the Item Reference of the object you want to bind to the Fan. Or, lets
Object
you click
Attribute
Accepts changes.
Cancel
Cancels changes.
Object
to launch a tree browser to select the object to bind to the Basic Shape.
Allows you to select the objects attribute to bind to the Basic Shape.
State 0
State 1
State 2
State 3
Orientation
For the triangle basic shape, chooses the position of the point (Up, Down, Left, or Right).
OK
Accepts changes.
Cancel
Cancels changes.
The default color is determined by the preferences. See Graphic Settings Tab in the Preferences section for details.
Dynamics: Switches
To bind Switch symbols to objects:
1. Double-click the Switch symbol. The Binding Information dialog box appears.
Metasys SMP Help: Insert Menu
607
Object
you click
Attribute
Number of States
State 0/1/2
OK
Accepts changes.
Cancel
Cancels changes.
Depending on the symbol you are adding, be wary if items are selected in the navigation tree. Some
symbols automatically bind to items selected in the tree. See the Symbols topics for more information on
drag and drop capabilities.
For more information on drag and drop binding shortcuts, see Drag and Drop Shortcuts.
608
2. Click the workspace to select a location for the text. The text block appears.
3. Click the Select icon from the toolbar and double-click on the text block. The edit text box appears.
4. Type in the text box and click OK.
5. Select the Select icon on the UGT Toolbar.
6. Select the text block and drag the sides to resize the block.
Editing Text Blocks
To edit text:
1. With the selection pointer tool, double-click on the block. The block opens for editing.
2. Change the text and click OK.
3. To change the text properties, right click on the text block and select Properties from the menu.
Note: You can change the font (type, size, bold, italic, bold italic), text color, background color, and border
visibility/color.
Editing a Background Image
Use this procedure if you want to edit a background of a graphic by exporting it from the UGT. Use this method when
a copy of the existing background image is not available.
1. Drag the desired graphic from the Navigation Tree to the display panel.
2. Click the Edit button on the UGT Toolbar to enter Edit Mode.
3. Click the Save Background Image icon on the UGT toolbar to save the static background image to a location on
your hard drive. The Save dialog box appears.
4. Enter a name for the background image, select the desired location on your hard drive, select JPG or SVG
format, and click Save.
5. Open the background image file in the desired graphic editing program. Edit the background image as desired
and save the file in SVG, SVGZ, or JPG format. See the Static background image section for information on
supported file formats.
Note: You can only save a background image under its original file type. For example, if the background image
was originally a JPG, you can save it only as a JPG now. You can save SVG and SVGZ files as SVG or
SVGZ.
6. Return to the graphic in the UGT.
7. Click the Set Background Image icon on the UGT toolbar to import the revised background image file into the
graphic.
8. Save the graphic.
9. Download the graphic to the online device (if you have created the graphic with the Metasys software offline
using the SCT). Upload the graphic to the archive database of the SCT (if you have created the graphic with
Metasys software online).
Note: Save a copy of the background image file in a folder on your hard drive as a backup method. If you decide
to edit that background image later, you can edit your hard drive copy and use the Set Background Image
icon to re-import the background into the graphic in the UGT. You also can use your hard drive copy in the
event that you lose your databases and need to recover the background image.
609
Creating Aliases
See Alias for more information on aliases.
Note: Do not set the Graphic attribute for an alarm extension to an aliased graphic. Aliased graphics do not display
properly when displayed from the Alarms Window or Event Viewer.
1. Create a graphic with an appropriate background image, and add value boxes to represent common field points.
2. For each value box, edit the bound reference and use a wildcard character (*) to replace the portion of the
reference specific to a particular supervisory device, field trunk, and/or field controller.
For example, change the bound object reference for a Zone Temperature AI from ADS 1:NAE1/N2 Trunk
1.VMA-1.ZN-T to *.ZN-T. This is your aliased graphic.
Note: One wildcard character is allowed per reference, and all wildcard characters used in bindings for a
particular aliased graphic must represent the same string.
3. Create a separate main graphic to use as the access point for your aliased graphic.
4. On the main graphic, add a button bound to the aliased graphic. Give the button a name indicating the field
device it represents (see Tip below).
5. Set the alias string for the button to the text that should replace the wildcard in the reference for the value boxes
on the aliased graphic.
For the example above, the alias string would be:
ADS 1:NAE1/N2 Trunk 1.VMA-1
6. Repeat Step 4 and Step 5 to add buttons for additional field controllers, setting the alias string appropriately for
each.
For example, ADS 1:NAE201/N2 Trunk 2.VMA-43.
Tip: You can use the following shortcut steps to quickly create the buttons for your aliased graphic on your
main graphic:
a. Display your main graphic in the Display panel, and click Edit.
b. Select the aliased graphic in the All Items navigation tree, then use Ctrl + click or Shift + click to select the
items to use with the aliased graphic.
For the example given earlier, select VMA-1 under N2 Trunk on NAE1, and VMA-43 under N2 Trunk 2 on
NAE 201.
c. With the aliased graphic and other items selected in the navigation tree, drag the Button from the UGT palette
into the graphic display area. A new button appears in the main graphic for each item. Each button is labeled
with the item name, bound to the aliased graphic, and has its alias string set to the full reference of the
selected item (for example, ADS 1:NAE1/N2 Trunk 1.VMA-1).
d. Find the button on the main graphic that has its alias string set to the aliased graphic (labeled with the name
of the aliased graphic). This button is no longer needed, so you may delete it.
e. Save your changes.
Once you have finished configuring your main and aliased graphic, display the main graphic in the online UI. Use
the buttons on the main graphic to open the aliased graphic for each field device. See Figure 63 and Figure 64.
Saving a Graphic
To save a graphic, click the Save button on the Toolbar.
610
Graphics+
Graphics+ files created with the Graphic Generation Tool (GGT) provide comprehensive and three-dimensional
views of building automation systems that allow you to monitor the status of a single building or an entire campus
of buildings. Unusual conditions are quickly identified on a dashboard screen that can navigate deep into a building,
floor, or zone. With minimal navigation, you can diagnose a problem and take corrective action. You can view
historical data directly within the graphic, further enabling effective problem diagnosis. You can also issue commands
from the graphic.
Graphics+ files are created offline with the GGT, a stand-alone application that runs on a computer with a supported
Microsoft Windows operating system. These graphics are then saved as Metasys objects (typically on the Site
Director) and viewed within the Site Management Portal UI or Ready Access Portal UI in any active display panel.
Graphics are usually made up of three parts:
You can access a graphic when you are logged in to the Site Management Portal UI via any Web browser. The
XAML Graphic Object represents a Graphics+ object in the All Items navigation tree. You can open these graphics
in any active display panel.
For information about Graphics+ symbol and element functions, refer to the Graphics+ Runtime Help (LIT-12011708).
For information about creating and editing Graphics+ files, then saving the graphic to an online device (ADS, ADX,
or supervisory controller) or offline to an SCT archive database, refer to the Graphic Generation Tool Help
(LIT-12011697).
Graphics+ Concepts
Graphics+ View
Graphics appear in the navigation tree as stand-alone items. You can access graphics from a Tailored Summary,
the Alarm Pop-ups window, or the Associated Graphic tab of a Field Controller device. The
symbol identifies a
Graphics+ graphic. When you open the graphic, a Display Control tool appears in the upper left corner of the active
display panel. Use the Display Control to zoom and pan a graphic. You can also open the Trend Module from this
control. See Figure 65 and Table 336 for details on the Display Control tool.
611
Collapse
Hides the Display Control tool. After you hide the tool, a faint arrow
appears that allows you to restore the tool.
Fit to Window
(center block)
3
Allows you to zoom by moving the ball clockwise (zoom in) and
counterclockwise (zoom out) along the zoom ring.
Enables and disables the panning tool that allows you to move the
graphic in the workspace.
Allows you to pan up, down, left, and right over the graphic in set
increments.
Enables and disables the manual zoom (magnifying glass) that allows
you to re-center the graphic and zoom in an out.
Tools Menu
Drops down a list of Tools. At this time, only the Trend Module is
available.
612
Trend
Opens and closes the Trend Module. This option appears when you
click the Tools down arrow.
10
Allows you to move the Display Control tool to a different area of the
graphic.
Navigation
You can navigate between graphics using various types of elements of a Graphics+ graphic or by opening the desired
graphic from the navigation tree. You can restrict user access to specific graphics by setting security levels in the
Security Administrator System.
You can also create user views that contain only graphics (hierarchy of graphics references).
Commands
You can command objects that are bound to graphic symbols using two methods. The first method is to left-click
the objects Inline Command Box or Advanced Value Box, then edit the value of the object. If commanding is disabled
for that symbol, the value is not be editable. The second method is to right-click the objects Inline Command Box,
Advanced Value Box, or other elements of Graphics+ symbols such as gauges, to open the User Actions Panel,
then select More Commands to bring up the Metasys commands dialog box. With both methods, if you are not
authorized to command the object, the command selection is disabled.
User Actions Panel
You can open the User Actions Panel for a graphic element by right-clicking the graphic element. The User Actions
Panel is a submenu of options that appears adjacent to the graphic element (Figure 66). The panel in the Site
Management Portal UI supports three actions: View, Command, and Trend (SCT only supports View; Trend only
appears for trended objects). To view the Focus window for the object, select its name (for example, ZN-SP). To
command the object, select More Commands. To view trend data for the object in the Trend Module, select View
Trend. If more than one attribute is trended, select View Trend, then click the attribute name. User access to all three
actions is set with security levels in the Security Administrator System.
Figure 66: Opening a User Actions Panel
Behaviors
Many elements of Graphics+ graphics support built-in or configurable behaviors.
Elements that support behaviors can flash if the bound object is in an alarm or warning state, change color based
on the bound object's state or status, or show or hide depending on the bound object's state or status.
613
In the Metasys UI, the elements of the Graphics+ graphic display the behaviors as the bound object's state or status
changes.
Note: Support of behaviors is limited in SCT.
Trend Module
From a Graphics+ object, you can view trended data for any object in the Site Management Portal UI with the Trend
Module. The object must be displayed in the graphic and have at least one trend extension defined. Examples of
graphic elements that support the Trend Module include any value box (for example, Basic Value Box, Inline Command
Box, and Key Data Item), any basic shape, the LCD display in the Room Control Module, gauges, and the Room
Status element. The Trend Module shows trend data from the devices online buffer, not from archived samples
stored in a historical database.
Opening the Trend Module
To open the Trend Module for an object on a Graphics+ graphic, click View Trend from the elements User Actions
Panel. The Trend Module appears with the charted trend data. If more than one trended attribute is available, click
View Trend to display a submenu that lists all available trended attributes. Click a trended attribute to open the Trend
Module.
Figure 67: Selecting a Trend to Add to the Trend Module
If you want to open the Trend Module without adding or changing its content, click the Tools drop-down arrow on
the Graphics+ Display Control tool and select Trend. The Trend Module reappears in its last state and condition.
614
615
616
Plot Area
Plots the trend data for all objects added to the Trend Module.
Box Zoom
Zooms in for the area that is highlighted. To enable box zoom, place the cursor
inside the plot area, hold down the mouse and drag left or right. A white shadow
appears to outline the zoom area.
Callouts
Indicates the name of the trended object with its value at the selected moment in
time (white vertical line).
Maximize
Changes the size of the Trend Module to its maximum size within the constraints
of the Metasys display panel.
Close
Zoom Out
Returns the chart to its original size. This option is only available if the chart is
currently zoomed in.
Right Y Axis
Indicates the axis that is plotting the discrete states for objects currently displayed
in the Trend Module. Metasys objects that are displayed on this axis typically consist
of Boolean or multi-state values.
(state data)
8
Newest Date/Time
Displays date and time of the last value that appears on the chart.
10
Moment in Time
(X Axis)
Indicates the date and time of the value at a particular location on the chart. The
date/time information as well as a vertical moment in time line is displayed as
you move the mouse over the chart. The units along the x-axis always represent
time.
11
Oldest Date/Time
Indicates the date and time of first sample that appears on the chart.
12
13
Left Y Axis
Indicates the axis that is plotting the numeric values for objects currently displayed
in the Trend Module. Metasys objects that are displayed using this axis typically
consist of analog values.
(numeric)
14
Scroll Bar
Adjusts the range of data that appears on the chart. Also zooms in and out when
you resize the scroll bar. To zoom, click and drag the left/right arrows of the scroll
bar. To pan, drag the scroll bar left or right.
15
Refresh
Updates the trend data for all objects shown in the Trend Module.
617
618
Resizes the space taken by the legend. Move the splitter to the bottom
or double-click the splitter bar to hide the legend and increase the size
of the trend chart.
Legend Icons
Display both the color and the y-axis that is used to display the trend
data for the trended object in this row of the legend. The legend color
assigned to an object matches its trended values in the chart, so that
you can correlate information between the legend and the chart.
Four preset trend line colors are used: blue, orange, violet, and white.
The colors cannot be customized. These icons are used:
The forward facing L indicates that the left y-axis is used for this
trend series, which displays numeric values.
The backward facing L indicates that the right y-axis is used for this
trend series, which displays state values.
Show/Hide Trend
Selects which objects currently appear in the chart. Click this box to hide
and unhide trend data.
Object Name
Displays the name for the trended Metasys object. When you click the
object name (or its row), the corresponding line in the chart is highlighted.
Trend Name
Displays the name of the trend that appears in the chart. If more than
one trend is available for this trended object, a drop-down box appears
from which to select.
Navigate
Navigates away from the Trend Module and the graphic and opens the
trend data for the attribute. If you are not authorized to view the object,
the navigate button is disabled.
Remove
Removes the trended object and its associated data from the Trend
Module.
Loading Indicator
A loading indicator (
) appears in the chart area while the system is retrieving trend data.
619
Legend Operations
Once the trend data is plotted, use the check boxes in the legend to hide or unhide trend values from appearing in
the chart. If you want to remove the trended object from the legend and the chart, click the remove ( ) button.
To highlight a specific trend object and its data, click on its name in the legend. This action sends the selected series
and its associated y-axis information to the foreground of the chart.
If you try to plot a trended attribute that was deleted or whose object is offline, its legend icon is blank and a user
message box appears.
Figure 71: User Message: No Trend Data Available
A maximum of 500 data points can be displayed for a single trended object. No data older than 2 years can be
displayed.
The trend data originates from the devices online buffer; samples stored in a historical database such as the
JCIHistorianDB archive database are not included.
You can open only one Trend Module per graphic.
The Trend Module can chart a maximum of four trended Metasys objects. If you try to plot a fifth object, a user
message box appears.
620
The Trend Module does not support nested trend extensions. For example, the Trend Module cannot chart
totalization extensions that contain a trend extension.
You cannot save the Trend settings for later use. Once you close the graphic, you need to select the objects for
the trend module again.
Refresh Function
The Trend Module does not automatically refresh with new data samples. Use the refresh button to display the latest
trend data within the Trend Module.
Error Handling
If an error occurs while stored trend samples are retrieved (for example, the bound trend object does not exist or its
supervisory device is offline), the chart line for this trend series does not appear. The error message Could not
retrieve trend information appears as a tooltip for the existing legend item.
Graphics+ Steps
Viewing Graphics
To view a graphic, double-click or drag the Graphics+ object from the Navigation Tree into the Panel Layout.
Monitoring and Commanding Items Using Graphics
Note: The Site Management Portal UI provides the capability to monitor and command the Metasys system from
a graphic.
To monitor your Metasys system using graphics:
1. Open a graphic to display the current status/state of system components.
2. Navigate through the system.
3. To command Metasys objects or items using graphics, right-click the graphic element to open the User Actions
Panel and click More Commands. Select from the available commands. To change the value of a Metasys object
or item from an inline command box, click inside the box, type a new value, and press Enter. For information on
the runtime behavior of a particular graphic element, refer to the Graphics+ Runtime Help (LIT-12011708).
Metasys SMP Help: Insert Menu
621
Navigating Graphics
To navigate graphics, click the image or navigation button in the graphic to navigate to the linked graphic.
Opening the User Actions Panel from a Graphic
To open the user actions panel from a graphic:
1. Open a Graphics+ object to display the current status and state of system components.
2. Right-click the graphic element. The User Actions Panel that applies to the object appears. If no panel appears,
this element does not support the User Actions Panel. Supported elements include value boxes, room status
elements, the LCD display within a Room Control Module, basic shapes, and gauges.
3. Select an action.
Opening the Trend Module from a Graphic
Note: You can open the Trend Module from a User Actions Panel or from the Graphics+ Display Control tool.
1. Open a Graphics+ object.
2. To open the Trend Module from a User Actions Panel, right-click a graphic element to open its User Actions
Panel. Supported elements include value boxes, room status elements, the LCD display within a Room Control
Module, basic shapes, and gauges.
3. Click View Trend. If more than one trend is available, click View Trend, then select from the list of trended
attributes that appear in the submenu. The Trend Module loads and plots the trend data.
Note: If View Trend does not appear in the User Actions Panel, this object has no trend extension.
4. For more details, see Trend Module.
5. To open the Trend Module from the Graphics+ Display Control tool, click the Tools drop-down arrow. The Trend
option appears.
6. Click Trend. The Trend Module appears either blank (no trend data selected) or replots the trend data for the
objects you selected earlier.
Graphic Object
The Graphics object defines the attributes that represent a defined user graphic for a given set of objects. Graphic
objects must exist under a container object or under another Graphic object (this allows you to link graphics together).
For detailed information on the User Graphics Tool, see User Graphics Tool (UGT).
622
Graphic Attributes
This object contains attributes common to many Metasys system objects. These common attributes are described
in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab, the
Diagnostics tab (if applicable), and any other tab specific only to this object. See the Object and Feature Tabs section
for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options
tab appear on point objects).
Table 339: Graphic Object Attributes - Focus/Configuration Tab
1
Attribute Name Data Type
Initial
Values/Options/Range Attribute Description
Notes
Value
File Name
Set of related
values
Element Data
Name
Type
Initial
Value
Exportable True or
False
value
False (0)
Object
List of
Reference References
References True or
False
value
Relative
Path
False (0)
Text
W - Writable
Data Type
Initial Value
Exportable
False (0)
Object Reference
List of references
References
Relative Path
Text
False (0)
Relative Path
The name of the file relative to the directory containing the .moi file for the device.
623
Trend Studies
Menu Selection: Insert > Trend Study
Inserts a trend study into the site.
Tip:
or
With the Trend Study tab selected on the Configure Screen, select the
trend items.
Select the Configuration tab on the Configure screen for further configuration.
The Metasys Historical Data Management feature allows you to collect and store historical samples of Engine object
data. Metasys Trend Studies allow you to view the historical data. Using this information, you can manage energy
usage, bill tenants, prove compliance to standards, and diagnose problems in your Metasys system. You can also
trend attributes of system objects. With the addition of an ADS Device Object to your network, the Metasys system
provides long-term storage of historical data and you dramatically increase storage capabilities.
See the Site Object and Engine Device Object.
The Engine allows you to add Trend Extensions to objects. The Trend Extension contains all of the trend definition
information associated with the object. Each trend is associated with a single attribute of that object and collects
historical data samples of that attribute. With Trend Extensions, data is collected in the Engine only, but you can
configure the Engine to transfer the data to the ADS/ADX for long-term storage. For more information on extensions,
see Extensions.
Do not confuse the trend study with the Trend Viewer or Trend Extension. For information on Trend Extensions or
the Trend Viewer, see the Trend Extensions and Trend Viewer sections .
For performance information on trends, refer to the Metasys System Configuration Guide (LIT-12011832).
624
Note: You do not need an ADS/ADX on the site to forward trend samples to an ADS/ADX . You can forward trend
samples to an ADS/ADX on a different Metasys site. See the ADS Device Object for ADS/ADX information.
Views
There are three views in the Trend Study: Chart View, Table View, and Definition View.
Table 342: Views
Button
View
Description
Chart View
Table View
Definition View
Allows you to view the Trend Study setup and display options.
625
(Zoom)
Description
Update
Retrieves the most recent data samples for the displayed trends.
Zoom
Toggles the mouse behavior for the chart between zoom mode and normal
mode.
(Normal)
drag the mouse over an area of the chart to zoom in on that area.
click Zoom to exit zoom mode and restore the mouse to normal mode.
When you exit zoom mode, the chart remains at the current zoom level. Use
the Restore button to fully zoom out on the chart.
Note:
You cannot pan while the mouse is in zoom mode.
You can also zoom and unzoom in normal mode by using the Shift key
and the mouse. To zoom, hold the Shift key down while dragging the
mouse across the chart. To zoom out one level, left-click the mouse while
holding the shift key down.
Restore
Pan
Allows you to pan the view of the chart vertically or horizontally by dragging
the mouse across a zoomed chart. Panning is not available for unzoomed
charts or when zoom mode is active. To pan left or right, drag the mouse
over the X-axis. To pan up or down, drag the mouse over the Y-axis.
Points Line
Displays the data using lines and point markers. The Points Line chart is the
default chart type in chart view.
Area
Bar
Points
Line
Stacked Y-axis
Single Y-axis
626
Opens the Select a Color dialog box and allows you to configure the background color.
Y-axis Scale
X-axis Scale
Gridlines
Allows you to select what type of gridlines to appear on the chart. You can choose: None, X
and Y, X Only, and Y Only.
Chart Type
Allows you to select what type of chart to display. You can choose: Points Line, Area, Bar,
Points, and Line.
Stacked Y-axis
Chart Legend
The Chart Legend appears below the graphical charting area. The Chart Legend displays the list of trend items for
the Trend Study in a table, and includes information about each item.
Table 345: Legend
Button/Field
Name
Description
Select All
Selects the maximum number of trend items for display in the chart.
Show
Indicates if the trend item appears in the Chart. When checked, the data
appears on the chart and in the table. When unchecked, the data does not
appear in the chart or table.
Indicates the trend was selected from the ADS/ADX Historical Database folder.
Marker
Indicates the appearance of the marker style and color for the trend item on
the Chart.
Color Palette
Displays the Select a Color dialog box. Allows you to change the color used
to chart the trend data.
Name
Reference
627
Name
Description
Update
Copy to Clipboard
Allows you to copy selected trend data to the system clipboard for
pasting into other applications such as Microsoft Excel. You can also
use Ctrl + C to copy selected trend data.
The Historical Trend Icon appears in the Table View column headings when applicable.
Chart Display
Refresh rate: specifies the amount of time, in seconds, for automatic refresh of data. You must configure
this attribute with a value of 0 seconds, 60 seconds, or greater than 60 seconds. Values 1 to 59 are
invalid and not allowed. 0 means manual refresh. If the refresh rate is 0, click the Update button to
display new data.
Display precision: specifies the decimal point rounding and the number of decimal places used to
format real values that do not report a display precision. If the value reports a display precision, this
Trend Viewer attribute is ignored in favor of the values native display precision.
Specifies the Start Time and End Time for the Trend Study.
Radio Buttons: Allows you to choose relative time or absolute time for the Study Range (start and
end times). The fields enable depending on which one you select.
Absolute Time: Select either Today or Now. If you select Today, enter the Relative Time. If you choose
Now, specify an Offset.
Relative Time: Allows you to choose the relative time for the Study Range.
Offset: Represents a combination of a whole number of days, hours, minutes, and seconds before or
after (- or +) the current date and time.
Allows you to add gridlines, stack the Y-axis, and choose the chart style for the Trend Study.
628
Description
Indicates the trend was selected from the ADS/ADX Historical Database folder.
Add
Opens the Select Item dialog box and allows you to add trend items to the
Trend Study. This button only enables when the view is in edit mode.
Note: All items and navigation trees appear in the Select Item window; however,
you can only select trends. All other items appear dimmed.
Remove
Allows you to remove a trend item from the Trend Study. This button only
enables when the view is in edit mode.
Name
Reference
Aggregate Function
Allows you to select the aggregate function to use on the trend sample data
(NONE, Average, Minimum, Maximum, Standard Deviation, Range, Sum, and
Variance). You can sample the same point for different aggregate functions
and display them on a single chart.
The aggregate functions of the trend study apply to information in the Historical
Data at the ADS/ADX Server and do not apply to data in the NAE buffer.
Aggregate Interval
Specifies the time, in minutes, over which the aggregate function should be
applied (for example, 60 for an hourly calculation, or 1,440 for a daily
calculation).
Plotting Style
Allows you to select the plotting method for the trend item.
Discrete - line stays at the same value until the next data sample is taken
(good for binary data). Discrete plotting has 90-degree angles at the time
when samples change value. The chart appears to be a series of steps.
Study Range
The Study Range is the time period used to filter trend data. The Trend Study gathers and displays the trends that
are taken during this time period.
Default Destination
The ADS Repository defines where trend samples are sent when the local trend buffers reach their defined Transfer
Setpoint (see the Trend Extensions section), the Engine defined ADS Delivery Time (see the Engine Device Object)
is reached, or the user initiates a transfer. You can initiate a transfer by using the Trend Extensions Route command.
Note:
You do not need an ADS/ADX on the site to forward trends to an ADS/ADX . You can forward trend
samples to an ADS/ADX on a different Metasys site. The off-site ADS/ADX that receives forwarded trend
samples must be the site director of its site.
You can define only one repository as the default destination for each Engine.
For more information on ADS/ADX default trend destinations, see Configuring the ADS/ADX as the Destination for
Trend Data.
629
If you have a site with an ADS/ADX and engines, and you create a Trend Study on an engine (rather
than on the ADS/ADX ), any trend items added to the trend study from the ADS/ADX s Historical DB
folder is listed with the current site name in their references instead of their actual site names.
When referencing trend items that were forwarded from an off-site device, create the trend study object
on the ADS/ADX , rather than on the engine.
630
7. Click OK. See Adding New Trend Items to the Trend Study.
8. Click Save.
9. Click the Chart or Table buttons to see trended data in the specific format.
Note: If nothing appears in the chart or table, check to see if you have samples in your study range and adjust
if necessary.
Editing Trend Studies
1. View the Trend Study.
2. Click the Definition View button.
3. Click the Edit button.
4. Make your changes using the table in the Trend Study Definition View section, including adding new Trend Items.
5. Click the Save button to save the changes.
Viewing Trend Studies
Note: To create Trend Studies, see Creating Trend Studies (Overview).
1. From the navigation tree, drag and drop the Trend Study you want to view to the Panel Layout.
2. Select the Definition View button to edit the Trend Study. Select the Chart View or Table View buttons to view
the trend data.
Note:
The UI limits the number of data samples you can retrieve. Therefore, you may not see the full range
specified. The most recent data samples are always retrieved first.
If the chart appears to flicker, you have too many trend samples in the Trend Study. Reduce the number
of displayed trends or change the trending date/time range to display fewer samples and improve
performance. See Deleting Trends from the Trend Study.
button in the Trend Items table. The Select Item dialog box appears.
631
5. Select the trend(s) that you wish to add from the Select Item dialog box.
Note:
You are limited to dates and times between the start and end dates configured in the Trend Study
definition.
When you select Use Automatic Range Calculation, you do not fill in the Range fields.
4. Specify the Start Time, Start Date, End Time, and End Date.
5. Click OK.
Note: You can also configure the X-axis range by changing the start and end dates and times in the Definition View.
See the table in the Trend Study Definition View.
Configuring the Y-axis
To configure the Y-axis in the Chart view:
1. Place your cursor on the chart and right-click.
2. Select the Y-axis Scale menu item. The Range Configuration dialog box appears.
3. If you are using stacked Y-axis, choose the trend item to which the Y-axis range should be applied from the item
drop-down list.
4. Specify whether to Use Automatic Range Calculation. The Range is determined automatically based on the trend
items.
Note: When you select Use Automatic Range Calculation, you do not fill in the Range fields.
5. Specify the minimum and maximum values for the Y-axis.
Note: When you use stacked Y-axis, click Apply to apply the changes to a specific trend item. You can continue
setting the ranges for other trend items in the Range Configuration dialog box.
Metasys SMP Help: Insert Menu
632
6. Click OK.
User Views
User views (user-defined navigation trees) contain references to selected items found in the All Items navigation
tree (the default navigation tree). For example, you could create a user navigation tree with all the AIs grouped
together, or a navigation tree that contains only points for a certain area of a building. User views are useful for
restricting access for certain users and grouping commonly used items/graphics together. User Views are necessary
to apply the Ready Access Portal UI, as only User Views assigned to individuals are visible from this UI. You can
use the user view edit capabilities to easily consolidate small user views into a larger view, or to break large user
views into multiple smaller views. Specify the User View navigation display as either a set of tabs (Tabbed) or a
drop-down list (List) in the Default navigation display preference in the Display Settings Tab in the Preferences
section. We recommend list view if the system has many user views, as list view takes up less space in the navigation
tree pane. User views provide a mechanism for viewing Tailored Summaries. See the Tailored Summaries section
in the Metasys SCT Help (LIT-12011964) for more information.
User views are easy to create. The system supports drag-and-drop functionality of items from the Global Search
Results table to add them as references in a User View. To do this, view both the Global Search Viewer and the
User View in the display frame (using a multiple panel view). Click Edit in the User View. Then drag the desired
items from the Search Results table to the User View. The system also supports drag-and-drop functionality to add
references to items from the navigation frame (User View [online] or All Items tree) to a User View in Edit mode. In
addition, to add an entire tree (only from the navigation frame) to a User View, press the Ctrl key and drag and drop
the tree to a User View in Edit mode.
For more information on the wizard used to create a user view, see the New User View section. For more information
on the object created by this wizard, see User Navigation Tree.
The Security Administrator System allows administrators to assign user view permissions to specific users (in the
Online UI only). For information on the Security Administrator System, see Related Documentation.
User Views Concepts
User View Behavior by Mode
User views appear and function differently, depending on what mode you are in (Table 349).
633
Behavior Notes
Offline (SCT)
drag and drop the user view into the Display frame for editing
drag and drop the user view into the Display frame for
viewing
Online (Standard
Access)
Simulation
drag and drop the user view into the Display frame for editing
634
from the All Items view into a user view, you cannot nest anything under
When you add a reference to a folder
it.
Graphic references may contain any number of additional graphic references.
With the exception of graphics, references may only be nested under user view folders (that is, a non-graphic
reference cannot be a child of a reference). References do not need to be nested to exist in the User View.
Any item may be referenced any number of times within the user view hierarchy.
When creating user views for the Ready Access Portal UI, keep in mind that Ready Access Portal users navigate
their site using only user views.
To take advantage of the alert filtering capabilities in the Ready Access Portal UI, create a dedicated user view
to use with only the alert filters. For example, add folders with an Engine under each folder that is named for the
location the Engine serves.
In the Ready Access Portal UI, add the device and schedules in a user view so that the link for a device summary
works, and a selected schedule appears in a summary function.
Adds one or more items to the user view. When you add a reference to an item
that has children in the navigation tree, the children are not included in the user
view.
Add Tree(s)
Adds an entire user view, an entire folder hierarchy, or single item reference to
a user view. When you add an item using this button, you add the item and all
of its children to the user view.
New Folder
Creates a new folder in the user view. Use this button to add a folder to a user
view.
Remove
Removes anything you select from the user view. The Remove button removes
not only what you select, but all children of the item you select.
Move Up
Moves a selected user view item up in the user view. This button changes the
order of items in the navigation tree but does not nest items. See Drag and Drop
in the Table 351.
635
Moves a selected user view item down in the user view. This button changes
the order of items in the navigation tree but does not nest items. See Drag and
Drop in the Table 351.
Sort Ascending
Sorts the items in the user view in ascending, alphanumeric order. You can sort
items at any level in the user view (for example, the folders directly under the
User View or the contents of a folder). The items are sorted only one level down
(not subsequent levels).
Sort Descending
Sorts the items in the user view in descending, alphanumeric order. You can
sort items at any level in the user view (for example, the folders directly under
the User View or the contents of a folder). The items are sorted only one level
down (not subsequent levels).
Edit Label
Changes the label used for an item within a specific user view. Changing the
label for an item in the user view does not affect the items Name attribute or
reference, and does not affect the label used for other occurrences of the item
in the same or other user views.
To change the label for an item, triple-click the item or right-click the item and
select Rename.
Selects multiple items in the Select Item dialog box, which is displayed when you click Add Reference
or Add Tree.
Moves the selected reference or folder, and its nested items, to a new location within the user view.
When you are dragging an item to a collapsed folder, hover the mouse pointer over the collapsed
folder for a moment and it automatically expands. To change the order in which items appear within
a parent folder or under a graphic, see Move Up and Move Down in Table 350.
Note: You can drag and drop objects from the all items tree or any other user view into the user view
you are editing. When you drag/drop an object with children, only the parent object is added to the
user view.
636
Updates the first occurrence of the specified text in all references with the replacement (Replace with)
text. Enter the reference text and the new text and click Find. A list of references is generated. Click
Replace All to update all references, or select a reference and click Replace to update a reference
individually.
Updates the site identifier in all references to the site name where the user navigation view resides.
This value comes from the user navigation views full reference and is not editable in this dialog box.
Click Find. A list of references is generated. Click Replace All to update all references, or select a
reference and click Replace to update a reference individually.
Replaces the Engine or ADS/ADX device identifier in item references with a different device identifier.
All Device Names is entered by default, but you can specify a specific device name if desired. Enter
the new name and click Find. A list of references is generated. Click Replace All to update all
references, or select a reference and click Replace to update a reference individually. The device
identifier updates in the references for the selected item and its children.
You also can use the Find and Replace option in online mode to quickly duplicate user view hierarchies for supervisory
devices with similar configurations.
Note: The Select Item dialog box contains the set of views that appear in your navigation frame. Because user
views do not appear in the navigation frame in the SCT, these steps work only in online mode.
For example, perhaps you have several Network Automation Engines (NAEs)s on your site that have the same set
of N2 controllers and field points under their N2 trunks. You can create a user view to group your field devices and
field points for NAE-1 into a logical system-based or geographical hierarchy. You can then duplicate the NAE-1 user
view to create the same references and hierarchy for NAE-2.
Follow these steps:
1. Create a user view referencing NAE-1 items (for example, field devices and/or field points), organizing the items
in folders as desired.
2. Refresh all tabs in the navigation frame to update the navigation views displayed in the UI.
3. Create and edit a new user view for NAE-2, or edit the user view you created for NAE-1.
4. Add items to the new NAE-2 user view.
a. Click Add Trees (see Table 350) to display the Select Item dialog box.
b. In the dialog box, select the tab for the user view you created for NAE-1.
c. Select the items you wish to duplicate (choose the root node to duplicate the entire navigation view).
d. Click OK. The Select Item dialog box closes, and the selected items and their children appear in the NAE-2
user view.
5. Use the Find and Replace feature (Device Name Only in the Table 352) to replace the NAE-1 identifier with
NAE-2 in the references for the duplicated items.
6. Save your changes when finished.
User Views with Tailored Summaries
The Tailored Summary feature relies on the User View feature to provide a mechanism for viewing Tailored
Summaries. After defining Summary Definition objects, add them to a folder in the User View through the All Items
tree. Then view the Tailored Summary through the User View (that is, view the User View folder to display the
Tailored Summary). See the User View Editor, Workflow, and Defining User Views with Summary Definitions topics
in the Tailored Summaries section in the Metasys SCT Help (LIT-12011964) .
637
For information on the buttons and functionality in the Tree View tab, see the Tree View Tab section.
For information on the attributes in the Focus tab, see the Summary Definition Object.
4. Click Save when finished.
Deleting a User View
Note: You cannot create, edit, or delete a user view in online mode with Basic Access.
To delete a user view:
1. Select the user view in the User Views folder of the All Items navigation tree.
2. On the Edit menu, select Delete Items.
Metasys SMP Help: Insert Menu
638
3. Click Continue in the Delete Items Wizard dialog box. The user view disappears.
Consolidating User Views
You can consolidate multiple small user views into one larger user view.
Note: You must be in online mode to consolidate user views.
To consolidate user views:
1.
2.
3.
4.
5.
6.
Create a new user view, or edit an existing user view. This is the user view to which you add other views to
consolidate them.
With the user view in Edit mode, select the location (root or existing folder) where you would like to add the
contents of another user view.
Click Add Tree. The Add Tree(s) dialog box appears.
In the Add Tree(s) dialog box, select the tab for the user view you would like to add.
Select the root node of the user view you would like to add.
Click OK.
Note: You also can press the Ctrl key and drag and drop a tree (only from the navigation frame) to a User View
in Edit mode to add an entire tree to the User View.
A new folder, which contains the contents of the user view you selected, appears in the user view you are
editing. If you would like to rename the folder or move the children to another location within the user view, see
Table 351.
7.
8.
Repeat Step 1 through Step 6 if you would like to consolidate other user views into the user view you are editing.
When you are finished consolidating user views, click Save.
9. Refresh the tabs in the navigation frame and delete any user views you no longer need.
10. Have a Metasys Administrator adjust the navigation permissions for the consolidated user view (if necessary).
Breaking Up User Views
You can break up a large user view into several smaller views.
Note: You must be in online mode to break up user views.
To break user views:
1.
2.
3.
4.
5.
6.
7.
Repeat Step 2 through Step 5 if you want to move more content from the large user view to the new smaller
user view.
When you are finished with this new smaller user view, click Save.
8.
Repeat Step 1 through Step 7 to create additional smaller user views with content from the large user view.
639
9.
Refresh the tabs in the navigation frame and review the user views to make sure they contain the correct items.
Edit the new smaller user views as necessary.
Edit the large user view and remove the items that are now located in the new smaller views, if desired.
10. Refresh the tabs in the navigation frame.
11. Have a Metasys Administrator adjust the navigation permissions for the consolidated user view (if necessary).
640
Click the attribute name in the table for a description of the attribute.
Table 353: Summary Definition Object Attributes - Focus/Configuration Tab
1
Attribute Name
Data Type
Initial Value
Values/Options/Range
Notes
Key Data
1
List of Strings
CNW
List of Structures CW
CNW
Key Data
Holds the item name or Fully Qualified Reference of a key item to display in a tailored summary. You can configure
up to four key items.
Row Heading Column Text
Defines the text to display as the label for the row headings column (that is, the first column) in a tailored summary.
Tools Menu
Click one of the following menu items for a description of the menu item or perform a key word search for the menu
item in this PDF, using Ctrl+F. For a description of the Authorized Required column, see Authorized Menu Items.
641
Mode Visible In
Authorization Required
Online (Standard
Access)
Online (Basic
Access)
User Profile
Change Password
Administrator
Configure Preferences
GX-9100 (N2)
DX Commissioning (N2)
CCT (MSTP)
1
2
The Field Device Tools menu selection replaces the N2 Tools menu selection available at Release 2.0 and earlier.
To use the CCT in Ethernet passthru mode, open CCT from the Tools > Field Device Tools > CCT (MS/TP) menu option.
User Profile
Menu Selection: Tools > User Profile
Launches the current users properties for managing the users language, default navigation view, and other profile
settings.
Preferences
The Metasys system provides customized preferences for the user interface. The preferences allow you to configure
how the user interface behaves, including its sounds and colors, startup views, alarm priorities, and the ability to
add links to external applications that can be accessed from within the UI.
Some of the preferences defined in the Metasys Preferences dialog box also apply to the Ready Access Portal UI
and the Metasys UI. The Metasys Preferences Dialog Box section calls out such preferences.
Metasys Preferences Dialog Box
The Metasys Preferences dialog box is accessed through the Tools menu (Configure Preferences) and allows you
to configure system and user preferences. Users authorized to edit system preferences can edit all preference fields
using the Metasys Preferences dialog box. See Users Authorized to Edit System Preferences. Unauthorized users
can edit only user preferences.
Some of the preferences defined in the Metasys Preferences dialog box also apply to the Metasys UI and Ready
Access Portal UI. The following table calls out the tabs with such preferences. See the specific tab section for details.
Click the tab name in the table for a description of the Metasys Preferences tabs. For more information on the modes
of operation, see Metasys Modes. The Authorization Required column means you must be authorized to edit some
or all of the preferences located on that tab.
642
Applies to
Metasys UI
Authorization
Required
Access)
Access)
Graphic Settings
Tab
Display Settings
Tab
Applications Tab
Electronic
Signature Settings
3
Tab
Annotation
Settings Tab
Information Tab
1
2
3
Simulation mode uses the default preferences. Preferences are not configurable in Simulation mode.
Only settings that apply to the SCT are available.
This tab appears only for Metasys for Validated Environments (MVE) installations.
Information Tab
The Information tab displays messages regarding the current state of the preferences. This tab does not contain
configurable preferences.
Alarm Settings Tab
The Alarm Settings tab allows you to configure up to 10 alarm priority groups, each with a unique sound and a unique
color. The groups are based on the priority of the alarm. The Alarm Settings tab allows you to specify the alarm
sound interval. The alarm settings are system settings and therefore can be edited only by Users Authorized to Edit
System Preferences.
These alarm settings apply to the Site Management Portal UI (online mode). The alarm color preferences also apply
to the Ready Access Portal UI and the Metasys UI.
The alarm sound files can be Audio (.au) or Wave (.wav) files. The Metasys UI uses Wave (.wav) files for all web
browsers except Windows Internet Explorer. For Windows Internet Explorer, the Metasys UI uses the MP3 file
equivalent to the configured Wave (.wav) file.
Alarm sound files must be placed manually into the audio folder. Refer to the Configuring and Managing Preferences
appendix of the ADS/ADX Commissioning Guide (LIT-1201645) or the NAE Commissioning Guide (LIT-1201519)
for details. The Metasys system validates that the audio file exists on the device and is in a supported format. If
the audio file does not exist or is not in a supported format, the UI marks the audio file red. If the specified sound
file for a particular range of alarm priorities is missing, the UI uses the default system beep for those alarm priorities.
The UI uses the specified sound files for other alarm priorities if their sound files exist.
The Alarm Settings tab controls the sounds made by the Metasys system when an alarm is received; however, the
sound settings of the client computer control the volume of the audible alarms.
643
Note:
The client computer can only play sound files if a sound card is installed on it. If the UI does not detect
an installed sound card, it uses the default system beep, regardless of whether sound files are specified
and available.
To hear alarm notifications, you must also have Enable Audio Alarm selected in your User Profile.
The following table describes the attributes of the Alarm Settings tab.
Table 357: Alarm Settings Tab
Field Name
Description
Alarm Sound Interval
Specifies whether the system uses sound files with the four-level alarming feature or the system
uses the default system beep.
When true, the event viewer displays the event with a background color that is a translucent
version of the color specified for the priority level. The color that appears in the Alarm window is
not affected by this field.
Insert Button
Delete Button
Priority
Indicates the range of priorities of each priority level. The number of priorities is adjustable, but
in each case, the first priority begins at 0 and the next range begins one number higher than where
the previous range stopped, up to 255.
For example, the following describes the priority ranges if you had 4 priority levels:
The Level 1 range starts at priority 0 and ends at the number configured here.
The default Level 1 range is 039.
The Level 2 range starts at priority Level 1 + 1 (39 + 1 = 40) and ends at the number configured
here.
The default Level 2 range is 4079.
The Level 3 range starts at priority Level 2 + 1 (79 + 1 = 80) and ends at the number configured
here.
The default Level 3 range is 80139.
The Level 4 range starts at priority Level 3 + 1 (139 + 1 = 140) and ends at the number
configured here.
The default Level 4 range is 140255.
Audio File
Indicates the sound file that plays for each priority level when an alarm comes in. The default files
for levels 1 through 4 are alarm1.wav, alarm2.wav, alarm3.wav, and alarm4.wav, respectively.
Color
Allows you to customize the background color and text color for each priority level. The color you
specify here appears in the alarms window and in the event viewer.
1 , 2
1
2
If you click the Insert button, you can add priority levels. In this case, you can have more than four priority levels.
The sound files on a device are only used by the UI when you are directly logged in to that device. If a sound file is missing
from the device, the Metasys system uses the default system beep in its place.
644
Indicates the initial number of trends that are marked Visible within the Trend Viewer or Trend Study.
The range is from 1 to the value of the Maximum number of visible trends attribute. The default value
is 6.
Maximum number of
visible trends
Indicates the maximum number of trends that can be marked Visible within the Trend Viewer or Trend
Study. The range is from 1 to 10. The default value is 10.
Default chart
background color
Indicates the default background color of trend charts. The default color is light gray.
Click
to access the Select a Color dialog box. The Select a Color dialog box allows you to select
a custom color from three color palettes and to preview the color for the attribute.
Default chart grid
color
Indicates the default color of the grid lines of trend charts. The default color is white.
Click
to access the Select a Color dialog box. The Select a Color dialog box allows you to select
a custom color from three color palettes and to preview the color for the attribute.
Default line style
Allows you to select what type of gridlines appear on the chart. You can choose: None, X and Y, X
Only, and Y Only. The default value is None.
Legend initially
collapsed
Indicates whether the trend legend is collapsed when the Trend Viewer or a Trend Study is initially
opened. This attribute allows you to maximize screen space for viewing trend charts. The default value
is False.
Line
Line Color
to access the Select a Color dialog box. The Select a Color dialog box allows you to select
a custom color from three color palettes and to preview the color for the attribute.
Line Marker
Opens a drop-down menu and allows you to select a marker type for the line.
The Status Colors apply to value boxes, cells in Tailored Summaries, basic shapes (circle, triangle,
and square), and the Room Status symbol used in floor plan-based graphics. See the Analog Alarm
Extension for details on how these states are calculated.
Normal
Specifies the color used to indicate a status of Normal. The default color is white: RGB(255, 255,
255).
645
Specifies the color used to indicate a status of Out of Service. The default color is orange: RGB(255,
142, 25).
Overridden
Specifies the color used to indicate a status of Overridden. The default color is orange: RGB(255,
142, 25).
Trouble/Warning
Specifies the color used to indicate a status of Trouble, Low Warning, High Warning, or
Sensor/Actuator bus (SAB) Device Warning. The default color is yellow: RGB(255, 255, 0).
Offline
Specifies the color used to indicate a status of Offline. The default color is black: RGB(0, 0, 0).
Value Inaccessible
Specifies the color used to indicate a status of an inaccessible value (for example, communications
failed). The default color is gray: RGB(190, 190, 190).
Alarm
Specifies the color used to indicate a status of High Alarm, Low Alarm, Alarm, or SAB Device Alarm.
The default color is red: RGB(255, 0, 0).
Above Setpoint
Specifies the color used to indicate a status of Above Setpoint. The default color is pink: RGB(191,
0, 95).
Below Setpoint
Specifies the color used to indicate a status of Below Setpoint. The default color is blue: RGB(0, 0,
255).
Unoccupied
Specifies the color used to indicate an Unoccupied status. The default color is dark gray:
RGB(150,150,150).
Fan Status
The Fan Status colors allow you to customize the fan status color of the attribute that appears in
system graphics. The Fan Status colors apply only to fans.
Stopped
Defines the background color used for a fan symbol when its bound objects value indicates the fan
is stopped.
Stopped is defined as State 0 (for binary/multistate objects) or as zero (for analog objects).
The default color is red: RGB(255, 0, 0).
Running
Defines the background color used for a fan symbol when its bound objects value indicates the fan
is running.
Running is defined as State 1+ (for binary/multistate objects) or as non-zero (for analog objects).
The default color is green: RGB(0, 153, 51).
The Default State Colors settings allow you to customize the default state color of the attribute that
appears in system graphics. The Default State Colors apply to basic shapes (circle, triangle, square)
that are bound to a binary/multistate object. These default state colors can be changed for each
shape after it is added to a graphic.
State 0
Specifies the color used for the State 0 setting of a dynamic graphic symbol. The default color is
white: RGB(255, 255, 255).
State 1
Specifies the color used for the State 1 setting of a dynamic graphic symbol. The default color is
green: RGB(0, 153, 51).
State 2
Specifies the color used for the State 2 setting of a dynamic graphic symbol. The default color is
red: RGB(255, 0, 0).
State 3
Specifies the color used for the State 3 setting of a dynamic graphic symbol. The default color is
blue: RGB(0, 0, 255).
Specifies the color used for the All Other States setting of a dynamic graphic symbol. The default
color is light gray: RGB(204, 204, 204).
646
The Simple Symbol Flash settings allow you to customize simple UGT shapes (such as circles and
squares) to flash when their bound object is in alarm.
Flash Type
State Color/Alarm Color (Flashes between the State Color and Alarm Color)
State Color/Alternate Color (Flashes between the State Color and Alternate Color)
Defines the color used when flashing between the current color and an alternate flash color. The
default color is white: RGB(255, 255, 255).
Flash Rate
Defines the flash rate for graphics symbol flashing. The range is from 100 to 1,000 ms. The default
value is 250 ms.
Specifies how often (in minutes) the local time is synchronized with the server time. The range is 560
minutes. The default value is 30 minutes.
Hide unauthorized
commands
Indicates whether the Command window hides the unauthorized commands for the logged in user.
The default value is False, in which case the unauthorized commands appear dimmed.
Indicates the amount of time audits/events are considered new (based on their time of occurrence in
the Metasys system). The default value is 15 minutes. New audits/events are marked with a blue star
in the Event Viewer and Audit Viewer.
Query Results
Maximum results in
global search
Indicates the maximum number of rows displayed in the Global Search results view if the Site Director
is an NAE. The range is 10500 and the default value is 500.
If the Site Director is an ADS/ADX , the range is 102,000 and the default value is 500.
Note: Increasing the number of results in global search may have a negative impact on performance.
Print Settings
Default paper size
Specifies the default paper size (Letter or A4) to be used for printing. The default value is Letter.
Indicates whether the Advanced View is the default view when opening an item in the display panel
or a wizard. The default value is False.
If the user is not authorized to access the Advanced View, the Advanced View is not shown.
647
Indicates whether extended labels are displayed in the navigation tree on login. The default value is
False.
Default command set Specifies which types of commands are shown by default when the Command window opens. The
options are All Commands (default), Primary Commands, Secondary Commands, and Alarming
Commands.
Note: We recommend using Primary Commands as the default command set to reduce errors by lower
level operators.
Default schedule
display
Default navigation
display
Weekly Schedule
Exception Schedule
Scheduled Items
Specifies the User View navigation display as either a set of tabs (Tabbed) or a drop-down list (List).
The default is Tabbed.
Note: List is recommended if the system has many user views, as this takes up less space in the
navigation tree pane.
Specifies that upon login, the navigation tree collapses to the left (True or False). The default is False.
Specifies the Display Frame Layout that is displayed at login. The default panel layout is Single Panel.
Startup item 14
Defines up to four startup views, which are automatically displayed at login. The number of views that
can be displayed is based on the Default display panel layout.
Note: Aliased graphics do not display properly if selected as a startup item. Specify the main graphic
instead.
Click
to access the Select Item dialog box. Select the item you want to appear in the panel upon
Applications Tab
The Applications tab allows you to specify links to external applications, such as a spreadsheet or Microsoft Word
document, that can be launched from the Tools menu or from within graphics. The following table describes the
attributes of the Applications tab.
648
Allows you to add a new external application that can be accessed from within the Site Management Portal
(SMP) UI. Once you click Add, the lower pane allows you to enter application information. If you are
authorized to change system preferences, an Add Application dialog box appears first and allows you to
specify whether the application is to be a system or user preference.
Note: If you are not authorized to change system preferences, the application is automatically added as a
user preference.
For more information, see System and User Preferences.
Remove button
Application Name Enter the name of the application as you want it to appear on the Tools menu or within graphics.
Application Path
Enter the full path of the application, including the command line arguments. The path is based on the local
file system (where you are browsing from), not on the path of the device you are logged in to. The application
path can also use any mapped network drives.
Click
to access a Browse dialog box and select the application and path.
To launch a specific file, select the path to the application that opens the file, followed by a space and the
path to the specific file in quotation marks. Use the following format:
C:\Application Path\Application.exe C:\filename path\filename.extension
For example, to launch a Microsoft Word document named Worksheet_01:
C:\Program Files\Microsoft Office\OFFICE11\WINWORD.EXE "C:\Documents and
Settings\username\Desktop\Worksheet_01.doc"
Note: The Application you add is specific to the computer you are using when you add it. The application
may not launch from a different computer unless the application exists on that computer in the same location.
Tools Menu
Indicates whether the application appears on the Tools menu in the SMP UI. Select True (default) to have
the application appear on the Tools menu. Select False if you do not want it to appear on the Tools menu.
Note: You must log out of the SMP UI and then log back in for new items to appear in the Tools menu.
Graphics
Indicates whether the application can be hyperlinked to and launched by a button in a standard graphic.
The application name you specify appears on the Hyperlink Information Application drop-down menu for
buttons in graphics. See Buttons. Select True to enable this functionality. Select False (default) if you do
not want the application to provide graphics.
Note: This hyperlink capability is supported in the Graphics+ as well as the User Graphics Tool (UGT).
Mnemonic
Type
Specifies whether the application is available for the system or the user. This is specified when you first
click Add to add a new application to the list. Once specified, this attribute cannot be changed.
649
MVE sites have settings in the Site Object for enabling annotation and electronic signature functionality. You can
set the MVE site to require only annotations, only electronic signatures, both annotations and signatures, or neither
annotations nor signatures. Non-MVE sites may optionally define and use annotations; however, electronic signatures
are specific to MVE sites.
You can configure electronic signatures at the device and object levels. Table 362 describes the attributes of the
Electronic Signature Settings tab.
Table 362: Electronic Signature Settings Tab
Field Name
Description
Reason Text
Enter a new reason for electronic signature requirement, to be added to the list of predefined reasons.
The text can be from 1 to 255 characters in length. Click Add to save the new reason.
Predefined reasons are Approval, Author, Required, Cause, and Operator Action. These reasons can be
edited or deleted.
Predefined Reason Displays the list of predefined reasons. Select a reason and click Delete to remove the reason from the
List
list. The Move Up and Move Down buttons allow you to reorder the list.
For additional information, refer to the Metasys for Validated Environments, Extended Architecture Technical Bulletin
(LIT-12011327).
Annotation Settings Tab
The Annotations Settings tab allows you to define customized annotations to select when acknowledging and
discarding events.
MVE sites have settings in the Site Object for enabling annotation (and electronic signature) functionality. You can
set the MVE site to require only annotations, only electronic signatures, both annotations and signatures, or neither
annotations nor signatures. Non-MVE sites may optionally define and use annotations; however, electronic signatures
are specific to MVE sites.
We recommend that you define custom annotations specific to your needs, in addition to the predefined annotations.
When the new Annotation Settings are saved in an MVE system, the new annotation selections are available to
users when they electronically sign for changes.
You can configure annotations at the device and object levels. See Audit Message Annotations in Audit Trail for
details on annotation fields. Also see Configuring Annotation and Electronic Signature Requirements in the Site
Object in MVE .
Table 363 describes the attributes of the Annotation Settings tab.
Table 363: Annotation Settings Tab
Field Name
Description
Annotation Text
Enter a new annotation to be added to the list of predefined annotations. The text can be from 1 to 255
characters in length. Click Add to save the new annotation.
Predefined annotations can be edited or deleted.
Predefined
Annotation List
Displays the list of predefined annotations. Select a reason and click Delete to remove the annotation from
the list. The Move Up and Move Down buttons allow you to reorder the list.
For additional information, refer to the Metasys for Validated Environments, Extended Architecture Technical Bulletin
(LIT-12011327).
System and User Preferences
Preferences are divided into two categories: system preferences and user preferences.
Metasys SMP Help: Tools Menu
650
System Preferences
System preferences apply to all users who log in to the site or device. System preferences affect the performance
and operation of the system and require authorization to configure. A change to the audible alarm notification is an
example of a system preference. Only the users defined in the section are authorized to configure system preferences.
To synchronize system preferences within a site or to reuse the system preferences on another site, refer to the
Configuring and Managing Preferences appendix of the ADS/ADX Commissioning Guide (LIT-1201645) or the NAE
Commissioning Guide (LIT-1201519).
User Preferences
User preferences apply to a specific Metasys system user. User preferences define how the information is displayed
in the UI, and do not affect the operation for other users of the system. The colors and marker styles of a trend
display are examples of user preferences. At SCT Release 11.0, user preferences and object lists are now included
in uploads and downloads. Metasys servers at Release 8.0 or later that are reinstalled no longer require object lists
or user preferences to be recreated.
To synchronize user preferences within a site or to reuse the user preferences on another site, refer to the Configuring
and Managing Preferences appendix of the ADS/ADX Commissioning Guide (LIT-1201645) or the NAE Commissioning
Guide (LIT-1201519).
Users Authorized to Edit System Preferences
Any user whose account is assigned to the Administrator role is authorized to configure system preferences.
Change Password
Menu Selection: Tools > Change Password
Changes the current users password. The password you select must meet the requirements for complex passwords.
For details, refer to the Network and IT Guidance for the BAS Professional Technical Bulletin (LIT-12011279).
Note: For Active Directory and RADIUS users, the Change Password menu remains disabled.
Administrator
Menu Selection: Tools > Administrator
Launches the Security Administrator System. This menu item is only available for users in the ADMINISTRATOR
role. Within the Security Administrator System, Administrators manage user accounts by creating roles/profiles;
setting user passwords; assigning category-based, system-level, and navigation view permissions/access; and
performing other duties. For more information on the Security Administrator System, refer to the Security Administrator
System Technical Bulletin (LIT-1201528).
Configure Preferences
Menu Selection: Tools > Configure Preferences
Launches the Metasys Preferences dialog box.
The Metasys system provides customized preferences for the UI. The preferences allow you to configure how the
UI behaves, including the sounds and colors, the startup view, and the ability to add links to external applications
that can be accessed from within the UI.
651
You must have N2 Tools and the SCT installed on the same PC that is running Passthru with HVAC PRO,
GX-9100, XTM Configurator, DX Commissioning, or N2 Device Loader passthru.
The Passthru wizard does not always appear when you are connected to the NAE or ADS/ADX online if
you are already logged on to the site. The selected tool loads automatically after selecting it from the Tools
menu.
On the Passthru Site Login screen of the wizard, enter your username and password as defined by your
User Profile. If desired, click Login to check if your login parameters are valid to access the tools.
Passthru Requirements
For installation requirements, refer to the Metasys Server Installation and Upgrade Instructions Wizard (LIT-12012162)
or ODS and SCT Installation Instructions Wizard (LIT-12011945).
Note: Computers with Windows 8 and Windows 7 require the use of Passthru. To use CCT, HVAC PRO software,
or the GX-9100 tool software in Passthru mode from SCT, you must disable user account control in Control
Panel. If you do not disable user account control, Passthru mode does not work in Windows 8 or Windows
7. To disable user account control, go to Control Panel > System and Security > Action Center. Locate User
Action Control under the Security section and click Choose Your UAC level. On the left side of the screen,
drag the slide bar to Never Notify. Click OK and restart the computer.
Launching N2 Configuration Tools and CCT in Passthru Mode
N2 Devices are configured using N2 configuration tools in Passthru mode in the SCT. To use the N2 configuration
tools in Passthru mode, install the N2 configuration tools on the machine where you are using them.
CCT devices are configured using CCT in Passthru mode. To use CCT in Passthru mode, install CCT on the machine
where you are using them.
To launch N2 configuration tools and CCT in Passthru mode:
652
Note: -
When you use the GX-9100 tool in Passthru mode, engines appear as N30 devices in the UI of the
GX-9100 tool.
If you use Passthru on Windows 8 or Windows 7, the user needs to turn off the UAC. To turn off the
UAC, go to Control Panel and click System and Security > Action Center. The Action Center window
appears. Click Change User Account Control settings, then move the slider bar to the bottom position
called Never notify. Click OK and restart the computer.
HVAC PRO
HVAC PRO configures the Application-Specific Controller (ASC): VMA14, VAV, AHU, and Unitary Controllers (UNTs).
In Passthru mode, you can use the HVAC PRO software to download, upload, and commission ASC devices through
an engine.
In addition, Passthru mode makes it easier to identify and manage controllers for common tasks by showing the
user a complete list of controllers currently mapped in an engine. The first step in any Passthru operation from HVAC
PRO is to select a controller from a list. Subsequent Passthru operations, such as Controller Information and
Upload/Download, are performed on the selected controller.
HVAC PRO restricts the number of characters allowed in each controller name. See HVAC PRO Name Restrictions
in Passthru Mode.
HVAC PRO Name Restrictions in Passthru Mode
HVAC PRO Release 8.06 and later restricts the number of characters allowed in each controller name. HVAC PRO
does not download, upload, commission, or retrieve information about the controller if the item name or controller
name exceeds the 157 maximum characters limit.
The controllers full name consists of the: domain name, site name, equipment name, trunk name, and the actual
controllers name. The controller name appears in the following format:
Site_name:device_name.domain_name/N2 Trunk #.controller_name
The following table describes the controller name restrictions.
Note: The component column lists each of the components represented in a Full Item reference. The Maximum
Viewable Characters column lists the restrictions on the Component names when entered through SCT or
a web-based user interface of the Metasys supervisory controller. The Maximum Characters Allowed by
HVAC PRO column shows the maximum number of characters in a Full Item Reference allowed in HVAC
PRO.
653
Maximum Viewable
Characters
Maximum Characters
Allowed by HVAC PRO
Site Name
30
157
Device Name
Domain Name
N2 Trunk Name
Controller Name
47 Total
GX-9100 Tool
The GX-9100 tool configures the DX-9100 and DX-9200 controllers.
In Passthru mode, you can use the GX-9100 software to download or upload the DX configurations. When you use
the GX-9100 through an engine, the LoaderUI application launches to initiate the upload or download.
XTM Configurator
The XTM Configurator supports building configuration files for XTMs.
Note: The XTM Configurator tool does not support N2 passthru but can be used to download XTMs using a serial
connection.
DX Commissioning
Opens the DX Commissioning Tool.
N2 Device Loader
Opens the N2 LoaderUI window. You can browse to the location of the DX-9100 device file and other N2 device
files to upload and download. All devices found on the selected engine appear with the Address, Device Type, and
Object Name. You can open the device file in the GX-9100 or HVAC PRO tool.
654
Query Menu
Click one of the following menu items for a description of it. For more information on the modes of operation, see
Metasys Modes. For a description of the Authorized Required column, see Authorized Menu Items.
Table 365: SMP Query Menu
Menu Item
Mode Visible In
Authorization Required
Alarm Report
Offline Report
Disabled Report
Supervisory Override
Report
Trouble Report
Global Search
1
2
3
4
Reports
Use the predefined report feature to query a single Engine, multiple Engines, or the entire site (all Engines on the
site) for alarm, offline, disabled, override, trouble, and out of service conditions. To generate a report, select one or
multiple Engines or the site in the navigation tree and select a report from the Query Menu. The query executes for
the selected Engine or site. When you select multiple Engines or the site in the navigation tree, the report feature
queries each supervisory device and combines the results in one report.
These predefined reports (alarm, offline, disabled, override, trouble, and out of service) are different from the
Scheduled Reports option available in the Query menu. For information on scheduled reports, see the Scheduled
Reports section. For information on the Global Search and Object List options, see the Global Search section.
The query results in a report in the display panel. The report shows the time the query was initiated, the report status,
and the report results. The stop button allows you to cancel a running query at any time. The Copy button allows
you to copy the report content to the clipboard. The following figure shows an example of an Offline Report. See the
Running Reports topic for information on how to run a query.
655
Offline
Disabled
Operator Override
656
Trouble
Lists all items that have the Trouble attribute set to True.
For each item in trouble state, the report displays the item type icon, item name, and item description.
Binary Input and Binary Output points often have this property. It is mostly used in Fire and Security
applications, but may be used when the Binary Output command does not match the feedback. (Trouble
reports are integration dependent.)
Out of Service
Lists all items that have the Out of Service attribute set to True.
For each out of service item, the report displays the item type icon, item name, and item description.
All BACnet point objects have this property (for all integrations) as well as the BACnet Loop, Program,
and Schedule objects.
Global Search
The Global Search feature allows you to search the Metasys system for multiple items that meet specific criteria
based on naming and object type. The global search provides you with the ability to manage lists of objects, which
can be used by other features for commanding, trending, reporting, modification, and object selection. For example,
you could create a list of all discharge air temperatures for the AHU in a building. This feature is especially helpful
in the creation of User Views and Summary Definitions as you can use drag-and-drop functionality to add items from
the search results to these features.
See Using Global Commands with the Global Search in the Commands Dialog section, Using Global Modify with
Global Search in the Modify Dialog section, and Locate in Tree in the Working in the SMP UI section for steps on
using the these features together.
For information on backing up object lists before an upgrade, refer to the Preferences appendix in the NAE
Commissioning Guide (LIT-1201519) or the ADS/ADX Commissioning Guide (LIT-1201645) .
657
With the Global Search feature, you can view information about multiple items at once. You can create different
groups of objects and save them as object lists for later use. The Global Search Viewer lets you view summary data
for multiple objects, and allows multiple selection for Global Commanding and Global Modifying.
See the Global Search Viewer Screen and Object List sections.
Global Search Viewer Screen
The Global Search Viewer allows you to perform a global search for like objects in your Metasys system. You can
access the Global Search Viewer from the Query Menu by selecting Global Search. The Global Search Viewer
opens in the Panel Layout of the Metasys system Site Management Portal .
You can have multiple Global Search Viewers open, but can only initiate one search at a time within the same UI.
If you try to start another search in the same UI, an error message appears stating you must either stop the search
in progress, or wait until it completes before initiating another search.
The Global Search feature displays 500 items by default and can be increased to 2,000 in user preferences.
SCT does not support dynamic updating for search values with the Global Search feature. If the search results reach
the maximum number of items, a message appears stating the current search is too broad and you should change
the search criteria to narrow the search and try again.
Note: On an NxE with more that 500 items, the Global Search may display red Xs and the message Value cannot
be read. As the view continues to update data, the red Xs disappear. However, once the search reaches
500, results data updates are disabled and the red Xs remain.
Figure 74: Global Search Viewer Screen
Lists the parts of the Metasys system navigation view you selected to search.
When you initially invoke the Global Search feature, any items currently selected in the
navigation view appear in the Search Locations list box. If no items are selected in the navigation
view, the box appears blank. Make or change selections using the Add and Remove buttons.
658
Opens the Select Item dialog box and allows you to select the parts of the system you want
to search. You can select items from available views (All Items tab or User View tabs) depending
on your user authorization.
You can search the entire site, one or more devices, one or more trunks on a device, one or
more User Views, and so on. Use the Ctrl or Shift keys when clicking to select multiple items.
After completing the dialog box, the items you selected appear in the Select Scope box.
Remove Button
Allows you to type the full or partial name of the object you want to find. You can leave it blank
for a more expansive search. You also can use one or more wildcards (* or ?) to aid in your
search.
Wildcard Examples:
LCP-2*
ZN-T*
OCC-S*
N?E* (searches for all items named NAE*, NIE*, and so on)
Allows you to select a specific type of object to search for or to search for all object types.
Options include:
All (excluding extensions)
Trend Extensions
Totalization Extensions
Alarm Extensions
Schedules
Calendars
Field Devices
Field Points
Includes all child objects of any items found when searching the Search Locations. That is, it
includes the nested child objects.
Includes the location items in the search results (if they meet the search criteria), as well as
any items found when searching in those locations.
For example, if you initiate a search on an N2 Trunk named N2 Trunk 1 to search for all objects
named *2*, and you check Include search location objects, the results include the N2 Trunk
in the results. If you do not check the option, the search results only include items under the
N2 Trunk (along with their child objects, if the Include child objects option was checked), and
does not include the N2 Trunk itself.
Search Button
Cancels a search in progress and no more new objects appear in the Search Results table.
659
If you select an item in the Search Results and place your cursor over it within each column,
tooltips appear providing more information, if available.
Any data that does not fit within the columns is identified by an ellipsis (...). You can resize
the column or place your cursor over the table cell to see its tooltip text.
If the search finds an object in more than one location (for example, in the All Items
navigation view and in a user navigation view), the object is listed twice in the Search
Results Table. If the same location is searched a second time, or if search locations overlap,
the object is not repeated in the table. Items are only repeated in the table if their location
differs.
See the Working with Search Results section for more information on manipulating and using
the table data.
Status Icon Column
Displays the icon of the objects current status as defined by its Status attribute.
Icon Column
Status Column
Name/Label Column
Displays the objects name as defined by its Name attribute. The objects full reference identifier
appears in a tooltip when the cursor is placed over the name.
Value Column
Displays the objects value as defined by its default attribute (generally, the Present Value
attribute).
Units/States Column
Displays the Units attribute data for analog objects, Number of States attribute data for multistate
objects, and appears blank for all other objects.
Description Column
Location Column
Displays the objects context, specifically its location within a particular navigation view.
Type Column
Category
Displays the objects category as defined by its Object Category attribute (for example, General).
Signature
Annotation
Select All
Clear List
Add New
Allows you to manually add one or more objects to existing search results (where the added
objects append to the bottom of the existing Search Results table).
Copy to Clipboard
Copies the selected search results in a tab-delimited format to the Clipboard for pasting into
other applications such as Microsoft Excel or Word.
Status Bar
Displays the current location being searched while the search is in progress, the status of the
search, and the number of objects found.
660
Object List
The objects listed in the Search Results table make up an object list. You can save an object list for future viewing
and commanding. You can open an existing object list in the Global Search Viewer if you want to access the same
search results without having to perform the search again. You also can open object lists for use by other features
such as the Trend Viewer, Scheduled Reports, Global Commands, and Global Modify. Object lists provide easy
object selection for these features.
When you save an object list, it is saved on the Site Director. Sorting order is not saved in the object list. For
information on working with and using object lists, see the Working with Search Results, Saving an Object List,
Opening an Object List, and Deleting an Object List sections. Also, see the Trend Viewer, Scheduled Reports,
Commands Dialog, and Modify Dialog sections.
The object lists are not saved during a backup of the database, and are deleted during a restore. The files must be
manually saved and restored in order to retain saved lists.
On the ADS/ADX , the files are stored at C:\ProgramData\Johnson Controls\MetasysIII\File Transfer\Object Lists.
On the engines, use Remote Desktop within the NxE Information and Configuration Tool (NCT) to access the files.
For information on backing up object lists, refer to the Preferences appendix in the NAE Commissioning Guide
(LIT-1201519) or the ADS/ADX Commissioning Guide (LIT-1201645) .
661
3. Select the part of the system that you want to search from the available tabs depending on your user authorization
and Metasys mode. You can search the entire site, the All Items navigation tree, a User View, one or more
devices, one or more trunks on a device, and so on. Use the Ctrl or Shift keys when clicking to select multiple
items.
Note: Selecting a User View object from the All Items tab does not search that User Views contents. You must
select the root of the User View from its tab.
4. Click OK.
5.
6.
7.
8.
9.
Note: To remove items from the Search Locations box, select the item and click Remove.
Select the Include child objects check box if you want to include all child objects of any items found when
searching the Search Locations.
Select the Include search location objects check box if you want to include the Search Locations in the results.
In the Object Name box, type the full or partial name of the object you want to find or leave it blank. You can use
one or more wildcards (* or ?) to aid in your search (for example, N?E*). The object name search is not
case-sensitive.
From the Object Type menu, select the type of object to search or select All (excluding extensions).
Click Search. The search begins and the Search Results table fills with any matching object information. When
finished, the status section displays Search Completed and the number of objects found.
Note: If you rename an object, you must remove the old name from the Search Locations list before the object can
appear in the results list under its new name.
See the Working with Search Results section.
Stopping a Search
To stop a running search, click Stop Search.
Metasys SMP Help: Query Menu
662
Click and drag your cursor over objects in the Search Results table to select objects that appear
consecutively.
Drag-and-drop functionality can add items from the Global Search Results table to a User View or Tailored
Summary Viewer. Use this feature to view both the Global Search Viewer and the User View or Tailored
Summary Definition in the display frame (using a multiple panel view). Follow these steps to use
drag-and-drop functionality:
1. Click Edit in the User View or Tailored Summary Definition.
2. Drag items from the Search Results table to the User View or Tailored Summary Viewer.
You also can drag an item from the Global Search Results table and drop it into an empty display panel
to view the item or perform a Global Modify to the search results.
663
664
2. Select an object list to open. You can only open object lists under All, and under categories for which you have
View access.
3. Click Open. The Global Search Viewer appears in the display panel with the search criteria and the object list
filling the Search Results table.
Note: Objects that are renamed in the UI after an object list is saved do not reflect the new name in the object list
until the object list is re-saved.
665
Table 368 describes the fields in the Create New Scheduled Report screen.
666
Allows you to enter a name for the report. Use a descriptive name so you can recognize the details
by the name; for example, Weekly Building Two Status Report.
Note: Enter a name that has fewer than 100 characters. Otherwise, you receive an error when you
attempt to view the new report.
Object List
Allows you to select which object list to run the report against. For information on Object Lists, see
Object List in the Global Search section.
Report Format
Allows you to select the report file format: Tab Delimited, XML, and Text.
Tab Delimited: saves the report with an .txt extension. You can use the report with a spreadsheet
application, such as Excel.
XML: saves the report with an .xml extension. You can use the report with an Internet browser,
such as Internet Explorer.
Text: saves the report with an .txt extension. You can use the report with any text-viewing
application, such as Notepad.
Send To Printer
Allows you to automatically send the report to the default printer of the ADS/ADX each time the report
generates. The report first saves to a file on the server, then it is sent to the default printer. Scheduled
reports configured to be sent directly to printer on the ADS/ADX are printed in the systems default
language. For more information on configuring the default printer on the ADS/ADX , refer to the ADS
documents listed in the Related Documentation table in the Welcome section.
Schedule Report
Allows you to schedule the report to run at one or more future times.
Allows you to select how often to generate the report. Selections include: One Time Only (default),
Daily, Weekly, Monthly, and Yearly.
Start Date
End Date
No End Date
Date Information
Allows you to further configure the date information for when the scheduled report runs.
Time Information
Allows you to further configure the time information for when the scheduled report runs.
Scheduled Reports
The Scheduled Reports feature provides a reporting service on an ADS/ADX Site Director. The ADS/ADX generates
summary reports based on Object Lists and Report Schedules.
Scheduled Reports Concepts
Scheduled Report
A Scheduled Report consists of one Object List and one Report Schedule. You select the objects that appear on an
Object List. Create and Save Object Lists to the Site Director using the Global Search feature. A Report Schedule
specifies the day and time to run the report.
Object List
An Object List is a list of objects you select. Object Lists are created and saved to the Site Director using the Global
Search feature. See the Object List section in the Global Search section for more information.
Report Schedule
The Report Schedule specifies the days and times a report is generated.
667
Report Output
Scheduled reports generate files on the ADS/ADX that contain the actual report output. You can view the content
of a report output file through the online UI using any compatible Web browser, but you must log in to the ADS/ADX
Windows operating system and use Windows Explorer (or another software application) to browse to and
delete/manage the files. Scheduled reports configured to be sent directly to the printer on the ADS/ADX are printed
in the systems default language.
To view the content of the Report Output file in the UI, use the Report Output Viewer. See Report Output Viewer for
information on viewing the Scheduled Report output in the UI. To manage report output files, see Accessing Report
Output Files on the ADS/ADX .
Report Output Viewer
The Report Output Viewer allows you to view the content of a Scheduled Report output file in the UI in the Report
Output Viewer window. The Report Output Viewer displays output in any format (tab delimited, XML, and text) and
is available via the Scheduled Reports Viewer.
Each Report Output viewer window displays the content of a single report output file. You can have multiple Report
Output viewers open simultaneously. To display the Report Output viewer, see Viewing the Content of a Report
Output File in the UI.
Scheduled Reports Overview
Each scheduled report contains one or more properties (for example, Item Name and Status) of each item in an
Object List. A report engine on the server runs the Scheduled Report at the specified times and saves it to a file in
a standard location on the server. The report engine can also send the report output to a printer if specified.
There are two scheduled report screens: the Create New Scheduled Report Screen and the Scheduled Reports
Viewer screen.
Scheduled Reports Steps
Creating a New Scheduled Report
1. On the Query Menu, select New Scheduled Report. The Metasys - New Scheduled Report screen appears.
2. Enter a report name that has fewer than 100 characters.
3. Select an Object List.
4. Select a Report Format.
5. Select Send to Printer if you want to print the report.
6. Select either Run Report Now or Schedule Report.
7. In the Run This Report drop-down list, specify how often you want to run the report.
8. Enter a Start Date.
9. Enter an End Date.
Note: If you wish to run the report indefinitely, select No End Date.
10. Enter the Date Information if you schedule to run the report more than One Time Only.
11. Enter the time you want the report to run in the Time Information section.
Note: To repeat the schedule every X minutes, select the Repeat check box. Enter the interval (in minutes) to
repeat and configure the time when this repeating interval ends. The range is 15 to 1,440 minutes. For
an example, see the Scheduling Scenarios section.
12. Click Save.
Metasys SMP Help: Query Menu
668
Note: If you click Cancel, a Metasys - Report Changes Pending screen appears. Click Yes to save your
changes. Click No to close the screen without saving your changes.
Launching the Scheduled Reports Viewer
To launch the Scheduled Report Viewer, select Scheduled Reports from the View Menu. The Scheduled Reports
Viewer Screen appears.
Editing an Existing Scheduled Report
1. Launch the Scheduled Reports Viewer.
2. On the Scheduled Actions tab, select the report to edit.
3. Click Edit.
4. Make the necessary changes.
5. Click Save.
Copying an Existing Report to a New Report
1. Launch the Scheduled Reports Viewer.
2. Select the Scheduled Actions tab.
3. Select a report to copy.
4. Click Edit.
5. Click Copy to New Report. The Copy to a New Report dialog box appears.
Note: The Copy To a New Report button allows you to save an exact copy of the current report with a different
name. Your new report appears in the Scheduled Actions tab in the Scheduled Reports Viewer.
6. Enter a new name or Object List.
7. Click OK. A message appears to indicate a successful copy. Your new report appears in the Scheduled Actions
tab in the Scheduled Reports Viewer.
Enabling/Disabling a Report
1. Launch the Scheduled Reports Viewer, and select either the Actions in Progress tab or the Scheduled Actions
tab.
2. Click the report.
3. Click Enable or Disable.
Rescheduling a Completed or In Progress Report
1. Launch the Scheduled Reports Viewer and select the Completed Actions or Actions in Progress tab.
2. Click the report.
3. Click Reschedule. The Reschedule a Report screen appears.
4. Modify the date and time using the drop-down menus.
5. Click OK.
Viewing the Status of a Report
1. Launch the Scheduled Reports Viewer and select the Completed Actions tab.
2. Click the report.
3. Click View Status. The Scheduled Reports Status dialog box appears.
Metasys SMP Help: Query Menu
669
The correct viewer depends on the report type. For example, text in Notepad, XML in Internet Explorer,
and tab delimited in Excel.
You may wish to periodically archive or delete report output files to avoid filling the ADS/ADX hard
disk.
670
The View Report button is enabled only when a single report is selected. If no reports are selected, or more
than one report is selected, the button is disabled.
To copy the content to the clipboard, click Copy to Clipboard. To save the content to a file on your computer,
click Save to File.
If the report was not successful, an error message appears (Figure 78).
Figure 78: Unsuccessful Report Error Message
4. Click Close when you are finished. All open Report Output Viewer windows close when you log out or exit the
UI.
Changing the Report Output Directory Location
The default directory for the Scheduled Report output on the ADS/ADX Site Director is
C:\ProgramData\Johnson Controls\MetasysIII\File Transfer\Report Definitions.
Use this procedure if you want to change the location of the report output directory.
To change the Report Output directory location:
1.
2.
3.
4.
From the Control Panel of the ADS/ADX Site Director computer, select Administrative Tools > Services. The
Services window appears.
Right-click the Metasys III Action Queue service and select Stop.
Right-click the Metasys III Device Manager service and select Stop.
Right-click the Metasys III Action Queue service and select Properties. The Metasys III Action Queue Properties
dialog box appears.
671
5.
6.
Note the directory in the Path to executable text box (Figure 79), and use Windows Explorer to navigate to
that directory.
Open the ActionQueue.exe.config file using a standard text editor, such as Notepad.
7.
672
8.
Change the contents of the value section to the preferred location of the report output. For example, to send
report output to the C:\Metasys System directory, the line of text appears as follows:
<add key=FileTransfer.AliasFilePath value=C:\Metasys System\/>
On the Query menu, select New Scheduled Report. The Create New Scheduled Report Dialog Box appears.
Enter a report name that has fewer than 100 characters.
Select an Object List to run the report against.
Select a Report Format.
Select Schedule Report.
Select Run This Report Daily.
Verify the Start Date is set to today.
Select the No End Date check box.
In the Time Information section, configure the Run At time to 8:00 A.M.
673
674
SCT Help
Menu Selection: Help > SCT Help
Launches the Metasys SCT Help.
Starting at Release 10.0, you can also launch the Metasys SCT Help using the
icon located in the uppers in
various windows of the Metasys SCT user interface. Clicking the icon opens the Help PDF in a web browser.
Note: We recommend setting your default web browser to Goggle Chrome for proper functionality of this feature.
About Metasys
Menu Selection: Help > About Metasys
Displays the Metasys software version, UI version, Graphics+ runtime software version, and copyright. Click Terms
& Conditions to view terms and conditions information.
Metasys SMP Help: Help Menu
675
676
Right-Click Menus
The contents of the menus vary depending on the item or feature selected. The contents are either feature-specific
based on the active panel or item-specific based on the selected item in the navigation tree.
For details on how to access right-click menu items using the equivalent menu bar selection, see Right-Click Menus
and Menu Bar Equivalents.
Command
Modify
Copy
Paste
Delete Items
Event Viewer
Alarm Report
Offline Report
Disabled Report
Trouble Report
Show Extensions
Refresh
View
Rename
Add Annotation
View Annotations
Edit
Import Integration
Import Definition
Locate in Tree
677
Event Viewer
Report Viewer
Global Search
Viewer
Refresh
Discard
Add Annotation
View Annotation
Refresh
Refresh
Discard
View Item
Ack
View Item
Add Annotation
View Annotation
Refresh
Refresh
View
View
Refresh
Refresh
Delete Items
4
2
4
2
View
Command
Locate in Tree
View
Command
Modify
Add Annotation
View Annotations
Show Extensions
Locate in Tree
Refresh
Move Up
Move Down
Sort Ascending
Sort Descending
4
4
4
4
3
3
Change Results
Viewer
All Items
Organizer
6
6
678
View
Event Viewer
View
Event Viewer
Command
Modify
Add Annotation
View Annotations
Alarm Report
Offline Report
Audit Viewer
Command
Modify
Add Annotation
View Annotations
Disabled Report
Show Extensions
Operator Override
6
Report
Supervisory Override
6
Report
Trouble Report
Locate in Tree
3
3
Alarm Report
Offline Report
Disabled Report
Trouble Report
Import Integration
Locate in Tree
6
6
6
6
6
3
6
6
6
6
6
6
679
Trend Viewer
Refresh
View
Command
Background Color
Refresh
View
Command
Modify
Event Viewer
Y-Axis Scale
Audit Viewer
X-Axis Scale
Add Annotation
View Annotations
Gridlines
- None9
Background Color
Y-Axis Scale
X-Axis Scale
Gridlines
- None9
8
4
3
3
X Only
Y Only
9
9
9
Chart Type
- Points Line9
Bar
Points
Line
Y Only
Chart Type
- Points Line9
Line
X Only
Points
Area
X and Y
Bar
2 , 4
Area
2 , 4
X and Y
2 , 4
9
9
Stacked Y-Axis
Command
9
9
Stacked Y-Axis
Locate in Tree
6
7
8
9
Tabbed Item
Viewer (Display
Panel Tabs)
1
2
3
4
5
2 , 4
Delete Items
Modify
2
Command
Show Extensions
The View, Commands, and Show Extensions menu items are item specific.
With the header of the display panel selected.
Available on the ADS/ADX only.
With an item in the report, Legend, Trend Items table, or results table selected.
The menu options available are item specific (that is, they depend on the type of item selected in the Tailored Summary table
and Key Data table).
Available for an Engine only.
Available for a Tailored Summary with trunk/integration data (for example, trunk diagnostics).
With an item in the Legend selected.
With the Chart selected.
680
Contents In Mode
ADS
User Views
Site
View
View
Modify
Import Definition
Import Definition
View
View
Modify
Event Viewer
Command
Event Viewer
Audit Viewer
Add Annotation
View Annotations
View
View
Modify
View
View
Command
Command
2
2
Add Annotation
View Annotations
2
2
View
View
Event Viewer
Event Viewer
Audit Viewer
Command
Command
Alarm Report
Modify
Offline Report
Disabled Report
Trouble Report
Add Annotation
View Annotations
Show Extensions
Alarm Report
Offline Report
Disabled Report
Trouble Report
681
Contents In Mode
1
2
3
4
View
Modify
Export Definition
View
View
View
Command
Command
Modify
Modify
Show Extensions
Add Annotation
View Annotations
Delete Items
2
2
Available for the Summary Definitions folder in the All Items tree.
Available on the ADS/ADX only.
For Trend or other extensions, the View and Show Extensions menu items display for the parent item, not for the extension
itself.
Available for only Schedule and Calendar objects.
682
Troubleshooting
Table 372: Troubleshooting
Problem
When you attempt to execute any N2 Passthru tool (for
example, HVAC PRO) from the ADS, ADX, or NAE user
interface, the following error appears:
Solution
Date or time may be incorrect. Verify that all dates and times
are correct. For more information, refer to Appendix: Time Zone,
Date, and Time Management in the ADS/ADX Commissioning
Guide (LIT-1201645) .
Item name may be too long. Refer to the HVAC PRO Name
Restrictions in Passthru Mode section in the SCT Help
(LIT-12011964).
SCT does not log in to allow HVAC PRO to load despite
already being logged in to the NAE.
SCT (offline) allows you to log in and run HVAC PRO, but
you receive a ZSWHPRO crash when you try to do anything
over Passthru.
Login responds with:
Unable to Login. Unexpected Error.
The error typically occurs if IIS 5.0 is installed after the .NET
Framework. Uninstall .NET, IIS, and SCT. Reinstall in the
following order: IIS, .NET, SCT.
HVAC PRO gives the item reference of the NAE, but fails Only the second N2 Trunk is integrated. Integrate the first N2
to get any controllers and causes ZSWHPRO.EXE to crash. Trunk, even if it has no controllers on it. You must integrate the
first N2 Trunk if N2 Trunk 2 is being used in HVAC PRO, even
if there are no devices on the first N2 trunk.
Downloading and uploading the database of an NxE in SCT Check that the engine is online.
causes a Communication Error (521).
683
Solution
Downloading and uploading the database of an NxE in SCT The SCT is case sensitive for the names of the NxE devices.
causes a Communication Error (521).
Create a new Supervisory device in SCT and give it the exact
same name of the NAE. For example, the name nae is different
from NAE in SCT.
Downloading or Uploading the database of an NxE in SCT This error occurs when the NxEs have domain names defined
causes a Communication Error (521) or error (522).
for them, but the domain names are not defined in SCT. When
you define a new Site or a new Supervisory device in SCT, you
must include the domain name as part of the name (for example,
NAE.cg.jci.com instead of just NAE). You can also use the IP
address of the device that the archive is being taken from.
N2 applications respond with no information, or lock up.
SCT upgrade tool fails with the following archive upgrade Verify the name of the backup matches the name of the archive.
log error for a restored database:
To verify the backup and archive names match, log in to the
Site Director. The name at the top of the tree is the archive
In ConvertArchives: Error in reading archive
name. Rename the SCT backup database to match the archive
data for fixbuild1, Empty Archive
name, restore the database, and execute the archive upgrade
again.
When you attempt to use one of the N2 Passthru tools, the M-Tools may have been installed while running the N2 Passthru.
following error message appears:
Shut down all active N2 Tools and SCT. Reinstall SCT.
Supervisory Device Offline
A DX9100 device may remain offline after exiting the GX9100 The GX9100 device is disabled at the GX9100. To enable the
Commissioning tool. This occurs when the tool is run in GX9100 device, you must first command the DX9100 N2 Device
passthru mode from an ADS . In the NAE, the DX9100 N2 to Disable, then command the DX9100 device to Enable.
Device tab shows:
Offline = True and Enabled = True
The N2DeviceLoader/LoaderUI (LoaderUIG3.exe) crashes The error typically occurs when you have a child NAE listed
above the Site Director. When the child NAE appears offline
when you try to connect to the site.
(with a red or blue X), the N2DeviceLoader/LoaderUI crashes.
Right-click the offline NAE and choose Remove from Site.
The SCT installed without error, but the SCT UI window
freezes or stalls while Java software is loading.
This error occurs when you attempt to log in to the SCT and
you do not have proper permissions assigned. If you are an
Active Directory user, this occurs when attempting to start the
SCT.
Verify that System Configuration Tool is an assigned privilege
for the user in the System Access Permissions of the Security
Administrator System.
684
Solution
685
Solution
In SCT, when trying to save a standard user graphic from This problem occurs when the user graphic size is over 4 MB,
a restored database, the following error appears:
which is the default maximum allowed size for an IIS message
as defined by Microsoft Corporation.
Failed to communicate to the server or device.
The workaround is to increase the default size using the
<httpRuntime> element in the system.web section of the
web.config file. Change the values of the maxRequestLength
and executionTimeout attributes.
Note: maxRequestLength is defined as the number of KB
allowed, so the default is 4,096 KB (4 MB); executionTimeout
is the number of seconds until the request is killed.
For example, a maxRequestLength of 40 MB and
executionTimeout of 10 minutes appears as follows:
...
<configuration>
<appSettings>
<!-- The following settings are used by the
GenericItem Capability. -->
<add key="GenericItemDb.AssemblyName"
value="C:\inetpub\wwwroot\MetasysIII\Tool
\bin\Subsystems.Database.dll"/>
<add key="GenericItemDb.ClassName"
value="JohnsonControls.MetasysIII.Database.
GenericItemDbFactory"/>
...
</appSettings>
<system.web>
<httpRuntime executionTimeout="600"
maxRequestLength="40960"/>
</system.web>
</configuration>
On the Windows 10, Windows 8.1, Windows 8, Windows 7, Manually run the application as an Administrator:
Windows Server 2012 R2, Windows Server 2012, Windows
Right-click the application and select Properties > Run As
Server 2008 R2, and Windows Server 2008 operating system
Administrator.
(OS), applications (including Windows Tools such as IIS
Manager, Windows Event Viewer, and so on), cannot run
with Administrative privileges even though you are logged
in to the computer as an Administrator.
On Windows 10, Windows 8.1, Windows 8, Windows 7,
Manually run the application as an Administrator:
Windows Server 2012 R2, Windows Server 2012, Windows
Right-click the application and select Run As Administrator.
Server 2008 R2, and Windows Server 2008, when using
Windows Authentication to access a SQL database with
SQL Server Express Management Studio (or other
user-driven application), you do not obtain sysadmin
permissions in the SQL database even though you are
logged in to the computer as Built-in/Administrators and
have sysadmin permissions in the SQL database.
686
Solution
One of the following errors appears after attempting a global When running Metasys Release 3.0 or later, you cannot use
modification:
the global modify feature on devices at Release 2.2 or earlier.
Object does not exist.
One or more attribute modifications failed.
An object appears with no name in the navigation tree or
the Focus/Configuration tab.
687
Solution
This is a misuse of the Release All command. The Release All
command works exactly as designed. The proper command to
use is the Override Release command.
To recover the FEC controller from a Release All Command,
issue the command value determined by the application instead
of the relinquish default.
To release an override, use the Override Release command.
For other types of releases, make sure you use the release that
corresponds to the command to release.
The Metasys system cannot discover BACnet Trend Logs You cannot discover BACnet Trend Logs on a Siemens device.
on a Siemens device.
Add the Trend Log manually to show the trend log attributes in
the views and log data graph properly. The Siemens third-party
Trend Log object does not support the Logging Type attribute,
which is used in the BACnet discovery process.
When adding a LONWORKS point manually, the Target
Reference appears blank.
This is normal functionality. Manually type the path for the Target
Reference (path into the controller for the data being mapped
by the object) in the text box on the Select Data Source screen.
You cannot command analog objects to values outside of Change the minimum and maximum range to include the values
the minimum and maximum present value allowable range. used to ensure your features work properly.
If you have objects with values outside of the allowable
range and upgrade to the next software release, the objects
may now appear unreliable.
This affects programmed features such as the LCT,
Scheduling, and the multiple command object (MCO), as
well as manual commands.
The Metasys system cannot command or write LONWORKS, Priority 6 (Minimum On Off) is reserved by the BACnet protocol
for minimum on/off control. You may need to edit interlocks,
N1, N2, XL5000, and VND output points at priority 6
multiple command objects, schedules, and LCT objects in
(Minimum On Off).
existing databases using this priority after converting them.
When a point goes into alarm, Metasys software receives If you experience this issue:
the alarm message and a multitude of normal messages.
1. In the Notification Class object, on the Focus\Configuration
You must acknowledge all normal messages to get to the
tab, click Edit.
alarm message. You are not using BACnet intrinsic
2. Find the Ack Required attribute.
alarming.
3. Deselect To Normal.
4. Click Save.
Computer Name (Host Name) restrictions are unclear to
you.
688
Solution
Changes made at an NxE do not appear in the UI of the Site For releases prior to Release 5.0, use the Update All Items
Director.
Cache command to update the All Items cache on the Site
Director.
See the Update All Items Cache command and All Items Update
in Progress attribute descriptions in the Site Object section for
details.
Note: The All Items cache automatically updates for engines
at Release 5.0 or later.
You cannot edit an LCT process on an NxE at version 2.1 You cannot have mixed revisions when you want to edit the
or 2.2 from ADSs/ADXs at Release 3.0 or later.
LCT in the Engine from the ADS/ADX, if the ADS/ADX is at
Release 3.0 or later. You cannot have devices at different
The following error message appears when attempting to
releases because the Scalable Vector Graphic (SVG) rendering
edit LCT processes or Program (Control System) objects
program was changed after Release 2.2.
from earlier versions:
This change in functionality is per design. As the system
This logic diagram is read-only for the current
progressed, we were unable to support newer features while
version of Metasys. To edit the diagram you
maintaining the ability to edit the processes created in the earlier
must directly log in to the device on which it versions. To edit LCT processes or Program (Control System)
is located.
objects in a mixed system, you need to log in to the Engine
A similar error message appears if you try to edit a graphic directly.
object at Release 2.2 or earlier from a Site Director at
Release 3.0 or later.
The download seems to progress correctly, but the SCT UI This issue can occur at any Metasys release and is a result of
reports that the load still is establishing communications. a problem with the ActionQ. With this issue, the load executes
No errors appear.
successfully, but the UI does not show the status of the
download correctly. If you suspect the download is complete,
refresh the screen and verify that the status of the download is
complete.
This issue may be due to the following circumstances:
Some graphics appear jumbled when viewed in a single
pane. If you minimize the window and maximize it again,
older Java software components are present on the
the problem resolves for a few moments and then recurs.
computer
689
Solution
Nodes in the navigation tree are slow to open for Release This behavior may occur if the NavTreeCache database requires
5.0 or later.
maintenance. A stored procedure in the NavTreeCache
database called spu_DoDBMaintenance performs the required
maintenance. You can run this stored procedure manually or
on a schedule using either the SQL Server Agent or Windows
OS Task Scheduler. Refer to microsoft.com for details on stored
procedures and how to run them.
When entering the IP address in the Internet Explorer
address bar to launch Metasys software, Multiple UI
windows open.
Email is no longer being sent after upgrading from Release Due to changes made at Release 5.0, you may need to rebuild
4.0 to Release 5.0.
the Email DDA.
You are editing pager destinations and you lose some of
the definitions.
This alarm indicates that the ADS/ADX server could not process
at least one message in the Metasys_trendbacklog queue. The
NAE might be receiving trend data from a point with an
unsupported data type. For further assistance, contact the Field
Support Center (FSC).
690
Solution
On Windows 10, Windows 8.1, Windows 8, Windows Server Always view the SMP UI on the desktop. The Alarms window
2012 R2, or Windows Server 2012, the Alarms window does does not appear on the Windows 10, Windows 8.1, Windows
not appear.
8, Windows Server 2012 R2, or Windows Server 2012 Start
screen.
On Windows 10, Windows 8.1, and Windows 8, with Internet To resolve this issue, in Internet Explorer go to Tools > Internet
Explorer 10, when you click Print Preview for a Graphics+ Options > Security tab and complete the following tasks:
object, the following ActiveX web browser message
add the Metasys site as a Trusted site. Ensure you clear
appears:
the check box next to Require server verification (https:)
for all sites in this zone.
An ActiveX control on this page is not safe.
Your current security settings prohibit running change the security level to Medium-low.
unsafe controls on this page. As a result, this Next, go to the Advanced tab and set the ActiveX settings from
page might not display as intended.
Disable to Prompt.
The Print Preview window does not open.
The following message appears in the Alarms window or
in the Event Viewer:
691
Index
A
Access Types..............................................................23
Basic....................................................................23
Standard..............................................................23
Tenant..................................................................23
Accumulator..............................................................330
Accumulator Object..................................................330
Action Tables Tab......................................................554
Add..............................................................................97
Annotation.............................................................97
ADS Device Object..................................................230
ADS/ADX......................................................................9
Alarm...........................................................................80
BACnet Event Enrollment Object........................80
Alarm and Event Management..................51, 67, 69, 77
BACnet Integration Alarming................................77
Event Priority........................................................67
Metasys Systems with BACnet Devices..............77
Steps.....................................................................69
Alarm Extensions................................................53, 153
Alarm Tab..................................................................554
Alias..........................................................................600
Analog Input..............................................................311
Analog Input Object..................................................311
Analog Output..........................................................316
Analog Output Object................................................316
Analog Value............................................................324
Analog Value Object..................................................324
Annotation.................................................76, 95, 9798
Add................................................................76, 97
Audit Message......................................................95
Create.............................................................76, 98
View................................................................76, 97
Annotations................................................................37
Associated Graphic Tab............................................554
Attribute Name..........................................................545
Attributes...................................................................545
Audit Message..........................................92, 95, 9899
Annotation.............................................................95
Discard..................................................................98
Forward to Default Destination............................98
Launch Associated Item Focus View....................99
Sort......................................................................98
Audit Repositories......................................................90
Audit Repository....................................................96, 98
Clear....................................................................98
Configure Engine..................................................96
692
C
Calendar............................................................366, 368
Calendar Object........................................................366
Calendar Tab............................................................558
Change Results Viewer....................................125127
Steps...................................................................127
Clear............................................................................98
Audit Repository..................................................98
Command..................................................136, 141143
Item.....................................................................141
Multiple Items......................................................142
Use Global Search..............................................143
Commands................................................................548
Commands Dialog Box............................135136, 141
Steps...................................................................141
Common Object Attributes................................548549
Communications Tab................................................559
Configuration Tab......................................................559
Configure.....................................................................96
Engine Audit Repository......................................96
Control System..........................................................431
Control System Object..............................................431
Create.................................................................98, 548
Annotation.............................................................98
Create New Summary Definition Wizard..................640
Create New User View..............................................633
Create New User View Wizard..................................633
D
Data Broadcast........................................................470
Data Broadcast Object..............................................470
Data Type..................................................................546
Database Timeout Error..............................................54
DDA............................................................................70
Configure..............................................................70
Default Destination........................................55, 91, 629
Delete........................................................................549
Demand Limiting......................................................472
Department of Defense Banner..................................20
Diagnostic Tab..........................................................559
Dialog Box.................................135136, 144145, 642
Commands.................................................135136
Global Commands..............................................136
Global Modify......................................................145
Modify.................................................................144
Preferences........................................................642
Discard........................................................................98
Audit Message......................................................98
Display Attribute........................................................548
DLLR........................................................................472
DLLR Object..............................................................472
DoD Banner................................................................20
E
Effective Period........................................................378
Electric Demand Control Object................................389
Electric Demand Monitoring Object..........................389
Electronic Signatures..................................................37
Email..........................................................................63
Event Message Destination..................................63
Email Tab..................................................................559
Engine...........................................................................9
Engine Device..........................................................217
Engine Device Object................................................217
Engineering Tab........................................................562
Event...................................................................51, 372
Event Enrollment................................................80, 390
Configuration Example........................................80
Event Message...............................................60, 7476
Acknowledge........................................................74
Configure Format..................................................74
Discard..................................................................75
Filter......................................................................60
Destinations..................................................60
Launch Associated Graphic..................................76
Launch Item Focus View......................................75
Route....................................................................60
Route Using Filter................................................74
Sort......................................................................75
Event Message Annotation........................................59
Event Message Flow..................................................53
Event Message Forwarding........................................59
Event Messages....................................................49, 56
Event Parameters....................................................390
Event Priority..............................................................67
Event Relationships..................................................390
Event Repositories......................................................54
Event Repository........................................................69
Configure Engine..................................................69
Event Respository......................................................70
Configure ADS/ADX............................................70
Event Tab..................................................................562
Event Viewer............................................4849, 56, 75
Create Custom Filter............................................75
Launch..................................................................48
Print Event Message............................................75
Exception Schedule..................................................371
Extension Wizard......................................................152
Extensions........153, 172, 182, 191, 200, 202, 205, 545
Alarm..................................................................153
693
Averaging............................................................202
Load....................................................................191
Resource File......................................................200
Steps...................................................................205
Totalization..........................................................172
Trend..................................................................182
F
Fast Clock................................................................379
Feature Tabs............................................................553
Features..............................................................51, 657
Alarm and Event Management............................51
Global Search.....................................................657
Filter......................................................................74, 98
Apply....................................................................74
Create Custom......................................................98
Filter Examples..........................................................62
Filter Operators..........................................................61
Filter Options..............................................................61
Focus Tab..................................................................562
Forward......................................................................98
Audit Message......................................................98
G
Generator Load Control Object................................389
Generic Integration....................................................252
Generic Integration Object........................................252
GGT..........................................................................611
GIO............................................................................252
Global Calendar........................................................380
Global Command..............................................142143
Use Global Search..............................................143
Global Command Support........................................139
Global Commands Dialog Box..................................136
Global Data Sharing..................................................488
Global Modify....................................................149150
Global Search.....................................................150
Global Modify Dialog Box..........................................145
Global Search...................................143, 150, 657, 661
Steps...................................................................661
Global Search Viewer..............................................658
Graphic......................................................................622
Graphic Generation Tool..........................................611
Graphic Object..........................................................622
Graphic Tab..............................................................562
Graphic Workspace..................................................591
Graphics+..........................................................611, 621
Steps...................................................................621
Group........................................................................395
Group Object............................................................395
Group Tab................................................................562
H
Hardware Tab............................................................562
Historical Data..................................................624625
Management.......................................................625
I
IEIEJ BACnet System..............................................389
IEIEJ BACnet System Objects..................................389
Initial Value................................................................547
Input Category Tab....................................................580
Insert Control System................................................431
Insert Control System Wizard..................................431
Insert Field Device....................................................274
Insert Field Device Wizard........................................274
Insert Folder Wizard..................................................431
Insert Graphic............................................................590
Insert Graphic Wizard..............................................590
Insert Integration......................................................248
Insert Integration Wizard..........................................248
Insert Metasys Server..............................................230
Insert Metasys Server Wizard..................................230
Insert Object Wizard..................................................467
Insert Point................................................................310
Insert Point Wizard....................................................310
Insert Site Wizard......................................................209
Insert Supervisory Device........................................217
Insert Supervisory Device Wizard............................217
Insert Trend Study....................................................624
Insert Trend Study Wizard........................................624
Interlock....................................................................491
Interlock Definition Tab..............................................580
Interlock Object........................................................491
Intrinsic Alarming........................................................78
L
Launch..................................................................87, 99
Audit Viewer..........................................................87
Item Focus View Associated with Audit
Message..............................................................99
Launcher....................................................................17
LCT..........................................................................433
Life Safety Point........................................................396
Life Safety Point Object............................................396
Life Safety Zone........................................................400
Life Safety Zone Object............................................400
Load Extensions........................................................191
Load Rolling..............................................................472
Load Summary Tab..................................................580
Load Tab..................................................................580
Logic..........................................................................436
Logic Connector Tool........................................433, 456
694
Steps...................................................................456
Logic Tab..................................................................580
Login..........................................................................20
LON Controller..........................................................287
LON Controller Object..............................................287
LON Integration........................................................263
LON Integration Object............................................263
LONWORKS Network Integration............................253
Loop..........................................................................403
Loop Object..............................................................403
M
Members Tab............................................................580
Metasys Modes....................................................2223
Offline..................................................................22
Online..................................................................22
Simulation............................................................23
Metasys System Overview............................................9
Mode Set..................................................................548
Modify........................................................................147
Attributes.............................................................147
Modify Dialog Box....................................................144
MS/TP Field Bus Integration....................................255
MS/TP Field Bus Integration Object..........................255
Multiple Command....................................................502
Multiple Command Object........................................502
Multistate Input..........................................................410
Multistate Input Object..............................................410
Multistate Output......................................................413
Multistate Output Object............................................413
Multistate Value........................................................418
Multistate Value Object............................................418
N
N1 Integration............................................................252
GIO....................................................................252
N1 Migration..............................................................266
N1 Migration Object..................................................266
N1 PID Loop..............................................................507
N1 PID Loop Object..................................................507
N1 Pulse Counter......................................................506
N1 Pulse Counter Object..........................................506
N2 Controller............................................................291
N2 Controller Object..................................................291
N2 Master Datalink (N2 Trunk)..................................269
N2 Master Datalink Object (N2 Trunk)......................269
NAE..............................................................................9
Navigation Tree..........................................................25
NCE..............................................................................9
Network Automation Engine......................................217
Network Tab..............................................................581
695
Program....................................................................431
Program Object........................................................431
Proportional..............................................................508
Proportional plus Integral..........................................508
Proportional plus Integral plus Derivative..................508
Pulse Meter..............................................................532
Pulse Meter Object....................................................532
R
Range........................................................................547
Recipient List Tab......................................................584
Related Documentation................................................6
Remote Services Connection....................................585
Report Output............................................................668
Report Output Viewer................................................668
Report Schedule......................................................667
Reports................................................................31, 655
Resource File Extensions........................................200
Resource Tab............................................................586
Route..........................................................................67
Event Messages..................................................67
Example........................................................67
S
Schedule...........................................................369, 425
Schedule Object........................................................425
Schedule Tab............................................................586
Scheduled Report............................................667668
Object List..........................................................667
Report Output....................................................668
Report Schedule................................................667
Scheduled Reports....................................................668
Steps...................................................................668
Scheduled Reports Viewer........................................125
Scheduling................................368369, 372, 378, 382
Event...................................................................372
Items..................................................................372
Scheduling Concepts..........................................368
Scheduling Steps................................................382
Trend..................................................................378
Scheduling Scenarios..............................................673
S C T ..............................................................................9
Server............................................................................9
Signal Select............................................................537
Signal Select Object..................................................537
Simulation Mode........................................................23
Site............................................................................209
Site Management Portal UI..................................10, 37
Steps.....................................................................37
Site Object................................................................209
Site View Tab............................................................587
SNMP Tab................................................................587
SNMP Trap..................................................................66
Event Message Destination..................................66
Solar Clock................................................................540
Solar Clock Object....................................................540
Sort..............................................................................98
Audit Message List..............................................98
Standard Access........................................................23
State Set..................................................................548
Status Attribute..........................................................548
Study Range............................................................629
Summary Definition Object......................................640
Summary Definition Tab............................................589
Summary Definitions Library....................................108
Summary Tab............................................................589
Symbols....................................................................595
System Overview..........................................................9
System Preferences..................................................651
T
Tab............554, 558559, 562, 580584, 586587, 589
Action Tables......................................................554
Alarm..................................................................554
Associated Graphic............................................554
Averaging............................................................554
BACnet Alarm....................................................554
Calendar............................................................558
Communications................................................559
Configuration......................................................559
Diagnostic..........................................................559
Email..................................................................559
Engineering........................................................562
Event...................................................................562
Focus..................................................................562
Graphic...............................................................562
Group..................................................................562
Hardware............................................................562
Input Category....................................................580
Interlock Definition..............................................580
Load....................................................................580
Load Summary..................................................580
Logic..................................................................580
Members............................................................580
Network..............................................................581
Options..............................................................581
Output Category................................................581
Pager..................................................................582
Parameter Category..........................................583
Printer................................................................583
Profile..................................................................584
696
Recipient List......................................................584
Resource............................................................586
Schedule.............................................................586
Site View............................................................587
SNMP................................................................587
Summary............................................................589
Summary Definition............................................589
Tailored Summary..............................................589
Totalization..........................................................589
Tree View............................................................589
Trend..................................................................589
Trend Study........................................................589
User Defined Enumeration Editor......................589
Tailored Summary....................................................125
Troubleshooting..................................................125
Tailored Summary Tab..............................................589
Tenant Access............................................................23
Timed Logout..............................................................36
Totalization Extensions..............................................172
Totalization Tab........................................................589
Tree View Tab..........................................................589
Trend Extensions......................................................182
Trend Scheduling......................................................378
Trend Studies............................................................624
Concepts............................................................624
Trend Study.......................................624625, 629630
Range................................................................629
Steps...................................................................630
Trend Study Tab........................................................589
Trend Tab..................................................................589
Trend Viewer......................................................99, 103
Concepts..............................................................99
Steps...................................................................103
Views....................................................................99
Troubleshooting........................................................683
Type Set....................................................................548
U
UGT..........................................................................591
UGT Modes..............................................................591
User Defined Enumeration Editor Tab......................589
User Graphics Tool............................591, 595, 600, 603
Alias....................................................................600
Graphic Workspace............................................591
Modes................................................................591
Steps...................................................................603
Symbols..............................................................595
User Interface..................................................10, 23, 31
Access Types........................................................23
Diagnostics Window............................................31
Screen Layout......................................................23
Building Efficiency
507 E. Michigan Street, Milwaukee, WI 53202
Metasys and Johnson Controls are registered trademarks of Johnson Controls, Inc.
All other marks herein are the marks of their respective owners. 2016 Johnson Controls, Inc.
Published in U.S.A.
www.johnsoncontrols.com
697