DLC_GET_EXCEP ioctl Operation for DLC

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

The following parameter block returns asynchronous exception notifications to the application user:

struct dlc_getx_arg { __ulong32_t user_sap_corr; /* user SAP corr - RETURNED */ __ulong32_t user_ls_corr; /* user ls corr - RETURNED */ __ulong32_t result_ind; /* the flags identifying the type */ /* of excep*/ int result_code; /* the manner of excep */ u_char_t result_ext[DLC_MAX_EXT];/* excep specific ext */ };

The fields of this ioctl operation are:

Field	Description
`user_sap_corr`	Indicates the user service access point (SAP) correlator for this exception.
`user_ls_corr`	Indicates the user link station (LS) correlator for this exception.
`result_ind`	Result indicators: DLC_TEST_RES Test complete: a nonextended result. Set to 1, this bit indicates that the link test has completed as indicated in the result code. DLC_SAPE_RES SAP enables: an extended result. Set to 1, this bit indicates that the SAP is active and ready for LSs to be started. DLC_SAPD_RES SAP disabled: a nonextended result. Set to 1, this bit indicates that the SAP has been terminated as indicated in the result code. DLC_STAS_RES Link station started: an extended result. Set to 1, this bit indicates that the link station is connected to the remote station in asynchronous or normal disconnected mode. GDLC is waiting for link receive data from the device driver or additional commands from the user such as the DLC_CONTACT ioctl operation. DLC_STAH_RES Link station halted: a nonextended result. Set to 1, this bit indicates that the LS has terminated due to a DLC_HALT_LS ioctl operation from the user, a remote discontact, or an error condition indicated in the result code. DLC_DIAL_RES Dial the phone: a nonextended result. Set to 1, this bit indicates that the user can now manually dial an outgoing call to the remote station. DLC_IWOT_RES Inactivity without termination: a nonextended result. Set to 1, this bit indicates that the LS protocol activity from the remote station has terminated for the length of time specified in the configuration (receive inactivity timeout). The local station remains active and notifies the user if the remote station begins to respond. Additional notifications of inactivity without termination are suppressed until the inactivity condition clears up. DLC_IEND_RES Inactivity ended: a nonextended result. Set to 1, this bit indicates that the LS protocol activity from the remote station has restarted after a condition of inactivity without termination. DLC_CONT_RES Contacted: a nonextended result. Set to 1, this bit indicates that GDLC has either received a Set Mode, or has received a positive response to a Set Mode initiated by the local LS. GDLC is now able to send and receive normal sequenced data on this LS. DLC_RADD_RES Remote address/name change: an extended result. Set to 1, this bit indicates that the remote LS address (or name) has been changed from the previous value. This can occur on synchronous data link control (SDLC) links when negotiating a point-to-point connection, for example.
`result_code`	Indicates the result code. The following values specify the result codes for GDLC. Negative return codes that are even indicate that the error condition can be remedied by restarting the LS returning the error. Return codes that are odd indicate that the error is catastrophic, and, at the minimum, the SAP must be restarted. Additional error data may be obtained from the GDLC error log and link trace entries. DLC_SUCCESS The result indicated was successful. DLC_PROT_ERR Protocol error. DLC_BAD_DATA A bad data compare on a TEST. DLC_NO_RBUF No remote buffering on test. DLC_RDISC Remote initiated discontact. DLC_DISC_TO Discontact abort timeout. DLC_INACT_TO Inactivity timeout. DLC_MSESS_RE Mid session reset. DLC_NO_FIND Cannot find the remote name. DLC_INV_RNAME Invalid remote name. DLC_SESS_LIM Session limit exceeded. DLC_LST_IN_PRGS Listen already in progress. DLC_LS_NT_COND LS unusual network condition. DLC_LS_ROUT Link station resource outage. DLC_REMOTE_BUSY Remote station found, but busy. DLC_REMOTE_CONN Specified remote is already connected. DLC_NAME_IN_USE Local name already in use. DLC_INV_LNAME Invalid local name.
	DLC_SAP_NT_COND SAP network unusual network condition. DLC_SAP_ROUT SAP resource outage. DLC_USR_INTRF User interface error. DLC_ERR_CODE Error in the code has been detected. DLC_SYS_ERR System error.
`result_ext`	Indicates result extension. Several results carry extension areas to provide additional information about them. The user must provide a full-sized area for each result requested since there is no way to tell if the next result is extended or nonextended. The extended result areas are described by type below.