display alarms

Last Updated : Aug 08, 2023 |

Use the display alarms command to see the hardware alarm report. Use this report to select the alarms to be displayed.

The system creates the hardware alarm reports from the logs of the maintenance subsystem that monitors the system hardware and logs problems as errors or alarms. The type of alarm indicates the impact of the problem. Following are the types of alarms:

  • Warning alarm — Indicates a problem that is important to log or external to the system, but does not cause a noticeable degradation of service.

  • Minor alarm — Indicates a problem that can disable a local area of the system and noticeably degrade the system.

  • Major alarm — Indicates a problem that widely degrades the system and impairs service. The system places a call to INADS.

A resolved alarm is a problem that has been corrected, and the alarmed component of the system is functioning correctly again. The system stamps resolved alarms with the date and time the problem was corrected. The system handles any errors associated with the alarms as resolved.

Syntax

display alarms [ schedule ]
schedule

Specify a start time for the command.

display alarms field descriptions

Field

Description

Alarm Types

Enter y or n in the alarm type fields to specify the type of alarm to display on the report. You can choose a combination of:

  • active or inactive alarms.

  • major, minor, or warning alarms.

  • resolved or unresolved alarms.

Interval

Enter m, h, d, w or a to display alarm records for the last month, last hour, last day, last week, or all.

  • From: Display alarm records from the time specified by mm/dd/hh:mm, where mm is the month, dd is the day, hh is the hour and mm is the minute. If no From date is defined, the report includes every alarm active since a month before to the current time.

  • To: Display alarm record to the time specified by mm/dd/hh/mm, where mm is the month, dd is the day, hh is the hour, and mm is the minute. If no To date is entered, any alarm that is active after the From date is used.

Equipment Type

Identify the equipment type that you want on the report. If there is no input to these fields, the system defaults to every type.

  • Gateway: Display every alarm associated with a particular gateway.

  • Board Number: Display every alarm associated with a particular media module. Alarms for a media module are referenced by media gateway.

  • Port: Display every alarm associated with a particular port on a media gateway. Alarms for a port circuit are referenced by port location Mediagateway#-mediamodule#-circuit.

  • Category: Enter a category to restrict the report to maintenance objects in a specific category. The Help key displays a list of categories.

  • Extension: Alarms associated with an extension number.

  • Trunk (group/member): Display every alarm associated with a particular trunk group or trunk-group member.

Input for display alarms

Enter display alarms to display the Alarm Reports options screen. Select different options on this screen for the type of report you want to see and press Enter.

Table 1: Alarm Report field descriptions

Field

Description

Port

The location of the alarmed object.

Maintenance Name

Name of the MO as it is in the alarm and error logs.

Alt. Name

Alternate name depends upon the type of the object. For example:

  • Station MO, Alternate Name = nnnnn (extension)

  • Trunk MO, Alternate Name = nn/n (trunk-group#/member #)

  • Personal CO line MO, Alternate Name = P/xx (P/personal CO line group #)

Alarm Type

Major, Minor, or Warning is an indicator of the seriousness of the alarm.

Service State

Service state of the station and trunk ports:

  • RDY — ready for service

  • OUT — out of service

  • IN — in service

  • [Blank] — No associated service state

Ack

Headings 1 and 2 identify the first and second OSS telephone numbers, respectively. The entries in the column below ACK indicate the acknowledged alarm state:

  • y — alarm has been acknowledged

  • n — alarm has not been acknowledged

  • c (cleared) — alarm was first acknowledged, then resolved and cleared

  • [Blank] — no attempt was made to report the alarm If the user disables the alarm origination with change system-parameters maintenance, then the Ack field is blank regardless of the true acknowledged state of the alarm.

Date Alarmed

Day, hour, and minute of alarm.

Date Resolved

Day, hour, and minute of resolution. 0 for active alarms.

Feature interactions for display alarms

If the alarm origination is disabled by change system-parameters maintenance, the Ack field is blank regardless of the true acknowledge state for the alarm.

If second-as-backup is entered in the Alarm Origination to OSS Numbers field, the column under the heading 2 will be blank for the alarms that the switch has not attempted to send to the second OSS telephone number. For the alarms that the switch has attempted to send to the second OSS telephone number, the column will be y, n, or c, depending on the acknowledgment status of the alarm. After the call to the first OSS telephone number is successful, for the alarms that the switch has attempted to send to OSSN2, the column will be consistent with the column under heading 1.