NMS_V5ResetE1Status

Resets status information for a specified E1 link.

Prototype

NMS_V5_RESULT_T NMS_V5ResetE1Status ( NMS_V5_INTERFACE_ID_T interfaceId NMS_V5_CHANNEL_LOCATION_T *e1_loc)

Argument

Description

interfaceId

Interface ID of a provisioned interface.

e1_loc

Pointer to the E1 link location for which to reset status information.

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.

NMSV5_INVALID_E1

Specified E1 link is not provisioned on this interface.

NMSV5_INVALID_INTERFACE_ID

Specified interface is not provisioned.

NMSV5_NOT_INITIALIZED

NMS V5 library was not initialized with NMS_V5Initialize.


Details

NMS_V5ResetE1Status resets status information for a specified E1 link. Applications can only reset status information for E1 links provisioned on the active variant of an interface. The NMS_V5_E1_LOCATION_T structure includes the following values:

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_V5GetE1Status

Example

void  ResetE1Status( void )
{
    NMS_V5_RESULT_T         NmsResult;
    DWORD                   InterfaceId;
    NMS_V5_E1_LOCATION_T    E1Location;
 
    printf("NMS_V5ResetE1Status:\n");

    /* Get parameters */
    promptdw_nodft("Enter InterfaceId", &InterfaceId);

    printf("Enter E1 location:\n");
    GetE1LocationNMS( &E1Location );

    NmsResult = NMS_V5ResetE1Status( InterfaceId, E1Location );

    printf ("NMS_V5ResetE1Status:
    Result=%s\n",PRINT_RESULT(NmsResult));

}