This topic discusses how to set and control blackouts for various BMC PATROL objects.
You can set blackouts for various PATROL objects such as parameters, application instances, or application classes by using the BMC PATROL Agent configuration interface.
You can control blackouts for PATROL objects by using options for setting types of blackouts.
You can use the /AgentSetup/Blackout configuration branch to configure blackouts for PATROL objects. The branch maintains the list of objects that you want to black out and the object-specific blackout configuration such as the type of blackout, schedule information, duration, and information message to be associated with the blackout.
You can configure a blackout by using pconfig, wpconfig (Windows), xpconfig (UNIX ® ), PATROL Configuration Manager, or a PSL pconfig script, by using the following format:
"/AgentSetup/Blackout/<object>" = {REPLACE = "[TYPE; START_INFO; DURATION; INFO_MSG]"}
The preceding format contains the following options:
<object> represents the PATROL object that you want to black out. Specify the PATROL object as described in the following table.
PATROL objects
PATROL object options | Description |
---|---|
Application class | Blackout is applied to the specified application class, and all the instances and the parameters contained in the application class instances. |
Application class instance | Blackout is applied to the specified application class instance and all its parameters. |
Parameter | Blackout is applied to the specified parameter. |
The object is specified in the following format:
/APP_NAME[/INST_NAME][/PARAM_NAME]
You can specify the application class ([/APP_NAME]
) in an exact form, and in a generic form by using the __ANYAPPL__ wildcard string, as illustrated below:
__ANYAPPL__ applies the blackout to all the application classes, instances, and parameters contained in that application class.
Note
If you have set the blackout for a specific PATROL object for the same or overlapping duration of time, the product applies the combined blackout to that PATROL object. For example, if you have set the TYPE_COLLECTION blackout on an application class by using __ANYAPPL__ and have set the TYPE_EVENT blackout on a parameter contained in that application class, the resultant blackout type for that parameter is TYPE_COLLECTION | TYPE_EVENT.
You can specify the application class instance ([/INST_NAME]
) in an exact form, and in a generic form by using the __ANYINST__ wildcard string, as illustrated below:
For example,
"/AgentSetup/Blackout/PROCPRES/__ANYINST__/PROCPPCount" = {REPLACE = "[TYPE; START_INFO; DURATION; INFO_MSG]"}
Type name | Type value | Description |
---|---|---|
TYPE_COLLECTION | 1 | Suppresses data collection for parameters of an application class or an application class instance |
TYPE_ALARM | 2 | Suppresses range evaluations |
TYPE_EVENT | 4 | Suppresses event generation
|
TYPE_RECOVERY | 8 | Suppresses recovery action |
TYPE_SNMPTRAP | 16 | Suppresses Simple Network Management Protocol (SNMP) traps generated by the standard event classes |
TYPE_INFO | 32 | Generates only the blackout start and stop information events |
TYPE_ALL | 63 | Runs all blackout types |
When an event is generated for a PATROL object, the event description displays the type values described in the above table for various types of blackout.
Notes
You can define multiple types by separating the types by using a | as in case of TYPE_EVENT|TYPE_RECOVERY|TYPE_COLLECTION
, TYPE_RECOVERY|TYPE_SNMPTRAP
, and so on.
START_INFO represents the condition when you want the blackout to start for the specified object. Specify START_INFO in the following format:
START \[ONCE/DAILY/DOW/DOM] \[LIST OF DAYS\] AT TIME
The following table describes the values that you can specify for START_INFO.
START_INFO options
START_INFO options | Description |
---|---|
ONCE | Applies the blackout once |
DAILY | Applies the blackout daily |
DOW | Applies the blackout on a day of the week |
DOM | Applies the blackout on a day of the month (1 to 31) |
LIST OF DAYS | Applies the blackout on the list of days that you specified as a range by using ‘
|
TIME | Applies the blackout at the time that you specified in the Hour:Min format (24-hour format), when you want the blackout to start |
Note
START_INFO is case-sensitive. You must specify values in upper case only.
0
(zero), the blackout is set for an infinite duration.