# 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));
}