ISDN_LISTEN.ISDN_REQ(D7isdn)

ISDN_LISTEN.ISDN_REQ -- ISDN activate incoming event signalling request

Synopsis

   #include <sys/stream.h>
   #include <sys/mdi.h>
   #include <sys/types.h>
   #include <sys/scoisdn.h>
   
   typedef struct isdn_listen_req
   {
       isdnCtrlr_t        ctlr;
       isdnInfoMsk_t      infoMask;
       isdnCIPmask_t      cipMask;
       isdnCIPmask_t      cipMask2;
       isdnCallingNbr_t   callingNbr;
       isdnCallingAdr_t   callingAddr;
   } isdn_listen_req_t;

Description

The ISDN_LISTEN.ISDN_REQ message consists of one M_PROTO(D7str) message block requesting the ISDN driver to signal incoming events. The infoMask parameter defines the signalling protocol events to be indicated to the application. These events are normally associated with physical connections. The cipMask parameter defines selection criteria based upon Bearer Capability and High Layer Compatibility, thus indicating which incoming calls are signalled to an application.

More than one application may listen to the same isdnCIPvalue(D4isdn). Every application listening to a matching value will be informed about incoming calls. If more than one application wants to accept the call, the first ISDN_CONNECT.ISDN_RESP(D7isdn) received by the ISDN driver in response to an ISDN_CONNECT.ISDN_IND(D7isdn) will be accepted. Every other application will get the ISDN_DISCONNECT.ISDN_IND(D7isdn) message with the reason parameter to indicate this condition. This scenario is similar to the situation where more than one set of compatible ISDN equipment on an ISDN line attempts to accept an incoming call.

Clearing all bits in the cipMask parameter disables the signalling of incoming calls to the application.

The callingNbr and callingAddr parameters are only used for external ISDN equipment (handsets), which might need the own (local) address to handle outgoing calls.

Parameters

ctlr: controller; see isdnCtrlr(D4isdn).
infoMask: information mask; see isdnInfoMsk(D4isdn).
cipMask: CIP (Compatibility Information Profile) mask; see isdnCIPmask(D4isdn).
cipMask2: reserved for future use
callingNbr: calling party number; see isdnCallingNbr(D4isdn).
callingAddr: calling party subaddress; see isdnCallingAdr(D4isdn).

References

Intro(D4isdn), Intro(D7isdn)

ISDN_LISTEN.ISDN_CONF(D7isdn)

``SCO ISDN adapter drivers'' in Developing MDI network adapter drivers