MGSL_DLSTATS Structure

The MGSL_DLSTATS structure is used with the MgslDlGetStats API function to retrieve the current statistics for the specified link instance.

typedef struct _MGSL_DLSTATS
{
   ULONG    Link;         /* link instance identifier */

   ULONG    State;        /* link layer connection state */
   ULONG    Status;       /* bit mapped flags for link status */

   ULONG    RxREJ;        /* received reject frames */
   ULONG    RxFRMR;       /* received frame rejects */
   ULONG    RxBadCmdResp; /* rx FRMR with bad command/response */
   ULONG    RxBadLength;  /* rx FRMR with bad length */
   ULONG    RxBadNR;      /* rx FRMR with bad rx sequence number */
   ULONG    RxTooBig;     /* rx FRMR with I-frame too big */
   ULONG    RxRSET;       /* rx RSET frames */
   ULONG    RxTEST;       /* rx TEST frames */

   ULONG    TxREJ;        /* transmitted reject frames */
   ULONG    TxFRMR;       /* transmitted frame rejects */
   ULONG    TxBadCmdResp; /* tx FRMR with bad command/response */
   ULONG    TxBadLength;  /* tx FRMR with bad length */
   ULONG    TxBadNR;      /* tx FRMR with bad rx sequence number */
   ULONG    TxTooBig;     /* tx FRMR with I-frame too big */
   ULONG    TxRSET;       /* tx RSET frames */
   ULONG    TxTEST;       /* tx TEST frames */

   ULONG    ResponseTimeouts;
   ULONG    IdleTimeouts;

   ULONG    TxPending;    /* I-frames pending transmission */
   ULONG    TxPendingAck; /* I-frames pending acknowledgement */
   ULONG    TxAcked;      /* Acknowledged I-frames */

    ULONG    RxInfo;      /* received info frames */
    ULONG    RxInfoBytes; /* received info field bytes */
    ULONG    RxUI;        /* received UI frames */
    ULONG    RxUIBytes;   /* received UI info field bytes */

    ULONG    Reserved1;   /* must be zero */
    ULONG    Reserved2;   /* must be zero */

} MGSL_DLSTATS, *PMGSL_DLSTATS;

Link

The Link member must be set to the link instance identifier by the application before passing the structure to MgslDlGetStats.

MGSL_DLSTATS State

This member indicates the link connection state.

 
DLSTATE_RELEASED
The link is in disconnected mode 
DLSTATE_WAIT_INIT
Waiting for initialization mode command to complete. 
DLSTATE_INIT_MODE
Initialization mode, SIM received 
DLSTATE_WAIT_ESTABLISH
Link establishment procedures pending 
DLSTATE_ESTABLISHED
The link is active and no release procedure is pending 
DLSTATE_WAIT_RELEASE
Link release procedures are pending 
DLSTATE_TIMER_RECOVERY
Acknowledged mode established and trying to recover from a timer expiration (transmit or idle timeout)

MGSL_DLSTATS Status

 
DLSTATUS_ACK_PENDING
Waiting for opportunity to acknowledge received I-frames. 
DLSTATUS_BEACON_TEST
Beacon test state set by loop controller (loop mode secondary station only). 
DLSTATUS_ENABLE_CHECKPOINT
Enable checkpoint lost frame detection. 
DLSTATUS_ENQUIRY_PENDING
Waiting for opportunity to signal receiver busy state to peer. 
DLSTATUS_FRMR
Waiting for peer to initiate recovery procedures after encountering a severe error. 
DLSTATUS_INHIBIT_CP
Inhibit checkpoint detection for next received frame with P/F bit set. 
DLSTATUS_INHIBIT_SREJ
Inhibit processing of next received selective reject frame. 
DLSTATUS_MODIFIED_LINK_TEST
Modified link test mode set by loop controller (loop mode secondary station only). 
DLSTATUS_MONITOR_MODE
Monitor mode (receive only mode) set by loop controller (loop mode secondary station only) 
DLSTATUS_OWN_RCV_BUSY
Local station is not ready to accept data. 
DLSTATUS_PEER_RCV_BUSY
Remote station is not ready to accept data. 
DLSTATUS_PENDING_RELEASE
A release request is pending completion of a previous mode setting command. 
DLSTATUS_REESTABLISH
Waiting for link reestablishment as part of an error recovery procedure to complete. 
DLSTATUS_REJ_RECOVERY
Link is waiting for retransmission of frames by peer after signaling the missing frames with a REJ (reject). 
DLSTATUS_REQUEST_DISC
Link is waiting for peer to send disconnect command. (Secondary station only). 
DLSTATUS_RIM
Link is waiting for peer to set initialization mode (Secondary station only). 
DLSTATUS_RX_POLL
Link received a command with the poll bit set but has not sent a response with the final bit set. 
DLSTATUS_SABM
Asynchronous balanced mode, modulo 8 
DLSTATUS_SABME
Asynchronous balanced mode, modulo 128 
DLSTATUS_SIM
Link is waiting for opportunity to set initialization mode. 
DLSTATUS_SNRM
Normal response mode, modulo 8 
DLSTATUS_SNRME
Normal response mode, modulo 128 
DLSTATUS_SREJ_RECOVERY
Link is waiting for retransmission of frames by peer after signaling the missing frames with a SREJ (selective reject). 
DLSTATUS_TX_POLL
Link sent a command with the poll bit set but has not received a response with the final bit set. 
DLSTATUS_WRAP
Wrap mode set by loop controller. (loop mode secondary station only).

Previous Contents Next