Sun Microsystems 3U manual Call Setup

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.

qcc_parse_* Extracts a defined set of values from an encoded message

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 qcc_bld/qcc_pack functions.

qcc_create_* Creates a message structure with the required values set. You can further customize the structure using qcc_set_ie.

qcc_set_ie Updates or inserts values for an information element into a message 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 FIGURE C-2.

qcc_unpack_* The reverse of qcc_pack_*: takes an encoded message and decodes the data into a message structure.

Parameter values

Encoded Q.2931 message (in the format shown in FIGURE C-2)

none

Default parameter values

Message structure and IE structure (defined in

<atm/qcctypes.h>)

Message structure (defined in <atm/qcctypes.h>)

Encoded Q.2931 message (in the format shown in FIGURE C-2)

Encoded Q.2931 message (in the format shown in FIGURE C-2)

Parameter values

Maximum length of the message

Message structure (defined in

<atm/qcctypes.h>)

Updated message structure

Encoded Q.2931 message (in the format shown in FIGURE C-2)

Message structure (defined in

<atm/qcctypes.h>)

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,

Appendix C Application Programmer’s Interface 93