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