Server Attributes - Metasys - LIT-12011964 - Software Application - SCT System Configuration Tool - 16.0

ADS Repositories

C,W

ADS, ADX, OAS, ODS

For an ADS, ADX, or OAS, this attribute lists the ADS/ADX device host names or IP addresses to which incoming trend and Alarm/Event data forwards. An ADS, ADX, or OAS cannot have its own host name or IP address in this field. Refer to the ADS/ADX Commissioning Guide (LIT-1201645) for details on configuring repositories.

For an ODS, this attribute 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).

For an ODS, 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

ADS, ADX, OAS, ODS

Indicates the status of the devices listed in the ADS Repositories attribute.

Range: Offline, OK

C,W

5

ADS, ADX, OAS, ODS

Specifies the amount of time to delay after an operator temporarily ignores, or snoozes an alarm before re-announcing the alarm.

Range: 0 to 75

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

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

Range: 2 to 10

C,W

10,000

Indicates the amount of time in milliseconds between retransmission of an APDU segment.

Range: 1,000 to 65,535

Units: milliseconds

C,W

10,000

Indicates the amount of time in milliseconds between retransmissions of an APDU requiring acknowledgment for which no acknowledgment has been received.

Range: 1,000 to 65,535

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

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

Range: 0 to 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.

ADS, ADX, OAS, ODS

Indicates whether the DHCP protocol should be used.

Range: true, false

The device may run in three modes:

• DHCP is enabled and a DHCP server exists on the network. The DHCP server assigns network configuration information. 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:
  • JCI IP Address
  • IP Mask, ODS only
  • IP Router Address, ODS only
  • DNS Server IP Addresses, ODS only, when the Obtain DNS Address Automatically attribute is True
• DHCP is enabled and no DHCP server exists on the network. Using the Automatic Client Configuration feature, the device automatically defines the network configuration.

• DHCP is disabled. You must manually assign the JCI IP Address attribute. On an ODS you must also manually assign the IP Mask attribute.

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)

ADS, ADX, OAS, ODS

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

ADS, ADX, OAS, ODS

Indicates 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 percent to which this buffer is filled is indicated by the Transfer Buffer Full Worst 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.

Range: 60 to 86,400

Units: seconds

C,W

120

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 server restart (cold or warm).

Range: 5 to 255

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.

Range: 0 to 144

Units: minutes

This attribute is only available on validated sites.

Enables the MVE feature at the device, which includes re-authentication with electronic signature and required annotation when the user makes a change to the system, such as commanding an object, acknowledging an alarm, or changing the value of an attribute. This attribute can be set to True for MVE sites only. This attribute is writable only with the SCT, and is read-only online.

Range: true, false

ADS, ADX, OAS, ODS

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 server 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 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. See the DHCP Enabled attribute.

ADS, ADX, OAS, ODS

Displays the date on the server.

ADS, ADX, OAS, ODS

Displays the time on the server.

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.

Range: 128 to 65,535

Units: bytes

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.

range: 98 to 65,535

Units: bytes

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

ADS, ADX, OAS, ODS

Indicates the name of the device model.

C,W

1,001

Specifies the BACnet network address. A change to this attribute takes effect after the next server restart (cold or warm).

ADS, ADX, OAS, ODS

For an ADS/ADX, displays the number of NxE devices that registered this ADS/ADX as their trend repository.

For an ODS, displays the number of NxEs reporting to your server.

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

If set to true, when an ODS receives an alarm from a device that is not mapped, the ODS maps the device and processes the alarms for that device. If set to false, an ODS ignores alarms from devices that are not mapped.

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.

ADS, ADX, OAS, ODS

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.

ADS, ADX, OAS, ODS

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

Units: seconds

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.

Range: 0 to 1,440

Units: minutes

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.

ADS, ADX, OAS, ODS

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

ADS, ADX, OAS, ODS

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.

Units: seconds

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

ADS, ADX, OAS, ODS

For the ADS, ADX, and OAS, this attribute indicates the data value collection rate of the Ready 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.

For the ODS, this attribute 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 for the ODS.

Units: per minute

Maximum value: 83,333

ADS, ADX, OAS, ODS

This attribute indicates the number of data values currently locally stored by the Ready Time Series Data feature as a percentage of the maximum allowed. Typically, data samples are routinely delivered to an online client and the data usage remains small. When the client is unknown or offline, data values continue to accumulate in local storage until limits are reached. This feature is used by a Site Director and is updated every 1 minute. For the ADS, data values are accumulated in memory and stored in batches in a disk-based queue limited to 10,000 entries. This attribute is based on the worst case queue usage of all clients of this feature.

Units: %

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 server's local repository. This count does not persist through a server reset, and reflects the number of lost events since the last reset.

Incoming Audit Rate

Units = Per Hour

ADS, ADX, OAS, ODS

Specifies the average rate of audits, per hour, received from other devices (NxEs or ADS/ADXs) during the previous hour. The value of this attribute updates every 5 minutes. This rate only includes audits generated by devices at Release 5.2 or later.

ADS, ADX, OAS, ODS

For an ADS, ADX, or OAS, this attribute indicates the average rate of events, per hour, received from other devices (NxEs or ADS/ADXs) during the previous hour. This rate only includes events generated by devices at Release 5.2 or later.

For an ODS, this attribute indicates the number of event messages destined for the Metasys server in the last hour, and is for diagnostic purposes.

The value of this attribute updates every 5 minutes.

Units: per hour

ADS, ADX, OAS, ODS

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.

Units: seconds

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

It is calculated as follows:

Total commit charge x 100

Display Precision = 0.1

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.

ADS, ADX, OAS, ODS

For an ADS, ADX, or OAS, this attribute indicates the average rate of events per hour, sent to other repositories (ADS/ADXs). This rate only includes events generated by devices at Release 5.2 or later.

For an ODS, this attribute indicates 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.

Units: per hour

ADS, ADX, OAS, ODS

For an ADS, ADX, or OAS, this attribute indicates the number of registrations used by the Ready Metasys Time Series Data feature. 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.

For an ODS, this attribute 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 on an ODS.

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

ADS, ADX, OAS, ODS

Specifies the number of transport failures per day (for diagnostic purposes). This number represents how often HTTP posts from this server 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.

Units: failures per day