Cisco Cisco Prime Optical 9.6 Guía Del Desarrollador

Cisco Prime Optical 9.6.3 GateWay/CORBA Programmer Reference Guide 

OL-28047-01

 

 

206

 

equipmentOrHolderName

 

Globaldefs::NamingAttributes_T

 

In

 

Equipment on 

which to activate 

alarm reporting.

 

Throws 

globaldefs::ProcessingFailureException 

EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure. 

EXCPT_INVALID_INPUT - Raised when equipmentOrHolderName does not reference an 
equipment or holder. 

EXCPT_ENTITY_NOT_FOUND - Raised when equipmentOrHolderName references an 
object that does not exist. 

EXCPT_UNABLE_TO_COMPLY - Raised when alarm reporting cannot be disabled for 
the equipment or holder. 

EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost. 

Compliance 
TMF-defined. 

Synopsis 

void unprovisionEquipment( 

        in globaldefs::NamingAttributes_T equipmentName) 

     raises(globaldefs::ProcessingFailureException); 

Description 
This interface enables the NMS to permanently unprovision equipment from the managed 

element. The successful result of this operation is the potential deletion of the equipment 

object and all of its related objects, such as termination points. 
The ONS 15454 SONET does not allow a user to unprovision a piece of equipment that is in use 

(SNC is created on this equipment). However, if the equipment is present in the slot and is not 

in use, it can be unprovisioned. If the equipment is not physically removed from the slot and 

new equipment is not provisioned in the same slot, the NE redetects the equipment in 

approximately 1 minute. If the equipment is not physically removed from the slot and new 

equipment of a different type is provisioned in the same slot, the NE generates an equipment 

mismatch alarm. 
If the equipment is unprovisioned successfully, Prime Optical generates a state change event on 

the holder state change and an object deletion event for the equipment, and pushes them to 

the event channel. 
The ONS 15454 reserves slots 7 and 11 for TCC. One of these slots has an in-service TCC card. If 

the NMS invokes unprovisionEquipment on this equipment, Prime Optical throws the 

EXCPT_UNABLE_TO_COMPLY exception.