DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

isdnInfoMsk(D4isdn)


isdnInfoMsk -- ISDN information mask

Synopsis

   #include <sys/types.h>
   #include <sys/scoisdn.h>
   

typedef isdnDword_t isdnInfoMsk_t;

Description

The infoMsk parameter specifies the type of information provided by an ISDN driver for a physical connection or controller. The selected information will be indicated to the application with the ISDN_INFO.ISDN_IND(D7isdn) message. The given infoMsk is set in ISDN_LISTEN.ISDN_REQ(D7isdn); it is valid until superceded by another ISDN_LISTEN.ISDN_REQ and it applies to all information concerning the corresponding application.

The infoMsk parameter is coded as a bit field. A bit set to 1 means that corresponding ISDN_INFO.ISDN_IND messages will be generated, and a bit set to 0 means the specified information will be suppressed. In the default infoMsk, all bits are set to 0. If an application wants to change this value, it must send an ISDN_LISTEN.ISDN_REQ message, even if it does not want to be informed about incoming calls.

This parameter is used by:

ISDN_LISTEN.ISDN_REQ(D7isdn)

Bit mask values

The following bit masks are valid for isdnInfoMsk:


ISDN_INFOMSK_CAUSE
0x00000001: cause information given by the net during disconnection. The isdnInfoEl(D4isdn) parameter in the corresponding ISDN_INFO.ISDN_IND(D7isdn) is an ISDN driver structure that contains the cause information element defined in Q.931 4.5.12.

ISDN_INFOMSK_DATETIME
0x00000002: date and time information indicated by the net. The isdnInfoEl parameter in the corresponding ISDN_INFO.ISDN_IND is an ISDN driver structure that contains the date/time information element defined in Q.931 4.6.1.

ISDN_INFOMSK_DISPLAY
0x00000004: display information to be displayed to the user. The isdnInfoEl parameter in the corresponding ISDN_INFO.ISDN_IND is an ISDN driver structure that contains the display information element defined in Q.931 4.5.15.

ISDN_INFOMSK_USERINFO
0x00000008: user-user information that is transparently carried by the net. The isdnInfoEl parameter in the corresponding ISDN_INFO.ISDN_IND is an ISDN driver structure that contains the user-user information element defined in Q.931 4.5.29.

ISDN_INFOMSK_CALLPROG
0x00000010: call progression, information related to the progress of the call. There are five different ISDN_INFO.ISDN_IND messages that correspond to this information type, each with a unique isdnInfoEl. The first indication contains the Q.931 progress indicator information element. The other four messages indicate the occurrence of the network events SETUP ACKNOWLEDGE, CALL PROCEEDING, ALERTING, and PROGRESS. In these cases, the isdnInfoNbr indicates the corresponding message type and the information element in an empty ISDN driver structure.

ISDN_INFOMSK_FACILITY
0x00000020: facility information to indicate the invocation and operation of supplementary services. The isdnInfoEl parameter in the corresponding ISDN_INFO.ISDN_IND is an ISDN driver structure that contains the facility information element defined in Q.931 4.6.2.

ISDN_INFOMSK_CHARGING
0x00000040: connection-oriented charging information provided by the net. There are two different ISDN_INFO.ISDN_IND messages with unique isdnInfoNbr values that correspond to this information type. The first shows the sum of charging units indicated by the net up to this moment, and the second shows the sum of charges in the national currency indicated by the net up to this moment. In both cases, the isdnInfoEl parameter is coded as an ISDN driver struct containing a dword. It is highly recommended to provide only one of these two types of charging information to the user and to transform one type to the other. However, in some networks this might be impossible due to the information provided from the net. In these cases it is not defined, if the current charges are represented by only one or both or the sum of these indicated charges.

References

Intro(D4isdn), Intro(D7isdn)

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


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005