Sun Microsystems 3U User Manual
Appendix C
Application Programmer’s Interface
93
Call Setup
To make a call, send a SETUP message down to Q.93B and wait for a SETUP_ACK
from Q.93B. The SETUP message should include a Broadband Higher Layer
Information (BHLI) information element that contains a four-octet SAP identified as
User Specific Information. The SAP is used to identify the application on the
receiving host to which the Q.93B should direct the message. After receiving a
SETUP_ACK with a 0 error field, wait for a CALL_PROCEEDING, ALERTING,
from Q.93B. The SETUP message should include a Broadband Higher Layer
Information (BHLI) information element that contains a four-octet SAP identified as
User Specific Information. The SAP is used to identify the application on the
receiving host to which the Q.93B should direct the message. After receiving a
SETUP_ACK with a 0 error field, wait for a CALL_PROCEEDING, ALERTING,
TABLE C-3
qcc
Functions
Name
Functionality
Input
Output
qcc_bld_*
Creates and encodes a message;
enables customization of a limited
set of values, depending on the
message type. Configurable values
are passed in as parameters.
enables customization of a limited
set of values, depending on the
message type. Configurable values
are passed in as parameters.
Parameter values
Encoded Q.2931
message (in the format
shown in
message (in the format
shown in
)
qcc_parse_*
Extracts a defined set of values
from an encoded message
from an encoded message
Encoded Q.2931 message
(in the format shown in
(in the format shown in
)
Parameter values
qcc_len_*
Returns the maximum length of the
buffer that should be allocated for
the second strbuf in a Q.2931
message. Only applicable to user
space applications; the kernel API
allocates the buffers inside the
buffer that should be allocated for
the second strbuf in a Q.2931
message. Only applicable to user
space applications; the kernel API
allocates the buffers inside the
qcc_bld/qcc_pack
functions.
none
Maximum length of
the message
the message
qcc_create_*
Creates a message structure with
the required values set. You can
further customize the structure
using
the required values set. You can
further customize the structure
using
qcc_set_ie
.
Default parameter values
Message structure
(defined in
(defined in
<atm/qcctypes.h>
)
qcc_set_ie
Updates or inserts values for an
information element into a message
structure.
information element into a message
structure.
Message structure and IE
structure (defined in
structure (defined in
<atm/qcctypes.h>
)
Updated message
structure
structure
qcc_pack_*
Takes a message structure and
encodes it into an actual Q.2931
message, consisting of the two
mblks (or strbufs) illustrated in
encodes it into an actual Q.2931
message, consisting of the two
mblks (or strbufs) illustrated in
Message structure (defined
in
in
<atm/qcctypes.h>
)
Encoded Q.2931
message (in the format
shown in
message (in the format
shown in
)
qcc_unpack_*
The reverse of
qcc_pack_*
: takes
an encoded message and decodes
the data into a message structure.
the data into a message structure.
Encoded Q.2931 message
(in the format shown in
(in the format shown in
)
Message structure
(defined in
(defined in
<atm/qcctypes.h>
)