Natural Call Control Service Developer's Reference Manual

P/N 6708-11
Version

(Page 1 of 1 in this chapter)

Table of Contents

About This Manual

Developer Support

1 Introduction

1.1 Introduction
1.2 Call Control Overview
1.2.1 Protocols
1.3 NCC and CT Access
1.3.1 CT Access Services
1.3.2 CTA Contexts and Event Queues
1.3.3 CT Access Programming Model
1.3.4 Managing Parameters in CT Access

2 The Natural Call Control API

2.1 Introduction
2.2 NCC Service Call Control Model
2.2.1 Lines and Calls
2.2.2 Call Control States
2.3 NCC Service Functions
2.4 NCC Service Events
2.5 Protocol Capabilities
2.6 NCC Service State Machines
2.6.1 Line States
2.6.2 Call States
2.6.3 Functions and States
2.6.4 Events and States

3 Initializing an NCC Service Application

3.1 Introduction
3.2 Setting Up the CT Access Environment
3.2.1 Initializing CT Access
3.2.2 Creating Event Queues and CTA Contexts
3.2.3 Opening Services
3.2.4 Receiving NCC Service Events
3.3 Loading and Starting a Protocol
3.3.1 Starting a Protocol on a CTA Context
3.4 Linking with the NCC Service

4 Basic Call Control

4.1 Introduction
4.2 Responding to Inbound Calls
4.2.1 Inbound Call Sequence
4.2.2 Seizure
4.2.3 Getting Call Address Information (Caller ID)
4.2.4 Overlapped Receiving of Digits
4.2.5 The Incoming Call State
4.2.6 Accepting Inbound Calls
4.2.7 Answering Inbound Calls
4.2.8 Rejecting Inbound Calls
4.2.9 Setting Billing
4.3 Establishing Outbound Calls
4.3.1 Outbound Call Sequence
4.3.2 Placing an Outbound Call
4.3.3 Call Control Mask Parameters (ADIMGR NCC Implementation)
4.3.4 Overlap Sending of Digits
4.3.5 The Placing Call State
4.3.6 The Proceeding Call State
4.3.7 Billing Indications
4.4 The Connected Call State
4.5 Disconnecting and Releasing a Call
4.5.1 Call Disconnection
4.5.2 Call Release

5 Call Hold, Transfer, and Blocking

5.1 Introduction
5.2 Call Hold and Retrieve
5.2.1 Placing a Call on Hold
5.2.2 Retrieving a Held Call
5.2.3 Unsolicited Hold/Retrieve Events
5.3 Transferring Calls
5.3.1 Supervised Transfer
5.3.2 Blind (Automatic) Transfer
5.4 Blocking and Unblocking Calls
5.4.1 Blocking Calls
5.4.2 Unblocking Calls

6 Getting Status Information

6.1 Introduction
6.2 Getting Line Status Information
6.3 Getting Call Status Information
6.4 Getting Extended Call Status Information
6.5 Status Change Notifications
6.5.1 Calling Address Information Changes
6.5.2 Protocol-Specific Call Status Information Changes

7 Sending Protocol-Specific Information

7.1 Introduction
7.2 Sending Protocol-Specific Info with a Function Call
7.3 Sending Protocol-Specific Call and Line Messages

8 Alphabetical Function Reference

8.1 Introduction
nccAcceptCall
nccAnswerCall
nccAutomaticTransfer
nccBlockCalls
nccDisconnectCall
nccGetCallStatus
nccGetExtendedCallStatus
nccGetLineStatus
nccHoldCall
nccPlaceCall
nccQueryCapability
nccRejectCall
nccReleaseCall
nccRetrieveCall
nccSendCallMessage
nccSendDigits
nccSendLineMessage
nccSetBilling
nccStartProtocol
nccStopProtocol
nccTransferCall
nccUnblockCalls

9 Alphabetical Event Reference

9.1 Introduction
9.2 About the Event Data Structure
9.3 Alphabetical Event Reference
NCCEVN_ACCEPTING_CALL
NCCEVN_ANSWERING_CALL
NCCEVN_BILLING_INDICATION
NCCEVN_BILLING_SET
NCCEVN_BLOCK_FAILED
NCCEVN_CALL_CONNECTED
NCCEVN_CALL_DISCONNECTED
NCCEVN_CALL_HELD
NCCEVN_CALL_PROCEEDING
NCCEVN_CALL_RELEASED
NCCEVN_CALL_RETRIEVED
NCCEVN_CALL_STATUS_UPDATE
NCCEVN_CALLS_BLOCKED
NCCEVN_CALLS_UNBLOCKED
NCCEVN_CAPABILITY_UPDATE
NCCEVN_EXTENDED_CALL_STATUS_ UPDATE
NCCEVN_HOLD_REJECTED
NCCEVN_INCOMING_CALL
NCCEVN_LINE_IN_SERVICE
NCCEVN_LINE_OUT_OF_SERVICE
NCCEVN_PLACING_CALL
NCCEVN_PROTOCOL_ERROR
NCCEVN_PROTOCOL_EVENT
NCCEVN_RECEIVED_DIGIT
NCCEVN_REJECTING_CALL
NCCEVN_REMOTE_ALERTING
NCCEVN_REMOTE_ANSWERED
NCCEVN_RETRIEVE_REJECTED
NCCEVN_SEIZURE_DETECTED
NCCEVN_START_PROTOCOL_DONE
NCCEVN_STOP_PROTOCOL_DONE
NCCEVN_UNBLOCK_FAILED

10 Demonstration Program

10.1 Introduction
10.2 Demonstration Program
10.3 Call Transfer: nccxfer

Appendix A Glossary

Appendix B NCC Service Errors

Introduction
Alphabetical Error Summary
Numerical Error Summary

Appendix C Events Numerically Listed

Appendix D Parameters

Introduction
Parameter Groups
Parameter Files
Parameter Names
Loading Parameters
Changing Parameter Values
NCC Service Global Parameters
eventmask Bits

Appendix E Migration from ADI to NCC

Introduction
The ADI service vs. the NCC service
Querying the Capabilities of a Protocol
Calls Vs. Lines
State Machine Changes
Line States Vs. Call States
Inbound Call State Machine Changes
Outbound Call State Machine Changes
Disconnecting and Releasing Calls
Transferring Calls
New Call Hold/Retrieve Functionality
Sending Protocol-Specific Arguments
NCC Counterparts for ADI Functions
Changes to adiGetContextInfo Function
New Functions
NCC Counterparts for ADI Events and Reasons
New Events
NCC Parameters Vs. ADI Parameters
NOCC

(Page 1 of 1 in this chapter)

tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.