(Page 1 of 1 in this chapter) Version


Index

A

Accepting call state 52, 58
description 12
determining if protocol supports 24, 58
error returned if state not supported 91
events signifying state change to/from 28, 92, 139
functions valid in 32
possible events while in 38
accepting calls. See call accepting
Active call
and line states 11
becomes inactive when disconnected 69
defined 10, 215
not active when on hold 72
Active line state
and Active calls 11
description 11
entered on seizure 54
entered when call is retrieved 73
events signifying state change to/from 26
functions valid in 30
possible events while in 34
address information
caller ID. See caller ID
retrieving 51, 101
ADI service
described 4
migrating to NCC service. See migration
adiGetContextInfo 224
ADIMGR 42, 44-45
AG configuration file 44
agmon
loads TCP 7
must be started prior to protocol initialization 47
alerting
description 66
event reference 168
performing transfer when call is 75, 95
ANI. See caller ID
Answering call state 52, 59
changed from ADI 218
description 12
events signifying state change to/from 28, 93, 140
functions valid in 32
possible events while in 38
answering calls. See call answering
asynchronous functions
defined 5
list of 13-16
asynchronous programming 5
automatic call transfer 75-76
ADI vs. NCC 219
defined 74-75
demonstration program 177
determining if protocol supports 24, 74, 76
determining when call is to be transferred 95
event reference 150
function reference 95
methods 75
procedure 75-76

B

billing
determining if incoming billing info is reported 66, 68, 212
determining if protocol supports 24, 60
event summary 21
function reference 124
setting 60
solicited event reference 142
unsolicited event reference 141
blind transfer. See automatic call transfer
blocking calls. See call blocking
Blocking line state
description 11
events signifying state change to/from 26, 76
functions valid in 30
possible events while in 34

C

call
Active. See Active call
defined 10, 215
events 22
handle. See call handle
multiple on a line 10
call accepting 51, 58-59
determining if embedded media is supported 24
determining if state is supported by protocol 24, 58
event reference 139
function reference 91
methods 58, 92
call answering 51, 59
event reference 140
function reference 93
remote. See remote answering
call blocking 76-77
canceling previous invocation before blocking takes place 77
event reference 155
event summary 21
failure event reference 143
function reference 98
function summary 16
line state. See Blocking line state
methods 76, 99
unblocking blocked calls. See call unblocking
call collision. See glare
call control
defined 2
functions 50
mask parameters 64
performing under NCC 50-70
call disconnecting 69-70
ADI vs. NCC 218
determining states call can be disconnected in 24, 69
event reference 146
event summary 20
function reference 100
function summary 15
call handle
defined 10, 51, 215
getting number of unreleased handles in line status structure 106
included in event indication 11, 215
obtaining 54
returned in CTA_EVENT structure 46, 137
call holding 72-73
ADI vs. NCC 219
determining if protocol supports 24, 72
determining states call can be held in 24, 70, 73
event reference 150, 159
event summary 19
function reference 107
function summary 14
held/unheld status available in NCC_CALL_STATUS 56, 83, 103
retrieving held calls. See call retrieving
call message 87-88
determining if protocol supports 24, 87
sending function reference 118
sending function summary 15
call placement 61-67
function reference 109
glare 61, 63
parameters 64, 109
call rejecting 51, 60
determining if protocol supports 24
event reference 167
function reference 113
if app does not respond to incoming call 52
methods 60
call release 52, 70
after automatic call transfer 75
after supervised call transfer 74
event reference 152
event summary 20
function reference 115
function summary 14-15
call retrieving 72-73
ADI vs. NCC 219
determining if protocol supports 24
event reference 153, 170
event summary 14, 19
function reference 116
call states
defined 11, 216
events possible while in each 38-39
functions valid in each 32-33
initial 54
machine 29
not affected by call held/un-held status 72
returned in NCC_CALL_STATUS 55, 82, 102
summary 12
summary of associated events 27-29
call status
determining if unsolicited update events are reported 212
extended. See extended call status
retrieval event summary 20
retrieval function summary 15
retrieving 51, 55-56, 82-83, 101
retrieving protocol-specific information. See extended call status
structure 55, 82, 101
unsolicited update event reference 154
call transfer
ADI vs. NCC 219
automatic. See automatic call transfer
blind. See automatic call transfer
capabilitymask bits 24
function summary 14
overview 74
supervised. See supervised call transfer
call unblocking 77
event reference 156
event summary 21
failure event reference 174
function reference 133
function summary 16
called address 56, 82, 102
calledaddr
caller ID
defined 55
determining if protocol supports 25, 55
field in NCC_CALL_STATUS containing 56, 82, 102
retrieving 51, 55, 101
callhd. See call handle
calling address. See caller ID
calling name 56, 82, 102
callproggen. See NCC.START.callproggen parameters
capabilitymask. See protocol capability information
Centrex 75
Connected call state 68
as part of inbound call sequence 52
changed from ADI 218
description 12
events signifying state change to/from 28, 93-94, 144
functions valid in 32
performing transfer when call reaches 75, 95
possible events while in 38
reaching 68
connectmask parameter 62, 64, 68-69
context handle. See line handle
CT Access
and NCC service 3
CTA context 4
defined 3
event queue 4
initializing 42
programming model 5-7
setting up for use with NCC 42-45
CTA context
creating 43
defined 4
equivalent to line handle 43
handle returned in CTA_EVENT structure 46, 137
handle. See line handle
starting protocol on 47-48
CTA_EVENT
description 46, 136
fields in 46, 137
listing 46, 136
CTA_REASON_FINISHED 48, 127, 172-173
CTA_SERVICE_DESC structure 43
ctaCreateContext 43, 46, 137
ctaCreateQueue 42
ctadef.h 46
ctaerr.h 198
CTAERR_BAD_ARGUMENT 91, 96, 101, 104-105, 109, 118, 120, 122, 127, 131, 199-200
CTAERR_BAD_SIZE 104, 106, 199-200
CTAERR_FATAL 101, 104, 118
CTAERR_INVALID_CTAHD 199-200
CTAERR_INVALID_HANDLE 91, 93, 96, 98, 100, 106-107, 109, 112-113, 115-116, 120, 122, 124, 127, 130-131, 133, 199-200
CTAERR_INVALID_STATE 77, 91, 93, 96, 98, 100, 107, 109, 112-113, 115-116, 120, 124, 127, 130-131, 133, 199-200
ctahd. See line handle
ctaInitialize 42
ctaOpenServices 43
ctaSetParmByName 209
ctatest 45
ctaWaitEvent 45-46, 136
ctdaemon 209

D

debugflag. See NCC.START.debugflag parameter
DemoLoadParameters 209
demonstration program 176-178
developer support xi
DID. See called address
digits
receiving one by one. See overlapped receiving
sending one by one. See overlapped sending
DIS_INCOMING_FAULT 147
Disconnected call state 52
description 12, 218
events signifying transition to/from 28, 100
functions valid in 32
possible events while in 38
reaching after supervised call transfer 74
reaching during automatic call transfer 75
disconnecting calls. See call disconnecting
disconnectmask parameter 62, 64, 66, 69, 148, 218
DNIS. See called address

E

error codes 198-200
defined 5
prefixes 198
returned in CTA_EVENT structure 46, 137
event queue
creating 42
defined 4
events 43
alphabetical reference 138-174
call state(s) each event may be received in 38-39
data structure 46, 136
defined 5
DONE 5
fields 46, 137
for billing setting 21
for blocking and unblocking calls 21
for disconnecting and releasing calls 20
for establishing outbound calls 19
for getting status and capability info 20
for handling incoming calls 18
for holding and retrieving calls 19
for managing telephony protocols 18
include call and line handles 11, 215
informational 17
line and protocol 22
line state(s) each event is valid in 34
NCC equivalents for ADI events 225-232
new events (not in ADI) 232-234
numeric equivalents 202-203
queue. See event queue
receiving 45-46, 136-138
solicited 17
transitional 17
types 17
unsolicited 17
unsolicited. See unsolicited events
extended call status
determining if protocol supports 24, 83
determining if unsolicited update events are reported 158, 212
retrieving 83
retrieving function reference 104
unsolicited update event reference 158

F

functions
call state(s) each function is valid in 32-33
for blocking and unblocking calls 16, 98, 133
for disconnecting and releasing calls 15, 100, 115
for getting status and compatibility info 15, 101, 104-105, 112
for handling incoming calls 14, 91, 93, 113, 120
for handling outbound calls 14, 109
for holding and retrieving calls 14, 107, 116
for managing parameters 8
for managing telephony protocols 13, 126, 130
for sending call and line messages 15, 118, 122
for setting billing 16, 124
for transferring calls 14, 95, 131
line state(s) each function is valid in 30-31
NCC equivalents for ADI functions 220-225
new functions (not in ADI) 224
pending 81, 103, 106
reference 90-133
sending protocol-specific information with 86-87
summary of 13-16

G

glare
during outbound call placement 61, 63
resolving 218

H

holding calls. See call holding

I

Idle line state
and Active calls 11
changes to Active on seizure 54
description 11
entered when call is placed on hold 73
events signifying state change to/from 26
functions valid in 30
how entered 47-48
possible events while in 34
incoming call
accepting 58-59
answering 59
delivered from network to NCC service 51
determining if call is 56, 83, 103
disconnecting and releasing 69-70
event summary 18
functions for handling 14
handling 51-60
new states (not in ADI) 217
overlapped receiving of digits 57
rejecting 60
retrieving call address information 55-56
seizure 51, 54
sequence diagrams 53-54
setting billing 60
state. See Incoming call state
Incoming call state 51, 57
description 12
events signifying state change to/from 28, 57, 160
functions valid in 32
possible events while in 38
informational events
defined 17
list of 18-22

L

libnccapi.so 48
line
defined 10, 215
events 22
getting status of. See line status
handle. See line handle
multiple calls on 10
seizure. See seizure
states. See line states
line handle
defined 10, 215
equivalent to CTA context handle 43, 215
included in event indication 11, 215
obtaining 54
returned in CTA_EVENT structure 46, 137
returned in NCC_CALL_STATUS 56, 83, 103
line message 87-88
determining if protocol supports 24, 87
sending function reference 122
sending function summary 15
line service
in-service event reference 161
out-of-service event reference 162
line states
changes to Idle when call is placed on hold 72-73
defined 11, 216
events valid in each 34
functions valid in each 30-31
machine 27
returns to Active when call is retrieved 73
summary 11
summary of associated events 26-27
line status
event reference 161-162
function reference 105
retrieval event summary 20
retrieval function summary 15
retrieving 80-81
retrieving function reference 105
service. See line service
linehd. See line handle

M

media functions
performing on held call 73
playing before connecting a call. See call accepting
playing before rejecting a call. See call rejecting
mediamask 128, 172, 231
migration 214-237
ADI service vs. NCC service 214
adiGetContextInfo functionality change 224
calls vs. lines 215
changes to call transfer mechanism 219
NCC counterparts for ADI events 225-231
NCC counterparts for ADI functions 220-225
NCC parameters vs. ADI parameters 234-237
new call hold/retrieve functionality 219
new events 232-233
new functions 224
NOCC 237
querying capabilities of a protocol 215
sending protocol-specific arguments 220
state machine changes 216
mode 44
MVIP address 44-45, 81, 106

N

NaturalFax service 3
NCC service
and CT Access 3
and hardware 6
and TCP 6
call control model 10-12
defined 2
event summary 17
function summary 13-16
linking with 48
migrating to from ADI service. See migration
opening 43-45
state machines 26-39
NCC.START parameters
list of 210
migrating from ADI 235
NCC.START.callproggen parameters
list of 128, 210
migrating from ADI 236
NCC.START.debugflag parameter 128, 210, 235
NCC.START.eventmask parameter
ADI equivalent 236
and events 34, 38
bit summary 212
controlling events in Proceeding call state 66, 168-169
description 128, 210
determining if billing indications are reported 67, 110, 141
determining if state change notifications are reported 84
in NCC_START_PARMS structure 128
NCC.START.overlappedreceiving parameter 28, 51, 57, 128, 166, 210, 217, 235
NCC.START.waitforPCtime parameter 57, 128, 167, 210, 235-236
NCC_ACCEPT_PLAY_RING 58, 91-92, 139, 225
NCC_ACCEPT_PLAY_SILENT 58, 91-92, 139, 225
NCC_ACCEPT_USER_AUDIO 58, 91-92, 139, 225
NCC_ANSWER_MODEM 169, 230
NCC_ANSWER_SIGNAL 169, 230
NCC_ANSWER_VOICE 169, 230
NCC_BILLINGSET_DEFAULT 125, 142, 225
NCC_BILLINGSET_FREE 125, 142, 225
NCC_BLOCK_OUT_OF_SERVICE 76, 98-99, 155, 228
NCC_BLOCK_REJECTALL 76, 98-99, 155, 228
NCC_BLOCK_TIMEOUT 143
NCC_CALL_STATUS
address information received in 57
ADI equivalent 221
field descriptions 55, 82, 102
held field in 108, 150, 153
listing 55, 82, 101
unsolicited event indicating change in 154
NCC_CALL_STATUS_CALLINGADDR 84, 102, 154, 231
NCC_CAP_ACCEPT_CALL 24, 91-92, 139
NCC_CAP_AUTOMATIC_TRANSFER 24, 74, 76, 96-97
NCC_CAP_CALLER_ID 25
NCC_CAP_DISCONNECT_IN_ANY_STATE 24, 69, 100, 149
NCC_CAP_EXTENDED_CALL_STATUS 24, 104, 233
NCC_CAP_HOLD_CALL 24, 72, 107-108, 117, 150, 153, 159, 232-233
NCC_CAP_HOLD_IN_ANY_STATE 24, 73, 107-108, 116, 150, 219
NCC_CAP_MEDIA_IN_SETUP 24, 92, 113-114
NCC_CAP_OVERLAPPED_SENDING 24, 61, 111, 120-121
NCC_CAP_RETRIEVE_CALL 170
NCC_CAP_SEND_CALL_MESSAGE 24, 87, 118-119
NCC_CAP_SEND_LINE_MESSAGE 24, 87, 122-123
NCC_CAP_SET_BILLING 24, 60, 124-125, 142
NCC_CAP_SUPERVISED_TRANSFER 24, 74-75, 131-132
NCC_CON_ANSWERED
ADI equivalent 225
description 144
NCC_CON_CED
ADI equivalent 225
description 144
NCC_CON_DIALTONE_DETECTED
ADI equivalent 225
description 144
NCC_CON_ON_CALL_PROCEEDING 68
NCC_CON_PROCEEDING
ADI equivalent 225
description 144
NCC_CON_RING_BEGIN
ADI equivalent 225
description 144
NCC_CON_RING_QUIT
ADI equivalent 225
description 144
NCC_CON_SIGNAL
ADI equivalent 225
description 144
NCC_CON_SIT_DETECTED
ADI equivalent 226
description 144
NCC_CON_TIMEOUT
ADI equivalent 226
description 144
NCC_CON_VOICE_BEGIN
ADI equivalent 226
description 144
NCC_CON_VOICE_END
ADI equivalent 226
description 144
NCC_CON_VOICE_EXTENDED
ADI equivalent 226
description 145
NCC_CON_VOICE_LONG
ADI equivalent 226
description 145
NCC_CON_VOICE_MEDIUM
ADI equivalent 226
description 145
NCC_DBG_xxx
description 165
NCC_DIS_BUSY
ADI equivalent 226
description 146
NCC_DIS_CED
ADI equivalent 226
description 146
NCC_DIS_CLEARDOWN_TONE
ADI equivalent 226
description 146
NCC_DIS_CONGESTION
ADI equivalent 227
description 146
NCC_DIS_DIAL_FAILURE
ADI equivalent 226
description 146
NCC_DIS_DIALTONE
ADI equivalent 226
description 146
NCC_DIS_GLARE
ADI equivalent 226
description 146
NCC_DIS_HOST_TIMEOUT
ADI equivalent 226
description 146
NCC_DIS_INCOMING_FAULT
ADI equivalent 227
description 146
NCC_DIS_NO_ACKNOWLEDGEMENT
ADI equivalent 226
description 147
NCC_DIS_NO_CS_RESOURCE
ADI equivalent 226
description 147
NCC_DIS_NO_DIALTONE
ADI equivalent 226
description 147
NCC_DIS_NO_LOOP_CURRENT
ADI equivalent 226
description 147
NCC_DIS_PROTOCOL_ERROR
ADI equivalent 227
description 147
NCC_DIS_REJECT_REQUESTED
ADI equivalent 227
description 147
NCC_DIS_REMOTE_ABANDONED
ADI equivalent 227
description 147
NCC_DIS_REMOTE_NOANSWER
ADI equivalent 227
description 147
NCC_DIS_RING_BEGIN
ADI equivalent 227
description 147
NCC_DIS_RING_QUIT
ADI equivalent 227
description 147
NCC_DIS_SIGNAL
ADI equivalent 227
description 147
NCC_DIS_SIGNAL_UNASSIGNED_NUMBER
ADI equivalent 227
description 147
NCC_DIS_SIGNAL_UNKNOWN
ADI equivalent 227
description 147
NCC_DIS_SIT_DETECTED
ADI equivalent 227
description 147
NCC_DIS_TIMEOUT
ADI equivalent 227
description 148
NCC_DIS_TRANSFER
ADI equivalent 219, 227
after nccAutomaticTransfer 96
description 148
indicating successful automatic call transfer 75, 96-97
indicating successful supervised call transfer 74, 132
NCC_DIS_VOICE_BEGIN
ADI equivalent 227
description 148
NCC_DIS_VOICE_END
ADI equivalent 227
description 148
NCC_DIS_VOICE_EXTENDED
ADI equivalent 227
description 148
NCC_DIS_VOICE_LONG
ADI equivalent 227
description 148
NCC_DIS_VOICE_MEDIUM
ADI equivalent 227
description 148
NCC_LINE_STATUS
field descriptions 81, 106
listing 80, 105
NCC_OUT_OF_SERVICE_DIGIT_TIMEOUT
ADI equivalent 228
description 162
NCC_OUT_OF_SERVICE_LINE_FAULT
ADI equivalent 228
description 162
NCC_OUT_OF_SERVICE_NO_DIGITS
ADI equivalent 228
description 162
NCC_OUT_OF_SERVICE_NO_LOOP_CURRENT
ADI equivalent 228
description 162
NCC_OUT_OF_SERVICE_PERM_SIGNAL
ADI equivalent 228
description 162
NCC_OUT_OF_SERVICE_REMOTE_BLOCK
ADI equivalent 228
description 162
NCC_OUT_OF_SERVICE_WINK_STUCK
ADI equivalent 228
description 162
NCC_PLACECALL_PARMS 148, 218
NCC_PROT_CAP
fields 112
listing 112
NCC_PROTERR_BAD_CALLERID
ADI equivalent 229
description 164
NCC_PROTERR_CAPABILITY_ERROR
ADI equivalent 229
description 164
NCC_PROTERR_COMMAND_OUT_OF_SEQUENCE
ADI equivalent 229
NCC_PROTERR_COMMAND_OUT_OF_SERVICE
description 164
NCC_PROTERR_DIGIT_TIMEOUT
ADI equivalent 228
description 164
NCC_PROTERR_EVENT_OUT_OF_SEQUENCE
ADI equivalent 229
description 164
NCC_PROTERR_EXTRA_DIGITS
ADI equivalent 229
description 164
NCC_PROTERR_FALSE_SEIZURE
ADI equivalent 229
description 164
NCC_PROTERR_INVALID_DIGIT
ADI equivalent 229
description 164
NCC_PROTERR_NO_CS_RESOURCE
ADI equivalent 229
description 164
NCC_PROTERR_PREMATURE_ANSWER
ADI equivalent 229
description 164
NCC_PROTERR_TIMEOUT
ADI equivalent 229
description 164
NCC_REJECT_HOST_TIMEOUT
ADI equivalent 230
description 167
NCC_REJECT_PLAY_BUSY 60, 114, 167, 230
NCC_REJECT_PLAY_REORDER 60, 113-114, 167, 230
NCC_REJECT_PLAY_RINGTONE 60, 113-114, 167, 230
NCC_REJECT_USER_AUDIO 60, 113-114, 167, 230
NCC_RELEASED_ERROR 152, 228
NCC_RELEASED_FALSE_SEIZURE 110
NCC_RELEASED_GLARE 63, 110, 152, 218, 228
NCC_REPORT_ALERTING 62, 66, 110, 168, 212
NCC_REPORT_ANSWERED 62, 66, 110, 169, 212
NCC_REPORT_BILLING 67, 141, 212
NCC_REPORT_STATUSINFO 84, 154, 158, 212, 233
NCC_START_PARMS
fields 128
listing 126
overlappedreceiving parameter in 57
NCC_TRANSFER_ALERTING 95
NCC_TRANSFER_CONNECTED 95
NCC_TRANSFER_PROCEEDING 95
NCC_UNBLOCK_TIMEOUT 174
NCC_X_ADI_PLACECALL_PARMS 64
nccAcceptCall
called in Incoming call state 57
determining if protocol supports 58
function reference 91
methods 58, 92
sending protocol-specific information with 86
using 51, 58
nccAnswerCall
ADI equivalent 221
and overlapped receiving 57
function reference 93
in Accepting call state 58
in inbound call sequence 51
in Incoming call state 57
sending protocol-specific information with 86
using 51, 59
nccapi.lib 48
nccAutomaticTransfer
ADI equivalent 223
function reference 95
in demonstration program 177
sending protocol-specific information with 86
using 75
nccBlockCalls
ADI equivalent 221
function reference 98
sending protocol-specific information with 86
using 76
nccDisconnectCall
ADI equivalent 222
function reference 100
sending protocol-specific information with 86
using 69
NCCERR_INVALID_CALL_STATE 91, 93, 96, 100, 107, 113, 115-116, 120, 124, 131, 199-200
NCCERR_NOT_CAPABLE 91, 96, 104, 107, 113, 118, 120, 122, 124, 131, 199-200
NCCEVN_ACCEPTING_CALL
ADI equivalent 225
event reference 139
in inbound call sequence 52
in response to nccAcceptCall 92
indicates change to Accepting call state 52
numeric equivalent 202
NCCEVN_ANSWERING_CALL
ADI equivalent 225
event reference 140
in inbound call sequence 52
in response to nccAnswerCall 59, 93
numeric equivalent 202
NCCEVN_BILLING_INDICATION
ADI equivalent 225
determining if reported 67
event reference 141
eventmask bit 212
in Connected call state 68
in Proceeding call state 66
numeric equivalent 202
unsolicited event 67
NCCEVN_BILLING_SET
ADI equivalent 225
event reference 142
in response to nccSetBilling 60, 125
numeric equivalent 202
NCCEVN_BLOCK_FAILED
ADI equivalent 232
event reference 143
in response to nccBlockCalls 98
numeric equivalent 203
NCCEVN_CALL_CONNECTED
ADI equivalent 225
event reference 144
in inbound call sequence 52
in outbound call sequence 62
indicates transition to Connected call state 68
numeric equivalent 202
received during call placement 110
received in response to nccAnswerCall 93
NCCEVN_CALL_DISCONNECTED
ADI equivalent 219, 226
after nccAcceptCall 58-59
after nccAnswerCall 59, 93-94
after nccAutomaticTransfer 75, 96-97
after nccDisconnectCall 69, 100
after nccRejectCall 60, 114
after nccTransferCall 74-75, 132
event reference 96, 146
if automatic call transfer fails 153
in inbound call sequence 52
in outbound call sequence 62
indicating automatic call transfer complete 96-97
indicating disconnect 92-93
indicating nccDisconnectCall succeeded 100
numeric equivalent 202
received after nccAcceptCall 92
while placing call 65
NCCEVN_CALL_HELD
ADI equivalent 232
event reference 150
numeric equivalent 202
received after nccAutomaticTransfer 75, 96-97
received after nccHoldCall 73, 107-108
received during automatic call transfer 96-97
unsolicited 73
NCCEVN_CALL_PROCEEDING
ADI equivalent 227
after nccPlaceCall 110
event reference 151
in outbound call sequence 61
meaning 66, 217
numeric equivalent 202
NCCEVN_CALL_RELEASED
ADI equivalent 228
after nccReleaseCall 70, 115, 130
after nccStopProtocol 130
after nccTransferCall 74
during call placement 110
event reference 152
in glare situation 61, 63, 218
numeric equivalent 202
NCCEVN_CALL_RETRIEVED
ADI equivalent 232
after nccAutomaticTransfer 76, 96-97
after nccRetrieveCall 116
event reference 153
if automatic call transfer fails 153
numeric equivalent 202
received after nccRetrieveCall 73
unsolicited 73
NCCEVN_CALL_STATUS_UPDATE
ADI equivalent 230
description 84, 102
determining if unsolicited updated events are reported 154
event reference 154
eventmask bit 212
numeric equivalent 202
NCCEVN_CALLS_BLOCKED
ADI equivalent 228
after nccBlockCalls 76, 98-99
event reference 155
numeric equivalent 202
NCCEVN_CALLS_UNBLOCKED
ADI equivalent 228
after nccUnBlockCalls 77, 133
event reference 156
numeric equivalent 202
NCCEVN_CAPABILITY_UPDATE
ADI equivalent 232
description 25
event reference 157
numeric equivalent 203
NCCEVN_EXTENDED_CALL_STATUS_UPDATE
ADI equivalent 233
description 84
determining if event is generated 158
eventmask bit 212
numeric equivalent 203
NCCEVN_HOLD_REJECTED
ADI equivalent 233
after nccHoldCall 107
event reference 159
numeric equivalent 202
NCCEVN_INCOMING_CALL
ADI equivalent 228, 235-236
and waitforPCtime parameter 128
event reference 160
if app does not respond to 52
if received while blocking calls 99
in inbound call sequence 51-52
indicates all address information has been received 57, 166
indicates call status information is available 55, 102
indicates that app must handle incoming call 114
indicates that calling party info is available 55, 57
indicates transition to Incoming call state 51, 57, 217
numeric equivalent 202
NCCEVN_LINE_IN_SERVICE
ADI equivalent 228
event reference 161
numeric equivalent 202
NCCEVN_LINE_OUT_OF_SERVICE
ADI equivalent 228
event reference 162
numeric equivalent 202
NCCEVN_PLACING_CALL
ADI equivalent 228
after nccPlaceCall 63, 110, 217
event reference 163
in outbound call sequence 61
indicates Outbound Initiated call state 65
numeric equivalent 202
NCCEVN_PROTOCOL_ERROR
ADI equivalent 228
event reference 164
numeric equivalent 202
NCCEVN_PROTOCOL_EVENT
ADI equivalent 230
event reference 165
numeric equivalent 202
NCCEVN_RECEIVED_DIGIT
ADI equivalent 230
event reference 166
indicates transition to Receiving Digits call state 57, 217
numeric equivalent 203
overlapped receiving 57
NCCEVN_REJECTING_CALL
ADI equivalent 230
after nccRejectCall 60, 113-114
event reference 167
in inbound call sequence 52
numeric equivalent 202
NCCEVN_REMOTE_ALERTING
ADI equivalent 230
after nccPlaceCall 110
description 66
determining if reported 62, 66, 168, 212
event reference 168
in Connected call state 68
in outbound call sequence 61
in Proceeding call state 66
numeric equivalent 202
NCCEVN_REMOTE_ANSWERED
ADI equivalent 230
after nccPlaceCall 110
determining if reported 66, 169
event reference 169
eventmask bit 212
in Connected call state 68
in outbound call sequence 61
in Proceeding call state 66
numeric equivalent 202
NCCEVN_RETRIEVE_REJECTED
ADI equivalent 233
after nccRetrieveCall 116
event reference 170
numeric equivalent 202
NCCEVN_SEIZURE_DETECTED
ADI equivalent 225, 231
contains call handle 54
event reference 171
glare situation 63
in inbound call sequence 51
indicates transition to Seizure call state 51, 217
numeric equivalent 202
received at seizure 54
NCCEVN_START_PROTOCOL_DONE
ADI equivalent 220, 231
after nccStartProtocol 48, 127
event reference 172
numeric equivalent 203
NCCEVN_STOP_PROTOCOL_DONE
ADI equivalent 231
after nccStopProtocol 130
event reference 173
numeric equivalent 203
NCCEVN_UNBLOCK_FAILED
ADI equivalent 233
after nccUnBlockCalls 133
event reference 174
numeric equivalent 203
nccGetCallStatus
ADI equivalent 221
calling in response to unsolicited update event 80, 84
cannot be used after call is released 70
function reference 101
in Disconnected call state 69
obtaining caller ID and other info with 55
obtaining line handle with 54
using 51, 55, 82
nccGetExtendedCallStatus
ADI equivalent 221
calling in response to unsolicited update event 84
cannot be used after call is released 70
function reference 104
using 83
nccGetLineStatus
ADI equivalent 221
function reference 105
using 80
nccHoldCall
ADI equivalent 223
sending protocol-specific information with 86
using 73
nccPlaceCall
ADI equivalent 221
function reference 109
in outbound call sequence 61
overlapped sending of digits 65
parameters 64, 109
sending protocol-specific information with 86
using 63
nccQueryCapability
function reference 112
NCCREASON_OUT_OF_RESOURCES 128, 172, 231
nccRejectCall
ADI equivalent 222
and overlapped receiving 57
function reference 113
in Accepting call state 58
in inbound call sequence 51
in Incoming call state 57
sending protocol-specific information with 87
using 51, 60
nccReleaseCall
ADI equivalent 222
calling after successful nccTransferCall 74, 132
following call rejection 60
function reference 115
in call sequence 52
sending protocol-specific information with 87
using 70
nccRetrieveCall
ADI equivalent 223
function reference 116
sending protocol-specific information with 87
using 73
nccSendCallMessage
ADI equivalent 222
function reference 118
sending protocol-specific information with 87
using 87
using in Disconnected call state 69
nccSendDigits
function reference 120
in outbound call sequence 61
sending protocol-specific information with 87
using 63, 65
using while placing call 111
nccSendLineMessage
ADI equivalent 222
function reference 122
sending protocol-specific information with 87
using 87
nccSetBilling
ADI equivalent 222
function reference 124
using 60
nccStartProtocol
ADI equivalent 223
function reference 126
sending protocol-specific information with 87
starting protocol instance with 47
nccStopProtocol
ADI equivalent 223
function reference 130
sending protocol-specific information with 87
nccTransferCall
function reference 131
in demonstration program 177
sending protocol-specific information with 87
using 74
nccUnBlockCalls
ADI equivalent 223
function reference 133
sending protocol-specific information with 87
using 77
using to cancel a blocking request 99
nccxfer 176-178
NOCC 44, 237

O

opening a service 43
Out of Service line state
description 11
events signifying state change to/from 26
functions valid in 30
possible events while in 34
outbound call
billing indications 67
cannot be blocked 76
connectmask, disconnectmask 64
determining if call is 56, 83, 103
disconnecting and releasing 69-70
establishing 61-67
event summary 19
functions for handling 14
initiating 63
new states (not in ADI) 217
overlap sending of digits 65
Placing call state 65
Proceeding call state 66
Outbound Initiated call state
description 12, 217
entering using nccPlaceCall 63
events signifying state change to/from 28
functions valid in 32
possible events while in 38
overlapped receiving 51
description 57
determining if allowed 57
entering 57, 217
event reference 166
overlapped sending
determining if protocol supports 24, 58, 61, 65
function reference 120
overlappedreceiving. See NCC.START.overlappedreceiving parameter

P

parameter file
changing values 209
loading using DemoLoadParameters 209
Parameter Management service (PRM) 47
parameters 206-212
ADI vs. NCC 234-237
call control mask 64
call control mask. See connectmask parameter, disconnectmask parameter
call placement 64, 109
changing values 209
files 207
groups 206
loading 47, 209
managing 8
must be modified before nccStartProtocol 209
names 208
NCC service global 210-211
pending command 56, 81, 83, 103, 106
Placing call state 65
and overlapped sending of digits 65
description 12
events signifying state change to/from 28, 163, 217
functions valid in 32
possible events while in 38
placing calls. See call placement
port. See MVIP address
Proceeding call state 66
connecting on 68
description 12, 151, 217
events signifying state change to/from 28, 151
functions valid in 32
performing transfer when call reaches 75, 95
possible events while in 38
protocol
capabilities. See protocol capability information
defined 3
determining protocols running on a line 81, 106
error event 164
event event 165
events for managing 18
functions for managing 13
loading and starting 47-48, 126
NOCC. See NOCC
retrieving protocol-specific information. See extended call status
sending protocol-specific information using escape mechanisms 87-88, 220
sending protocol-specific information with function call 86-87, 220
starting event 172
starting function 13
stopping event 173
stopping function 13, 130
protocol capability information 23-25
bit summary 24, 30, 34
retrieval event summary 20
retrieval function reference 112
retrieval function summary 15
update event reference 157

R

reason code
returned in CTA_EVENT structure 46, 137
Receiving Digits call state 51
description 12, 217
entering from Seizure call state 57
events signifying state change to/from 28, 57
functions valid in 32
possible events while in 38
Rejecting call state 52
description 12
events signifying state change to/from 28
functions valid in 32
possible events while in 38
rejecting calls. See call rejecting
releasing calls. See call release
remote answering
description 66
determining if state is reported 168-169, 212
event reference 169
responding to inbound calls
call sequence and events 51, 61
retrieving a held call. See call retrieving
retrieving calls from hold. See call retrieving

S

seizure 51, 54
description 54
event reference 171
Seizure call state 51
changing to Receiving Digits call state 57
description 12, 217
events signifying state change to/from 28
functions valid in 32
possible events while in 38
nccBlockCalls 86
service
and hardware 6
defined 3
list of CT Access 4
opening 43-45
service manager 42
solicited events
billing 21, 142
call blocking/unblocking 21, 143, 155-156, 174
call disconnecting and releasing 152
call disconnecting/releasing 146
call hold/retrieve 19
defined 17
disconnecting/releasing 20
hold/retrieve 150, 153
incoming call 18, 139-140, 167
managing telephony protocols 18, 172-173
outbound call 19, 163, 168-169
states
ADI vs. NCC 216
call control 11-12
call. See call states
defined 11
line. See line states
status
of call. See call status
of line. See line status
supervised call transfer 74-75
ADI vs. NCC 219
defined 74
demonstration program 177
determining if protocol supports 24, 74-75
function reference 131
Switching service 3-4, 6
synchronous functions
defined 5
list of 13-16

T

transferring calls. See call transfer
transitional events
defined 17
list of 18
Trunk Control Program (TCP)
See also protocol
defined 6
loaded by agmon 7
multiple 7

U

unblocking calls. See call unblocking
Uninitialized line state
description 11
events signifying state change to/from 26
functions valid in 30
how exited 48
initial state after CT Access is initialized 47
possible events while in 34
unsolicited events
billing indication 66-68, 141
call connected event 68, 144
call disconnected event 146
call proceeding event 66, 151
call rejection 167
defined 17
hold/retrieve 73, 150, 153
incoming call 57, 160
line service 161-162
overlapped receiving 57, 166
protocol capability update 25, 157
protocol errors/events 164-165
seizure 54, 171
status update 84, 154, 158

V

variant 3
Voice Message service 4, 6

W

waitforPCtime. See NCC.START.waitforPCtime parameter


(Page 1 of 1 in this chapter) Version


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