Manpage of CCI-ISDN

CCI-ISDN

Section: Call Control Interface (CCI) (7)
Updated: 2008-10-31
Index Return to Main Contents

NAME

CCI-ISDN - Call Control Interface - Corrigendum for Q.931/932 Conformance

SYNOPSIS

#include <ss7/cci.h>
#include <ss7/isdni.h>
#include <ss7/isdni_ioctl.h>

int isdn_stream = open(/dev/isdn, flags);

DESCRIPTION

This Corrigendum describes the formats and rules that are specific to ISDN Q.931/932[1, 2]. The Corrigendum must be used along with the generic CCI as defined in cci(7) when implementing a CCS provider that will be configured with the ISDN Q.931/932[1, 2] The Corrigendum must be used along with the generic CCI as defined call processing layer.

Address Format

The format of the call control address for ISDN Q.931/932[1, 2] The Corrigendum must be used along with the generic CCI as defined conforming CCS providers is as follows:

typedef struct isdn_addr {
        ulong scope;        /* the scope of the identifier */
        ulong id;           /* the identifier within the scope */
        ulong chan;         /* B-channel identifier */
} isdn_addr_t;

scope
id
chan

Scope

The scope of the call control address is one of the following:

ISDN_SCOPE_CH: Conveys that the scope of the call control address is a channel. The id within the scope is a channel that uniquely identifies a YYY to the CCS provider
ISDN_SCOPE_FG: Conveys that the scope of the call control address is a facility group. The id within the scope is a facility group that uniquely identifies a YYY to the CCS provider
ISDN_SCOPE_TG: Conveys that the scope of the call control address is a transmission group. The id within the scope is a transmission group that uniquely identifies a YYY to the CCS provider
ISDN_SCOPE_EG: Conveys that the scope of the call control address is a equipment group. The id within the scope is a equipment group that uniquely identifies a YYY to the CCS provider
ISDN_SCOPE_XG: Conveys that the scope of the call control address is a exchange group. The id within the scope is a exchange group that uniquely identifies a YYY to the CCS provider
ISDN_SCOPE_DF: Conveys that the scope of the call control address is a default. The id within the scope is a default that uniquely identifies a YYY to the CCS provider

Rules

Rules for call conrol addresses:

---: In primitives in which the address parameter occurs, the scope field setting indicates the scope of the address parameter.
---: Only one call control address can be specified within a single scope.
---: Not all scopes are necessarily supported by all primitives. See the particular primitive definition, below.
---: The address contained in a primitive must contain a scope and an id within the socpe (zero (0) is a valid id indicating that the id is unspecified).
---: If the scope of the address is ISDN_SCOPE_DF, the id and chan fields should be coded zero (0) and will be ignored by the CCS user or provider.
---: In all scopes other than ISDN_SCOPE_DF, the chan field is optional and coded zero (0) if unused.
---

Options

The format of the options for ISDN conforming CCS providers are formatted as optional Information Elements as defined in ISDN Q.931/932[1, 2]. The Corrigendum must be used along with the generic CCI as defined

Rules for optional parameters:

---: Th optional information elements provided by the CCS user may be checked for format by the CCS provider. If the CCS provider discovers formatting errors in the optional information elements, the CCS provider should respond with a CC_ERROR_ACK(7) primitive with error [CCBADOPT].
---: For some primitives, specific optional information elements might be interpreted by the CCS provider and alter the function of some primitives. See the specific primitive description for more details.
---: Except for optional information elements interpreted by the CCS provider as specified along with the primitives, the optional information elements are treated as opaque and the optional information element list is only checked for format. Opaque parameters will be passed to the ISDN message without examination by the CCS provider.
---: To perform specific functions, additional mandatory or optional information elements may be added to the ISDN message by the CCS provider.
---: To perform specific functions, optional information elements may be interpreted and modified by the CCS provider being added to the ISDN message.
---

Primitives

Local Management Primitives

Primitive Mode Description

CC_INFO_REQ(7) Local Information request.

CC_INFO_ACK(7) Local Information acknowledgement.

CC_ADDR_REQ(7) Local Address request.

CC_ADDR_ACK(7) Local Address acknowledgement.

CC_BIND_REQ(7) Local Bind protocol address request.

CC_BIND_ACK(7) Local Bind protocol address acknowledgement.

CC_UNBIND_REQ(7) Local Unbind protocol address request.

CC_OK_ACK(7) Local Successful receipt acknowledgement.

CC_ERROR_ACK(7) Local Error acknowledgement.

CC_OPTMGMT_REQ(7) Local Options management request.

CC_OPTMGMT_ACK(7) Local Options management acknowledgement.

Call Setup Primitives

Primitive Mode Description

CC_SETUP_REQ(7) All Outgoing call setup request.

CC_SETUP_CON(7) All Outgoing call setup confirmation.

CC_SETUP_IND(7) All Incoming call setup indication.

CC_SETUP_RES(7) All Incoming call setup response.

CC_CALL_REATTEMPT_IND(7) NNI Local Call reattempt indication.

CC_SETUP_COMPLETE_REQ(7) N->U Incoming call setup complete request.

CC_SETUP_COMPLETE_IND(7) N->U Outgoing call setup complete indication.

Continuity Check Primitives

Primitive Mode Description

CC_CONT_CHECK_REQ(7) N->N (not used) Continuity check request.

CC_CONT_CHECK_IND(7) N->N (not used) Continuity check indication.

CC_CONT_TEST_REQ(7) N->N (not used) Continuity test request.

CC_CONT_TEST_IND(7) N->N (not used) Continuity test indication.

CC_CONT_REPORT_REQ(7) N->N (not used) Continuity report result request.

CC_CONT_REPORT_IND(7) N->N (not used) Continuity report result indication.

Call Establishment Primitives

Primitive Mode Description

CC_MORE_INFO_REQ(7) U->N, N->U More information request.

CC_MORE_INFO_IND(7) U->N, N->U More information indication.

CC_INFORMATION_REQ(7) U->N, N->U Information request.

CC_INFORMATION_IND(7) U->N, N->U Information indication.

CC_PROCEEDING_REQ(7) U->N, N->U Call setup proceeding request.

CC_PROCEEDING_IND(7) U->N, N->U Call setup proceeding indication.

CC_ALERTING_REQ(7) U->N, N->U Call setup alerting request.

CC_ALERTING_IND(7) U->N, N->U Call setup alerting indication.

CC_PROGRESS_REQ(7) U->N, N->U Call setup progress request.

CC_PROGRESS_IND(7) U->N, N->U Call setup progress indication.

CC_FORWXFER_REQ(7) N->N (not used) Call forward transfer request.

CC_FORWXFER_IND(7) N->N (not used) Call forward transfer indication.

CC_CONNECT_REQ(7) U->N, N->U Call connect request.

CC_CONNECT_IND(7) U->N, N->U Call connect indication.

Call Established Primitives

Primitive Mode Description

CC_SUSPEND_REQ(7) U->N Call suspend request.

CC_SUSPEND_IND(7) U->N Call suspend indication.

CC_SUSPEND_RES(7) N->U Call suspend response.

CC_SUSPEND_CON(7) N->U Call suspend confirmation.

CC_SUSPEND_REJECT_REQ(7) N->U Call suspend reject request.

CC_SUSPEND_REJECT_IND(7) N->U Call suspend reject indication.

CC_RESUME_REQ(7) U->N Call resume request.

CC_RESUME_IND(7) U->N Call resume indicaiton.

CC_RESUME_RES(7) N->U Call resume response.

CC_RESUME_CON(7) N->U Call resume confirmation.

CC_RESUME_REJECT_REQ(7) N->U Call resume reject request.

CC_RESUME_REJECT_IND(7) N->U Call resume reject indication.

Supplementary Services Primitives

Primitive Mode Description

CC_FACILITY_REQ(7) U->N, N->U Facility request.

CC_FACILITY_IND(7) U->N, N->U Facility indication.

CC_HOLD_REQ(7) U->N, N->U Call hold request.

CC_HOLD_IND(7) U->N, N->U Call hold indication.

CC_HOLD_RES(7) U->N, N->U Call hold response.

CC_HOLD_CON(7) U->N, N->U Call hold confirmation.

CC_RETRIEVE_REQ(7) U->N, N->U Call retrieve request.

CC_RETRIEVE_IND(7) U->N, N->U Call retrieve indication.

CC_RETRIEVE_RES(7) U->N, N->U Call retrieve response.

CC_RETRIEVE_CON(7) U->N, N->U Call retrieve confirmation.

CC_REGISTER_REQ(7) U->N, N->U Service register request.

CC_REGISTER_IND(7) U->N, N->U Service register indication.

Call Termination Primitives

Primitive Mode Description

CC_INFO_TIMEOUT_IND(7) U->N, N->U Information timeout indication.

CC_REJECT_IND(7) U->N, N->U Call reject indication.

CC_CALL_FAILURE_IND(7) U->N, N->U Call failure indication.

CC_IBI_REQ(7) N->N (not used) Call disconnect request.

CC_IBI_IND(7) N->N (not used) Call disconnect indication.

CC_DISCONNECT_REQ(7) U->N, N->U Call disconnect request.

CC_DISCONNECT_IND(7) U->N, N->U Call disconnect indication.

CC_RELEASE_REQ(7) U->N, N->U Call release request.

CC_RELEASE_CON(7) U->N, N->U Call release confirmation.

Management Primitives

Primitive Mode Description

CC_RESTART_REQ(7) Local Interface restart request.

CC_RESTART_CON(7) Local Interface restart confirmation.

CC_NOTIFY_REQ(7) U->N, N->U Call notification request.

CC_NOTIFY_IND(7) U->N, N->U Call notification indication.

CC_STATUS_IND(7) U->N, N->U Call status indication.

CC_ERROR_IND(7) U->N, N->U Call error indication.

CC_DATALINK_FAILURE_IND(7) U->N, N->U Call datalink failure indication.

CC_STOP_REQ(7) N->N (not used) Interface stop request.

CC_STOP_IND(7) N->N (not used) Interface stop indication.

CC_START_RESET_IND(7) N->N (not used) Interface start reset indication.

CC_RESET_REQ(7) N->N (not used) Circuit (group) reset request.

CC_RESET_IND(7) N->N (not used) Circuit (group) reset indicaiton.

CC_RESET_RES(7) N->N (not used) Circuit (group) reset response.

CC_RESET_CON(7) N->N (not used) Circuit (group) reset confirmation.

CC_BLOCKING_REQ(7) N->N (not used) Circuit (group) blocking request.

CC_BLOCKING_IND(7) N->N (not used) Circuit (group) blocking indication.

CC_BLOCKING_RES(7) N->N (not used) Circuit (group) blocking response.

CC_BLOCKING_CON(7) N->N (not used) Circuit (group) blocking confirmation.

CC_UNBLOCKING_REQ(7) N->N (not used) Circuit (group) unblocking request.

CC_UNBLOCKING_IND(7) N->N (not used) Circuit (group) unblocking indication.

CC_UNBLOCKING_RES(7) N->N (not used) Circuit (group) unblocking response.

CC_UNBLOCKING_CON(7) N->N (not used) Circuit (group) unblocking confirmation.

CC_QUERY_REQ(7) N->N (not used) Circuit (group) query request.

CC_QUERY_IND(7) N->N (not used) Circuit (group) query indication.

CC_QUERY_RES(7) N->N (not used) Circuit (group) query response.

CC_QUERY_CON(7) N->N (not used) Circuit (group) query confirmation.

Maintenance Primitives

Primitive Mode Description

CC_MAINT_IND(7) Local

FILES

<ss7/cci.h>, <ss7/bssapi.h>, <ss7/bssapi_ioctl.h>.

DEVICES

/dev/bssap.

REFERENCES

[1]: ITU-T Recommendation Q.931, Digital Subscriber Signalling System No. 1 --- ISDN User-Network Interface Layer 3 Specification for Basic Call Control, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.931/>
[2]: ITU-T Recommendation Q.932, Digital Subscriber Signalling System No. 1 --- Generic Procedures for the Control of ISDN Supplementary Services, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.932/>
[3]: ITU-T Recommendation Q.930, Digital Subscriber Signalling System No. 1 (DSS1) --- ISDN User-Network Interface Layer 3 --- General Aspects, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.930/>