User guide

3-119
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.8.36 getAllClearedAlarms
in unsigned long how_many,
out notifications::EventList_T eventList,
out notifications::EventIterator_I eventIt)
raises(globaldefs::ProcessingFailureException);
Description
This interface enables an NMS to request all of the cleared and acknowledged alarms for the specified
ME. Alarms that are not reported by the ME to the EMS are not reported by this operation. Some alarms
may be filtered out by specifying the probable cause of the severities.
The result of this operation is independent of the filtering set up by the NMS for the notification service.
ONS 15310 CL, ONS 15310 MA SDH, ONS 15310 MA SONET, ONS 15327, ONS 15454 SONET, ONS 15454 SDH, ONS
15600 SONET, and ONS 15600 SDH
The ONS 15310 CL, ONS 15310 MA SDH, ONS 15310 MA SONET, ONS 15327, ONS 15454 SONET,
ONS 15454 SDH, ONS 15600 SONET, and ONS 15600 SDH do not send a “clear” for TCA events.
TCAs are not reported in the eventList returned by this method.
ONS 15530 and ONS 15540
TCAs are reported in the eventList returned by this method. The ONS 15530 and ONS 15540 send a
“clear” for TCAs.
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised when meName does not reference a managed element object or
excludeProbCauseList contains undefined values.
EXCPT_ENTITY_NOT_FOUND - Raised when meName references an ME object that does not exist.
EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost.
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the maximum number of iterators reaches 128.
Compliance
CTM-defined.
Name Type Input/Output Description
meName globaldefs::NamingAttributes
List_T
In Name of the ME for which to retrieve alarms.
excludeProbCause
List
notifications::ProbableCause
List_T
In List of probable causes to exclude (for which events are
not reported).
exludeSeverityList notifications::PerceivedSeveri
tyList_T
In List of severities to exclude from the output event list.
how_many Unsigned long In Maximum number of alarms to report in the first batch.
eventList notifications::EventList Out First batch of alarms.
eventIt notifications::EventIterator_I Out Iterator to retrieve the remaining alarms.