NMS GR303 library structures

When using the NMS GR303 library, applications can send or receive the following structures:

Structure	Description
NMS_GR303_BOARD_FAMILY_T	Applications send this structure to specify the board family (CG boards) used on the host system.
NMS_GR303_DS1_LOCATION_T	Applications send this structure to specify the location of a DS1 link on a CG board.
NMS_GR303_CHANNEL_LOCATION_T	Applications send this structure to specify the location of an HDLC channel on a CG board.
NMS_GR303_DS1_STATUS_T	The NMS GR303 library returns this structure to indicate the status of a particular DS1 link.
NMS_GR303_CHANNEL_STATISTICS_T	The NMS GR303 library returns this structure to provide statistics about the transmit or receive operations on HDLC channels.

NMS_GR303_BOARD_FAMILY_T

When applications initialize the NMS GR303 library, they specify the board family with NMS_GR303_BOARD_FAMILY_T:

typedef enum _NMS_GR303_BOARD_T
{
NMS_BOARD_FAMILY_CG
} NMS_GR303_BOARD_FAMILY_T;

Dependent function: NMS_GR303Initialize

Field name	Type	Default	Description
NMS_BOARD_FAMILY_CG	NMS_BOARD_FAMILY_CG	N/A	Specifies the board family (CG boards) used on the system.

NMS_GR303_DS1_LOCATION_T

When applications obtain or reset DS1 link status information, they specify the DS1 link information through NMS_GR303_DS1_LOCATION_T:

typedef union _NMS_GR303_DS1_LOCATION_T
{
    struct {
        DWORD boardNb;
        DWORD trunkNb;
    } CG;
} NMS_GR303_DS1_LOCATION_T;

Dependent functions: NMS_GR303GetDS1Status or NMS_GR303ResetDS1Status

Field name	Type	Default	Units	Description
boardNb	DWORD	N/A	N/A	Logical board number of the board where the DS1 link is located (as defined by NMS OAM).
trunkNb	DWORD	N/A	N/A	Logical trunk number associated with the T1 link (as defined by NMS OAM).

NMS_GR303_CHANNEL_LOCATION_T

When applications obtain or reset HDLC channel statistics or modify a channel location, they specify the HDLC channel information through NMS_GR303_CHANNEL_LOCATION_T:

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

Dependent functions: NMS_GR303GetChannelStatistics, NMS_GR303ResetChannelStatistics, or NMS_GR303ModifyChannelLocation

Field name	Type	Default	Units	Description
boardNb	DWORD	N/A	N/A	Logical board number of the board where the HDLC instance is located as defined by NMS OAM.
trunkNb	DWORD	N/A	N/A	Logical trunk number associated with the HDLC instance (as defined by NMS OAM).
timeslotNb	DWORD	N/A	N/A	Physical timeslot number associated with the HDLC instance.

NMS_GR303_DS1_STATUS_T

When the NMS GR303 library returns information about the status of a DS1 link, it provides the information in NMS_GR303_DS1_STATUS_T:

typedef struct {
    DWORD Size;
    NMS_GR303_DS1_STATUSMASK_T StatusMask;
    DWORD Slips;
    DWORD Es;
    DWORD Ses;
    DWORD Uas;
    DWORD LineErrors;
    DWORD FrameErrors;
    DWORD ElaspedTime;
} NMS_GR303_DS1_STATUS_T;

Dependent function: NMS_GR303GetDS1Status

Field name	Type	Units	Description
Size	DWORD	N/A	Size of the structure.
StatusMask	NMS_GR303_DS1_ STATUSMASK_T	N/A	Current DS1 status bit mask. This can combine the following values: NMSGR303_DS1_LOS (0x01) Loss of signal. NMSGR303_DS1_LOF (0x02) Loss of frame. NMSGR303_DS1_AIS (0x04) Alarm indication signal. NMSGR303_DS1_RAI (0x08) Remote alarm indicator.
Slips	DWORD	count	Number of slips.
Es	DWORD	count	Number of errors seconds.
Ses	DWORD	count	Number of severely errored seconds.
Uas	DWORD	count	Number of unavailable seconds.
LineErrors	DWORD	count	Number of line code violations.
FrameErrors	DWORD	count	Number of frame bit errors and CRC errors.
ElaspedTime	DWORD	count	Seconds since counters started. This represents the duration of the observation time (in seconds). All statistics are the count of particular events that occur during the ElaspedTime interval.

NMS_GR303_CHANNEL_STATISTICS_T

When the NMS GR303 library returns HDLC channel statistics, it provides the information in NMS_GR303_CHANNEL_STATISTICS_T (which includes both a CHANNEL_STATISTICS_RECEIVE_T or CHANNEL_STATISTICS_TRANSMIT_T subtype):

typedef struct {
   DWORD Size; /* Size of this structure */
   CHANNEL_STATISTICS_RECEIVE_T  chan_stat_rx;
   CHANNEL_STATISTICS_TRANSMIT_T chan_stat_tx;
} NMS_GR303_CHANNEL_STATISTICS_T;

typedef struct {
  DWORD Octets;
   DWORD Frames;
   DWORD Drops;
   DWORD FifoOverruns;
   DWORD Aborts;
   DWORD CrcErrors;
  DWORD NonAlignedOctets;
   DWORD BufferOverflows;
} CHANNEL_STATISTICS_RECEIVE_T;

typedef struct {
   DWORD Octets;
   DWORD Frames;
   DWORD Drops;
   DWORD FifoUnderruns;
   DWORD FifoOverruns;
} CHANNEL_STATISTICS_TRANSMIT_T;

CHANNEL_STATISTICS_RECEIVE_T

Dependent function: NMS_GR303GetChannelStatistics

Field name	Type	Units	Description
Octets	DWORD	count	Bytes received count.
Frames	DWORD	count	Frames received count.
Drops	DWORD	count	Frames dropped count.
FifoOverruns	DWORD	count	FIFO overrun count. Not supported on CG 6100C or CG 6500C boards.
Aborts	DWORD	count	Receive abort count.
CrcErrors	DWORD	count	Receive CRC errors count.
NonAlignedOctets	DWORD	count	Non-aligned octets count. Not supported on CG 6100C or CG 6500C boards.
BufferOverflows	DWORD	count	Buffer overflows count. Not supported on CG 6100C or CG 6500C boards.

CHANNEL_STATISTICS_TRANSMIT_T

Dependent function: NMS_GR303GetChannelStatistics

Field name	Type	Units	Description
Octets	DWORD	count	Bytes transmitted count.
Frames	DWORD	count	Frames transmitted count.
Drops	DWORD	count	Frames dropped count.
FifoUnderruns	DWORD	count	FIFO underrun count. Not supported on CG 6100C or CG 6500C boards.
FifoOverruns	DWORD	count	FIFO overrun count. Not supported on CG 6100C or CG 6500C boards.