Alert status settings

The alert status settings control whether and how devices are displayed in topology maps, and the frequency with which the settings are updated.

The alert status settings are contained in the $NMGUI_HOME/profile/etc/tnm/status.properties file. You can control the following settings:

Table 1. Alert status settings
Setting	Description
`status.color.background.severity`	The `status.color.background.severity` property specifies background status color for each alert severity level.
`status.color.foreground.severity`	The `status.color.foreground.severity` property specifies the color of the device label text for each alert severity level.
`status.globalfilter`	The `status.globalfilter` property filters certain alerts from the status display of devices in the topology maps. This property filters on the `alerts.status` table of the ObjectServer. In versions of Network Manager prior to 4.2 Fix Pack 6, this property did not apply to the standalone Structure Browser. Starting with Fix Pack 6, the `status.globalfilter.apply.to.structurebrowser` property controls whether the value of `status.globalfilter` is applied to the standalone Structure Browser. The following example prevents ping fail events from affecting the displayed status of devices in the topology: `status.globalfilter=EventId<>'NmosPingFail'` The following example displays the status of only those devices in the topology views that have associated events with `EventId ='NmosPingFail'`: `viewsstatus.globalfilter=EventId='NmosPingFail'` The following example displays status of devices in the topology views that have associated events with `Severity` of `Minor`, `Major` or `Critical`: `status.globalfilter=Severity>2`
`status.globalfilter.apply.to.structurebrowser`	If this property is set to `true`, the value of `status.globalfilter` is applied to the standalone Structure Browser, in addition to all other locations where alert status is shown. If this property is set to `false`, `status.globalfilter` is not applied to the standalone structure browser. The default value is `true`.
`status.hopview.linestyle`	The `status.hopview.linestyle` property indicates whether to display the alert status on links between nodes in the Hop View. By default, the status of links is set to `simple`, another possible value is `detailed`. Do not have a value of `none`. If `status.hopview.linestyle=none`, the show events tool displays an error for links because no status is registered for, nor requested.
`status.map.updateperiod`	The `status.map.updateperiod` property specifies how often the system updates the alerts status settings in the topology maps.
`status.map.maxnodes`	The `status.map.maxnodes` property indicates the maximum number of nodes for which alert status can be displayed in a single topology map.
`status.map.image.severity`	The `status.map.image.severity` property specifies the icons that are used to represent device alert status in the topology map. To customize these icons, create a GIF or SVG icon with the relevant name and save it to the following location: $NMGUI_HOME/profile/etc/tnm/resource/.
`status.map.image.size.severity`	The `status.map.image.size.severity` property specifies the size of the icons to use to represent device alert status in topology maps.
`status.map.image.xoffset.severity` `status.map.image.yoffset.severity`	The `status.map.image.size.severity` and `status.map.image.yoffset.severity` properties specify x-axis and y-axis offset of the icon. The NE (northeast) positioning would place the icon so that it is touching the frame surrounding the device. The offset values moves the icon slightly down and to the left, so that it is positioned just inside the frame.
`status.map.topcolor.saturation.severity` `status.map.bottomcolor.saturation.severity` `status.map.topcolor.brightness.severity` `status.map.bottomcolor.brightness.severity`	The `status.map.topcolor.saturation.severity`, `status.map.bottomcolor.saturation.severity`, `status.map.topcolor.brightness.severity`, and `status.map.bottomcolor.brightness.severity` properties specify saturation and brightness adjustment controls that control the gradient of the background status color for each alert severity level.
`status.netview.linestyle`	The `status.netview.linestyle` property indicates whether to display the alert status on links between nodes in the Network Views. By default, the status of links is set to `simple`, another possible value is `detailed`. Do not have a value of `none`. If `status.netview.linestyle=none`, the show events tool displays an error for links because no status is registered for, nor requested.
`status.none.enabled`	The `status.none.enabled`property indicates whether the `none` status for a device is represented in the same way as the `clear` status. Tip: `none` status means that no events have been received for the device. `clear` status means that earlier events of severity level 1 or more have now been cleared on the device.
`status.registration.devicealert`	Set the `status.registration.devicealert` property to `true` to include alerts from devices in the alert status of views that are based on device components. For example, if you have an MPLS view that includes only interfaces, you might want to exclude alerts from the chassis of the devices containing those interfaces. To exclude alerts from the main nodes, set this property to `false`.
`status.registration.threadscalefactor`	The `status.registration.threadscalefactor` property defines how many threads are used to register alert status. For example, if the `status.registration.threadlimit` property is set to 200 (the default), then one extra thread is used for each additional 200 views that a user has. This setting applies to all users. Increase the default setting if alert status takes a long time to appear on maps and in the Network View tree. More threads use more resources. Ensure that you have enough resources on the server to run the extra threads, based on your total number of users and views. Threads are increased up to the maximum defined by the `status.registration.threadlimit` property.
`status.registration.threadlimit`	The `status.registration.threadlimit` property defines the upper limit of the number of threads allowed per user to register alert status. Sets a limit for the scaling of threads defined by the `status.registration.threadlimit` property.
`status.table.image.severity`	The `status.table.image.severity` property specifies the icons that are used to represent device alert status in the topology map tabular layout. To customize these icons, create a GIF or SVG icon with the relevant name and save it to the following location: $NMGUI_HOME/profile/etc/tnm/resource/.
`status.table.image.sortUp` `status.table.image.sortDown`	The `status.table.image.sortUp` and `status.table.image.sortDown` properties specify how to sort alert severity icons in the topology map tabular layout.
`status.tree.bookmarks.enabled`	The `status.tree.bookmarks.enabled` property specifies whether device status is displayed in the Network View Bookmark tree. Set to `true` to enable and `false` to disable.
`status.tree.libraries.enabled`	The `status.tree.libraries.enabled` property specifies whether device status is displayed in the Network View Library tree. Set to `true` to enable and `false` to disable.
`status.tree.maxviews`	The `status.tree.maxviews` property specifies the maximum number of views that a Network View tree can contain and still display alert status.
`status.tree.registration.ondemand`	To enable on-demand Event Viewer filters in the Network View tree, change the value of the `status.tree.registration.ondemand` property to true. When you open an Event Viewer from a parent Network View in the Network View tree that has not been opened in the topology display pane, the Event Viewer shows events for all devices. If you click on the Network View, and then launch an Event Viewer from that view, the Event Viewer is filtered to show events on only those devices in that view. Enabling on-demand filters uses less heap memory. To disable on-demand Event Viewer filters in the Network View tree, change the value of the `status.tree.registration.ondemand` property to false. When you open an Event Viewer from any Network View, the Event Viewer is filtered to show events on only those devices in that view.
`status.tree.updateperiod`	The `status.tree.updateperiod` property specifies how often the system updates the alerts status settings in the Network Views and Structure Browser Navigation Panel.
`status.tree.image.severity` Where `severity` is a string or number specifying alert status severity	The `status.tree.image.severity` property specifies the icons that are used to represent device alert status in the network view tree. To customize these icons, create a GIF or SVG icon with the relevant name and save it to the following location: $NMGUI_HOME/profile/etc/tnm/resource/.
`status.view.enabled`	The `status.view.enabled` property specifies whether device status is displayed in Network Views, Network Hop View, and Structure Browser. Set to `true` to enable and `false` to disable.