NMS_GR303ResetDS1Status

Resets DS1 link status information collected for a specified DS1 link.

Prototype

NMS_GR303_RESULT_T NMS_GR303ResetDS1Status ( NMS_GR303_INTERFACE_ID_T interfaceId, NMS_GR303_DS1_LOCATION_T ds1_loc)

Argument

Description

interfaceId

Interface ID of a provisioned interface.

ds1_loc

DS1 location for which to reset status information as specified in the following:

typedef union _NMS_GR303_CHANNEL_LOCATION_T
{
     struct {
     DWORD  boardNb;
     DWORD  trunkNb;
     DWORD  timeslotNb;
     } CG;
} NMS_GR303_CHANNEL_LOCATION_T

See the Details section for field descriptions.


Return values

Return value

Description

NMSGR303_SUCCESS

 

NMSGR303_INTERNAL_FAILURE

Internal failure. Refer to the trace log for more information.

NMSGR303_INVALID_DS1

Specified DS1 link has no HDLC channels provisioned on this interface.

NMSGR303_INVALID_INTERFACE_ID

Specified interface is not provisioned.

NMSGR303_NOT_INITIALIZED

NMS GR303 library was not initialized with NMS_GR303Initialize.


Details

NMS_GR303ResetDS1Status resets status information for a specified DS1 link. The NMS_GR303_CHANNEL_LOCATION_T structure includes the following information:

Field

Description

boardNb

Logical board number of the board where the DS1 link is located (as defined by NMS OAM).

trunkNb

Logical trunk number associated with the DS1 trunk (as defined by NMS OAM).


Applications can only request to reset status information for DS1 links that are associated with at least one HDLC channel.

See also

NMS_GR303GetDS1Status

Example

void  ResetDS1Status( void )
{
       NMS_GR303_RESULT_T        NmsResult;
       DWORD                     InterfaceId;
       NMS_GR303_DS1_LOCATION_T  DS1Location;

       printf("NMS_GR303ResetDS1Status:\n");

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

       printf("Enter DS1 location:\n");
       GetDS1LocationNMS( &DS1Location );

       NmsResult = NMS_GR303ResetDS1Status( InterfaceId, DS1Location );

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