# NMS_V5AddE1

Adds an E1 link associated with voice channels to a provisioned active variant on a specified interface.

#### Prototype

NMS_V5_RESULT_T NMS_V5AddE1 ( 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 { struct { DWORD boardNb; DWORD trunkNb; } CG; }NMS_V5_E1_LOCATION_T See the Details section for field descriptions.

#### Return values

Return value | Description
NMSV5_SUCCESS |
NMSV5_INTERNAL_FAILURE | Internal failure. Refer to the trace log for more information.
NMS_INVALID_E1 | Specified E1 link is already provisioned.
NMSV5_INVALID_INTERFACE_ID | Specified interface is not provisioned.
NMSV5_NOT_INITIALIZED | NMS V5 library was not initialized with NMS_V5Initialize.

#### Details

NMS_V5AddE1 adds an E1 link associated with voice or HDLC channels to an active variant of a provisioned interface without requiring the application to re-provision the interface. When the application invokes NMS_V5AddE1, the NMS V5 library begins monitoring status information associated with the E1 link. If the application starts the interface, the NMS V5 library reports alarms and SA7 bit changes to the application through application-configured callbacks. Applications cannot call NMS_V5AddE1 for standby variants.

The NMS_V5_E1_LOCATION_T structure includes the following information:

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).

#### See also

NMS_V5DeleteE1

#### Example

void AddE1( void )
{
NMS_V5_RESULT_T NmsResult;
DWORD InterfaceId;
NMS_V5_E1_LOCATION_T NMSNewE1Loc;
printf("NMS_V5AddE1:\n");
/* Get parameters */
promptdw_nodft("Enter interfaceId", &InterfaceId);
GetE1LocationNMS( &NMSNewE1Loc );
NmsResult = NMS_V5AddE1( InterfaceId, NMSNewE1Loc );
}