NMS_GR303ResetChannelStatistics

Resets the HDLC channel statistics collected for a specified HDLC channel provisioned on an active interface variant.

Prototype

NMS_GR303_RESULT_T NMS_GR303ResetChannelStatistics ( NMS_GR303_INTERFACE_ID_T interfaceId, NMS_GR303_CHANNEL_LOCATION_T channel_loc)

Argument

Description

interfaceId

Interface ID of a provisioned interface.

channel_loc

HDLC for which to reset statistics as specified in the following structure:

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_CHANNEL

Specified HDLC channel is not provisioned on the interface.

NMSGR303_INVALID_INTERFACE_ID

Specified interface is not provisioned.

NMSGR303_NOT_INITIALIZED

NMS GR303 library was not initialized with NMS_GR303Initialize.


Details

NMS_GR303ResetChannelStatistics resets the channel statistics for the specified HDLC channel. The NMS_GR303_CHANNEL_LOCATION_T structure includes the following information:

Field

Description

boardNb

Logical board number where an HDLC instance is located (as defined by NMS OAM).

trunkNb

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

timeslotNb

Physical timeslot number associated with the HDLC instance.


See also

NMS_GR303GetChannelStatistics

Example

void  ResetChannelStatistics( void )
{
       NMS_GR303_RESULT_T            NmsResult;
       DWORD                         InterfaceId;
       NMS_GR303_CHANNEL_LOCATION_T  ChannelLocation;

       printf("NMS_GR303ResetChannelStatistics:\n");

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

       printf("Enter channel location:\n");
       GetChannelLocationNMS( &ChannelLocation );

       NmsResult = NMS_GR303ResetChannelStatistics (InterfaceId,
                                                    ChannelLocation);

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