ODS Attributes - Metasys - LIT-12011942 - "" - Software Application - Metasys Open Data Server - 10.1

ADS Repositories

C,W

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 site’s devices).

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

C,W

C,W

5

Units = Minutes

Specifies whether clock-aligned periodic time synchronization is enabled. If periodic time synchronization is enabled and the time synchronization interval is a factor of an hour or a day (that is, the value divides without remainder), then the beginning of the period specified for time synchronization aligns to the hour or day, respectively.

C,W

4

Indicates the maximum number of times that an 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 restart the ODS for the new settings to take effect.

2–10

C,W

4,000

Indicates the amount of time in milliseconds between retransmission of an APDU segment. If you write the value of this attribute, you must restart the ODS for the new settings to take effect.

1,000–32,767

Units = milliseconds

C,W

6,000

Indicates the amount of time in milliseconds between retransmissions of an APDU requiring acknowledgment for which no acknowledgment has been received. If you write the value of this attribute, you must restart the ODS for the new settings to take effect.

1,000–32,767

Units = milliseconds

Identifies the version of the application software installed in the device. The content of this string is locally defined (date-and-time stamp, a programmer’s name, a host file version number, and so on).

C,W

jci_bacnet _comm

Provides password protection of BACnet services, such as DeviceCommunicationControl and ReinitializeDevice. Third-party workstations may send these services and must provide the password for the Engine to execute the services. The default password is jci_bacnet_comm. Third-party workstations cannot read or write this password.

Specifies whether integrated objects are displayed in the object list. The values are:

• Include in Object List - Makes internal integration objects visible to BACnet devices. This is the default value.
• Exclude from Object List - Makes internal integration objects unavailable to BACnet devices.

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.

C,W

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.

0–65,535

W

Contains a list of BACnet Object Identifiers of an Engine Device object and a BACnet device address in the form of a BACnet Address. Entries in the list identify the actual device addresses that are used when accessing the remote device through a BACnet service request. The list may be empty if no device identifier-device address bindings are currently known to the device.

1. DHCP enabled and a DHCP server exists on the network. The DHCP server assigns network configuration information. The DHCP server can assign the following attributes:

   • JCI IP Address
   • IP Mask
   • IP Router Address
   • DNS Server IP Addresses (when Obtain DNS Address Automatically attribute is True)

2. DHCP enabled and no DHCP server exists on the network. Using the Automatic Client Configuration feature, the device automatically configures the network configuration. The following attributes can be assigned:

3. DHCP disabled. You must manually assign the network configuration.
   • JCI IP Address
   • IP Mask

Indicates whether daylight saving time is in effect (True) or not (False) at the device’s location.

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.

C,W

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 = 1–4 with 5 Audit Levels:

• 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.

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.

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.

C,W

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.

C,W

60

Sets the period when 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.

C,W

20

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 time period the Internode Comm Timer). A change to this attribute does not take effect until the next Engine restart (cold or warm).

C,W

0

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.

Represents the IP address of this Server. The JCI IP address identifies the server on the network and assists in the routing of messages. Each Engine must have a unique JCI IP address for the network to operate properly. A write to this attribute is ignored because configuration is completed through the Windows network configuration. A read of this attribute returns either the user specified value or the value determined from DHCP.

Certain JCI IP addresses are invalid and cannot be written successfully. The network address portion of the JCI IP address is computed by including all bits in which the corresponding bit from the IP mask is 1. The device address portion of the JCI IP address is computed by including all bits in which the corresponding bit from the IP mask is 0. Neither the network address nor device address can be all zero bits or all one bits. For example, if the IP mask is 255.255.0.0, the following IP addresses are invalid: 0.0.100.100 and 100.100.0.0.

The JCI IP Address attribute can be set explicitly, or it may be automatically set using the DHCP server. Using a DHCP server may change this attribute even if you have set it up explicitly.

Indicates the date to the best of the device’s 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.

Indicates the time of day to the best of the device’s 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.

C,W

(empty string)

Indicates the physical location of the device.

C,W

1,024

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.

C,W

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.

Indicates the maximum number of segments of an APDU accepted by the device.

Indicates the device model, the hardware revision associated with the firmware, and the code file name used to download the device.

C,W

1,001

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.

C,W

empty list

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.

Maximum 64 elements, values limited by range of unsigned 32

Indicates which standard BACnet object types the device’s 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.

Indicates which standard BACnet protocol services the device’s protocol implementation supports. For more information on the PICS and BIBBs of the Engine, see the table in the section. 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.

Represents the BACnet protocol the device supports. Initial releases are Version 1; subsequent releases increase the number by one.

C,W

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.

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.

Indicates if the device supports segmentation of messages and (if so) if it supports segmented transmission, reception, or both.

Displays the amount of time in seconds that it takes for the ODS device to poll all NxEs on the site for trend samples.

W

General

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, Services, Administrative, General, Lighting, Refrigeration, Critical Environment, Air Quality, Power, Energy, System, Custom 1–150

D

Reflects the current physical and logical state of the device.

Operational, Operational Read Only, Download Required, Download in Progress, Nonoperational, Backup in Progress

W

Defines how automatic BACnet time synchronization updates are transmitted. If the list is of length zero, a device is prohibited from automatically sending a Time Synchronization request. If the list is of length one or more, a device automatically sends a Time Synchronization request but only to the devices or addresses listed. If it is present, this attribute is writable.

C,W

0

Specifies the periodic interval, in minutes, at which TimeSynchronization and UTCTimeSynchronization requests are sent. When set to zero, then periodic time synchronization is disabled.

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.

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.

C

Contains the Universal Coordinated Time (UTC). The UTC Offset attribute indicates the number of minutes (-900 to +900) offset between local standard time and Universal Coordinated Time. The time zones to the west of the zero degree meridian are indicated by positive values, and those to the east are indicated by negative values. The value of the UTC Offset attribute is derived from the Default Time Zone attribute of the site.

5

Distinguishes proprietary extensions to the protocol using a unique vendor identification code assigned by ASHRAE.

The Johnson Controls Vendor ID is 5.

JCI

Identifies the manufacturer of the device.

Specifies the average number of seconds devices in the transport layer are offline (for diagnostic purposes). Only time period less than one minute are used in this average to eliminate device resets. Ideally, this number should be zero, indicating there are no failures.

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.

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.

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.

Specifies the number of COV messages the ODS sends to other supervisory devices per minute. This attribute updates every minute. Each COV message represents one object reporting a value.

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.

Indicates the data value collection rate of the cloud-based platform Time Series Data feature. Starting at Release 10.0, the remote services connection to a cloud-based platform is no longer available, so this attribute does not function.

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.

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 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.

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.

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.

Specifies the maximum number of seconds a device was offline at the transport layer (for diagnostic purposes). Only time period under one minute are recorded, to eliminate device resets. The value of this attribute does not match the offline time period determined from generated alarms. Ideally, this number should be zero, indicating there are no failures.

Specifies the percent of system RAM that is currently in use.

It is calculated as follows:

Total commit charge x 100

Display Precision = 0.01

COV Increment = 0.1

C,W

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.

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 device’s 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.

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.

Indicates the number of registrations used by the Metasys Time Series Data feature in the cloud-based platform. Starting at Release 10.0, the remote services connection to a cloud-based platform is no longer available, so this attribute does not function.

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

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.

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.

Indicates the time, in minutes, between Engine trend consolidation buffer readings from the Metasys server (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.