Configuring the UIM Threshold

This procedure is used to configure the threshold (the number of times during a specified period of time) a specific UIM (unsolicited information message) is displayed at an EAGLE terminal using the set-uim-acthresh command.

The set-uim-acthresh command uses these parameters.

:uimn – The number of the UIM that the threshold is being created for, or the threshold being changed. The number of the UIM must exist in the EAGLE. See Unsolicited Alarm and Information Messages Reference for a list of the UIMs that can be displayed.

:limit – The number of UIMs that can be displayed in the amount of time specified by the intrvl parameter.

:intrvl – The amount of time, in minutes, that the number of UIMs specified by the limit parameter can be displayed at the EAGLE terminal.

:force – The force=yes parameter allows the limit parameter to be set to 0 should the conditions at the EAGLE make this action necessary. Setting the limit parameter to 0 prevents the specified UIM, and the information contained in the UIM, from being displayed at the EAGLE terminal. It is highly recommended that the limit parameter value is not set to 0.

When the limit=0 and the force=yes parameters are specified with the set-uim-acthresh command, this message appears in the scroll area of the terminal display.

Caution: Setting LIMIT=0 suppresses UIM permanently

When creating a new UIM threshold, both the limit and intrvl parameters must be specified with the set-uim-acthresh command.

If you are changing an existing UIM threshold, either the limit or intrvl parameters must be specified with the set-uim-acthresh command.

The examples used in this procedure change the time interval for the existing UIM threshold for UIM 1155 from 30 minutes to 20 minutes, the number of UIMs displayed for existing UIM threshold for UIM 1162 from 100 to 25, and to create a new UIM threshold to display UIM 1075 for 175 times in 30 minutes. These changes are shown in Table 4-5.

Table 4-5 Example UIM Threshold Configuration

UIM Number	Old Limit	Old Time Interval	New Limit	New Time Interval
1155	50	30	No Change	20
1162	100	5	25	No Change
1075	N/A	N/A	175	30

1. Display the UIM thresholds in the database using the rtrv-uim-acthresh command.

   This is an example of the possible output.

   rlghncxa03w 06-10-01 08:50:12 GMT EAGLE5 36.0.0
   UIMN    LIMIT    INTRVL
   1155     50       30
   1162     100      5
   1216     200      15
   
   The UIM Threshold Table is (3 of 499) 1% full.
   

2. Configure the UIM threshold using the set-uim-acthresh command.

   For this example, enter these commands.

   set-uim-acthresh:uimn=1155:intrvl=20

   set-uim-acthresh:uimn=1162:limit=25

   set-uim-acthresh:uimn=1075:limit=175:intrvl=30

   When each of these commands has successfully completed, this message should appear.

   rlghncxa03w 06-10-01 08:50:12 GMT EAGLE5 36.0.0
   SET-UIM-ACTHRESH: MASP A - COMPLTD
   

3. Verify the changes using the rtrv-uim-acthresh command.

   This is an example of the possible output.

   rlghncxa03w 06-10-01 08:50:12 GMT EAGLE5 36.0.0
   UIMN    LIMIT    INTRVL
   1075     175      30
   1155     50       20
   1162     25       5
   1216     200      15
   
   The UIM Threshold Table is (4 of 499) 1% full.
   

4. Back up the new changes using the chg-db:action=backup:dest=fixedcommand.

   These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first

   .

   BACKUP (FIXED) : MASP A - Backup starts on active MASP.
   BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
   BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
   BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.
   

Figure 4-17 Configuring the UIM Threshold