Define maintenance rules to mark CIs in maintenance status. When in maintenance
status, these CIs are excluded from impact calculation.
You can define rules to mark CIs that match the specified criteria as being in
maintenance status. The marked CIs populate the Impact Maintenance cis
Role required: evt_mgmt_admin
Note: When running maintenance rules, the cmdb_ci status of
matching CIs is not changed. However, matching CIs are flagged in the
em_impact_maint_ci table by these rules and this status is considered for impact and
The maintenance rules provided with
the base instance are:
|Default maintenance rule
|CI in Change Window
||Where the CI has an active change window, the matching CIs
are marked as being in maintenance status.
The rule runs a
query against the change request [change_request] table to
determine if the rule is applied. All these conditions in
the change_request table must be met:
- State is one of these
options: Scheduled, Implement, Work in Progress, or
Open/New (state in (-2, -1, 1, 2)).
- Approval is Approved
(approval = 'approved').
- The change request window is active, that is, the
current time is between Planned start
date and Planned end
date) or current time is between
Actual start and
- The change request record is not an on-hold record
Note: All these conditions must be present for the
CI to be placed in maintenance status by this rule. For
example, if the State of the change
request approval status is
Change is waiting for
approval then the change is not added to the
|Maintenance status of CI
||CIs whose CMDB status field is In
Maintenance are flagged by this rule as being in
The use of these legacy scripts has been deprecated:
Fill in the fields, as appropriate.
||The maintenance rule name.
||Select to activate the maintenance rule.
||Select to enable the optional script section to
||Information that describes this maintenance rule.
|Flag CIs that run on this host
||Select to flag CIs in a host to be in maintenance status
when the host is in maintenance.
||Select the table that contains the CI that you
||Specify how to select the data.
|CI field name
||Select the CI from the list. The list is populated
according to your selection in the
If a CMDB table,
or a table derived from CMDB, was selected, specify
sys_id for the CI
field name. Otherwise, specify the
required CI field that you want to use. See the
Example of a maintenance rule using a CMDB table.
Assume that a company defines
a CI as being in maintenance when the Operational Status of the CI is either
Repair in Progress or DR
Example of a maintenance rule using a table other than
Assume that a company uses Incident records to track maintenance. Any
maintenance request is translated to an incident when it has a description that
starts with “Performing maintenance on CI”. As long as the status of such an
incident is open, this status indicates that the maintenance is in progress. For the
CI field name field, specify a CI name from the table
that was chosen, in this case Incident.
Example of a maintenance rule that uses the advanced
In the Maintenance Rule page, select the
Advanced option. You can use this following script as an
example to prepare your own customized script. The return value for this example
script is a text string that represents an array of CI IDs, for example,