A.5 BMC Software PATROL

Table A-5 BMC Software PATROL Adapter Properties



Alarm Columns

A comma-separated list that determines which alarm columns display and the order in which the alarm items display (date/time, rule, etc.) in the Alarms view. The default list is:


Hierarchy File

A file in the /OperationsCenter_install_path/database directory that contains an XML description of the element hierarchy to build below the adapter element. The default is examples/PatrolHierarchy.xml.

KM Operations Permissions

ACL permissions to assign PATROL dynamic operations on elements. The default is Define.

Max Alarms Per Host

The maximum number of alarms that the adapter retains from each PATROL host. The default is 100.

This total number of alarms is cumulative. For example, if the default is 200 and there are five hosts, then the adapter can accept 1000 total alarms. Alarms can also roll over. If there are 250 alarms from one host, the adapter can represent all of them, as long as the total does not exceed 1000.

Max Alarms Queried

The maximum number of events that each agent can mine and display in Operations Center. Assigning a low value on a very active set of agents can improve performance of initial discovery and does not impede the display of meaningful information. Alarms rapidly accumulate after connecting to the agent. The default is 50.

Max Hours Alarms Retained

The maximum number of hours to retain alarms. For example, enter 24 to retain only alarms received within the last 24 hours. Overrides the Max Alarms Per Host and Max Alarms Queried values.

Property Page Permissions

Assigns user access privileges for PATROL-specific property pages: Libraries, Communication Settings, Host, and Hosts (available at the host element level). The default privilege is Define, which allows users to edit and update all property pages. You must use one of the valid Operations Center access privileges: View, Access, Manage, or Define. For example,


For details on these privileges, see the Operations Center 5.6 Security Management Guide.


A script that executes if the adapter fails for any reason. For example, the script can print the reason for the failure as msg using log.info(msg).


A script that executes upon adapter initialization. All of the Script.* properties are optional.


A script that executes when the adapter starts.


A script that executes after manually stopping the adapter.

Show Timestamp in Agent System Output Window

If True, displays the time stamp of PATROL messages in the PATROL agent’s System Output window which displays after clicking Show Output Window in the Operations Center console on a host machine. If False, it does not display the time stamp. The default is False.

The time stamp values do not originate from PATROL; instead, Operations Center generates the time stamp when it receives a message. As a result, time stamps in Operations Center might not match exactly what displays in the PATROL console.

Stylesheet File

The stylesheet file in the /OperationsCenter_install_path/database directory that applies to the HierarchyFile as a style markup to produce the final output.

Use Alarm Times For Condition Changes

The date/time stamp to use for all alarm data stored by the Operations Center Data Warehouse. If true, the alarm’s date/time stamp is used. If false, the date/time stamp of when the Operations Center server received the alarm is used. The default is true.

Alarm history is stored based on the alarm time rather than alarm receipt time. Also, for SLA metric data based on alarm properties, the property values are recorded based on the alarm time instead of the alarm receipt time. Note that recording historical condition data for historical alarms is not supported.