AT&T OneVision DEFINITY G3 Fault Management User Manual

Table of
Contents

OneVision Network

Issue 2
CMP 45733
April, 1996

Management Solutions

DEFINITY® G3

Fault Management

User Guide

Graphics © AT&T 1988

Contents

About This Book xi

■ Intended Audience xi

■ Associated Documents xi

■ Conventions xii

■ Trademarks xii

■ Security Considerations xiii

■ Reader Comments xiii

■ Credentials xiii

1 Introduction 1-1

■ Fault Management Features 1-1

Configuration Map 1-2
Fault Manager 1-2
Configuration Manager 1-3

■ System In t egrati o n 1 - 3

DEFINITY G3 Proxy Agent 1-3
Your Network Management System 1-3

■ Supported PBXs 1-4

■ Fault Management’s User Interface 1-4

Color 1-4
Alarms Display 1-5
Menu Bar 1-5
Hotspots 1-5
Scroll Bars 1-7
Close Button 1-7
Exit Button 1-8
Accelerator Keys 1-8

■ How to Enter Data 1-8

Data Typed into Fields 1-8
Pull-down Lists 1-8
Check Boxes 1-9
Radio B utt o n s 1-9

Issue 2 April 1996 iii

Contents

■ Management Information B as e 1-9

■ Data Refresh 1-9

Startup Refresh 1-10
Configuration Data Refresh 1-11
Bulletin Board Refresh 1-11
Alarms and Errors Data Refresh 1-11

2 Starting/S toppi ng Fault Management 2-1

■ Starting Fault Management 2-1

■ The Startup Screen 2-2

Start-Up Messag es 2-3
Exit Button 2-4

■ The Startup Process 2-4

Retrieving Data 2-4
Failing to Retrieve Data 2-5
Requestin g Dat a 2-5

■ Stoppi ng Fault Mana gem e nt 2-5

3 Cu stomizing Fault Management 3-1

■ Op enin g the Setup Screen 3-1

■ Th e Setup Screen 3-1

Sa mple Setup Screen 3-2
Menu Bar 3-3

■ Changing Colors 3-4

■ Cha nging Ti me Inte rv al s 3-5

■ Changing Other Options 3-7

■ Testing Your Changes 3-8

■ Saving Changes 3-8

■ Reverting to Default Setting s 3-9

■ Exiting the Set u p Screen 3-9

Issue 2 April 1996 iv

Contents

4 The Config uratio n Map 4-1

■ Overview of the Configuration Map 4-1

Faults Displayed as Colors 4-2
Screens in the Configurat ion View 4-2

■ Switch View 4-3

How to Open the Swi tch View 4-3
Sa mple Switch View 4-3
Menu Bar for Switc h View 4-4
Screen Heading for Switch View 4-6
Alarms for Switch View 4-6
Switch View Hotspots 4-7
Switch View Messages 4-8

■ Cabinet View 4-8

How to Open the Cabinet View 4-8
Sample C a b inet View 4-8
Menu Bar for the C a b inet View 4-9
Graphic Display Area 4-10
Cabinet Data Area 4-11
Cabinet Messages 4-14

■ Circuit Pack Information 4-14

How to Open Circuit Pack Information 4-14
Sample Circuit Pack Information Screens 4-15
Menu Bar for Circuit Pack Information 4-17
Data Area for Circuit Pack Information 4-17
Circuit Pack Hotspots 4-20

■ Port Information 4-20

How to Ope n Port Information 4-20
Sample Port Information Screens 4-20
Menu Bar for Port Information 4-24
Data Area for Port Information 4-25
Port Hotspots 4-29
Port Messages 4-29

■ External Devices 4-30

How to Open External Devices 4-30

Issue 2 Ap ril 1996 v

Contents

Sample External Devices Screen 4-30
Menu Bar for External Devices 4-32
Screen Heading for External Devices 4-32
Alarms for External Devices 4-32
External Device Hotspots 4-33
External Device Messages 4-33

■ Individual External Devices 4-33

How to Open Individual External Devices 4-34
Sa mple Individual External Devices Screen 4-34
Menu Bar for In d ivid ual External Device 4-35
Data Area for In d ividual External Device 4-35

5 The Fault Manag er 5-1

■ Overview of Fault Manager 5-1

■ Wh e n Fault Manager Receives Da ta 5-2

■ How Fault Manager Displays Faults 5-2

Color Highlighti n g 5-2
Alarms 5-2
Alarms Reports 5-3
Error Reports 5-6

■ How to open Report Windows 5-10

■ How to Print Reports 5-11

■ How t o Cl ose Rep ort Wind ow s 5-11

■ How to Get More Report Information 5-11

■ Error Descript i on Screen 5-11

How to Open Error Descriptions 5-12
Sample Error Description Screen 5-12
Menu Bar for Error Descriptions 5-13
Screen Heading for Error Descriptions 5-13
Error Description Panel 5-13
Notes Panel 5-13

■ Bulletin Board 5-14

How to O p e n the B ullet in Board 5-14

vi Issue 2 April 1996

Contents

Sa mple Bulle t in Board 5-14
Menu Bar for the Bulletin Board 5-15
Data Area for the Bulletin Board 5-16
How to Refresh this Screen 5-17

6 The Configuration Manager 6-1

■ Overview of Configuration Manager 6-1

Types of Configuration Data 6-2

■ Har dware/Software Information Report 6-2

■ Circuit Pack Inventory Report 6-4

■ How to Save Inventory Reports 6-6

■ Circuit Pack Reports 6-7

■ DS1 Circuit Pack Reports 6-9

■ How to Open Config urati on Reports 6-11

■ How to Print Configuration Reports 6-11

■ How to Close Confi g uration Reports 6-12

■ Cabinet Displays 6-12

Circuit Pack Filters 6-12
How to Identify Circuit Pack Conf i gurations 6-13
How to Clear Filter Highlighting 6-14

■ How to Refresh Configuration Data 6-14

Scheduled Refresh 6-14

7 Report Builder 7-1

■ Overview for Report Builder 7-1

Types of Tabl es 7-2
Search Criteria 7-2
Report Format 7-2

■ Report Builder Screen 7-3

How to O p e n Rep ort B uild er 7-3
Sample Report Builder Screen 7 -3

Issue 2 A pril 1996 vii

Contents

Menu Bar for Report Builder 7-5
Data Area for Re port Builder 7-5
Button Line 7-8

■ Overview for Creating Reports 7-8

■ How to Name the Rep ort 7-9

Guidelines for the Report Name Field 7-9

■ How to S elect the Tab l e to Search 7-9

Gui d eline s for the Table to Search Field 7-9
How to Display All Alarms 7-10

■ How to Enter Search Criteria 7-10

Gui delines for Data Selection Fields 7-10
How to Search for an Exact M atch 7-11
How to Search for a Range 7-13
How to Search for a Pa rtial Matc h 7-15

■ How to Format the Report 7-15

Gui d eline s for the Table to Outp u t Field 7-16

■ How to Sort Report Data 7-16

Guidelines for the Sort Fields 7-16

■ How t o Save Report Specif ic ations 7-17

■ How to Run the Rep ort 7-17

How to Change the Report 7-17

8 Output Options 8-1

■ Overview for Output Options 8-1

■ Output Opti ons Screen 8-1

How to Open Output Options 8-2
Sample Output Options Screen 8-2
Menu Bar for Out p u t Op tions 8-3
Data Area for Output Op t ion s 8-4
Output Options Messages 8-6
Button L ine for Out put O p tio n s 8-7

■ How to Disp lay Reports 8-7

■ How to Highlight Objects 8 - 7

viii Issue 2 April 1996

Contents

■ How to Print R e p o rts 8-7

■ How to Save Reports 8-8

9 Troubleshooting 9-1

■ xnmevents Crash (HP OpenView) 9-1

■ Switch View Messages 9 -2

Messages Specific to HP OpenView 9-5

■ Port Messa g e s 9-6

Messages Specific to HP OpenView 9-6

■ Pop-up Messages 9-7

■ Startup Me s sages 9-9

10 Integrating With Remedy 10-1

■ Ac t ion Request System Overview 10-1

■ HP OpenView 10-1

Create a Schema 10-2
Create a Macro 10-2
Test the Macro 10-3
Test the Script 10-3

■ Cabletron SP ECTRUM 10-3

11 Quick Reference for Screens 5

■ General Comme nts 5

IN Index IN-1

Issue 2 April 1996 ix

About This Book

The purpose of this document is to help private branch exchange (PBX)
administrators and managers use DEFINIT Y
guide provides a description o f the screens, fields, access methods, reports, and
other features that are p a rt of the application.

Intended Audience

This gu i de is i ntended for DE FINITY G3 and network managers who are
managing DEFIN ITY G3 PBXs as nodes on a network management system
(NMS). B ecause Fault M a nagement provides information about fault conditions
on a PBX, it is aime d p rim arily towa rd people who are concerned with the health
of a PBX. That person may be responsible for the PBX, the NMS, or both.

Associated Documents

Documents associated with this online guide are:

■

OneVision DEFINITY G3 Fault Management Installation and Integration

This gu i de explains ho w to install and set up Fault Management software,
how to set up PBXs and Proxy Agents as nodes on the NMS, how to
change Fault Management’s polling int ervals an d d e fault colors, and how
to verify that the Proxy Agent is connected to a PBX.



G3 Fault M a nagement. This user’s

■

OneVision Network Management Solutio ns DEFINITY G3 Proxy Agent
Installation and Connectivity

This gu i de explains how to install, set up , a nd c ustom ize Proxy Agent
software. It al so contain s basic hardware and software requirements,
inform at ion fo r c o nnect in g the Proxy Agent to a LAN, and troubleshooting
guidelines.

Issue 2 April 1996 xi

About This Book

■ BCS Produc ts Security Handbook (555-025-600)

■ The appropriate maintenance manual f or each DEFINITY G3 PBX that you

Conventions

This gu i de uses the followin g text c o nventi ons:

Text format Type of information

Bold Command names and parameters, informa tion you

italic

are managing on your NMS.

type, and file names

Emphasized key words

[bold and
bracketed]

Variables
Example: Enter aruser -e [mac ro-nam e ] means to

substitute the name of the macro for [macro-name].

constant width Sy stem messages and responses

small type Keyboard keys

à

Example: Press
Menu selections
Ex ample: Select Options à Close

Return.

, means to select

Options, then sele c t Close from the pull-down menu.

Throughout this document, tol l fraud security hazards are indicated by an
exclamation poi nt inside a triangle and the word Caution.

!

CAUTION:

A security alert may indicate the presence of a toll fraud security hazard.
Toll fraud is the unauthorized use of your telecommunications system by an
unauthorized party. Examples of unauthori zed pa rti es are p ersons other
than your com pany’s employees, a g e nts, s u b contractors, or persons
working on your company’s behalf. Additional security information is
included in Security Considerations later in this preface.

Trademarks

The fol lowing AT&T trademarks or registered trademarks are used in this
document:

■ DynaText is a registered trademark of Electronic Book Technologies, Inc.

■ HP, HP-UX, and OpenView are trademarks of Hewlett-Packard Company

xii Issue 2 April 1996

Security Considerations

■ OneVision and DEFINITY are trademarks or registered trademarks of AT&T

■ Remedy and Actio n Request System are trademarks of Remedy

Corporation

■ SP ECTRUM an d Sp ectroSERVER a re r eg istered trad emarks of Cabletron

Systems, Inc.

■ SunOS an d SPARC are trademarks or registered trademarks of Sun

MicroSystems, Inc.

All other bra nds and product names are the trademarks of their respective
holders.

Security Considerations

Your NMS provides the security for your network. As a part of that network, F ault
Management neither adds to nor detracts from the level of security your NMS provides.

Fault Management is a display-only application; you can view the data from your P BX, but
not change it.

Reader Comments

If you have any comme nts o r su g gestions abou t this document, please send
them to AT&T at the following address.

AT&T
Product Documentation Development Department
Room 22-2C11
11900 North Pecos Street
Denver, CO 80234

FAX: [phone]
Please include the following infor mat ion:

■ The nam e o f this document:

DEFINITY G3 Fault Ma nagement

■ Your NMS: HP OpenView

■ Your p l atfor m : SunOS

Credentials

DEFINITY G3 Fault Ma nagement is ISO 9001 certified.

OneVision Network Management Solutions



or IBM NetView



, HP-UX, or AIX

Issue 2 April 1996

xiii

About This Book

AT&T BCS is also an HP OpenView Solution Partner; and Faul t M a nagem ent is
listed in the HP OpenView Solutions c a talog.

xiv Issue 2 April 1996

Introduction

This chapter provi des an overview of the DEFINITY G3 Fault Management
software, and incl udes:

■ Fault Management Featu res

■ System Int e g rati on

1

■ Suppo r t e d PBXs

■ Fault Management’s User Interface

■ Data Refresh

This chapter lays the groundwork for subsequent chapters which cover the
application in greater detail.

Fault Management Features

DEFINITY G3 Fault Ma nagement (referred to as Fault Management throughout
this guide) provides a PBX manager with a graphical tool for monitoring the
status of a DEFI NITY G3 PB X.

Fault Ma nagement displays DEFINITY G3 PBX faul t a n d c o n f i g urat ion d a t a in a
graphical format. It resides on an industry-standard network management
system (NMS).

Fault Ma nagement consists of the following features:

■ Configuration Map

■ Fault Manager

■ Configuration Manager

Issue 2 Apri l 1996 1-1

Introduction

Configuration Map

The configuration map provides a graphical user interface (GUI) that displays
information ab out a DEFI NITY G3 PB X m anaged by your NMS.

You display this information by clicking on a pictoral rep rese ntation of the PBX’s
hardware. Each time you click, you peel away the layers of the PBX and uncover
more specific data.

The configuration map allows you to uncover the following PBX hardware layers.
The most general layer is shown first; the most sp ecific layer is shown last.

This layer … Includes data for …

Switch The entire PBX
Cabinet One cabinet in the PBX
Circuit Pack One circuit pack in the cabinet
Port One port on th e c i rcuit pac k

The configuration map also has the following layers for external devices:

This layer … Includes data for …

External Devices Each external device

Individual External
Device

Faul t Manager

The fau lt manager provides information about active (non-resolved) alarm
conditions that exist within a PBX. The inf o rmat i o n is i n a color-coded graphical
format so that you can find faults quickly and easily.

Fault ma nager alerts you to fault condit ions by:

■ Highlighting the graphic depiction of the PBX hardware that has an alarm.

administered on the PBX
A specif ic external device on the

PBX

The color of the highlight corresponds to the highest severity alarm. T his
highlighting allows you to see the following items at a glance:

— Where alarm conditions exist
— How severe the alarms are
— The q uant i t y of each alarm type

■ Displaying alarm counts that are sor t e d b y:

— The location of the ala r m

1-2 Issue 2 April 1996

System Int e g ration

— The severity of the alarm (major, minor, or warning )

Configuration Manager

The config uration manager provides, in a graphical and report format,
information about your PBX, cabinet, and external device configurations. This
information consists of a PBX ’s hardware and software versions and an inventory
of circuit packs and their locations.

System Integration

The Fault Management ap p lication is closely integrated with, and relies heavily
on, two other applications:

■ DEFIN ITY G3 Proxy Agent

■ Your network management system (NMS)

DEFINITY G3 Proxy Agent

Fault Ma nagement receives data from the PBX via AT&T’s DEFINITY G3 Proxy
Agent, release 1.2 (referred to as the Proxy Ag e nt throughout this gu i de). The
Proxy Agent and Fault Management are installed on two separate co mputers.

The purpose of the Pr oxy Agent is to receive status information from the PBX and
then translate that information into a format that your NMS can understand. That
format is SNMP (Simp le Network Management System).

Yo u r Netwo rk M anag emen t System

Fault Ma nagement is an add-on to your network management system (NMS).
Fault Ma nagement integrates with your NMS in such a way that Fault
Management must be executed from the NMS.

Both the NMS and Fault Man a gem en t receive d ata from the Proxy Agent. The
NMS can display within various views the d ata that it rec eives from the Proxy
Agent.

Fault Ma nagement can only manage the PBXs that are set up on your NMS. To
have status information available to you via Fault Management, the PBX must be
a node on Fault Management’s host NMS platform.

Refer to your

Management Installation and Integration

instructions on adding a node.

OneVision Network Management Solutions DEFINITY G3 Fau lt

guide and your NMS user guide for

Issue 2 April 1996

1-3

Introduction

Supported PBXs

Fault Ma nagement supports the following DEFINITY GENERIC 3 PBXs:

G3vs G3s G3i G3r

V1.1-ABP/PBP V1.1-ABP/PBP V1.1-286 V1.1
V2-ABP /PBP V2-ABP/PBP V2-386 V2
V3-ABP /PBP V3-ABP/P BP V3 (386) V3
V4-ABP/PBP V4-ABP/PBP V4 (386) V4

Fault Management’s User Interface

This section describes the following elem ents i n c luded in the Fault
Management’s user interface:

■ Accelerator Keys ■ Hotspots

Color

■ Alarms Display ■ Menu B ar

■ Color ■ Scroll Bars

■ Close Button

When the information is b est explained in the context of co m plet ing a Fault
Management task, this section refers you to another chapter for detail s.

Fault ma nager highlights the affe c ted ha rdware with the c o l or of the hi g hest
severity fault.

For example, if a cabinet has four warnings and one minor alarm, the cabinet is
highlighted with the color of the minor alarm.

NOTE:

You can change these color settings on the Setup me nu. See Ta ble 3-6 for
instructions.

To learn more
about color and … Go to this chapter …

Default settings Chapter 3, Customizing Fault

Management

Configuration management Chapter 6, The Configuration Manager

1-4 Issue 2 April 1996

Fault Management’s User Interface

Alarms Display

An alarms display, similar to the one shown below, is located on the ri g ht side of
any configuration s creen.

Figure 1-1. A l arms Display

Menu Bar

Fault Ma nagement uses a standard menu ba r with the following pull-down
men us. The actual list of c o m ma nds that you see is de t e r mined b y the active
screen.

Hotspots

Menu Description

Op tion Allows you to perform application-wide com mands. For

exampl e, op e ning Fault Management features, savin g d a t a,
and closing screens.

Fault Allows you to see lists or reports of current errors and

alarms . These lists display in new windows.

Config u ration A llow s you to ge t informatio n a b out the confi guration for the

current PBX. This menu is available only at the following
screens:

■ Switch View

■ Cabinet View

■ External Devices

Help The Help menu opens a window that contain s

context-sensitive help (help specific to the active window.)

To learn more about the menu bar for a specific screen, go to the Menu Bar
section for that screen.

When you click the mouse on an area of the screen designated as a hotspot, the
system performs a predetermined function.

Issue 2 April 1996

1-5

Introduction

NOTE:

This gu ide ref ers to hotspots in Fault M a nagement, not DynaText. The
Fault Management screens and windows that display when you double
cli c k on th e c ame ra i c on in this g u i d e d o not have functioning hotspots.
However, you c a n try out the hotspots when you return to the Fault

Management ap plication.
Fault Ma nagement hotspots open up a s c ree n at the next ha rdware layer.
For example:

If you are at this
layer …

Switch Cabinet icon Cabinet

Cabinet Circuit pack co de Circuit pack
Circuit pack Port numbe r Port
External Devices External d evic e icon Individual

The port and indi vidual external device layers do not have hotspots because
they are the last layers.

Each window that a hotspot opens is specific to the hotspot itself. For example, if
you click on the Cab inet 1 i c o n in the Switch View, the sys tem opens a window
containing only Cabinet 1 d a t a, as shown in the following figure :

And you click on this
hotspot …

External devices ic o n External Devices

Then this layer
display s…

External Device

1-6 Issue 2 April 1996

Fault Management’s User Interface

Figure 1-2. Cab inet View

Scroll Bars

Fault Ma nagement uses standard scroll bars. The sc ro ll b a r s ap pear only when
there is more information than can a ppear in the window, such as more cabinets
or more report items. If the window does not include scroll bars, all the relevant
information or dat a is visible in the window.

Close Bu tton

When you click o n th e close button, the system closes the current window and all
open "child" windows.

A child window is a window associated with a lower level or with a report fo r th e
current or l ower level. For examp le, the c i rc u i t pa c k d i splay is the child window
of a specific cabinet level disp lay window.

Issue 2 April 1996

1-7

Introduction

Exit Button

The exit bu t ton end s your Fault Management session. This button is available on
the Startup and Switch View screens.

Accelerator Keys

Accelerat or keys allow you to use the keyboard to execute a menu co m man d
(instead of pointing and clicking with a mouse). Each menu co m m and in Fault
Management has one letter underlined.

To use accelerator keys:

■ For top level menus, simu ltaneously press the meta key on your keyboard

and the underlined letter of the menu opt ion .

■ For a submenu, press the underlined letter of the menu item.

How to Enter Data

You c a n enter d a t a int o Fault Management screens in the following ways:

■ Data typed into fields

■ Pull-down lists

■ Check boxes

■ Radio buttons

Data Typed into Field s

You type data into some fields. You can also copy the dat a from one screen or
report and paste it into a field on another screen.

Pull-down Lists

Many fields have pull-down lists that allow you to select the vali d values fo r that
field.

Field s tha t have pull-down lists look like this:

1-8 Issue 2 April 1996

Management Information Base

Check Boxes

Check boxes allow you to turn an option on or off. Y ou can turn on as many check
boxes as you want.

Check boxes look like this:

In this examp le, all the check boxes are turned off.

Radio Bu t ton s

Radio buttons allow you to select one o p tion f rom a list of op t ions.
Radio buttons look like this:

In this examp le, the Ascending radio button is turned on.

Management Information Base

The management information base (MIB) is a da t abase of network management
information. The MI B is located in the following directory:

/usr/OV/OneVision/DG3FM/g3mib.asn1

You c a n p rint the MIB b y using your system’s print comma nd .

Data Refresh

Data refresh is the process Fault Management uses to signal the Proxy Age n t to
refresh its cache, if necessary, and then to rea d the d ata . Once t he Proxy Agent

Issue 2 April 1996

1-9

Introduction

has completed refreshing d a ta from the PBX, Fault Management u pdates the
alarm and circuit p a ck mismatch displays that use the data. This data includes:

■ Alarm dat a ■ Error data

■ Bulletin board data ■ External devices

■ Cabinet data ■ Trunk group

■ Configuration data ■ Vintage data

■ DS1

Fault Ma nagement uses the following refresh c a t egories:

■ S tartup Re fresh

■ Configuration Data Refresh

■ Bulletin Boa rd Refresh

■ Alarms and Errors Data Refresh

Each refresh process differs sli g h tly fro m the others. The next subsections
describe these op erati ons.

Startup Refresh

Startup refresh can occur when you invoke the application from the NMS. By
default, it occurs automatically on startup. The Fault Management Startup screen
displays the following message indicating the status of the startup refresh.

Refresh in progress, estimated delay 250 seconds, 50
seconds elapsed.

Startup refresh up d a t es the followin g information.

■ Alarm da t a ■ Error data

■ Bulletin board data ■ External devices

■ Cabinet data ■ Trunk group

■ Configuration data ■ Vintage data

■ DS1

If the Proxy Agent is unable to connect to the PBX and refresh the data, the
startup refresh fails. In this ca se, the follow ing message a ppears when you
invoke Fault Management fr o m the NMS.

Refresh on startup failed! Continuing with cache data.

Turning Off Startup Refresh

You ca n tur n off the startup refresh op t ion as foll ows:

1-10 Issue 2 April 1996

Data Refresh

1. Access the Switch View.

2. Select Options à Setup.

3. Change the value in Refresh Proxy Ag ent On Startup to FALSE.

4. Click Apply.

5. Select Options à Save.

For more information about the Setup screen, refer to the Chapter 3, Customizing
Fault Ma nagement.

Configuration Data Refresh

Config u ration d ata refresh consists of updating all th e c ircuit pack information,
including the circuit pack types and locations, and p o r t inform at ion.

The followin g events cause Fault Ma nagement to refresh the confi g urat ion d a t a.

■ The refresh timer for the c i rcuit pack expires.

Fault Ma nagement includes a refresh timer which you can turn off or set
for be tween 1 (one) hour and 1000 hours. The timer is reset before the
refresh process begins.

When the refresh timer expires, Fault Management starts the data refresh.
For more information about changing the timer for the ci rcuit pack refresh

interval, see Changing Time Intervals.

NOTE:

For a c onfi guration refresh, Fault Management close s any open
Ca b inet View and External Devices sc reen and their chi l d windows.

■ A user requests a refresh.

See How to Refresh Configuration Data for more informat ion.

Bulletin Board Refresh

Bulletin b o a rd refresh allows you to upd at e the me ss a g es on the Bu llet in Bo ard
screen. These messages originate on the PBX bulletin b oard and are only
updated upon request.

See Bulletin Board and How to Refresh this Screen for more information.

Alarms and Errors Data Refresh

The followin g events cause Fault Ma nagement to refresh the alarms and errors
data:

■ Fault Man agem ent receives a trap from the Proxy Agent

Issue 2 A pril 1996

1-11

Introduction

■ The alarm and er rors refresh interval has passed

■ The alarm poll detected a mismatch between the number of alarms on the

■ You request a refresh

NOTE:

Fault Management updates cabinet information only during the startup

refresh proc e ss. If you want to u pdate c a binet information, you must close

Fault Management and re-invoke it from your NMS.

Receiving a Trap

When Fault Man agement receives a trap from the Pr oxy Agent, it refreshes the
alarms an d errors data. A trap can indicate t hat

■ The PBX has generated a new major, minor, or warning alarm

■ All PB X alarms have be e n c leared

Receiving a trap from the Proxy Agent is the p ri ma ry met h od Fault Management
uses to refresh alarm and error data. However, if the Proxy A gent fails to forward
traps, Fault Management can us e the methods o f ref r es hing data described later
in this ch apt er.

NMS and the number of alarms on the Proxy Age nt.

Figure 1-3. Trap Message

1-12 Issue 2 April 1996

Data Refresh

Table 1-1. Field Descriptions for Trap Messages

Field Des crip tion

Heading Information The first line of text, including:

■ The da t e and time that th e P roxy Agent

received the trap

■ The nam e o f t he no d e o n the NM S

Location The location of the alarm tha t is relate d to the

trap.

Severity One of the followin g alarm states:

■ Major

■ Minor

■ Warning

Description The MO (ma i ntenance object) name for the

alarmed object.

On Board? Ind icates whether the fa ult is on the

associated circuit pack or on an off-board
element c onnected to the circuit pack.

Valid values are:

■ y = yes

■ n = no

Issue 2 A pril 1996

1-13

Introduction

Figure 1-4. Trap Mess age for Extern al Devices

1-14 Issue 2 April 1996

Data Refresh

Table 1-2. Field Descriptions for Trap Messages for External Devices

Field Des crip tion

Heading Information The first line of text, including:

■ The da t e and time that th e P roxy Agent

received the trap

■ The nam e o f t he no d e o n the NM S

Location The location of the alarm tha t is relate d to the

trap.

Severity One of the followin g alarm states:

■ Major

■ Minor

■ Warning

Description The MO (ma i ntenance object) name for the

alarmed object.

On Board? Ind icates whether the fa ult is on the

associated circuit pack or on an off-board
element c onnected to the circuit pack.

Valid values are:

■ y = yes

■ n = no

External Device
Information

A heading that identifies the fields for external

devices.
Alternate Nam e The n ame of the ext ernal device.
Description The description of the external device.
Building The nam e o f t h e building that the external

device is in.
Address The mailing ad d re ss fo r the b uil ding.
Product ID The id entification number for the external

device.

Issue 2 A pril 1996

1-15

Introduction

Figure 1-5. Trap Message for Resolved Alarms

Table 1-3. Field Descriptions for Trap Messages for Resolved Alarms

Field Des crip tion

Heading Information The first line of text, including:

ALL ALARMS
RESOLVED

Alarm and Error Refresh Interval

Fault Management periodically polls the P BX for alarm and error information. The
interval of time specified in the Alarm and Error R efr esh I nterval field on the S etup
sc reen de t er mi nes how often polli ng o cc urs. When the amount of time sp ecified
in this field passes, Fault Ma nagement sta rts the data refresh. The cycle begins
again when Fault Management completes the refresh.

Fault Ma nagement allows you to:

■ Set this time interval for anytime from 5 and 1500 m inut es

■ Turn off p olling for alarm and error data

For more information about changing the interval for the alarm and error refresh,
see Changing Time Intervals.

■ The da t e and time that th e P roxy Agent

received the trap

■ The nam e o f t he no d e o n t he N MS

Trap messag e tha t in d icates all alarms have
been cleared.

1-16 Issue 2 April 1996

Data Refresh

Detecting a Mismatch

Fault Ma nagement periodically polls the P roxy Agent for the following MIB
objects:

■ healthMajor

■ healthMinor

■ healthWarning

■ snmpOutTraps

Mismatches in the application view of the values of these object s results in a
refresh.

For the MIB-II object snmpOutTraps, Fault Management compares the number of
traps in the initial sta rt u p poll p lus the traps received to the number of traps in
subsequent polls. Any difference between the two indicates the need for a
refresh.

Fault Ma nagement allows you to:

■ Set this time interval for anytime from 1 and 60 min ute s. When the interval

has passed, Fault Management starts pollin g th e MI B objects from the
Proxy Agent.

■ Turn off p olling for MIB objects.

For more information about changing the interval for alarm polling on the Proxy
Agent, see Changing Tim e Intervals.

Requesting a Refresh

Fault Ma nagement allows you to refresh alarm and error da ta manuall y, as
follows:

1. Open the Switch View.

2. From the menu bar, select Faul t à Refresh Alarms and Errors.

Issue 2 A pril 1996

1-17

Starting/Stopping Fault Management

This chapter describes:

■ Star t ing Fault Mana g emen t

■ The Sta rtu p Screen an d it s messages

2

■ The Sta r tup Process (an overview)

■ Stopping Faul t Manage me nt

Starting Fault Management

Fault Ma nagement is an application hosted by your NMS. Because Fault
Management is integrated into your NMS, when you add a DEFINITY PBX as a
node on your NMS, the system creates DEFINITY G3 Faul t Management as an
executable app licat ion.

You use the node icons on the NMS map to start Fault Management. Double click
on the following icon for the procedure for starting Fault M a nagement:

:

Issue 2 Apri l 1996 2-1

Starting/Stopping Fault Management

Table 2-1. Starting from HP OpenView and IBM NetView

Use either of the following me thods of starting Fault Management:

Method A

1. Highlight a PBX icon.

2. Double click on the DEFINITY icon that represents the PBX for which
you want to run Fault Ma nagem ent.

Method B

1. Highlight a PBX icon.

2. At the menu, select Monitor à DEFINITY à G3 Fault Management.

The Startup Screen

When you start Fault Management from th e NMS, Fault Management displays the
Startup screen.

To view this screen, do uble c lick on the following icon:

2-2 Issue 2 April 1996

The Startup Screen

Figure 2-1. The Fault Management Startup Screen

Start-Up Messages

The Startup sc reen d isplays one of the following mess a g es to describe the
start-up activity:

■ Refresh in progress, estimated delay nnn seconds, n

seconds elapsed.

This refresh status message indicates that Fault Management has
requested a full data refr esh. T he Proxy Agent gets new data from the P BX
and forwards it to Fault Ma n a gem e n t . The message includes the

Fault Ma nagement requests a full refresh if the value in the Refresh on
Start-up field on the Setup screen is TRUE. This value is the def ault
settin g .

Refer to Chapter 3, Custom izing Fault Management, for instructions on
changing the start-up settings.

■ Refresh on startup failed! Continuing with cache data.

This message displays if the Proxy Agent is unable to connect to the PBX.
Fault Ma nagement uses data stored in the Proxy Age nt instead of data
refreshed during initialization.

— Estimated amount of time necessary to refresh dat a (nnn)
— Elapsed time (n)

Issue 2 April 1996

2-3

Starting/Stopping Fault Management

■ Initializing...

This messag e indicates that Fault Management is retrieving da ta stored
by the Proxy Agent instead of getting new data from the PBX. This startup
method is quicker, but it retrieves cached data.

Exit Button

During the startup process, you can click on the Exit button on the startup screen
to sto p Fault Ma n a gem e nt from ref re shing and initializing.

If you click on the Exit bu t ton durin g th e sta r t u p p rocess, Fault Managemen t
stops initializing, closes its window, and returns you to the NMS.

The Startup Process

During the startup p roc e ss, Fault Management can:

■ Retrieve d ata successfully

■ Fail to retrieve data b e cause your cache is empty

■ Stop re q uesti n g d a t a after a p red e ter m ined number of attempts

Retrieving Data

Fault Ma nagement retrieves da ta when you first start it up . Faul t Management:

1. Uses the sysObjectID object from the MIB-II to get the switch type from

2. Compares the switch type of the sysObjectID object to the switch ty p e of

3. Gets the alarms and errors, changes the color of cabinet bo rd er s to

the Proxy Agent.

the vintage object in the G3 MIB.

If the switch types ... Then Fault Management ...

Match Gets all of the cabinet and external

devices data and draws th e a ppropriate
icons

Mismatch Displays an informational message that

explains the mismatch and stops
processing

indicate the highest severity alarm , a nd adds the alarm counts to the
alarms b o x.

4. Get s the c ircu it pack and D S1 informat ion using the configuration in the
G3-MIB.

2-4 Issue 2 April 1996

Stopping Fault Management

5. Populates any open cabinet-level displays with the circuit pack
inform at ion from ste p 4.

6. Indicates any alarm conditions by highlighting the circuit packs with the
hig hest level severit y for each .

7. Adds alarm co unts to the alarms box for the circuit pack.

NOTE:

Other methods of refr eshing data are discussed in the Da ta Refresh section
in Chapter 1.

Failing to Retrieve Data

When there is no c ached data in the database, Fault Management o p ens the
Switc h View s creen, but can not display any c a b inet , alarm , or error inform ation.

Reque sting Dat a

Fault Management requests data from the Proxy Age n t a p re d ete rm ine d nu m ber
of times. If Fault Management cannot retrieve data after the final attempt, it:

■ Displays a message in the message area of the Switch View window

■ Stops trying to get data

NOTE:

You use the Setup screen to specify t h e number of t i m e s Fault Management
requests d a t a b e f ore timin g out. See Table 3-6 for instructions.

Stopping Fault Management

At any time during your session, you can exit Fault Management as follows:

If you are here … Select or click this … And then do this …

Startup scre en Exit button
Switch Vie w Exit b u tton (or Options

à

Exit from menu bar)

Window Manager Quit Click OK at the

Click OK at the
confirmation prompt.

confirmation prompt.

Issue 2 April 1996

2-5

Customizing Fault Management

This chapter provides the information you need to customize Fault Management,
including:

■ Opening the Se tup Screen

■ The Setup Screen

3

■ Changing Colors

■ Changing Time Intervals

■ Changing Other Opti on s

■ T esting Your Changes

■ Saving Changes

■ Reverting to Default Settings

■ Exiting th e Setup Scre e n

Opening the Setup Screen

Use the following steps to access the Setup screen:

1. Open the Swi tch View s creen.

2. Select Setup from the Options me nu .
Result: The Setup screen d isplays.

The Setup Screen

The Setu p screen al lows yo u to change th e:

Issue 2 Apri l 1996 3-1

Customizing Fault Ma nagement

■ Colors tha t in d icate:

— Alarm conditions
— Circuit p ack mismatc he s
— Configurations you select for viewing

■ Time i nterva l s fo r ho w of t en Fault Ma n age ment re ceives data from the

Proxy Agent

■ Startup and retry indicators

■ The fi eld delimiter for reports in ASCII format

These settings a pply to all P BX’s on your NMS.

Sample Setu p Screen

The fol lowing fig ure shows the Fault Management Setup screen.

3-2 Issue 2 April 1996

The Setu p Screen

Menu Bar

Figure 3-1. Fault Management Setup Screen

The followin g tab le explains the menu bar for th e Setup screen:

Table 3-1. Command s for the Options Menu

Command Descript ion

Apply Applies the screen settings only to the current session.
Defaults Resets all fields setti n g s to their d efau lt values.
Grey Scale Re sets each color field to the de fault settings for g rey scale.
Save Saves the current settings pe rmanently.
Close Closes this screen and any o p e n c hild screens.

Issue 2 April 1996

3-3

Customizing Fault Ma nagement

Changing Colors

The Setu p screen al lows yo u to change the color settings for:

■ Alarm conditions

■ Circuit pack information on the configuration map

You can:

■ Select any color available to your monitor .

■ Specify a hexadecimal RGB color value.

■ Select a gray-scale instead of colors. This feature is designed for users

who are color-impaired or who have monochrome monitors.

Double click on a table icon for more information:

Table 3-2. Color Fields on the Setup Screen

Field Default Color Default Grey Scale

Major Alarm Color Red 0% Grey
Minor Alarm Color Orange 55% Grey
Warning Alarm Color Yellow 80% Grey
Circuit Pack Mismat c h Color B lu e 0% Grey
Highlight Color Green 0% Grey
Circuit Pack Select Color Cyan 0% Grey

Table 3-3. Procedure for Changing Colors

Use the following steps to c hange the default color settings:

1. Enter either the color name or the hexadecim al RGB color value in the
ap propriate color field.

Hint: Enter the RGB color value in the #RRGGBB format.
(RR = red, GG = g reen, BB = b lue)

Examp le: #FF0000 = re d
See Table 3-2 for infor ma tion about d efa ult co l or settings.

2. Click Apply to test your changes.

3. Select Optio ns à Save to save your changes for future sessions.

3-4 Issue 2 April 1996

Changing T im e Intervals

Table 3-4. Procedure for Changing Grey Scale Settings

Use the following steps to change the default se ttings for grey scale:

1. Select Options à Grey Scale.

2. Enter the following in each of the color fields that you want to change:

greyxx

xx = the percentage of grey. The higher this percent ag e, the
grey.

3. Click Apply to test your changes.

4. Select Optio ns à Save to save your changes for future sessions.

Changing Time Intervals

The Setu p screen al lows yo u to change the time intervals for:

■ Refreshing alar m s and er rors

■ Refreshing circuit pack data

■ Polling alarms

lighter

the

Issue 2 April 1996

3-5

Customizing Fault Ma nagement

Double click on a table icon for more information:

Table 3-5. Time Interval Fields on the Setup Screen

Field Default Valid Rang e Description

Alarm an d
Error Refresh
Interval
(minutes)

Circuit Pack
Refresh
Interval (hours)

Alarm Polling
Interval
(minutes)

60 minutes 5 to 1500

minutes

8 hours 1 to 1000

hours
0 turns the

refresh off.

10 minutes 1 to 60

minutes
0 turns the

p olli n g off .

The time interval between
data refreshes for PBX alarms
and errors.

The time interval between
d ata ref re shes for the PBX’s
circuit pack an d port
configuration.

The time interval between
p olls for an alarm c h ange.

If Faul t Management polls the
Proxy Agent and detects an
alarm change, it refreshes the
d ata. If it does not detect an
alarm change, it does not
refresh the da t a. You must
balance how often you want
Fault Management to check
for changed alarm status and
then update the da t a versus
how much the refr esh process
affects your network traffic.

Table 3-6. Procedure for Changing Time Intervals

Use the following steps to c hange the default settings for time intervals:

1. If you want to turn off the timing fu nction, t y p e a zero in each field you
want to disable. Otherwi se , skip thi s step .

2. Ty p e a new setti n g in the a ppro p riat e fields. Refer to the valid ranges
shown in Table 3-5.

3. Click Apply to test your changes.

4. Select Optio ns à Save.

For more information about time intervals, see Data Refresh.

3-6 Issue 2 April 1996

Changing Other O p tio ns

Changing Other Options

The Setu p screen al lows yo u to change th e options fo r:

■ Refreshing th e Proxy Agent at start up

■ The n u mber of retries on an SNMP time-out

■ The field delimiter for reports that you print in ASCII format

Double click on a table icon for more information:

Table 3-7. Other Option Fields on the Setup Screen

Field Default Description

Refresh Proxy
Agent On Startup

TRUE Ind icat es whether Fault Management

prompts the Proxy Agent to refresh all
its dat a from the PBX when you start
Fault Management.

■ TRUE = Fault Management

initializes with new PBX dat a from
the Proxy Agent.

Number Re tries
on SNMP Timeout

Default AS CII
Report F ield
Delimiter

■ FALSE = Fault Man ag em ent

initializes using cached (stored)
data from the Proxy Agent.

4 (retries)
The number of

retries does not
include the

Indicates how many times Fault
Manag e m ent retries to ge t d a t a from
the Proxy Agent. Enter a number from
0 to 10.

original attempt.
| (pipe) Displays the ASCII cha ra cter that

separates fields in an ASCII report.
Valid values are:

■ , (comma)

■ | (pipe)

■ : ( c o lon)

■ ; (semicolon)

■ tab

Whatever you choose be comes the
d ef ault . You can change this
character for a specific report on the
Output Options screen. (See How to
Save Reports.)

Issue 2 April 1996

3-7

Customizing Fault Ma nagement

Table 3-8. Procedure for Changing Other O ptions

Use the following steps to c hange the default setti n gs for the other o ptions on
the Setup screen:

1. To do this … Enter this … In this field …

Initialize Fault Management
using cache data

FALSE

Refresh Proxy
Agent On St artup

Change the number of
attempts at retrieving data
upon an SNMP timeout

Disable retries
Change the ASCI I fi eld

d elim it er for printed reports

2. Click Apply to test your changes.

3. Select Options à Save to save your c h a nges for future sessions.

Testing Yo ur Changes

You c a n test th e changes you make on the Setup screen b e fore you make them
permanent. This feature allows you to see how your changes affect your system.

For example, you can:

■ Change the color settings, and then test to see if they fit your needs.

■ Change a time inter v a l for getting new d a t a, a n d then test to determine if

the change has a negative affect on your network traffic.

A numbe r
between 1 an d
10

0
Selec t a value

from the
pull-down list

Number Retries on
SNMP Timeout

Number Retries on
SNMP Timeout

Default ASCII
Report Field
Delimiter

To test your changes without making them permanent, d o

■ Click on Apply at the lower left corner of the screen.

■ Select Options

The changes you make are in effect for the current session only and are lost
when you exit Fault Management.

Saving Changes

If you are satisfied with the changes you have made, use the following procedure
to save them for this and future sessions.

1. Select Apply at either of the following lo cations:

3-8 Issue 2 April 1996

à

Apply.

one

of the following:

Reverting to Default Settings

■ The A pply button in th e lower left corner of the screen

■ The Op ti ons me n u

2. Select Options à Save.
Result: Fault Management saves your changes in a resource file and uses

them in future startup s (from any terminal a n d for every node).

Reverting to Default Settings

Fault Management has default settings for all of the options you can customize. If
you make changes to th e Setup screen and then decide you want to r e turn to th e
default setting s, you may do so easily by selecting Option s à Defaults.

For these default settings … Click here …

Colors and grey scale Table 3-2
Time interval s Table 3-5
Other setup options Table 3-7

Exiting the Setup Screen

Use one of the following methods to exit the setup screen:

■ Click on the Close button at the lower right corner of the screen .

■ Select Options

NOTE:

If you close the screen without sa vin g or appl ying, any ch anges you have
made will be lost.

à

Close.

Issue 2 April 1996

3-9

The Configuration Map

This chapter describes the configuration map and the me thods used to repr esent
your DEFINITY G3 PBX. Understa nding the topics in this chapter c an help you
locate the fault inform at ion you need.

Topics include:

4

■ Overview of the Configuration Map

■ Switch View

■ Cabinet View

■ Circuit Pack Inform ation

■ Port Information

■ External Devices

■ Individual Extern al Devices

Overview of the Configuration Map

The configuration map is the graphical interface to the application. It allows you
to navigate through Fault Ma nagement and quickly access PBX data. The
benefit of this feature is that you can see configuration and fault information
quickly and easily.

This feat ure con si sts of graphical depictions of the PBX configuration. These
graphics are specific to an entire PBX, a cabinet, a circuit pack, a port, or an
external device.

Issue 2 Apri l 1996 4-1

The Configuration Map

Faults Displ ay ed as Colo r s

Fault Ma nagement shows the severity of alarm conditions wit h color h ighlig hting
or grey-scale settin g s. (This man ual uses t he ter m
settin g s.) However, within the context of the configuration manager , th e color
indicators are sp ecific to the level you are viewing.

Figure 4-1 is an example of an alarms display. The color-coded alarm boxes
show the cum ula tive to tal of active alarms. Typically, alarms display on the
right-hand side of the window.

c olor

to refer to bot h of these

Figure 4-1. A l arms

:

For information about … Click here …

Faults and color highlighting Color Hi g hlighting
The di fference bet ween c a b inet and pac k

alarms

Screens in the Configuration View

The configu ration map displays PBX d ata in layers, or views. Each view is a
graphical display for one of the following hardware layers.

■ Switch View

■ Cabinet View

■ Circuit Pack Inform ation

■ Port Information

■ External Devices

■ Individual Extern al Devices

Types of Alarms Re p orts

4-2 Issue 2 April 1996

Switch Vie w

Switch View

The Switch View contains a graphical d epiction of all the cab inet s an d exter nal
devices on the P B X. W he n you click on an icon, in forma tio n about the hardware’s
status and configuration displays.

The Switch View has the following c ompo n ents:

■ Menu Bar for Switch View

■ Screen Heading for Switc h View

■ Alarms for Switch View

■ Switc h View Hotspots

■ Swit ch View M e ssa g es

NOTE:

The icon for external devices only displays if an external device is
administered on the PBX.

How to Op en the Switch View

The Switch View opens automatically when you start Fault Managem ent. It is the
first sc re en to display after the Fault Management Startup screen.

Sample Switch View

The following fig u re shows the Switch View s creen :

Issue 2 April 1996

4-3

The Configuration Map

Figure 4-2. Switch View

Menu Bar for Switch View

Double click on an icon for information about the menu commands for the Switch
View.

Table 4-1. Options Comma nds

Command Description

Setup A llows you to mo d i f y c ertai n d ef ault settin gs.
R eport Bu i lder Allows you to create ad-hoc reports.
Clear Hig hlightin g Clears the highlighting that yo u sele cted.
Exit Closes Faul t M anagement and returns you to the NMS.

4-4 Issue 2 April 1996

Switch Vie w

Table 4-2. Fault Commands

Command Description

All Alarms Displays all active alarms on th e PBX.
Switch Level Alarms Displays active alarms that are not related to a

specific cabinet.

All Errors Disp lays all errors associated with active

alarms.

Switch Level Errors Displays errors for ac tive alarm s that are not

related to a specific cabinet.
Refresh Alarms and Errors Upda t e s c urrent ala rms and errors.
Refresh Bulletin Board Updates the bulletin board.
Display Bulletin Board Displays the bulletin board.

Table 4-3. Configuration Commands

Command Description

Display Hardware/
Software Information

Circuit Pack
Inventory

All Circuit Packs Displays a detailed report for all the circuit packs that

Exception Circuit
Packs

DS1 Circuit Packs Displays a rep ort for all the dig it al signali ng circ uit

Refresh
Configuration Data

Displays the current vintage or release information
ab out the PBX an d Fault Managemen t software.

Displays a summary report for the ci rcuit p acks
currently installed on the PBX.

are ad mi nistere d on the PBX or that are physically
p resent on the PBX.

Displays a report for all the circuit packs that are
administered on the PBX but are either mismatches or
are not physical ly present.

packs t hat are on the PBX.
Refreshes the information about circuit packs. You can

use this command when you change the configuration
of the PBX.

Issue 2 April 1996

4-5

The Configuration Map

Screen Heading for Switch View

Immed i atel y below the menu bar, the Switch View d isplays general information
about the PBX. Double click on the icon for more inform at ion:

Table 4-4. Screen Heading

Data Description

Appl ication
Name

Switc h Name The n a me of the PBX as it appe a rs on the NMS when the

Switch Type The type of PBX (the object ID from th e Prox y Agent M IB) , as

Number of
Cabinets
Found

DEFIN ITY G3 Fault Man agement

PBX is administered as a node on the network. This
information is passed from t he NMS.

it is administered on the Proxy Agent.
The number of cabinets that Fault Management recognizes.

Valid values are:

■ A number from 1 - 44

Circuit Pack
Mismatches

Alarms for Swi tch View

The color-coded alarms on the right side of the s c reen d isplay the number of
major, minor , and warning alarms as follows:

Column Description

Ex ternal Alarms for the external devices. This column displays only if

there are external devices administered on the PBX.

Switch Alarms that are on the system b ut are not associated with a

cabinet.

Cabinet Alarms that are specifically associated with ca binet hardware.

■ Blan k, if Faul t M a nage ment cannot find any cabinets for

the PBX.

The num ber of circuit packs with a mismatch between the
type that is inserted into the cabinet slot an d the type that is
administered for that slot.

Fault Management displays this field only when mismatches
exist.

4-6 Issue 2 April 1996

Switch Vie w

Swit ch View Hots pot s

The central por tion of th e Switch View conta ins hotspots in the form of ic ons that
represent external devices and c a b inet s .

Each cabine t icon represents a par t icula r cabinet on the PBX an d d e p i cts the
type of cabinet.

If you click on this icon … Then this screen dis plays …

External Device External Devices
Cabinet The appropriate Cabinet View

See Hot spots in Chapter 1 for an overview of hotspots.

Colored Borders

Each icon is surrounded b y a border that is highlight ed with the color that
represents the highest level of alarm. If the icon d oes not have a colored bo rder,
there is no alarm.

Icon Label s

A label disp lays a bove each i con in the hotspot area. Icon labels have the
following c omponents:

Component Description Example

Name Identifi es the external devic e o r c a b inet

Background
color

Border Identifies an external device or cabinet that

Id entifi e s c a b inet s with a circuit pack
mismatch.

If the cabinet does not contain any circuit
packs mismatches, the background color does
not di splay. (See example for Name.)

You can set the background color in the Circuit
Pack Mismatch Color fie l d on the Setup screen.

Fault Management includes in a report. This
border only displays if you request a report w ith
highlighting.

You can set the color for this border in the
Highlight Color field on the Setup sc reen.

Issue 2 April 1996

4-7

The Configuration Map

Switch View Messages

The messa g e a rea a t t h e b otto m of the Swi tch Vie w displays the following types
of messages:

Message Type Description

Warning A warning message only displays when the dat a that Fault

Message Fault Management regularly updates status and error data.

Cabinet View

Management displays is based on non-refreshed, cached
da ta. The followi n g sit uati ons can result in this warning:

■ Fault Manageme nt cannot comp l ete a refresh attemp t .

■ The Ref resh Proxy Agent On Startu p field on the Setup

screen is set to FALSE.

These messages describe these updates.

The Cabin et View displays data for a cabinet and is a graphical depiction of the
the carriers and circuit packs in the cabinet.

The Cabinet View has the following comp o nent s:

■ Menu Bar for the Cabinet View

■ Graphic Display Area

■ Cabinet Data Area

■ Cabinet Messages

How to Open the Cabinet View

To op en the C abinet View:

1. Display the Switch View.

2. Click on a cabinet icon.

Sample Cabin et View

The fol lowin g f i g ure shows the Cabinet View:

4-8 Issue 2 April 1996

Cabine t View

Figure 4-3. Cab inet View

Menu Bar for the Cabinet View

Double click on an icon for information about the menu commands for the
Cabinet View.

Table 4-5. Options Comma nds

Command Description

Report Bui lder Allows you to create ad-hoc reports.
Clear Hig hlightin g Removes highlighting.
Close Closes the Cabinet View and any open child windows.

Issue 2 April 1996

4-9

The Configuration Map

Table 4-6. Fault Commands

Command Description

All Alarms for Ca b inet # Displays all a c t ive alarms on the c a binet.
Cabinet Level Alarms

for Ca b inet #
All Errors for Cabinet # Displays all errors for the alarms on the cabinet.
Cabinet Level Errors for

Cabinet #

.

Table 4-7. Configuration Commands

Menu Option Command Description

Highlight Circuit
Packs With

Disp lays active alarms on the ca b inet that are not
related to a specific circuit pack.

Disp lays errors for alarms o n the c abinet that are
not related to a specific circuit pack.

Una ss igned Ports Does the following:
No Assigned Ports
No Available Ports
TTI Port s
Type Mismatch
Control Circuit

Packs
Major Alarms
Minor Alarms

■ Opens t he appropriate report

window.

■ Highlights the affected circuit

pa cks on the C ab inet View.

■ Displays an informational

message in the message area
of th e Switch and C abinet
views. T his message explains
the highlighting.

Warning Alarms

The configuration reports are described in Chapter 6, The Configuration
Manager.

Graphic Display Area

The lef t-han d si de of the Cabinet View shows a graphical display of the cabinet
with the:

■ Appropriate carriers.

■ Slots and their appropriate slot numbers.

■ Ci rcu i t pa c k la b els for slot s c o n tain ing a ci rcuit pack. The circu it pa ck

label depicts the type of circuit pack. If the slot is administered but d oes
not contain a circuit pack, the label is NO BRD.

4-10 Issue 2 April 1996

Cabine t View

■ B lank slots for slot s that d o not contain a c i rc u i t pa c k.

Cabinet Hotspots

Cabinet hotspots are icons of the different ci rcuit packs. When you click on a
circuit pack hotspot, Fault Management:

■ Opens the corresponding circuit pack view

■ Highlights the selected circuit pack on the cabinet level display

■ Displays a message in the lower right c orner of the screen that identifies

the highlightin g and color be ing used

NOTE:

You can open up to 23 circuit pack views. W hile these views are open, Fault
Management highlights the correspon d ing circuit pack on the cabinet view
with the circuit pack select color.

When you open several circuit pack views at the same time, you can bring
a particular one to the front by clicking on the corresponding circuit pack in
the cabinet view.

See Hot spots in Chapter 1 for an overview of hotspots.

Cabinet Data Area

The right -hand side of the Cabinet View is d ivide d into the following d at a areas:

■ Screen Heading

■ Alarms

■ Configuration Data

Double click on an icon for more information.

— Cabinet description
— Carrier description

Issue 2 A pril 1996

4-11

The Configuration Map

Table 4-8. Screen Heading

Field Description

Appl ication
Name

Switch N a m e The na m e of the PBX as it ap pears on the NMS when the

Cabinet Number The number of the current cabinet.
Circuit Pack

Mismatches

D EFINITY G3 FM

PBX is a d ministe re d as a node on the net work. This
informat ion i s p assed from the NM S.

The number of circuit packs with a mism at c h b e twee n the
type that is inserted into the cabinet slot and the type that
is administered for that slot.

A mismatch is the h i g hest level of severity, an d
supersedes alarm s.

You can set the background co lor in the Circu it Pack
Misma t c h Color fiel d on the Setup s c reen.

F ault Management displays this field only when
mismatches exist.

Table 4-9. Alarms

The color-coded alarms on the right side of the screen display the number of
major, minor, and warning alarms as follows:

■ Cabinet alarms that are on the cabinet but are not associated with a

circuit p a ck

■ Pack alar m s that are specifically associated with a circuit pack

Refer to Figure 4-1 for an illustration of the alarms box.

4-12 Issue 2 April 1996

Cabine t View

Table 4-10. Configuration Da ta

Data Area Field Description

CABINET
DESCRIPTION

This area of the sc reen includes details

ab out t h e c urrent ca b inet .
CABINET The cab inet number.
CABINET

LAYOUT

The type of cabinet layout:

■ five-carrier

■ single-carrier-stack

■ enhanced-single-carrier-stack

■ small

■ very-small

CABINET TYPE The type of cabinet:

■ proc essor

CARR I ER
DESCRIPTION

■ expansi on-port-network

ROOM The room where the cabinet is located

(taken from PBX administration.)
FLOO R The floor where the ca b inet is lo c ate d

(taken from PBX administration.)
BUI L D ING The building where the c abinet is

located (taken from PBX administrat ion. )

This area of the sc reen i ncludes details

ab out t h e carrier.
Carrier The carrier label.
Ca r ri e r Ty pe The typ e o f carrier:

■ p ro cessor

■ dup-sw-node

■ switch-node

■ port

■ fan

■ expansion-control

■ not -u sed

Port Network

The num be r of the port network, 1 - 44
Number

Issue 2 A pril 1996

4-13

The Configuration Map

Cabinet Messages

The message areas on the C a b inet View display the following types of
messages:

Message Type Location Description

Incomplete
Data Warning

Highlight
Message

Circuit Pack
Message

Cached Data
Warning

Above CABINET
DESCRIPT ION
information.

Below CARRIER
DESCRIPT ION
information.

Below highlight
message

Below CARRIER
DESCRIPT ION
information.

This war ning message displays only if
you clicked on a cabinet hotspot on the
Switc h View bef o re Fau lt M anagement
retrieved all the information about
circuit packs. The message disappears
once Fault Management completes
da ta retrieval.

An informational message that
describes the last highlighting selection
you made from the Configuration me nu.

An informational message that reminds
you that you selected a circuit pack.

A warning message only displays when
the data that Fault Management
di splays is based on non-refreshed,
cached data. The following situations
can result in this warning:

Circuit Pack Information

The Circu it Pack I n form ation sc reen disp lays data for a circuit pack and lists the
por ts. This screen has the following co m pone nts:

■ Menu Bar for Circuit Pack Information

■ Data Area for Circuit Pack Information

■ Circuit Pack Hotspots

How to Open Circuit Pack Information

To open the Circuit Pack Information screen:

1. Display the Cabinet View.

2. Click on a slot in the cabinet’s graphic display area.

■ Fault Man agem ent cannot

com p l e te a refresh attempt

■ The Refres h Prox y A gent On

Startup field on the Setu p screen is
set to FA LSE

4-14 Issue 2 April 1996

Circuit Pack Information

Sample Circuit Pack In fo rmati on Screens

Double click on one of the following icons for a sample screen:

Figure 4-4. Circuit Pack Information Screen

Issue 2 A pril 1996

4-15

The Configuration Map

Figure 4-5. Circ uit Pack Information Screen Showin g a Conflict

4-16 Issue 2 April 1996

Circuit Pack Information

Menu Bar for Circui t Pack In format ion

Double click on the icon for a description of the menu bar for the Circuit Pack
Inform atio n s c re en:

Table 4-11. Men u Co m m ands

Menu Com mand Description

Options Close Closes the Circuit Pack Information screen

Fault Al l Alarms for

Circuit Pack #
All Circuit Pack

Level Alarms for
Circuit Pack #

All Errors for
Circuit Pack #

All Circuit Pack
Level Errors for
Circuit Pack #

Help Displays a Help window.

and any open child windows.
Displays active alarms on the circuit pack.

Displays active alarms on the circuit pack
that are not related t o a specific port.

Displays errors related to active alarms on
the circuit pack.

Displays errors related to active alarms on
the circuit pack that are not related to a
specific port.

Data Area for Circuit Pack Information

The Circu it Pack I n form ation sc reen contains the foll owing data areas:

■ Screen heading

■ Alarms

■ Conf i g u ratio n data

— Circuit pack data
— Assigned ports

Issue 2 A pril 1996

4-17

The Configuration Map

Double click on the ico n for a description of these areas.

Table 4-12. Screen Heading

Field Description

Appl ication
Name

Screen Title Circuit Pack Information
Switch N a m e The na m e of the PBX as it ap pears on the NMS when the

Table 4-13. Alarms

The color-coded alarms on the right side of the screen displays the number of
major, minor, and warning alarms as follows:

D EFINITY G3 FM

PBX is a d ministe re d as a node on the net work. This
informat ion i s p assed from the NM S.

■ Cir cuit pack alarms that are on the circuit pack but are not associated with

a port

■ Pack alarms that are specifically associated with a port

4-18 Issue 2 April 1996

Circuit Pack Information

Table 4-14. Configuration Da ta

Data Area Field Description

Circuit Pack
Data

LOCATION The circuit pack’s cabinet, carrier, and slot.
TYPE The type of circuit pack. A few exampl e s are:

■ Analog line

■ BRI line

■ D a ta line

■ Digi t al lin e

■ DS1 interface

CODE The product code of the circuit pack.
SUFFIX The suffix o f th e circu it pack.
VINTAGE One of the following:

■ The vintage of the circuit pack.

ASSIGNED
POR TS

■ The highlighted word CONFL ICT; if there

is a mismatch b et ween the c i rcu i t p ack’s
administration and type.

SIGNALING The type of signaling. Displays only for DS1

circuit packs.

NAME The DS1 na me. Displays only for DS1 circuit

packs.

CSU
MODULE

The ID fo r t h e i n tegrated CSU module.
Displays only for DS1 circuit p acks.

BIT RATE The speed of the channels; either 2. 048 or

1.544 Mbps. Displays onl y f or DS1 circuit
packs. The Defa ult is 2 .0 4 8 .

This area of the screen lists each port on the
circuit pack (numbered from 1 up to as many
as 32).

■ Yes = the port is assigned

■ No = the port is not assigned

■ TTI = the port is a TTI port

Each port number is a hotspot that opens the
port view for that port.

Issue 2 A pril 1996

4-19

The Configuration Map

Circuit Pack Hotspots

Each po rt number listed u nder Assigned Ports is a hotspot which opens the por t
level view for that specific port.

See Hot spots in Chapter 1 for an overview of hotspots.

Port Information

The Port In f o r mation screen contains data for a single port. The data that
displays varies, depending on the type of equipment in the port . Equ ipment
types are:

■ Stations

■ Data modules

■ Trunks

How to Open Port Inform atio n

To op en the Port Info rm at ion screen :

1. Display the Circuit Pack Informati on screen.

2. Click on a port in the ASSIGNED PORTS data area.

Sample Port Informati on Scr eens

Double click on an icon for samples of each of the different types of Port
Informa tio n s c re ens:

4-20 Issue 2 April 1996

Port Information

Figure 4-6. Port Information: Pooled Modem

Issue 2 A pril 1996

4-21

The Configuration Map

Figure 4-7. P ort Infor m ation: Station

4-22 Issue 2 April 1996

Port Information

Figure 4-8. Port Information: Data Mod ule

Issue 2 A pril 1996

4-23

The Configuration Map

Figure 4-9. Port Information: Trunk

Menu Bar for Port Informat ion

The menu bar for the Port Inform ati on sc ree n co ntai ns the following commands:

Menu Com m and Description

Op tion s Close Closes the Port Information scr e en an d any

Fault Al l Alarms

for Port #
All Errors

for Port #

Help Displays a Help window.

4-24 Issue 2 April 1996

open child windows.
Displays all active alarms for the po rt specified.

Displays all errors for the port specified.

Port Information

Data Area for Port Information

The Port In form a tion sc reen contains the following data areas:

■ Screen heading

■ Alarms

■ Conf i g u ratio n data

— Por t d at a
— Equipment type

Double click on the icon for a description of these data areas.

Table 4-15. Screen Heading

Field Description

App lication Na m e DEFIN ITY G3 FM
Screen Title Port Information
Switc h Name The nam e of the PBX as it appears on the

NMS when the PBX is administered as a node
on the network. This information is passed
from the NMS.

Table 4-16. Alarms

The color-coded alarms on the rig ht side of the screen display the
number of major, minor, and warning alarm s for the port.

Issue 2 A pril 1996

4-25

The Configuration Map

Table 4-17. Port Data

Field Description

PORT LOCAT ION The port’s cabinet, carrier, slot, and p ort.

CIRCUIT PACK TYPE The typ e of circuit pack the port is on.
EQUIPMENT TYPE The equipment attached to the port. For

Example: 01C2004

■ 01 = Cabinet

■ C = Carrier

■ 20 = Slot

■ 04 = Port

example:

■ Station

■ Data Module

■ Integrated An n ouncemen t

IDENTIFICATION The a l t ernate name of the port. For example:

■ A station extension

■ The trunk/group me mber num b er

(Trk Gp /Mbr No)

EQUIP MENT TYPE For BRI Mu l ti point, the equipment attached to

the second port.

IDENTIFICATION For BRI Multipoint, the alternate nam e of the

second port.

4-26 Issue 2 April 1996

Port Information

Table 4-18. Equipment Type: Station

Display Area Field Des cription

Station
Information

Extension The extension number for the stati on.
Station Type The type of station.
Name The station’s name, as administered on the

PBX.

Building The building where the station is located,

as ad m inist ered on the PBX.

Floor The fl oor where the station is located, as

administered on the PBX.

Room The room where the station is locate d, as

administered on the PBX.

Cable The identifier of the cable, as administered

on the PBX .

Jack The location of the jack, as a dministered

on the PBX .
Service State The current service state of the station.
Maintenance

Busy?
Connected

Ports
SAC

Activated?
CF

Destination
Ext

Ring Cut Off
Active?

Indicates if the station is busy for

maintenance purposes.

Lists any ports that are currently

connected to the st ati o n.

Indicates if the Send All Calls feature is

active.

Call Forwarding d estination. The extension

to which the PBX forwards calls.

Indicates whether the Ring Cut Off feature

is active.

Issue 2 A pril 1996

4-27

The Configuration Map

Table 4-18. Equipment Type: Station

Display Area Field Des cription

Station Data
Module
Inform ation

Data

The extension number for the data module.

Extension
Dat a Name The n a m e of the d a t a module, as

administered on the PBX.

Data Service
State

Data
Maintenance

The current service state of the data
module.

Indicates if the data module is busy for
maintenance purposes.

Busy?
Data

Connected

Lists any ports that are currently
connected to th e dat a m odule.

Ports
Data CF

Destination

Call Forwardin g d estin ation for d at a. The
extension to which the PBX forwards calls.

Ext

.

Table 4-19. Equipment Type: Data Module

Field Description

Extension The extension num ber for th e stati on.
Type The type of data module.
Nam e The da ta mo dule’s name, as administered on the

PBX.
Service State The current service state of the data module.
Maintenance Busy? Indicates if the station is busy for main ten ance

purposes.
Connected Ports The ports that are connected to the data module.
CF Destination Ext Call Forwarding d estin ation. The e x tension to which

the PB X forwards calls.

4-28 Issue 2 April 1996

Port Information

.

Table 4-20. Equipment Type: Trunk

Display Area Field Description

Trunk Group
Information

Group Type The t ype of trun k group.
Group Name The group name, as administered on the

PBX.

Direction The t runk direction.

For example, a 2-way di rection has
incoming and outgoing calls.

Comm Type
or Service

Either the communicat ions type or the
service type.

Type
Trunk Type The type of trunk. Some examples are:

■ Voice

■ Dat a

Trunk Member
Status
Information

Port Hotspots

The port view does not have hotspots. See Hotspots in Chapter 1 for an overview
of hotspots.

Port Messages

The message area at the bot tom of the sc ree n d isplays the status of the retrieval
of port data.

■ Tie

Member Name The member name of the trunk, as

administered on the PBX.
Service State The current service state of the trunk.
Maintenance

Busy?
Connected

Ports
CF Destination

Ext

Indicates if the station is busy for

maintenance p urposes.

Lists any ports that are currently

connected to the trunk.

Call Forwardi n g d esti nati on for d a t a. The

extension to which the PBX forwards calls.

Issue 2 A pril 1996

4-29

The Configuration Map

External Devices

An external device can be anything tha t is c onnected to a PB X. Examples of an
external device are a thermostat and a voice mail system.

The Exter n a l Devices View displays icons for all the administered exter nal
devices on a DEFINITY G3 PBX. You ca n click on an icon to display inform at ion
about a device’s hardware status and configuration.

NOTE:

The icon for external devices only displays on the S witch V iew i f an external
device is administered on the PBX.

The Exter n a l Devices View has the following components:

■ Menu Bar for External Devices

■ Screen Heading for External Devices

■ Al ar ms for Extern al Devices

■ External Device Hotspots

■ External Device Messages

How to Open Extern al Devic e s

To op en the External Devices View:

1. Display the Switch View.

2. Click on the external devices icon.

Sample External Devices S creen

The following fig u re shows the External Devices View:

4-30 Issue 2 April 1996

External Devices

Figure 4-10. E xterna l Devices View

Issue 2 A pril 1996

4-31

The Configuration Map

Menu Bar for External Devices

Double click on the following icon for information about the menu commands for
the External Devices View:

Table 4-21. Menu Commands

Menu Command Description

Options R eport Bu ilder Allows you to create ad-hoc reports.

Clear Highlig ht Clears any highlig hting.
Close Closes this view an d any op en child

Fault A ll External

Device Alarms
All External

Device Errors

Help Disp lays a Help window.

windows.
Displays all active alarms for the d evice.

Displays all active errors for the device.

Screen Heading for External Devices

Immed i atel y below the menu b a r, the E xte r nal Device s View displays general
information ab out the PBX. Double click on the icon for more information:

Table 4-22. Screen Heading

Data Description

Appl ication Na m e DEFINITY G3 Fault Management
Switch N a me The name of the PBX as it ap pears on the NMS when

the PBX is administered as a node on the network.

Number of
External Devices
Administered

The number of external d evices administered on the
PBX. Valid values are numbers from 1 - 90.

Alarms for External Devic es

The color-coded alarms on the right sid e of the sc ree n d isplay the number of
major, minor , and warning alarms for the external devices.

4-32 Issue 2 April 1996

Individual External Devices

External Device Hotspots

The central portion of the External Devices View contains hotspots in the form of
icons that represent external devices.

See Hot spots in Chapter 1 for an overview of hotspots.

Colored Borders

Each icon is surrounded b y a border that is highlight ed with the color that
represents the highest level of alarm. If the icon d oes not have a colored bo rder,
there is no alarm.

Icon Label s

A label disp lays a bove each i co n. This la b el identifies the external device by
displaying the value in the ALT NAME field on the P BX.

If you requested a report with highlights, Fault Management highlights the labels
for each device that it includes in the report.

External Device Messages

The message area at the b ottom of th e screen displays the following types of
messages:

Message Type Description

Highlight
Reason

If Fault Management hig hli g h t s the label for an external
device’s icon, a mess a g e displays that explains the reason
for the highlightin g.

Cached Data
Warning

A warning message only displays when the d ata that Fault
Management displays is based on non-refreshed, cached
da ta. The followi n g sit uati ons can result in this warning:

■ Fault Management cannot complete a refresh attemp t .

■ The Refresh Proxy Agent On Startup field on the Setup

screen is set to FALSE.

Individual External Devices

The Individual Extern al Devices screen displays the hardware configuration and
the fault status for a specifi c external devic e .

The Individual Extern al Devices screen has the following comp o n ents:

■ Menu Bar for Individual External Device

Issue 2 A pril 1996

4-33

The Configuration Map

■ Data Are a for Individual External Device

How to Open Individual External Devices

To open the Individual External Devices screen:

1. Display the External Devices screen.

2. Click on an external d e vice icon.

Sample Individual External Devices Screen

The following fi g ure shows an Individual External Devic e sc reen for a voic e mai l
system:

Figure 4-11. Individual External Dev ice Screen

4-34 Issue 2 April 1996

Individual External Devices

Menu Bar for Individ ual Extern al Devic e

Double click on the following icon for information about the menu commands for
the Individual External Device screen:

Table 4-23. Menu Co m m ands

Menu Command Description

Options Close Closes this view and any

Fault Display Alarms For External

Device <name>
Display Errors For External

Device <name>

Help Displays a Help window.

open child windows.
Displays all active alarms for

the d e vic e.
Displays all active errors for

the d e vic e.

Data Area for Individual External Device

The Individual Extern al Devices screen has the following d a t a areas:

■ Screen heading

■ Alarms

■ Conf i g u ratio n data

Double click on an icon for more information:

Table 4-24. Screen Heading

Data Description

App lication
Name

External
Device Name

Switc h Name The name of the PBX as it appears on the NMS when the

DEFIN ITY G3 Fault Man agement

The nam e of the external device.

PBX is administered as a node on the network.

Issue 2 A pril 1996

4-35

The Configuration Map

Table 4-25. Alarms

The color-coded alarms on the right si d e of the s cree n d isplay the number of
major, minor , and warning alarms for the external device.

Table 4-26. Configuration Data

Field Description

Port Location The name of the port that co nnect s the external device.
Administered

Alarm Type

The ty pe of alarm that the P BX generates for an active
alarm. Valid values are:

■ Major

■ Minor

■ Warning

Alternate Name The abbreviat e d nam e for the external devic e .
Description A brief description of the external d evice.
Product Identifier The 10-digit product number for the external device.
Buil ding The building where the device is located.
Address The a dd ress of the building where the device is

located.

4-36 Issue 2 April 1996

The Fault Manager

This chapter describes the Fault Manager feature that helps you locate and
recognize faults within your DEFINITY G3 PBX. Topics include:

■ Overview of Fault Manager

■ When Fault Manager Receives Data

5

■ How Fault Manager Displays Faults

■ How to Print Reports

■ How to Close Report Windows

■ How to Get More Report Infor ma tion

■ Error Description Screen

■ Bullet in B o ard

Overview of Fault Manager

Fault ma nager uses a graphical format to indicate alar m c o nditions, including:

■ Where an active (non-resolved) alarm is located on a PBX.

■ The typ e o f alarm : major, minor, or warning.

The severity level of these alarm types are indicated by color, for easy
identification.

■ The nu mber of alarms in each alarm typ e.

For each alarm type, this alarm co u nt is furth e r divided into
hardware-specific and non-hard ware-specific categories.

Issue 2 Apri l 1996 5-1

The Fault Ma nager

When Fault Manager Receives Data

Fault Ma nager receives PBX data from Fault Management d u ring the following
events:

■ At start-up (when Fault Management i s firs t invoked from the N MS)

■ During the normal data refresh (refresh and po l ling intervals)

■ A t a user's re q uest

■ Upon receipt of a trap

NOTE:

For info r mation about how Faul t M anage ment retrieves data see The
Startup Process in Chapter 2.

How Fault Manager Displays Faults

Faults are active alarms and errors within a PBX. Fault manager uses the
following meth ods of displaying these faults:

■ Color H i g hlig hting

■ Alar ms

■ A larms Repo r ts

■ Error Reports

Color Highlighting

Fault ma nager highlights the affe c ted ha rdware with the c o l or of the hi g hest
severity fault.

For example, if a cabinet has four warnings and one minor alarm, the cabinet is
highlighted with the color of the minor alarm.

NOTE:

If your operating system allows you to change these color settings, you can
do so from the Setup men u. See Tabl e 3-2 for instructions.

Alarms

The alarms display, shown in Figure 4-1, is located on the right side of any
configuration window.

5-2 Issue 2 April 1996

How Fault Manager Displays Faults

Alarms Reports

Alarms reports display alarm data a bout faults on the PBX. They are specific to
the hardware layer currently displayed on your sc reen an d p rovide the following
information for that layer:

■ What faults exist

■ Which hardware is affected

The Fault menu allows you to select a report that displays alarms for:

■ A ll the alarm s for the hardware layer that is c ur rentl y d isplayed

■ Only the alarms that are not specific to the hardware you are displaying

NOTE:

These rep ort s sho w alar m d a t a that is c u rrent at the ti me you request the
report. Fault Management does not update th e d at a while th e rep ort
window remains open. To ensure that the data is up to date, close and then
re-open any open report window.

Double click on an icon for more information.

Table 5-1. Types of Alarms Reports

Screen Fault M enu Command Report Description

Switch
View

All Alarms All active alarms in the PBX
Switch Level Alarms All a c t ive alarm s that are in the PBX

but are not associate d with any
cabinet

Cabinet
View

All Alarms for
Cabinet #

Cabinet Level Alarms
for Cabinet #

All act ive alarm s in the c abinet

All act ive alarm s that are in the
cabinet but are not associated with
any circuit pack

Circuit
Pack
Information

All Alarms for Circuit
Pack #

Circuit Pack Level
Alarms for
Circuit Pack #

All act ive alarm s on the c i rcuit p ac k

All act ive alarm s that are on the
circuit pack but are not associated
with a p ort

Issue 2 April 1996

5-3

The Fault Ma nager

Table 5-1. Types of Alarms Reports

Screen Fault M enu Command Report Description

Port
Information

External
Devices
View

Individual
External
Device

All Alarms for Port # All active alarms for the port

All External Device
Alarms

Display Alarms For
External Device
<name>

All active alarms for all external
devices that are connected to the
PBX

All act ive alarm s for the external
device specif ied.

Figure 5-1. Alarm s Report for All Alarms at the Switch View

5-4 Issue 2 April 1996

How Fault Manager Displays Faults

Table 5-2. Field Descriptions for Alarms Reports

Field Description

# Alarms Found The n u mber of active alarms
Port The alphanumeric ID (location) of the alarmed

Maintenance Name The logical name of the maintenance alarmed

On Board? The location of the det e c t e d f ault .

object.
Zeros in this field indicate the alarmed ob j e c t

is not connected to a port (for example, a system
printer.)

Data for this report is sorted by port ID
number.

object

■ y = The fault is on the associated circuit pa ck

■ n = The fault is not as sociate d with this circuit

pack, but with on an off-board element that is
connected to the circuit pack

Alt Name An othe r way to id ent ify the maintenan ce

object.

■ If the object is a station, this field contains the

extension number.

■ If the object is a trunk, this field contains

xxx/yyy, where:
— xxx = the trunk group numb er
— yyy = the member number

■ If the object is a private CO line, this field

contains P/nnn, where:
— P = private
— nnn = the line group nu m b e r

Alarm Type The severi t y o f the fau lt, as follows:

■ MAJOR

■ MlNOR

■ WARNING

Issue 2 April 1996

5-5

The Fault Ma nager

Table 5-2. Field Descriptions for Alarms Reports

Field Description

Svc State The current service state of the stat ion a nd

Ack? Indicat es whether INADS has acknowledged the

trunk port:

■ RDY = ready for service

■ O UT = out of service

■ I N = in ser vi ce

■ Blank = there is no service state associated

with t h e port

alarm.

■ y = yes

■ n = no

■ Blank = the alarm ha s not and will not be

rep orte d to INADS

Date Alarmed The mont h, day, hour, and minute the alarm

You can click on the fields in an alarm report to display screens with more
information about the alarm. See How to Get More Repor t Infor m ation.

Custom Reports

You can create customized alarm reports on the Re port Builder Screen.

Error Reports

Error reports display error data about faults on the PBX. They are specific to the
hardware layer currently displayed on your screen and provide the following
information for that layer:

■ What faults exist

■ Which ports are affected

The Fault menu allows you to select a report that displays errors for:

■ A ll the errors for the hardware layer that is currently displayed

condition occurred

■ Only the errors that are not specific to the hardware you are displaying

5-6 Issue 2 April 1996

How Fault Manager Displays Faults

NOTE:

These rep o rt s show error d a ta that is current at the time you request the
report. Fault Management does not update th e d at a while th e rep ort
window remains open. To ensure that the data is up to date, close and then
re-open any open report window.

Error reports display the same information that is displayed when you execute
th e DEFINITY G3 comman d, " disp lay errors," with the following exception:

Exception

since that is not normally displayed a n d requires user specification in the
"display errors" co mmand.

Double click on an icon for more information.

Table 5-3. Types of Error Reports

Screen Fault Menu Com mand Report Description

Switch
View

Cabinet
View

Circuit
Pack
Information

Port
Information

: The report does not include seconds in the First Occur field,

All Errors All errors in the PBX
Switch Level Errors All errors that are in the PBX but are

not associated with any cabinet
All Errors for Cabinet # All errors in the c abinet
Cabinet Level Errors for

Cabinet #

All Err ors for Circuit
Pack #

Circuit Pack Level
Errors for Circ uit Pack #

All Errors for Port # All erro rs for the port

All active alarms that are in the

cabinet but are not associated with

any circuit pack

All errors on the circuit pack

All errors that are on the circuit pack

but are not associated with a port

External
Devices
View

Individual
External
Device

All External Device
Errors

Display Errors For
External Device
<name>

All errors for all external d e vices

All errors for the external device

specified

Issue 2 April 1996

5-7

The Fault Ma nager

Figure 5-2. E rror Report for All Errors for a Cabinet

Table 5-4. Field Descriptions for Error Reports

Field Description

Errors Found The number of errors related to active alarms at that

Ievel

Port The alpha numeric ID (location) of the alarmed object.

Zeros in this field i nd icate the alarmed object is not
c onnecte d to a port (for exam ple, a system printer.)

Mtce Nam e Maintena nce Name. The logical name of the

maintenance o bject.

5-8 Issue 2 April 1996

How Fault Manager Displays Faults

Table 5-4. Field Descriptions for Error Reports

Field Description

Alt Name Another way to i d e nti fy the m aint enance object.

Err Type Error Type. The code ident ifying the type of problem.

Only the error number displays because the error code
is ge nerally specific to the ind ividual ma int enance
object and the total number of error codes may be
extensive.

■ If the object is a station, this field contains the

extension number.

■ If the object is a trunk, this field contains xxx/yyy,

where:
— xxx = the trunk group number
— yyy = the member number

■ If the object is a private co line, this field c ontains

P/nnn, where:
— P = private
— nnn = the line group number

Aux Data Auxiliary Data. Addit ional information concerning the

error condition of the maintenance objec t.
As with the error type, this dat a is specific to the

maintenance object type. However, unlike the error
type, only the most recent value of the auxiliary data is
retaine d for each error type in the log.

First occur First occurred. The mon th, day, hour, and minut e that

the error was first recorded.

Last occur Last occurred. The month, day, hour, an d minute that

the most recent error was recorded.
If the system c a n not ret rieve the ti me of d ay the error

occurred, a dummy date in the format 00/00/00:00,
displays to distinguish it from reliable data.

Err Cnt Error Count. The total number of ti me s th a t th e error

type has occurred for this maintenance object.
255 is the maxim um number allowable. If 255 displays

in this field the actual error count may be higher.

Err Rt Error Rate. The average rate at which the errors have

occurred from the first occurrence to the present.
255 is the maxim um number allowable. If 255 displays

in this field the actual error count may be higher.

Issue 2 April 1996

5-9

The Fault Ma nager

Table 5-4. Field Descriptions for Error Reports

Field Description

Rt/Hr Rate per Hour. An approxima te rate that this error

Alarm Status The status of the maintenance object in the error and

Ac Active. Indicates whether the maintenance subsystem

occurred in the last hour.
255 is the maxim um number allowable. If 255 displays

in this field the actual error count may be higher.

alarm reports.
This field indicates:

■ Whether th e error causes an alarm

■ What kind of alarm it ca uses

a = an ac t ive alarm

c onsiders this error to be act ive a n d indicative of a
problem.

■ n = no

■ y = yes

You can click on the fields in an error report to display screens with more
informat ion about the error. Se e How to Get More Report Infor mation.

Custom Reports

You can create customized error reports on the Report Builder Screen.

How to open Report Windows

To open a report window:

1. Open the window for the hardware you want to examine.

2. Select Fault from the menu bar.

3. Select the report you want to display.
Result: A window for the repor t you selecte d opens.

NOTE:

For a description of your report choices, see the Types of Alar ms Reports
and the Types of Error Reports ta b les earlier in thi s ch a p t e r. You can also
create ad hoc reports from the Report Bui lder s c reen.

5-10 Issue 2 April 1996

How to Print Reports

How to Print Reports

To print an alarms or error report, see How to Display Reports.

How to Close Report Windows

To close the report window, click on Close.

How to Get More Report Information

Use the followin g t a b le to g et m ore infor m at ion about a rep o rt entr y that is liste d
in a report window:

And cl ick
Open this
report …

on this

field …

To displ ay
these screens … Com ment

Alarms or

Port
Errors

Errors Any field

except

Port

■ Cabinet V iew

■ Circuit Pack

Information

■ Port

Information

Only the screens with
information related to the port
display. For example , if the
port field is:

■ 000000 0, then the ob ject

is not connected to a port
and the Switch View
di s p lays

■ 01, then the Cabinet View

displays

■ 01c19, then the Cabinet

View and Circuit Pack
Information screen
display. (there is no po rt
data)

■ 01c1903, then the

Cabinet View, Circuit
Pack Inform ati on, a nd
Port Information sc reens
display

Error Description You must be in an error

report

Error Description Screen

The Error Descri ption screen provides you with an English description of an error
listed in an e rror repor t.

Issue 2 A pril 1996

5-11

The Fault Ma nager

The Error Description Screen has the following co mponents:

■ Menu Bar for Error Descriptions

■ Screen Heading for Error Descriptions

■ Error Description Panel

■ Notes Panel

How to Open Error Descriptions

To open the Error Description screen:

1. Display an error report window.

2. Click on the value in any field

Sample Error Description Screen

The fol lowing fig ure shows the Error Description screen:

except

Port.

Figure 5-3. Error Description Scre en

5-12 Issue 2 April 1996

Error Description Screen

Menu Bar for Error Des crip tio n s

Double click on the following icon for information about the menu commands for
the Error Description screen:

Table 5-5. Menu Commands

Menu Command Description

Op tio ns Save Saves your entry for the Not es panel.

Close Closes the Error Description screen.

Help D isplays a Help window.

Screen Heading for Error Descriptions

Immed i atel y below the menu b a r, the E rror Descrip t ion screen displays general
information ab out the er ror. Double click on the icon for more inform at i on:

Table 5-6. Screen Heading

Data Description

Application Name DEFINITY G3 Fault Management
Maintenance

Name
Error Code The code for that identifies the error
Aux Data Any auxiliary d a ta about the error condition

Error Description Panel

The Error Description panel contains a brief description of the error from the
database.

Note s Pa ne l

The Notes panel provides a place for you to enter your comments about the error.

How to Enter a Note

The name of the maintenance object that contains the
error

Use the following g u i delines to ent er a new note or e d it an existing note.

■ Yo u c a n enter u p t o 5 lines of text and 255 characters.

Issue 2 A pril 1996

5-13

The Fault Ma nager

■ The N o tes panel accepts all characters

■ Click on Save to save your note.

■ If you e d it your note, b e sure to cl ick on Save to save your changes.

How to Delete a Note

To delete a note:

1. Highlight the note an d then b a cks pace.

2. Click on Save.

Bulletin Board

The PBX bullet in board allo w s users to post messages for other users.
Technicians often use it to update network ma nagers a b o ut their progress when
fixing problems on the PBX.

Fault Ma nagement provides a screen that allows you to view the contents of the
bulletin board.

How to Open the B ul letin Bo a rd

except

the pipe (I).

To op en the bullet in board:

1. Display the Switch View.

2. Select Fault à Display Bulletin Board.

Sample Bul letin Bo ard

The fol lowin g f i g ure shows the b u llet in b o a rd :

5-14 Issue 2 April 1996

Bulletin B oard

Figure 5-4. B ulletin Bo ard

Menu Bar for the Bulletin Board

Double click on the following icon for information about the menu commands for
the bullet in b oa rd:

Table 5-7. Menu Commands

Menu Command Description

Options Save Report Opens a window so you can save the

Close Closes the bulletin board.

Help D isplays a Help window.

data to a file.

Issue 2 A pril 1996

5-15

The Fault Ma nager

Data Area for the Bulletin Board

The bu llet i n board has the following data ar eas:

■ Screen heading

■ Bullet in board message

■ Me ss age area

Double click on an icon for more information:

Table 5-8. Screen Heading

Data Description

Application Name DEFINITY G3 Fault Management
Report Name Bulletin Bo ard
Switch Name The name of the PBX as it appears on the NMS when the

PBX is administ ered as a node on the network. T his
informat ion is passed from the NMS.

Table 5-9. Field Descriptions for Bulletin Board Messages

Field Description

Date The date of the message
* Indicates a high-priority message
Message The message

Table 5-10. Message Area

The message area at the b ottom of th e screen can display t he f ollowing
message:

Message Description
Cached Data

Warning

A warning me ss a g e only displays when the da t a that Fault
Management displays is based on non-refreshed, ca ched
data. The following situations can result in this warning:

■ Fault Management cannot c omplete a refresh attempt.

■ The Refresh Proxy Agent On Startup field on the Setup

sc reen is set to FALSE.

5-16 Issue 2 April 1996

Bulletin B oard

How to Refresh this Scre en

Fault Ma nagement automati cally refreshes bulletin board inf o r mat ion upon
startup if the Refresh Proxy Agent on Startup field on the Setup screen is set to
TRUE.

You can also refresh the bulletin board anytime during a Fault Management
session as follows.

1. Display the Switch View.

2. Select Fault à Refresh Bulletin Board.

Issue 2 A pril 1996

5-17

The Configuration Manager

This chapter describes the conf ig uration manager for Fault Management. Topics
include:

■ Overview of Conf i g uration Manager

■ Hardware/Software Information Report

6

■ Circu i t Pack Inventory Repo rt

■ Circuit Pack Reports

■ DS1 Ci rcu i t Pack Reports

■ How to O p en Configurat ion Reports

■ How to Prin t Configuration Reports

■ How to Close Configuration Reports

■ Cabinet Displays

■ How to Refresh Configurat ion Dat a

Overview of Configu rat ion Manager

The confi guration manager provides configuration data for the PBX and the
cabinet hardware layers. This data is available in the following formats:

■ Onl ine reports that you can save to an ASCII file

■ A graphical display of circuit p a ck information

You selec t th ese fo r ma ts from the Configurat ion men u on eithe r the Switch View
or th e Cabinet View. From the Cabinet View, a variety of highlighting options allow
you to graphically display the circuit packs that meet specific selection criteria.

Issue 2 Apri l 1996 6-1

The Configuration Manager

Types of Configuration Data

The config uration manager provides the following da t a:

Screen Type of Data

Switch View Online configuration reports for:

Cabinet Vie w Graphical displays of the circuit p acks that match your

■ Hardware/Software Information

■ Circuit Pack Inventory

■ All Circuit Packs

■ Exception Circuit Packs

■ DS1 C i rcu it Pa ck s

selection criteria.
The configuration manager uses a filt ering mechanism to

highlight circuit packs, depending on your selection
from the Confi g urati on men u.

Hardware/Software Information Report

The hardw a re and softwa re configuration d a t a includes the following information:

■ The PBX’s

— Hardware type
— Active switch proce ssor element (SPE)
— Software vintag e
— Update id entifier
— Update state

■ The version of the current Fault Management software

Double click on an icon for more information a b out the Ha rdw a re/Software
Information report.

6-2 Issue 2 April 1996

Hardware/Software Information Report

Figure 6-1. Hardware/Softw are Inform ation Report

Table 6-1. Menu Commands

Menu Command Description

Op tions Save Report Op ens a window s o y ou can save the data

to a file.

Close Closes the re p ort window.

Help Disp lays a Help window.

Table 6-2. Report Headin g

Data Description

App lication
Name

Report Title Hardware/Software Information
Switc h Name The name of the PBX as it appears on the NMS when the

DEFIN ITY G3 Fault Man agement

PBX is administered as a node on the network.

Issue 2 April 1996

6-3

The Configuration Manager

Table 6-3. Field Descriptions for the Hardware/S oftware Inf orm at ion Report

Field Des crip tion

Hardware
Configuration from
the Prox y Agent

Hardware
Configuration from
the PBX

The PBX’s hardware configuration, taken from
the Proxy Agent.

This value an d the Hardware Confi gurati on
field value should b e the same.

The PBX’s hardware configuration, taken from
the PBX.

NOTE:

An error message displays if the switch
type in this field does not match the one
in the previous field. This message
indicates that the PBX is administered
as a d iffe rent configuration th an the
hardware really is.

Ac tive SPE The na me of th e switc h processor element

(SPE) that is currently act ive.

Software Vintage The release of PBX software running on the

active SPE.
If the value in this field is “n ot available,”

either there is no b ackup processor or the

backup processor is not operational.
Update Identifie r The ID f or t he upda te p atch.
Update State The stat e of the upd a te, a s re p orted by the

PBX.
Appl ication Software

Vintage

The current version of the Faul t M a nagem ent

software

Circuit Pack Inventory Report

The Circu it Pack I nvento ry rep o rt d isplays information about the circuit packs
currently on the PBX. The dat a i s so rted in th e following sequence:

Fault Management’s confi guration
valida t ion is c oncerned with any
difference in the r, i, s, or vs (as in
"G3rV3" or "G3vsV3).

1. Code

2. Suffix

6-4 Issue 2 April 1996