[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1


DLC_QUERY_LS ioctl Operation for DLC

The following parameter block queries statistics of a particular link station (LS):
struct dlc_qls_arg
   {
   __ulong32_t  gdlc_sap_corr;   /* GDLC SAP correlator */
   __ulong32_t  gdlc_ls_corr;   /* GDLC ls correlator */
   __ulong32_t  user_sap_corr;   /* user's SAP correlator - RETURNED */
   __ulong32_t  user_ls_corr;   /* user's link station corr-RETURNED */
   u_char_t  ls_diag[DLC_MAX_DIAG]; /* the char name of the ls */
   __ulong32_t  ls_state;   /* current ls state */
   __ulong32_t  ls_sub_state;   /* further clarification of state */
   struct dlc_ls_counters  counters;
   __ulong32_t  protodd_len;   /*protocol dependent data byte length*/
   };

The fields of this ioctl operation are:

gdlc_sap_corr Specifies the generic data link control (GDLC) service access point (SAP) correlator of the target LS.
gdlc_ls_corr Specifies the GDLC LS correlator to be queried.
user_sap_corr Specifies the user SAP correlator returned for routing purposes.
user_ls_corr Specifies the user LS correlator, that is the user LS identifier returned for routing purposes.
ls_diag Contains the link station (LS) diagnostic tag. Indicates the ASCII character string tag passed to GDLC at the DLC_START_LS ioctl operation to identify the station being queried. For example, SNA services puts the attachment profile name in this field.
ls_state Contains the current state of this LS:

DLC_OPENING
Indicates the SAP or link station is in the process of opening.

DLC_OPENED
Indicates the SAP or link station has been opened.

DLC_CLOSING
Indicates the SAP or link station is the process of closing.

DLC_INACTIVE
Indicates the link station is currently inactive.
ls_sub_state Contains the current substate of this LS. Several indicators may be active concurrently.

DLC_CALLING
Indicates the link station is calling.

DLC_LISTENING
Indicates the link station is listening.

DLC_CONTACTED
Indicates the link station is contacted into sequenced data mode.

DLC_LOCAL_BUSY
Indicates the local link station is currently busy.

DLC_REMOTE_BUSY
Indicates the remote link station is currently busy.
counters Contains link station reliability/availability/serviceability counters. These 14 reliability/availability/serviceability counters are shown as an example only. Each GDLC device manager provides as many of these counters as necessary to diagnose specific network problems for its protocol type.

test_cmds_sent
Specifies the number of test commands sent.

test_cmds_fail
Specifies the number of test commands failed.

test_cmds_rec
Specifies the number of test commands received.

data_pkt_sent
Specifies the number of sequenced data packets sent.

data_pkt_resent
Specifies the number of sequenced data packets resent.

max_cont_resent
Specifies the maximum number of contiguous resendings.

data_pkt_rec
Indicates data packets received.

inv_pkt_rec
Specifies the number of invalid packets received.

adp_rec_err
Specifies the number of data-detected receive errors.

adp_send_err
Specifies the number of data-detected transmit errors.

rec_inact_to
Specifies the number of received inactivity timeouts.

cmd_polls_sent
Specifies the number of command polls sent.

cmd_repolls_sent
Specifies the number of command repolls sent.

cmd_cont_repolls
Specifies the maximum number of continuous repolls sent.
protodd_len Indicates length of protocol-dependent data. This field contains the byte length of the following area.

The protocol-dependent data contains any additional statistics that a particular GDLC device manager might provide. See the individual GDLC specifications for information on the specific fields returned. This optional data area must directly follow (or append to) the end of the dlc_qls_arg structure.

Implementation Specifics

The DLC_QUERY_LS ioctl operation is selectable through the fp_ioctl kernel service or the ioctl subroutine. It can be called from the process environment only.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]