Deletes an E1 link from an active variant of a provisioned interface.
NMS_V5_RESULT_T NMS_V5DeleteE1( NMS_V5_INTERFACE_ID_T interfaceId, NMS_V5_E1_LOCATION_T e1_loc)
|
Argument |
Description |
|
interfaceId |
Interface ID of a provisioned interface. |
|
e1_loc |
E1 link location specified by the following structure: typedef union _NMS_V5_E1_LOCATION_T See the Details section for field descriptions. |
|
Return value |
Description |
|
NMSV5_SUCCESS |
|
|
NMSV5_INTERNAL_FAILURE |
Internal failure. Refer to the trace log for more information. |
|
NMSV5_INVALID_INTERFACE_ID |
Specified interface is not provisioned. |
|
NMSV5_NOT_INITIALIZED |
NMS V5 library was not initialized with NMS_V5Initialize. |
NMS_V5DeleteE1 deletes an E1 link associated with voice or HDLC channels from an active variant of a provisioned interface without requiring the application to re-provision the interface. However, applications must remove any HDLC channels associated with an E1 link before invoking NMS_V5DeleteE1 for that link.
When the application invokes NMS_V5DeleteE1, the NMS V5 library stops monitoring status information associated with the physical E1 link. Applications cannot call NMS_V5DeleteE1 on standby variants.
Applications provide the following information in the NMS_V5_E1_LOCATION_T structure:
|
Field |
Description |
|
boardNb |
Logical board number where the E1 link is located (as defined by NMS OAM). |
|
trunkNb |
Logical trunk number associated with the E1 link (as defined by NMS OAM). |
NMS_V5ProvisionInterface, NMS_V5AddE1
void DeleteE1( void )
{
NMS_V5_RESULT_T NmsResult;
DWORD InterfaceId;
NMS_V5_E1_LOCATION_T NMSE1Loc;
printf("NMS_V5DeleteE1:\n");
PrintInterfaces();
/* Get parameters */
promptdw_nodft("Enter interfaceId", &InterfaceId);
/* Ask for E1 location parameters */
GetE1LocationNMS( &NMSE1Loc );
NmsResult = NMS_V5DeleteE1( InterfaceId, NMSE1Loc );
printf ("NMS_V5DeleteE1: Result=%s\n",PRINT_RESULT(NmsResult));
}