Rules File Constructs

Customize the Knowledge Base › Components of Rules › Rules File Constructs

Rules File Constructs

The format of a rules file is not rigid. Multiple spaces, tabs, carriage return, and form feeds are treated as a single space. A rules file can include the following five constructs:

RULE
DISABLE
LITERAL
COMMENT
THRESHOLD

These rule constructs, their format, and use are discussed next:

RULE

Constructs define rules.

The format of the rule construct is as follows:
```
RULE rule_elements ENDRULE
```

The rule construct consists of seven rule elements. The optional elements in the list following are enclosed in brackets:
- Rule ID element
- [Domain element]
- Rule condition element [Rule condition element...]
- [Occurrence threshold element]
- [Evidence element]
- [Conclusion text element]
- [Brief conclusion text element]
Once defined and compiled, the rules can be supplied to the analysis process to cause a conclusion to be fired as appropriate or can be supplied to the archival process to cause the number of occurrences of the rule to be archived.

DISABLE

Constructs allow you to turn off individual rules.

The format of the disable construct is as follows:
```
DISABLE rule_id [rule_id...];
```
The parameter rule id specifies which rule or rules to disable; the construct ends with a semicolon (;).

LITERAL

Constructs allow you to define unique symbols for use in a rule expansion.

The format of the literal construct is as follows:

LITERAL literal_definition [literal_definition...] ENDLITERAL

A literal definition is defined as:
```
literal_symbol = decimal_value
```
A literal symbol is a unique symbol that you have equated to a decimal value. A literal symbol can contain up to 40 alphanumeric characters that have not been defined before as a literal, a threshold, or a data cell. A literal symbol can be used in a rule expansion.

COMMENT

Constructs allow you to include notations in the rules file.

An exclamation point (!), occurring as the first character in the line, denotes a comment construct. The Performance Manager ignores any text on the line after the exclamation point.

THRESHOLD

Constructs allow you to modify internal thresholds that affect the calculation of derived data cells.

The format of a threshold construct is as follows:

THRESHOLD threshold_definition [threshold_definition...] ENDTHRESHOLD

A threshold definition is defined as:
```
threshold_name = decimal_value
```
A threshold name must match one of the Performance Manager's predefined thresholds. These thresholds are not used directly in the rule expression; however, they influence the resultant value of some data cells that can be used in rule expressions. Some thresholds act as occurrence limits for a few factory rules.
The following table lists the Performance Manager's predefined thresholds and the default value of each threshold, and describes how each threshold affects the data cells or evidence.
All thresholds have a prefix of TD. These thresholds cannot be redefined, but their values can be modified.

The following tables show the Performance Manager thresholds:

Name	Default Value	Description
TD_MIN_DSKSPC_PCT	.05	The minimum percentage of disk free blocks required to set the data cell ANY_DISK_FULL to 1 for a given Performance Manager two-minute record.
TD_DISK_QL_MAX	1	The maximum queue length on any disk required to set the data cell ANY_DISK_OVER_QL_THRESHOLD to 1 for a given Performance Manager two-minute record. This affects condition-checking on rules I0040, I0050, I0055, I0060, and I0150.
TD_SMP_VUP_RATIO	85	A percentage of the threshold TD_SINGLE_CPU_VUP_n value applied to additional CPUs in an SMP system used to compute the total VUPs. This is used to compute the data cell CPU_VUP_RATING for processor type N. See the processor specific thresholds in the next table.
TD_M0010_PROBRECS_PER_IMAGE	4	Number of records for any one image required to fire the rule M0010.
TD_PROCESS	2	Number of problem records per user/image combination required to include the record into the evidence for rules M0050, M0055, and M0060.
TD_CIO	4	Number of problem records per disk volume required to include the image into the evidence for rule L0050, L0060, and L0070.
TD_IO_ERROR	2	Number of problem records per disk volume required to include the volume into the evidence for rule L0080.
TD_CI_PORT_IO	1500000	Number of bytes per second through any CI port required to set the data cell EXCESS_THRUPUT_ON_ANY_CHANNEL to 1 for a given Performance Manager two-minute record.
TD_UNIBUS_CHANNEL_IO	1000000	Number of bytes per second through any UNIBUS port required to set the data cell EXCESS_THRUPUT_ON_ANY_CHANNEL to 1 for a given Performance Manager two-minute record.
TD_KDA_CHANNEL_IO	800000	Number of bytes per second through any KDA50 port required to set the data cell EXCESS_THRUPUT_ON_ANY_CHANNEL to 1 for a given Performance Manager two-minute record.
TD_KDB_CHANNEL_IO	900000	Number of bytes per second through any KDB port required to set the data cell EXCESS_THRUPUT_ON_ANY_CHANNEL to 1 for a given Performance Manager two-minute record.
TD_MASSBUS_CHANNEL_IO	1700000	Number of bytes per second through any MASSBUS port required to set the data cell EXCESS_THRUPUT_ON_ANY_CHANNEL to 1 for a given Performance Manager two-minute record.
TD_GENERIC_DISK_IO	30	Default I/O operation per second threshold for disks that are not covered in the translation table (TD_Tn_x) thresholds.
TD_GENERIC_DISK_THRUPUT	1000000	Default number of bytes per second threshold for disks that are not covered in the translation table (TD_In_x) thresholds.
TD_T1_RK06	20	I/O per second threshold for disk type. Data cell DISK_IO_RATE_THRESHOLD has this value if the current disk sub-record is of this type.
TD_T2_RK07	20	Same as previous.
TD_T3_RP04	26	Same as previous.
TD_T4_RP05	26	Same as previous.
TD_T5_RP06	26	Same as previous.
TD_T6_RM03	26	Same as previous.
TD_T7_RP07	32	Same as previous.
TD_T8_RP07HT	32	Same as previous.
TD_T13_RM80	30	Same as previous.
TD_T15_RM05	26	Same as previous.
TD_T20_RA80	27	Same as previous.
TD_T21_RA81	28	Same as previous.
TD_T22_RA60	20	Same as previous.
TD_T25_RD51	10	Same as previous.
TD_T27_RD52	20	Same as previous.
TD_T28_RD53	26	Same as previous.
TD_T30_RA82	33	Same as previous.
TD_T31_RD31	18	Same as previous.
TD_T32_RD54	26	Same as previous.
TD_T34_RRD50	20	Same as previous.
TD_T36_RX33	10	Same as previous.
TD_T37_RX18	10	Same as previous.
TD_T38_RA70	32	Same as previous.
TD_T39_RA90	34	Same as previous.
TD_T40_RD32	20	Same as previous.
TD_T42_RX35	10	Same as previous.
TD_T43_RF30	24	Same as previous.
TD_T44_RF71	24	Same as previous.
TD_T45_RD33	18	Same as previous.
TD_T46_ESE20	240	Same as previous.
TD_T47_TU56	30	Same as previous.
TD_T48_RZ22	24	Same as previous.
TD_T49_RZ23	24	Same as previous.
TD_T50_RZ24	32	Same as previous.
TD_T51_RZ55	31	Same as previous.
TD_T52_RRD40S	20	Same as previous.
TD_T53_RRD40	20	Same as previous.
TD_T54_GENERIC_DK	30	Same as previous.
TD_T55_RX23	10	Same as previous.
TD_T56_RF31	78	Same as previous.
TD_T57_RF72	37	Same as previous.
TD_T58_RAM_DISK	130	Same as previous.
TD_T59_RZ25	38	Same as previous.
TD_T60_RZ56	34	Same as previous.
TD_T61_RZ57	38	Same as previous.
TD_T62_RX23S	10	Same as previous.
TD_T63_RX33S	10	Same as previous.
TD_T64_RA92	33	Same as previous.
TD_T65_SSTRIPE	60	Same as previous.
TD_T66_RZ23L	30	Same as previous.
TD_T67_RX26	10	Same as previous.
TD_T68_RZ57I	38	Same as previous.
TD_T70_RZ58	4	Same as previous.
TD_T71_SCSI_MO	20	Same as previous.
TD_T72_RRD42	20	Same as previous.
TD_T73_CD_LOADER_1	20	Same as previous.
TD_T74_ESE25	240	Same as previous.
TD_T75_RFH31	78	Same as previous.
TD_T76_RFH72	37	Same as previous.
TD_T77_RF73	44	Same as previous.
TD_T78_RFH73	44	Same as previous.
TD_T79_RA72	40	Same as previous.
TD_T80_RA71	40	Same as previous.
TD_T81_RF35	69	Same as previous.
TD_T82_RFH35	69	Same as previous.
TD_T83_RF31F	40	Same as previous.
TD_T84_RZ72	37	Same as previous.
TD_T85_RZ73	36	Same as previous.
TD_T86_RZ35	53	Same as previous.
TD_T87_RZ24L	35	Same as previous.
TD_T88_RZ25L	41	Same as previous.
TD_T89_RZ55L	34	Same as previous.
TD_T90_RZ56L	37	Same as previous.
TD_T91_RZ57L	42	Same as previous.
TD_T92_RA73	44	Same as previous.
TD_T93_RZ26	50	Same as previous.
TD_T94_RZ36	51	Same as previous.
TD_T95_RZ74	47	Same as previous.
TD_T96_ESE52	1300	Same as previous.
TD_T97_ESE56	1300	Same as previous.
TD_T98_ESE58	1300	Same as previous.
TD_T99_RZ27	51	Same as previous.
TD_I1_RK06	530000	Number of bytes per second threshold for disk type. Data cell DISK_THRUPUT_RATE_THRESHOLD has this value if the current disk sub-record is of this type.
TD_I2_RK07	530000	Same as previous.
TD_I3_RP04	800000	Same as previous.
TD_I4_RP05	800000	Same as previous.
TD_I5_RP06	800000	Same as previous.
TD_I6_RM03	1200000	Same as previous.
TD_I7_RP07	1300000	Same as previous.
TD_I8_RP07HT	2200000	Same as previous.
TD_I13_RM80	1000000	Same as previous.
TD_I15_RM05	1200000	Same as previous.
TD_I20_RA80	800000	Same as previous.
TD_I21_RA81	1500000	Same as previous.
TD_I22_RA60	1300000	Same as previous.
TD_I25_RD51	300000	Same as previous.
TD_I27_RD52	530000	Same as previous.
TD_I28_RD53	530000	Same as previous.
TD_I30_RA82	1600000	Same as previous.
TD_I31_RD31	500000	Same as previous.
TD_I32_RD54	530000	Same as previous.
TD_I34_RRD50	120000	Same as previous.
TD_I36_RX33	400000	Same as previous.
TD_I37_RX18	400000	Same as previous.
TD_I38_RA70	1000000	Same as previous.
TD_I39_RA90	1900000	Same as previous.
TD_I40_RD32	500000	Same as previous.
TD_I42_RX35	400000	Same as previous.
TD_I43_RF30	900000	Same as previous.
TD_I44_RF71	900000	Same as previous.
TD_I45_RD33	500000	Same as previous.
TD_I46_ESE20	2000000	Same as previous.
TD_I47_TU56	750000	Same as previous.
TD_I48_RZ22	1000000	Same as previous.
TD_I49_RZ23	1000000	Same as previous.
TD_I50_RZ24	1200000	Same as previous.
TD_I51_RZ55	1000000	Same as previous.
TD_I52_RRD40S	120000	Same as previous.
TD_I53_RRD40	120000	Same as previous.
TD_I54_GENERIC_DK	750000	Same as previous.
TD_I55_RX23	400000	Same as previous.
TD_I56_RF31	2100000	Same as previous.
TD_I57_RF72	1200000	Same as previous.
TD_I58_RAM_DISK	5000000	Same as previous.
TD_I59_RZ25	1800000	Same as previous.
TD_I60_RZ56	1400000	Same as previous.
TD_I61_RZ57	1700000	Same as previous.
TD_I62_RX23S	400000	Same as previous.
TD_I63_RX33S	400000	Same as previous.
TD_ _RA92	1900000	Same as previous.
TD_I65_SSTRIPE	1200000	Same as previous.
TD_I66_RZ23L	1200000	Same as previous.
TD_I67_RX26	500000	Same as previous.
TD_I68_RZ57I	1500000	Same as previous.
TD_I70_RZ58	3100000	Same as previous.
TD_I71_SCSI_MO	750000	Same as previous.
TD_I72_RRD42	120000	Same as previous.
TD_I73_CD_LOADER_1	120000	Same as previous.
TD_I74_ESE25	2000000	Same as previous.
TD_I75_RFH31	2100000	Same as previous.
TD_I76_RFH72	1600000	Same as previous.
TD_I77_RF73	2100000	Same as previous.
TD_I78_RFH73	2100000	Same as previous.
TD_I79_RA72	1400000	Same as previous.
TD_I80_RA71	1400000	Same as previous.
TD_I81_RF35	2600000	Same as previous.
TD_I82_RFH35	2600000	Same as previous.
TD_I83_RF31F	1400000	Same as previous.
TD_I84_RZ72	1400000	Same as previous.
TD_I85_RZ73	1900000	Same as previous.
TD_I86_RZ35	2600000	Same as previous.
TD_I87_RZ24L	1900000	Same as previous.
TD_I88_RZ25L	2000000	Same as previous.
TD_I89_RZ55L	1100000	Same as previous.
TD_I90_RZ56L	1500000	Same as previous.
TD_I91_RZ57L	1800000	Same as previous.
TD_I92_RA73	2100000	Same as previous.
TD_I93_RZ26	2600000	Same as previous.
TD_I94_RZ36	3700000	Same as previous.
TD_I95_RZ74	3100000	Same as previous.
TD_I96_ESE52	2000000	Same as previous.
TD_I97_ESE56	2000000	Same as previous.
TD_I98_ESE58	2000000	Same as previous.
TD_I99_RZ27	3700000	Same as previous.