Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager Release 10.0(1)
Message sequence charts
Downloads: This chapterpdf (PDF - 7.05MB) The complete bookPDF (PDF - 14.35MB) | Feedback

Contents

Message sequence charts

This appendix contains message sequences or call scenarios and illustrates a subset of these scenarios that are supported by the Cisco Unified TSP. Be aware that the event order is not guaranteed in all cases and can vary depending on the scenario and the event.

This appendix contains the following sections:

Abbreviations

The following list gives abbreviations that are used in the CTI events that are shown in each scenario:

  • NP—Not Present
  • LR—LastRedirectingParty
  • CH—CtiCallHandle
  • GCH—CtiGlobalCallHandle
  • RIU—RemoteInUse flag
  • DH—DeviceHandle

3XX

Application monitors B.

Table 1 3XX

Actions

CallState/CallInfo

@Referrer (A)

CallState/CallInfo

@Referree (B)

CallState/CallInfo

@Refer-to-Target (C)

A calls external phone that is running SIP, which has CFDUNC set to B

 

TSPI: LINE_APPNEWCALL

Reason = LINECALL

REASON_REDIRECT

 

Agent Greeting

Configuration

Customer Phone—IP Phone A with DN 1001.

Agent Phone—IP Phone B with DN 1002.

Agent Phone—IP Phone C with DN 1002 (shared line)

Supervisor Phone—IP Phone D with DN 1003.

IVR1—with DN 5555

IVR2—with DN 6666

Procedure

Application monitoring all lines on all devices.

New extension is negotiated when application opens lines.

SRTP is also supported at IVR side, can be variation of following use cases.

Table 2 StartSendMediaToBIB success case

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002 with 5555 and CgpnToIVR

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

 

Server-IVR call is redirected to BIB by feature

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit is set

 

Media event sent to application

(StartTransmissionEvent)

IVR1 drops call after agent greeting completes

At 1002:

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_ENDED,0,0) event

At 5555:

Call goes IDLE

Table 3 StopSendMediaToBIB success case

Action

Events, requests and responses

Agent playing is in progress…

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

 

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

 

At 5555:

CONNECTED

Calling = 5555

Called = 5555

Connected =

Application issues CCiscoLineDevSpecificStopSendMediaToBIBRequest on 1002

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_ENDED,0,0) event

At 5555:

Call goes IDLE

StopTransmissionEvent

Table 4 StartSendMediaToBIB failure while monitoring in progress at agent side

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartCallMonitoring on 1003 to monitor active call on 1002

At 1003:

CCiscoLineDevSpecificStartCallMonitoring request successful, monitoring is in session

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

At 1002:

LINE_REPLY returns with LINEERR_RESOURCEUNAVAIL

Table 5 StartSendMediaToBIB followed by monitoring request

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call redirected to BIB

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

Application issues CCiscoLineDevSpecificStartCallMonitoring on 1003 to monitor active call on 1002

At 1003:

LINE_REPLY returns with LINEERR_RESOURCEUNAVAIL

Table 6 StartSendMediaToBIB while recording is in session

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application sends CCiscoLineDevSpecificStartCallRecording to 1002

At 1002:

CCiscoLineDevSpecificStartCallRecording will be successful and recording is in session

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call redirected to BIB

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

IVR1 drops call after agent greeting completes

At 1002:

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_ENDED,0,0) event

At 5555:

Call goes IDLE

Table 7 StartSendMediaToBIB followed by recording request

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call is redirected to BIB

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

Application sends CCiscoLineDevSpecificStartCallRecording to 1002

At 1002:

CCiscoLineDevSpecificStartCallRecording will be successful and recording is in session

Table 8 StartSendMediaToBIB Failure while Barge in session

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Phone C (1002) barges in

At 1002 (device C)

Barge call is created.

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002 (B)

At 1002 (B):

LINE_REPLY with LINEERR_RESOURCEUNAVAIL

Table 9 StartSendMediaToBIB followed by Barge from shared line

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call is redirected to BIB

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

Phone C (1002 shared line) try to barge in

Barge will fail on phone C

Table 10  This behavior is also seen during consult operation. Agent Holds Call while Agent Greeting is being played

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call is redirected to BIB

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

1002 put call on hold

At 1002:

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_ENDED,0,0) event Call will go on hold

With StopReception and StopTransmission event

At 5555:

Call goes IDLE

1002 Unhold scenario

At 1002:

Call will go CONNECTED with StartTransmission and StartReception.

Table 11 Agent Redirects call while Agent Greeting is being played

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call is redirected to BIB

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

Application redirects call on 1002 to 1003

At 1003:

New call from 1002

At 1002:

Call goes IDLE

No MEDIA_TO_BIB_ENDED event

At 5555:

Call goes IDLE

Table 12 IVR1 redirects call to IVR2

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002

 

 

(CM feature creates server call to IVR 5555, 5555 answers call)

 

 

 

 

 

 

 

Server-IVR call is redirected to BIB

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

Application redirect call on IVR1 to IVR2

 

 

IVR2 answers and plays second agent greeting

At 5555:

Call goes IDLE

At 6666:

Calling =

Called = 6666

Connected = Redirecting = 5555

Redirection = 6666

CallAttributeBitMask = BIBCall

 

(StartTransmissionEvent)

IVR2 drops call after agent greeting completes

At 1002:

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_ENDED,0,0) event

At 6666:

Call goes IDLE

Table 13 Application-2 opened line after Agent Greeting is in playing

Action

Events, requests and responses

Make call from 1001 to 1002, and 1002 answers

At 1001:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1002

At 1002:

CONNECTED

Calling = 1001

Called = 1002

Connected = 1001

Application-1 issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002 with 5555 and CgpnToIVR

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call is redirected to BIB by feature

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

Application-2 opens agent line from another client

At 1002 (from application-2):

CallAttributeBitMask SendMediaToBIB will be set to indicate agent greeting is playing on the agent line.

Application 2 opens IVR line

CallAttributeBitMask = BIBCall

Table 14 Start Agent Greeting after conference is setup

Action

Events, requests and responses

Make call from 1001 to 1002, 1002 answers, 1002 sets up conference to 1003, 1003 answers, and 1002 completes

At 1001:

CONNECTED

CONFERENCED

Calling = 1001, Called = 1002, Connected = 1002

CONFERENCED

Calling = 1001, Called = 1003, Connected = 1003At 1002:

CONNECTED

CONFERENCED

Calling = 1001, Called = 1002, Connected = 1001

CONFERENCED

Calling = 1002, Called = 1003, Connected = 1003

At 1003:

CONNECTED

CONFERENCED

Calling = 1002, Called = 1003, Connected = 1002

CONFERENCED

Calling = 1003, Called = 1001, Connected = 1001

Application issues CCiscoLineDevSpecificStartSendMediaToBIBRequest on 1002 with 5555 and CgpnToIVR

 

 

(CM feature creates server call to IVR1 5555, 5555 answers call)

 

 

 

 

 

 

Server-IVR call is redirected to BIB by feature

 

 

 

 

 

 

 

IVR1 selects/plays agent’s greeting

At 1002:

the request is successful

Application receives LineCallDevSpecific (SLDSMT_MEDIA_TO_BIB_STARTED) event

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = CgpnToIVR

Called = 5555

Connected = CgpnToIVR

CallAttributeBitMask = ServerCall bit will be set

 

At 5555:

CONNECTED, dwreason = LINECALLREASON_UNKNOWN (unknown) ExtendedCallReason = CtiReasonSendMediaToBIB

Calling = 5555

Called = 5555

Connected =

CallAttributeBitMask = ServerCall bit will be set

 

Media event sent to application (StartTransmissionEvent)

 

1001 and 1002 also hears the agent greeting

Agent Zip Tone

The devices mentioned in the use cases below also apply to SIP TNP phones.

Configuration

SCCP phones: A (Customer/Remote), B (Agent/Local).

All Lines are Opened with Ext Version – 0x000B0000

Table 15 Application issues the Play Tone Request when the call is established between customer and agent. PlayToneDirection – Remote

Action

Expected events

LineInitialize.

LineOpen on A,B

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line A and B.

 

A calls B;B answers the Call

 

 

B issues LineDevSpecific (start PlayTone) request with Agent callid and ZIP Tone as input.

 

 

 

 

 

 

 

 

Zip Tone is played at A.

LINE_DEVSPECIFIC Event with dwParam1 = SLDSMT_CALL_TONE_CHANGEDdwParam2 = CTONE_ZIP, dwParam3 = 0(local) is reported on A and alsoLINE_DEVSPECIFIC Event with dwParam1 = SLDSMT_CALL_TONE_CHANGEDdwParam2 = CTONE_ZIP, dwParam3 = 1(Remote) is reported on B.

Table 16 Application issues the Play Tone Request when the call is established between customer and agent. PlayToneDirection – Local

Action

Expected events

LineInitialize.

LineOpen on A,B

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line A and B.

 

A calls B;B answers the Call

 

 

B issues LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input.

 

 

 

 

 

 

 

 

Zip Tone is played at B.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local) is fired for B indicating Zip Tone has been played on B.

Table 17 Application issues the Play Tone Request when the call is established between customer and agent. PlayToneDirection – BothLocalandRemote/NoLocalOrRemote

Action

Expected events

LineInitialize.

LineOpen on A,B

A calls B; B answers the Call

 

 

B issues LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input

 

 

 

 

LineDevSpecific (start PlayTone) request fails with error LINEERR_OPERATIONUNAVAIL.

Table 18 Application issues the Play Tone Request (with Unsupported Tone) when the call is established between customer and agent. PlayToneDirection – Local

Action

Expected events

LineInitialize.

LineOpen on A,B

A calls B; B answers the Call

 

 

B issues LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input

 

 

 

 

LineDevSpecific (start PlayTone) request fails with error LINEERR_OPERATIONFAILED.

Application issues the Play Tone request on a CTI Port with PlayToneDirection -Local/Remote

Configuration

A (Customer/Remote) is SCCP Phone.

B (Agent/local) is a CTIport/Route Point

Table 19 Application issues the Play Tone Request on a CTI port with PlayToneDirection – Local/Remote

Action

Expected events

LineInitialize.

LineOpen on A,B

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line A.

 

A calls B;B answers the Call

 

B issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input, and direction as local.

 

 

B issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input, and direction as remote.

 

 

 

 

 

 

 

 

LineDevSpecific (start PlayTone) request fails with error LINEERR_OPERATIONUNAVAIL.

 

 

Zip Tone is played at A.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local)) is fired for A indicating Zip Tone has been played on A

And also Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 1(remote) is fired for B

Application issues the Play tone request when the call is established between customer and agent (Shared Line). PlayToneDirection -Local

Configuration

SCCP phones: A (Customer/ Remote), B, B’ (Agent/Local)

Table 20 Application issues the Play Tone Request when the call is established between customer and agent (Shared Line). PlayToneDirection – Local

Action

Expected events

LineInitialize.

LineOpen on A, B, B’

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line B and B’.

 

A calls B;B and B’ starts ringing; B answers the Call

 

B issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input.

 

 

 

 

Variants:

 

B’ issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input direction remote.

 

B issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input direction remote.

 

 

 

 

 

 

A issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input direction remote.

 

 

 

 

 

 

 

 

Zip Tone is played at B.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local)) is fired for B indicating Zip Tone has been played on B.

 

There is no Zip Tone played at B’and no Zip tone notification on B’.

 

 

The LineDevSpecific (start PlayTone) request fails with Error LINEERR_OPERATIONFAILED

 

 

Zip Tone is played at A.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local))) will be fired for A also Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 1(remote) will be fired for B.

There is no Zip Tone played at B’and no Zip tone notification on B’.

 

Zip Tone is played at B and B’.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local))) is fired for B and B’ also Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 1(remote) is fired for A.

Table 21 Application Issues the Play Tone Request when the call is established between customer and agent (Intercom Line). PlayToneDirection – Local

Action

Expected events

LineInitialize.

Phone A have 2 lines: Line1 is a normal line with X, Line2 is a intercom line (B), SpeedDial DN = D

 

Phone B have 2 lines: Line1 is a normal line with Y, Line2 is a intercom line (D)

 

LineOpen on B,D

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line B, D

 

B calls D; D starts ringing; D answers the Call

 

D issues the LineDevSpecific (start PlayTone) request with agent(D) callid and ZIP Tone as input.

 

Variant 1:

 

D issues the LineDevSpecific (start PlayTone) request with agent(D) callid and ZIP Tone as input, and direction as remote.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The LineDevSpecific (start PlayTone) request fails with error LINEERR_OPERATIONUNAVAIL.

 

 

 

 

The LineDevSpecific (start PlayTone) request fails with error LINEERR_OPERATIONUNAVAIL.

Conference scenario. PlayToneDirection -local.

Configuration

A, B, and C are SCCP Phones.

Table 22 Conference scenario. PlayToneDirection – Local

Action

Expected events

LineInitialize.

LineOpen on A, B, and C

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line B.

 

A calls B; B answers the call; B sets up the conference with C; B completes the conference.

 

 

B issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input.

 

 

 

Variant 1:

 

B issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input and direction as Remote

 

 

 

 

 

 

 

 

 

Zip Tone is played at B.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local)) is fired for B indicating Zip Tone has been played on B.

 

 

The LineDevSpecific (start PlayTone) request will be Success.

But there will be no Tone played on the Coneference members.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 1(remote)) is fired for B

Application issues the Play Tone request when the call is established between customer and agent agent puts the call on Hold. PlayToneDirection -Remote.

Configuration

A and B are SCCP Phones.

Table 23 Application issues the Play Tone Request when the call is established between customer and agent, agent puts the call on Hold. PlayToneDirection – Remote

Action

Expected events

LineInitialize.

LineOpen on A,B

The CallToneChangedEvent message flag is Enabled using SLDST_SET_STATUS_MESSAGES request for Line B.

 

A calls B;B answers the Call; B puts the Call on hold

 

A issues the LineDevSpecific (start PlayTone) request with agent callid and ZIP Tone as input.

 

 

 

 

 

 

 

 

Zip Tone is played at B.

Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 1(remote)) is fired for A also Line_DevSpecific (dwparam1 = SLDSMT_CALL_TONE_CHANGED, dwParam2 = CTONE_ZIP, dwParam3 = 0(local) is fired for B.

Announcement Call

Prerequisites

Pre-conditions to all announcement call use cases, unless specified otherwise:

  • CTIRD (CTI Remote Device -Name: CTIRD-1)
    • Remote Destinations configured on CTIRD-1:
      • RD1-(Name: Mobile, Number: 914086271309)
    • Line-A (DN -1000) - Line-A configured on CTIRD-1 (shared line of Enterprise
    • DN -1000 configured on EP-1)
  • EP-1 (Enterprise Phone - SCCP -IP Phone)
    • Line-A' -DN -1000 configured on EP-1
  • Provider is opened ( lineInitializeEx successfully executed)
  • All relevant lines are opened with Extension version 0x000D0000 and in service

Persistent call has been created on A / RD-1.

Announcement with ID "WelcomeID" is defined on CUCM.



Table 24  Create Announcement Call
Action TAPI Messages TAPI Structure

Create Announcement Call:

LineMakeCall() on Line-A:

lpCallParams:

devSpecific =

Cisco_ CallParamsDevSpecific {

dwCallPriority = 0x00000000;

dwDevSpecificFlags = 0x00000004

(Cisco_ CALLPARAMS_ DEVSPECIFICFLAGS_ ANNOUNCEMENTCALL)

}

CallData = "WelcomeID"

LINE_ CALLSTATE

hDevice = hCall-2 dwParam1 = 0x40000002

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + OFFERING)

LINE_ CALLSTATE dwParam1 = 0x40000004

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + ACCEPTED)

LINE_ CALLSTATE

hDevice = hCall-2 dwParam1 = 0x40000100

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + CONNECTED)

LINE_ CALLDEVSPECIFIC

hDevice = hCall-2

dwParam1 = SLDSMT_ ANNOUNCEMENT_ STARTED

dwParam2 = 0 dwParam3 = 0

LINECALLINFO (hCall-2) dwOrigin = OUTBOUND dwReason = DIRECT CallerID = 5000

CallerIDName = RD5000 CalledID = A

ConnectedID = 5000

In DevSpecific portion:

CallAttributeType = 0x00008000 ( TSPCallAttribute_ AnnouncementCall)

LINE_ CALLDEVSPECIFIC

hDevice = hCall-2

dwParam1 = SLDSMT_ ANNOUNCEMENT_ ENDED

dwParam2 = 0 dwParam3 = 0

LINE_ CALLSTATE dwParam1

=

0x40004000

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + DIS

CONNECTED)

LINE_ CALLSTATE dwParam1 = 0x40000001

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + IDLE

)

Persistent call has been created on A / RD-1.

Announcement with ID "WelcomeID" is defined on CUCM.



Table 25  Drop Announcement Call
Action TAPI Messages TAPI Structures

Create Announcement Call:

LineMakeCall() on Line-A:

lpCallParams:

devSpecific =

Cisco_ CallParamsDevSpecific {

dwCallPriority = 0x00000000;

dwDevSpecificFlags = 0x00000004

(Cisco_ CALLPARAMS_ DEVSPECIFICFLAGS_ ANNOUNCEMENTCALL)

}

CallData = "WelcomeID"

LINE_ CALLSTATE

hDevice = hCall-2 dwParam1 = 0x40000002

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + OFFERING)

LINE_ CALLSTATE dwParam1 = 0x40000004

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + ACCEPTED)

LINE_ CALLSTATE

hDevice = hCall-2 dwParam1 = 0x40000100

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + CONNECTED)

LINE_ CALLDEVSPECIFIC

hDevice = hCall-2

dwParam1 = SLDSMT_ ANNOUNCEMENT_ STARTED

dwParam2 = 0 dwParam3 = 0

LINECALLINFO (hCall-2) dwOrigin = OUTBOUND dwReason = DIRECT CallerID = 5000

CallerIDName = RD5000 CalledID = A

ConnectedID = 5000

In DevSpecific portion:

CallAttributeType = 0x00008000 ( TSPCallAttribute_ AnnouncementCall)

Drop AnnouncementtCall:

(while announcement being played)

LineDrop() on Line-A:

LINE_ CALLDEVSPECIFIC

hDevice = hCall-2

dwParam1 = SLDSMT_ ANNOUNCEMENT_ ENDED

dwParam2 = 0 dwParam3 = 0

LINE_ CALLSTATE dwParam1 = 0x40004000 (CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + DIS CONNECTED)

LINE_ CALLSTATE dwParam1 = 0x40000001

(CLDSMT_ ANNOUNCEMENT_ CALL_ STATE + IDLE

)

Precondition: No Persistent call on CTIRD-1

Table 26  Negative -Create Announcement Call Failed / No Persistent Call
Action TAPI Messages TAPI Structures

Create Announcement Call:

LineMakeCall() on Line-A:

lpCallParams:

devSpecific =

Cisco_ CallParamsDevSpecific {

dwCallPriority = 0x00000000;

dwDevSpecificFlags = 0x00000004

(Cisco_ CALLPARAMS_ DEVSPECIFICFLAGS_ ANNOUNCEMENTCALL)

}

CallData = "WelcomeID"

LINE_ REPLY

LINEERR_ NO_ PERSISTENT_ CALL_ EXISTS (0xC0000021)

Blind Transfer

The following table describes the message sequences for Blind Transfer when A calls B, B answers, and A and B are connected.

Table 27 Message sequences for Blind Transfer

Action

CTI messages

TAPI messages

TAPI structures

Party B does a lineBlindTranfser() to blind transfer call from party A to party C

Party A

CallPartyInfoChangedEvent,

CH = C1,

CallingChanged = False,

Calling = A,

CalledChanged = True,

Called = C,

OriginalCalled = B,

LR = B,

Cause = BlindTransfer

LINE_CALLINFO

hDevice = hCall-1

dwCallbackInstance = 0

dwParam1 = CONNECTEDID, REDIRECTINGID, REDIRECTIONID

TSPI LINECALLINFO

dwOrigin = OUTBOUND

dwReason = DIRECT

dwCallerID = A

dwCalledID = B

dwConnectedID = NULL

dwRedirectingID = NP

dwRedirectionID = NP

Party B

CallStateChangedEvent,

CH = C2,

State = Idle,

Reason = Direct,

Calling = A,

Called = B,

OriginalCalled = B,

LR = NULL

TSPI: LINE_CALLSTATE

|hDevice = hCall-1

dwCallbackInstance = 0

dwParam1 = IDLE

dwParam2 = 0

dwParam3 = 0

TSPI LINECALLINFO

dwOrigin = INTERNAL

dwReason = DIRECT

dwCallerID = A

dwCalledID = B

dwConnectedID = NULL

dwRedirectingID = NULL

dwRedirectionID = NULL

Party C

NewCallEvent,

CH = C3,

origin = Internal_Inbound,

Reason = BlindTransfer,

Calling = A,

Called = C,

OriginalCalled = B,

LR = B

TSPI: LINE_APPNEWCALL hDevice = C

dwCallbackInstance = 0

dwParam1 = 0

dwParam2 = hCall-1

dwParam3 = OWNER

TSPI LINECALLINFO

dwOrigin = INTERNAL

dwReason = TRANSFER

dwCallerID = A

dwCalledID = C

dwConnectedID = NULL

dwRedirectingID = B

dwRedirectionID = C

Party A

CallStateChangeEvent,

CH = C1,

State = Ringback,

Reason = Direct,

Calling = A,

Called = C,

OriginalCalled = B,

LR = B

TSPI: LINE_CALLSTATE, hDevice = hCall-1, dwCallbackInstance = 0, dwParam1 = RINGBACK dwParam2 = 0

dwParam3 = 0

TSPI LINECALLINFO

dwOrigin = OUTBOUND

dwReason = DIRECT

dwCallerID = A

dwCalledID = B

dwConnectedID = NULL

dwRedirectingID = B

dwRedirectionID = C

Party C

CallStateChangedEvent,

CH = C3,

State = Offering,

Reason = BlindTransfer,

Calling = A,

Called = C,

OriginalCalled = B, LR = B

TSPI: LINE_CALLSTATE, hDevice = hCall-1, dwCallbackInstance = 0, dwParam1 = OFFERING dwParam2 = 0

dwParam3 = 0

TSPI LINECALLINFO

dwOrigin = INTERNAL

dwCallerID = A

dwCalledID = C

dwConnectedID = NULL

dwRedirectingID = B

dwRedirectionID = C

Call Control Discovery

Basic Call initiated from TAPI from phone A on cluster 1 to phone B on cluster2

Configuration

SCCP phone A(1900) are registered to cluster A

Phones A are associated with the end-user cluster1

SCCP phone B(1000) registered to cluster B

Phones B are associated with the end-user cluster2

CUCM learns a pattern 10XX, plus PSTN failover rule as 0:1408972 from SAF network. TAPI is observing A.

Procedure

Application monitors A

Application sends a lineMakeCall at A to call B

Action

CTI messages

TAPI messages

A dials 1000, this call first will be intercepted by CCD Requesting Feature, and CCD Requesting feature will extend this call to SIP trunk

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

CallerID = A / CalledID = ""

SIP trunk rejects this call due to no more bandwidth available

A receives CallStateChangeEvent (PROCEEDING)

LineA: LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)/ LINE_CALLINFO

CallReason = LINECALLREASON_DIRECT

CallerID = A / CalledID = 1000 / ConnectedID = / RedirectingID = / RedirectionID =

CCD Requesting feature will start PSTN failover by directing this caller to 1000’s PSTN failover number, that is, 14089721000. Call is sent out to a PSTN GW

 

 

CCD Requesting feature will start PSTN failover by directing this caller to 1000’s PSTN failover number, that is, 14089721000. Call is sent out to a PSTN GW

A receives CPIC and CallStateChangeEvent (Ringback/connected)

Provide TSPI_LinegetcallInfo on A connected with B

A:CPIC event received on party A

LineA: LINE_CALLSTATE (LINECALLSTATE_RINGBACK / LINECALLSTATE_CONNECTED)

 

CallReason = LINECALLREASON_DIRECT

 

LINECALLINFO.dwCallID = 0x00400BBA

LINECALLINFO.dwOrigin = 0x00000001

LINECALLINFO.dwReason = 0x00000001

LINECALLINFO.dwCallerID = 1900(A)

LINECALLINFO.dwCallerIDName =

LINECALLINFO.dwCalledID = 1000:

LINECALLINFO.dwCalledIDName = CCD Pattern

LINECALLINFO.dwConnectedID = 1000(B)

LINECALLINFO.dwConnectedIDName =

LINECALLINFO.dwRedirectionID = 1000

LINECALLINFO.dwRedirectionIDName =

LINECALLINFO.dwRedirectingID = 1000

LINECALLINFO.dwRedirectingIDName = CCD Pattern

ExtendCallReason = CtiReasonSAF_CCD_PSTNFailover(2B)

Basic Call initiated from TAPI from phone A on cluster 1 to phone B on cluster2 with PSTN Failover Rule not set

Configuration

SCCP phone A are registered to cluster A.

Phones A are associated with the end-user "cluster1".

SCCP phone B(1000) registered to cluster B.

Phones B are associated with the end-user "cluster2".

CUCM learns a pattern 10XX, plus PSTN failover rule as 0:1408972 from SAF network is not set.

Procedure

Application monitors A.

Application sends a lineMakeCall at A to call B.

Action

CTI messages

TAPI messages

A dials 1000, this call first will be intercepted by CCD Requesting Feature, and CCD Requesting feature will extend this call to SIP trunk

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

 

CallerID = A / CalledID = ""

SIP trunk rejects this call due to lack of bandwidth

A receives CallStateChangeEvent (PROCEEDING)

A:A receives CPIC event

LineA: LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)/ LINE_CALLINFO

CallReason = LINECALLREASON_DIRECT

 

CallerID = A / CalledID = 1000 / ConnectedID = / RedirectingID = / RedirectionID =

 

A receives CallStateChangeEvent (disconnected)

LineA: LINE_CALLSTATE (LINECALLSTATE_Disconnected)

 

EVENT = LINE_CALLSTATE = 2

m_lpfnEventProc = 0xXXX

m_htLine = 0x000XXXX

htCall = 0x000XXX

 

Provide TSPI_linegetcallinfo on the Disconnected call

dwParam1 = 0x00004000(LINECALLSTATE_DISCONNECTED)

dwParam2 = 0x00200000(LINEDISCONNECTMODE_SAFCCD)

dwParam3 = 0x00000004

 

LINECALLINFO.dwCallID = 0x00400BCF

LINECALLINFO.dwOrigin = 0x00000001

LINECALLINFO.dwReason = 0x00000001

LINECALLINFO.dwCallerID = 1900

LINECALLINFO.dwCallerIDName =

LINECALLINFO.dwCalledID = 10XX:

LINECALLINFO.dwCalledIDName = CCD Pattern

LINECALLINFO.dwConnectedID =

LINECALLINFO.dwConnectedIDName =

LINECALLINFO.dwRedirectionID = 1000:

LINECALLINFO.dwRedirectionIDName = CCD Pattern

LINECALLINFO.dwRedirectingID = 1000:

LINECALLINFO.dwRedirectingIDName = CCD Pattern

 

ExtendCallReason = CtiReasonSAF_CCD_PSTNFailover

Basic Call initiated from TAPI from phone A(1900) and B(1901) on cluster 1 B redirects to phone C(1000) on cluster2 with PSTN Failover Rule set

Configuration

SCCP phone A and B are registered to cluster A.

Phones A and B are associated with the end-user cluster1.

SCCP phone C(1000) registered to cluster B.

Phones C are associated with the end-user cluster2.

CUCM learns a pattern 10XX, plus PSTN failover rule as 0:1408972 from SAF network.

Procedure

Application monitors A and B.

Application sends a lineMakeCall at A to call B

Table 28 Basic Call initiated from TAPI from phone A(1900) and B(1901) on cluster 1, B redirects to phone C(1000) on cluster2 with PSTN Failover Rule set

Action

CTI messages

TAPI messages

A dials B

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing/Proceeding /ringback/connected).

 

 

 

B receives NewCallEvent and CallStateChangeEvent (offering/ringing/ connected).

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING, LINECALLSTATE_CONNECTED,)

 

CallerID = A / CalledID = B

 

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_OFFERING/ LINECALLSTATE_RINGING, LINECALLSTATE_CONNECTED)

CallerID = A / CalledID = B

B setsupconference, consult call to C(1000), this call first will be intercepted by CCD Requesting Feature, and CCD Requesting feature will extend this call to SIP trunk

SIP trunk rejects this call due to no more bandwidth available

CCD Requesting feature will start PSTN failover by directing this caller to 1000's PSTN failover number, i.e. 14089721000. Call is sent out to a PSTN GW

TSPI_linegetcallinfo on the consult call between B and C.

 

 

 

 

 

 

 

B completes conference.

 

 

 

 

 

 

 

 

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

B: receives CPIC event

LineB: LINE_CALLSTATE (LINECALLSTATE_RINGBACK / LINECALLSTATE_CONNECTED)

 

ExtendCallReason = CtiReasonSAF_CCD_PSTNFailover

 

 

 

A, B and C are in conference.

Basic Call initiated from TAPI from phone A and B on cluster 1 B transfers to phone C(1000) on cluster 2 with PSTN Failover Rule

Configuration

SCCP phone A and B are registered to cluster A.

Phones A(1900) and B(1901) are associated with the end-user cluster1.

SCCP phone C(1000) registered to cluster B.

Phones C are associated with the end-user cluster2.

CUCM learns a pattern 10XX, plus PSTN failover rule as 0:1408972 from SAF network.

Procedure

Application monitors A and B.

Application sends a lineMakeCall at A to call B.

Table 29 Basic Call initiated from TAPI from phone A and B on cluster 1, B transfers to phone C(1000) on cluster 2 with PSTN Failover Rule

Action

CTI messages

TAPI messages

A(1900) dials B(1901)

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing/Proceeding /ringback/connected).

 

 

 

B receives NewCallEvent and CallStateChangeEvent (offering/ringing/ connected)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING, LINECALLSTATE_CONNECTED,)

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_OFFERING/ LINECALLSTATE_RINGING, LINECALLSTATE_CONNECTED)

B(1901) setups transfer to C(1000)

This call first will be intercepted by CCD Requesting Feature, and CCD Requesting feature will extend this call to SIP trunk

SIP trunk rejects this call due to no more bandwidth available

CCD Requesting feature will start PSTN failover by directing this caller to 1000’s PSTN failover number, i.e. 14089721000. Call is sent out to a PSTN GW.

 

 

 

TSPI_linegetcallinfo on Consult call on B with C.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

B completes transfer

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

 

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

 

LINECALLINFO.dwCallID = 0x00400BBA

LINECALLINFO.dwOrigin = 0x00000001

LINECALLINFO.dwReason = 0x00000001

LINECALLINFO.dwCallerID = 1901(B)

LINECALLINFO.dwCallerIDName =

LINECALLINFO.dwCalledID = 1000:

LINECALLINFO.dwCalledIDName = CCD Pattern

LINECALLINFO.dwConnectedID = 1000(C)

LINECALLINFO.dwConnectedIDName =

LINECALLINFO.dwRedirectionID = 1000

LINECALLINFO.dwRedirectionIDName =

LINECALLINFO.dwRedirectingID = 1000

LINECALLINFO.dwRedirectingIDName = CCD Pattern

Extendedcallreason = CtiReasonSAF_CCD_PSTNFailover

B:

LINE_CALLSTATE (LINECALLSTATE_DISCONNECTED)

ExtendCallReason = CtiReasonTransferredCall

 

Call initiated from TAPI from phone A and B on cluster 1 B sets up conference to phone C(1000) on cluster 2 with PSTN Failover Rule

Configuration

SCCP phone A and B are registered to cluster A

Phones A(1900) and B(1901) are associated with the end-user cluster1

SCCP phone C(1000) registered to cluster B

Phones C are associated with the end-user cluster2

CUCM learns a pattern 10XX, plus PSTN failover rule as 0:1408972 from SAF network

Procedure

Application monitors A and B

Application sends a lineMakeCall at A to call B

Table 30 Call initiated from TAPI from phone A and B on cluster 1, B sets up conference to phone C(1000) on cluster 2 with PSTN Failover Rule

Action

CTI messages

TAPI messages

A dials B

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing/Proceeding /ringback/connected)

 

 

 

 

B receives NewCallEvent and CallStateChangeEvent (offering/ringing/ connected)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING, LINECALLSTATE_CONNECTED,)

 

CallerID = A / CalledID = B

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_OFFERING/ LINECALLSTATE_RINGING, LINECALLSTATE_CONNECTED)

 

CallerID = A / CalledID = B

B setsupconference, consult call to C(1000), this call first will be intercepted by CCD Requesting Feature, and CCD Requesting feature will extend this call to SIP trunk

SIP trunk rejects this call due to no more bandwidth available

CCD Requesting feature will start PSTN failover by directing this caller to 1000’s PSTN failover number, that is, 14089721000. Call is sent out to a PSTN GW

TSPI_linegetcallinfo on the consult call between B and C

 

 

 

 

 

 

 

 

B completes conference

 

 

 

 

 

 

 

 

 

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

B: receives CPIC event

LineB: LINE_CALLSTATE (LINECALLSTATE_RINGBACK / LINECALLSTATE_CONNECTED)

 

ExtendCallReason = CtiReasonSAF_CCD_PSTNFailover

A, B and C are in conference

 

Basic Call initiated from TAPI from phone A on cluster 1 to phone B on cluster 2 over SAF trunk

Configuration

SCCP phone A(1900) are registered to cluster A

Phones A are associated with the end-user cluster1

SCCP phone B(1000) registered to cluster B

Phones B are associated with the end-user cluster2

CUCM learns a pattern 10XX, no PSTN failover rule as SAF network has unlimited Bandwidth, TAPI is observing A

Procedure

Application monitors A

Application sends a lineMakeCall at A to call B

Table 31 Basic Call initiated from TAPI from phone A on cluster 1 to phone B on cluster 2 over SAF trunk

Action

CTI messages

TAPI messages

A dials 1000

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING)

 

CallerID = A / CalledID = ""

 

A receives CallStateChangeEvent (PROCEEDING)

LineA: LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)/ LINE_CALLINFO

CallReason = LINECALLREASON_DIRECT

 

CallerID = A / CalledID = 1000 / ConnectedID = / RedirectingID = / RedirectionID =

 

A receives CallStateChangeEvent (Ringback/connected)

A:CPIC event received on party A

LineA: LINE_CALLSTATE (LINECALLSTATE_RINGBACK / LINECALLSTATE_CONNECTED)

 

CallReason = LINECALLREASON_DIRECT

 

CallerID = A / CalledID = 1000 / ConnectedID = 1000 / RedirectingID = 1000 / RedirectionID = 1000

LINECALLINFO.dwCallID = 0x00400FB1

LINECALLINFO.dwOrigin = 0x00000001

LINECALLINFO.dwReason = 0x00000001

LINECALLINFO.dwCallerID = 1900

LINECALLINFO.dwCallerIDName =

LINECALLINFO.dwCalledID = 1000:

LINECALLINFO.dwCalledIDName = CCD Pattern

LINECALLINFO.dwConnectedID = 1000

LINECALLINFO.dwConnectedIDName =

LINECALLINFO.dwRedirectionID = 1000

LINECALLINFO.dwRedirectionIDName =

LINECALLINFO.dwRedirectingID = 1000:

LINECALLINFO.dwRedirectingIDName = CCD Pattern

Basic Call initiated from TAPI from phone A and B on cluster 1 B redirects to phone C(1000) on cluster 2 over SAF trunk

Configuration

SCCP phone A and B are registered to cluster A

Phones A and B are associated with the end-user cluster1

SCCP phone C(1000) registered to cluster B

Phones C are associated with the end-user cluster2

CUCM learns a pattern 10XX, from SAF network as unlimited Bandwidth

Procedure

Application monitors A and B

Application sends a lineMakeCall at A to call B

Table 32 Basic Call initiated from TAPI from phone A and B on cluster 1, B redirects to phone C(1000) on cluster 2 over SAF trunk

Action

CTI messages

TAPI messages

A dials B

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing/Proceeding /ringback/connected)

 

 

B receives NewCallEvent and CallStateChangeEvent (offering/ringing/ connected)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING, LINECALLSTATE_CONNECTED,)

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_OFFERING/ LINECALLSTATE_RINGING, LINECALLSTATE_CONNECTED)

B redirects call to 1000 over ICT trunk

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

TSPI_linegetcallinfo on A

 

 

 

 

 

A receives CallStateChangeEvent (Connected)

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DISCONNECTED)

ExtendCallReason = CtiReasonRedirect

A:CPIC event received on A

LineA: LINE_CALLSTATE (LINECALLSTATE_RINGBACK)

LineA: LINE_CALLSTATE (LINECALLSTATE_CONNECTED)/ LINE_CALLINFO

CallReason = LINECALLREASON_DIRECT

LINECALLINFO.dwCallID = 0x00400FB2

LINECALLINFO.dwOrigin = 0x00000001

LINECALLINFO.dwReason = 0x00000001

LINECALLINFO.dwCallerID = 1900

LINECALLINFO.dwCallerIDName =

LINECALLINFO.dwCalledID = 1901

LINECALLINFO.dwCalledIDName =

LINECALLINFO.dwConnectedID = 1000

LINECALLINFO.dwConnectedIDName =

LINECALLINFO.dwRedirectionID = 1000

LINECALLINFO.dwRedirectionIDName =

LINECALLINFO.dwRedirectingID = 1901

LINECALLINFO.dwRedirectingIDName =

 

ExtendCallReason = CtiReasonRedirect

Basic Call initiated from TAPI from phone A and B on cluster 1 B transfers to phone C(1000) on cluster 2 over SAF trunk

Configuration

SCCP phone A and B are registered to cluster A

Phones A and B are associated with the end-user cluster1

SCCP phone C(1000) registered to cluster B

Phones C are associated with the end-user cluster2

CUCM learns a pattern 10XX, plus PSTN failover rule as 0:1408972 from SAF network, SAF network has unlimited bandwidth.

Procedure

Application monitors A and B

Application sends a lineMakeCall at A to call B

Table 33 Basic Call initiated from TAPI from phone A and B on cluster 1, B transfers to phone C(1000) on cluster 2 over SAF trunk

Action

CTI messages

TAPI messages

A calls B

A receives NewCallEvent and CallStateChangeEvent (Dialtone/Dialing/Proceeding /ringback/connected)

 

 

B receives NewCallEvent and CallStateChangeEvent (offering/ringing/ connected)

A:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING, LINECALLSTATE_CONNECTED,)

 

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_OFFERING/ LINECALLSTATE_RINGING, LINECALLSTATE_CONNECTED)

B setup transfers to C(1000), through the ICT(SAF) trunk

 

 

 

 

 

 

 

 

 

Complete transfer on B

 

 

 

TSPI_linegetcallinfo on disconnected call on B

 

 

 

 

 

 

B: receives CPIC event

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DIALTONE/ LINECALLSTATE_DIALING/Proceeding)

 

LineB: LINE_CALLSTATE (LINECALLSTATE_RINGBACK / LINECALLSTATE_CONNECTED)

 

CallReason = LINECALLREASON_DIRECT

B:

LINE_APPNEWCALL, LINE_CALLSTATE (LINECALLSTATE_DISCONNECTED)

 

ExtendCallReason = CtiReasonTransferredCall

TSPI_linegetcallinfo on A

A receives CallStateChangeEvent (Connected)

A:

LineA: LINE_CALLSTATE (LINECALLSTATE_CONNECTED)/ LINE_CALLINFO

CallReason = LINECALLREASON_DIRECT

LINECALLINFO.dwCallID = 0x00400FB4

LINECALLINFO.dwOrigin = 0x00000001

LINECALLINFO.dwReason = 0x00000001

LINECALLINFO.dwCallerID = 1000

LINECALLINFO.dwCallerIDName =

LINECALLINFO.dwCalledID = 1901

LINECALLINFO.dwCalledIDName =

LINECALLINFO.dwConnectedID = 1000

LINECALLINFO.dwConnectedIDName =

LINECALLINFO.dwRedirectionID = 1900

LINECALLINFO.dwRedirectionIDName =

LINECALLINFO.dwRedirectingID = 1901

LINECALLINFO.dwRedirectingIDName =

ExtendCallReason = CtiReasonTransferredCall

CallFwdAll notification

This section describes the CallFwdAll Notification usecases.

Application pressed CFwdAll on TAPI monitored device

Application opens the line with new ExtVersion 0x000A0000. User presses CFwdAll softkey on A when device is in on-hook condition.

Action

CTI events

Expected results

LineInitialize

LineOpen on A with new ExtVesrion 0x000A0000

 

 

User presses CFwdAll softkey

NewCallEvent received for A

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask 0x00000040

TAPI monitored device goes off hook

Application opens the line with new ExtVersion 0x000A0000. Device goes off hook.

Action

CTI events

Expected results

LineInitialize

LineOpen on A with new ExtVesrion 0x000A0000

 

 

A goes off-hook

NewCallEvent received for A

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000000

Application monitors off hook device

Device goes off hook. Application does a LineInitialize and opens line A with new ExtVersion 0x000A0000

Action

CTI events

Expected results

Device goes offhook

 

 

LineInitialize

LineOpen on A with new ExtVesrion 0x000A0000

ExistingCallEvent received at A

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallType 00000000

Application monitors device after user presses CFwdAll

User presses CFwdAll softkey on the device. Application does a LineInitialize and opens line A with new ExtVersion 0x000A0000.

Action

CTI events

Expected results

User presses CFwdAll softkey on the device

 

 

LineInitialize

LineOpen on A with new ExtVesrion 0x000A0000

ExistingCallEvent received for A

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000040

User presses CFwdAll Softkey after device is off hook

TAPI application does a LineInitialize and opens line A with new ExtVersion 0x000A0000. Device goes off hook and user presses CFwdAll softkey.

Action

CTI events

Expected results

LineInitialize

LineOpen on A with new ExtVesrion 0x000A0000

ExistingCallEvent received for A

 

A goes off-hook

User presses CFwdAll softkey

NewCallEvent received for A

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000040

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000000

User presspresses CFwdAll Softkey on a multiline device

TAPI application does LineInitialize and opens all lines-A1 and A2 for the device with new ExtVersion 0x000A0000. User presses the CFwdAll softkey.

Action

CTI events

Expected results

LineInitialize

LineOpen on A1,

LineOPen on A2 with new ExtVesrion 0x000A0000

 

 

User presses CFwdAll softkey

NewCallEvent received for A1

 

LineGetCallInfo on A1

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000040

User presses CFwdAll on a multiline device by selecting a line

TAPI application does a LineInitialize and opens all lines-A1 and A2 for the device with new ExtVersion 0x000A0000. User selects line A2 and presses CFwdAll softkey.

Action

CTI events

Expected results

LineInitialize

LineOpen on A1,

LineOPen on A2 with new ExtVesrion 0x000A0000

 

 

User selects line A2 and presses CFwdAll softkey

NewCallEvent received for A1

 

LineGetCallInfo on A2

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000000

Shared Line scenario on pressing CFwdAll Softkey

TAPI application does a LineInitialize and opens a shared line A with new ExtVersion 0x000A0000 on devices P and Q. User presses CFwdAll softkey on device P.

Action

CTI events

Expected results

LineInitialize

LineOpen on A

LineOpen on A’ with new ExtVesrion 0x000A0000

 

 

On device P, user presses ‘CFwdAll’ softkey

NewCallEvent received at A

NewCallEvent received at A’ for RIU call

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000040

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000000

Cancellation of CFwdAll

TAPI application does a LineInitialize and open line A with new ExtVersion 0x000A0000. User sets CFwdAll for line A by pressing CFwdAll softkey followed by CallFwdAll destination number.

Later, user presses ‘CFwdAll’ softkey again to cancel CFwdAll setting.

Action

CTI events

Expected results

LineInitialize

LineOpen on A with new ExtVesrion 0x000A0000

 

 

User presses CFwdAll and enters FwdAll destination

NewCallEvent received for A

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000040

User again presses ‘CFwdAll’ softkey

NewCallEvent received for A

 

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain CallAttributeBitMask : 0x00000080

Calling Party IP address

Basic Call

TAPI application monitors party B

Party A represents an IP phone

A calls B

IP Address of A is available to TAPI application that is monitoring party B

Consultation Transfer

TAPI application monitors party C

Party B represents an IP phone

A talks to B

B initiates a consultation transfer call to C

IP Address of B is available to TAPI application that is monitoring party C.

B Completes the transfer

Calling IP address of A is not available to TAPI application that is monitoring party C (not a supported scenario).

Consultation Conference

TAPI application monitors party C

Party B represents an IP phone

A talks to B

B initiates a consultation conference call to C

IP Address of B is available to TAPI application that is monitoring party C.

B Completes the conference

Calling IP address of A and B is not available to TAPI application that is monitoring party C (not a supported scenario)

Redirect

TAPI application monitors party B and party C

Party A represents an IP phone

A calls B

IP Address of A is available to TAPI application that is monitoring party B

Party A redirects B to party C

Calling IP address is not available to TAPI application that is monitoring party B (not a supported scenario)

Calling IP address B is available to TAPI application that is monitoring party C

Calling Party normalization

Incoming call from PSTN to End Point

Action

CTI messages

TAPI messages

TAPI structures

A Call gets offered from a PSTN number 5551212/<SUBSCRIBER> through a San Jose gateway to a CCM end point 2000

CallStateChangedEvent, UnModified Calling Party = 5551212, UnModified Called Party = 2000, UnModified Original Called Party = 2000, Modified Calling Party = 5551212, Modified Called Party = 2000, Modified Original Called Party = 2000, Globalized Calling party = +14085551212, Calling Party Number Type = SUBSCRIBER, Called Party Number Type = UNKNOWN, Original Called Party Number Type, = UNKNOWN State = Connected, Origin = OutBound, Reason = Direct

LINE_CALLSTATE = CONNECTED

LINECALLINFO

Displayed Calling Party = 5551212, Displayed Called Party = 2000, Displayed Redirection Party = , Displayed Redirected Party = , Globalized Calling Party = +14085551212, Calling Party Number Type = SUBSCRIBER, Called Party Number Type = UNKNOWN, Redirection Party Number Type = , Redirecting Party Number Type =

Incoming call from National PSTN to CTI-Observed End Point

Action

CTI messages

TAPI messages

TAPI structures

A Call gets offered from a Dallas PSTN number 5551212/<NATIONAL> through a San Jose gateway to a CCM end point 2000

CallStateChangedEvent, UnModified Calling Party = 9725551212, UnModified Called Party = 2000, UnModified Original Called Party = 2000, Modified Calling Party = 9725551212, Modified Called Party = 2000, Modified Original Called Party = 2000, Globalized Calling party = +19725551212, Calling Party Number Type = NATIONAL, Called Party Number Type = UNKNOWN, Original Called Party Number Type, = UNKNOWN State = Connected, Origin = OutBound, Reason = Direct

LINE_CALLSTATE = CONNECTED

LINECALLINFO

Displayed Calling Party = 9725551212, Displayed Called Party = 2000, Displayed Redirection Party = , Displayed Redirected Party = , Globalized Calling Party = +19725551212, Calling Party Number Type = NATIONAL, Called Party Number Type = UNKNOWN, Redirection Party Number Type = , Redirecting Party Number Type =

Incoming call from International PSTN to CTI-Observed End Point

Action

CTI messages

TAPI messages

TAPI structures

A Call gets offered from a PSTN number in India 22221111/<INTERNATIONAL> through a San Jose gateway to a CCM end point 2000

CallStateChangedEvent, UnModified Calling Party = 011914422221111, UnModified Called Party = 2000, UnModified Original Called Party = 2000, Modified Calling Party = 011914422221111, Modified Called Party = 2000, Modified Original Called Party = 2000, Globalized Calling party = +914422221111, Calling Party Number Type = INTERNATIONAL, Called Party Number Type = UNKNOWN, Original Called Party Number Type, = UNKNOWN State = Connected, Origin = OutBound, Reason = Direct

LINE_CALLSTATE = CONNECTED

LINECALLINFO

Displayed Calling Party = 011914422221111, Displayed Called Party = 2000, Displayed Redirection Party = , Displayed Redirected Party = , Globalized Calling Party = +914422221111, Calling Party Number Type = INTERNATIONAL, Called Party Number Type = UNKNOWN, Redirection Party Number Type = , Redirecting Party Number Type =

Outgoing call from CTI-Observed End Point to PSTN Number

Action

CTI messages

TAPI messages

TAPI structures

A Call gets initiated from a CCM end point 2000 through a San Jose gateway to a PSTN number 5551212/<NATIONAL>

CallStateChangedEvent, UnModified Calling Party = 2000, UnModified Called Party = 5551212, UnModified Original Called Party = 5551212, Modified Calling Party = 2000, Modified Called Party = 5551212, Modified Original Called Party = 5551212, Globalized Calling party = +14085551212, Calling Party Number Type = UNKNOWN, Called Party Number Type = SUBSCRIBER, Original Called Party Number Type, = SUBSCRIBER State = Connected, Origin = OutBound, Reason = Direct

LINE_CALLSTATE = CONNECTED

LINECALLINFO

Displayed Calling Party = 2000, Displayed Called Party = 5551212, Displayed Redirection Party = , Displayed Redirected Party = , Globalized Calling Party = +14085551212, Calling Party Number Type = UNKNOWN, Called Party Number Type = SUBSCRIBER, Redirection Party Number Type = , Redirecting Party Number Type =

Outgoing call from CTI-Observed End Point to National PSTN Number

Action

CTI messages

TAPI messages

TAPI structures

A Call gets initiated from a CCM end point 2000 through a San Jose gateway to a Dallas PSTN number 9725551212/<NATIONAL>

CallStateChangedEvent, UnModified Calling Party = 2000, UnModified Called Party = 9725551212, UnModified Original Called Party = 9725551212, Modified Calling Party = 2000, Modified Called Party = 9725551212, Modified Original Called Party = 9725551212, Globalized Calling party = +19725551212, Calling Party Number Type = UNKNOWN, Called Party Number Type = NATIONAL, Original Called Party Number Type, = NATIONAL State = Connected, Origin = OutBound, Reason = Direct

LINE_CALLSTATE = CONNECTED

LINECALLINFO

Displayed Calling Party = 2000, Displayed Called Party = 9725551212, Displayed Redirection Party = , Displayed Redirected Party = , Globalized Calling Party = +19725551212, Calling Party Number Type = UNKNOWN, Called Party Number Type = NATIONAL, Redirection Party Number Type = , Redirecting Party Number Type =

Outgoing call from CTI-Observed End Point to International PSTN Number

Action

CTI messages

TAPI messages

TAPI structures

A Call gets initiated from a CCM end point 2000 through a San Jose gateway to a PSTN number in India 914422221111/<INTERNATIONAL>

CallStateChangedEvent, UnModified Calling Party = 2000, UnModified Called Party = 011914422221111, UnModified Original Called Party = 011914422221111, Modified Calling Party = 2000, Modified Called Party = 011914422221111, Modified Original Called Party = 011914422221111, Globalized Calling party = +914422221111, Calling Party Number Type = UNKNOWN, Called Party Number Type = INTERNATIONAL, Original Called Party Number Type, = INTERNATIONAL State = Connected, Origin = OutBound, Reason = Direct

LINE_CALLSTATE = CONNECTED

LINECALLINFO

Displayed Calling Party = 2000, Displayed Called Party = 011914422221111, Displayed Redirection Party = , Displayed Redirected Party = , Globalized Calling Party = +914422221111, Calling Party Number Type = UNKNOWN, Called Party Number Type = INTERNATIONAL, Redirection Party Number Type = , Redirecting Party Number Type =

Call PickUp

Registering CallPickUpGroup for notification

Configuration

Service parameter "Auto Call Pickup Enabled" is enabled.

Devices/Lines: 1000:P1,1001:P1.1002:P1,4000:P1 and 4001:P1

Pickup group P1:1111 is configured

P1:1000, P1:1001, P1:1002 are all in pickup group P1:1111

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen for P1:1111

LineOpenSuccessful

LineInService Event as well

LineInfo

DN and Partition information will be pickup Group DN and partition.

LineName – "CtiCallPickupDevice"

LineType -LINEDEVCAPSDEVSPECIFIC_PICKUPDN -0x00000004

UnRegistering CallPickUpGroup for notification

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen for P1:1111

Line Open Successful

Application sends CciscoLineDevSpecificUnRegisterCallPickupGroupForNotification on new line opened for PickUpGroup P1:1111

Line_Reply with success.

LINE_REMOVE event will be sent to Application for P1:1111

Re-Registering CallPickUpGroup for notification

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen for P1:1111

Line Open Successful

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with Error "LINEERR_OPERATIONUNAVAIL"

Variant : Test the Same with UnRegister

 

Registering/UnRegistering CallPickUpGroup for notification with invalid information

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with InValid DN or Partition

Line_Reply with Error Code "LINEERR_OPERATIONFAILED"

Variant : Test the Same with UnRegister

 

CallPickUp after enabling Auto Call Pickup enabled

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen for P1:1111

Line Open Successful

P1:4000 calls P1:1002

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

LineGetCallInfo on new call on P1:1111

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4000

dwCalledID : 1002

dwCallorigin : Outbound

dwCallReason : Direct

Check for all fields of Calling and Called Information

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with CallPickup option on P1:1000

Events on P1:1000:

LINE_NEWCALL and

LINE_CALLSTATE with state = LINECALLSTATE_CONNECTED

Call Info :

Caller = 4000, Called = 1002, Connected = 4000, dwReason = Direct, dwOrigin = Internal.

Note   

There is no notification at P1:1111 after the call has been pickup.

Varaint : P1:4000 calls P1:1002 and P1:4001 calls P1:1002

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with CallPickup option on P1:1000

First incoming Call will be picked up

(i.e call from 4000 will be picked up by 1000)

CallPickUp with Auto Call Pickup enabled disabled

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

LineGetCallInfo

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4000

dwCalledID : 1002

dwCallorigin: Internal

dwCallReason : Direct

Check for all fields of Calling and Called Information

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with CallPickup option on P1:1000

Events on P1:1000:

Call 1:

LINE_NEWCALL and

LINE_CALLSTATE with state =

LINECALLSTATE_IDLE

Note   

First call will go IDLE state after Proceeding state.

Call2:

LINE_NEWCALL and

LINE_CALLSTATE with state =

LINECALLSTATE_OFFERING

Once the call is Answered

LINE_CALLSTATE with state = LINECALLSTATE_CONNECTED

Call Info :

Caller = 4000, Called = 1002, Connected = 4000, dwReason = PickUp, dwOrigin = Outbound

 

Note   

There is no notification at P1:1111 after the call has been pickup.

Varaint : Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with CallPickup option on P1:1002

CallPickup Request will be successful and the newcall will be created and the call will be in Offering state

CallPickUp with Multiple Calls available

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

Call1:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

P1:4001 calls P1:1001

Call 2:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

LineGetCallInfo on Call

 

 

 

 

 

 

LineGetCallInfo on Call2

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4000

dwCalledID : 1002

dwCallorigin: Internal

dwCallReason : Direct

Check for all fields of Calling and Called Information

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4001

dwCalledID : 1001

dwCallorigin: Internal

dwCallReason : Direct

Check for all fields of Calling and Called Information

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with CallPickup option on P1:1000

Events on P1:1000:

Call 3:

LINE_NEWCALL and

LINE_CALLSTATE with state = LINECALLSTATE_CONNECTED

Call Info :

Caller = 4000, Called = 1002, Connected = 4000, dwReason = Direct, dwOrigin = Internal

Note   

There is no notification at P1:1111 after the call has been pickup.

CallPickupGroup changed for a device on AdminPage

Pickup group P1:9999 is configured

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on 1000:P1

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

Now from Admin page change the CallPickupGroup of 1000:P1 line to None or some other group P1:9999

LineGetDevCaps with Extension Version – 000A0000 on 1000:P1

Changed CallPickUp Group DN and Partition Information will be sent to application

CallPickUpGroup Partition or DN information updated

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on 1000:P1

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

LineGetCallInfo

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4000

dwCalledID : 1002

dwCallorigin: Internal

dwCallReason : Direct

Check for all fields of Calling and Called Information

Now From Admin Pages change the Partition or DN information of the Pickup Group

LINE_REMOVE for the line P1:1111

LineGetDevCaps with Extension Version – 000A0000 on 1000:P1

Changed CallPickUp Group DN and Partition Information will be sent to application

CallPickUpGroup is deleted

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

Now From Admin Pages Pickup Group 1111:P1 is deleted

LINE_REMOVE for the line P1:1111

Call Queuing

HP1 is a Huntpilot with the below configuration:

"Queue Calls" check box is selected.

“Display Line Group Member DN as Connected Party" check box is selected.

HP1: LG1

HP2: LG1

A, B (IP phones/CTI Ports)

Table 34 Basic Hunt List Call (HP1 has atleast one member free)

Action

Expected events

App initiates call from A to HP1 and call is answered by LG1.

At A:

LINE_CALLSTATE -RINGBACK

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = LG1

HuntPilot = HP1

 

At LG1:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = A

HuntPilot = HP1

Table 35 Basic Hunt List Call. HP1 has all members busy (LG1)

Action

Expected events

App initiates call from A to HP1 and call is Queued.

 

At A:

LINE_CALLSTATE -RINGBACK

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = HP1

HuntPilot =

Call on LG1 goes idle (LG1 is free). Queued call from A is de-queued and offered on LG1.

 

 

 

 

 

 

 

 

 

 

 

 

 

LG1 Answers the call.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Variance: Repeat and verify info when

Display Line Group Member DN as Connected Party is enabled

 

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x2e(CallDeQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x2e(CallDeQueue)

Caller = A,

Called = HP1

HuntPilot = HP1

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(direct)

ExtendedCallReason = x2e(CallDeQueue)

Caller = A

Called = HP1

HuntPilot = HP1

Connected = LG1

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x2e(CallDeQueue)

Caller = A

Called = HP1

HuntPilot = HP1

Connected = A

 

Same as above

Table 36 Hunt List Call to HP1 when queue depth is reached. (Maximum Number of Callers Allowed in Queue = 2)

Action

Expected events

HP1 has 2 queued calls.

App initiates call from A to HP1, call is disconnected

 

At A:

LINE_CALLSTATE -DISCONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Variance:

Destination When Queue is Full = B

 

 

 

 

 

 

 

 

 

 

 

 

 

B Answers the call.

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

At B:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x30(CallDeQueueAgentsBusy)

Caller = A,

Called = HP1

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1

HuntPilot = HP1

Connected = B

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x30(CallDeQueueAgentsBusy)

Caller = A

Called = HP1

Connected = A

Variance:

Destination When Queue is Full = HP2

Call on LG1 of HP2 goes idle (LG1 is free). Queued call from A is de-queued and offered on LG1.

 

 

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

 

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x30(CallDeQueueAgentsBusy)

Caller = A,

Called = HP1

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1

HuntPilot = HP1

Connected = LG1 of HP2

HuntPilot = HP2

 

At LG1 of HP2:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x30(CallDeQueueAgentsBusy)

Caller = A

Called = HP1

Connected = A

Table 37 Hunt List Call to HP1 and Maximum wait time in Queue is Met

Action

Expected events

HuntMember LG1 of HP1 is busy.

App initiates call from A to HP1.

 

 

 

 

 

 

 

 

 

 

 

 

Maximum wait time at queue is reached.

 

At A:

LINE_CALLSTATE -RINGBACK

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = HP1

HuntPilot =

 

At A:

LINE_CALLSTATE -DISCONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

Variance:

Destination When maximum wait time in Queue expires = B

 

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

At B:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x2f(CallDeQueueTimerExpired)

Caller = A,

Called = HP1

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1

HuntPilot = HP1

Connected = B

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x2f(CallDeQueueTimerExpired)

Caller = A

Called = HP1

Connected = A

Variance:

Destination maximum wait time in Queue expires = HP2

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x2f(CallDeQueueTimerExpired)

Caller = A,

Called = HP1

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A Called = HP1

HuntPilot = HP1

Connected = LG1 of HP2

HuntPilot = HP2

At LG1 of HP2:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x2f(CallDeQueueTimerExpired)

Caller = A

Called = HP1

Connected = A

Table 38 Hunt List Call to HP1 and No Agents Logged In or Registered

Action

Expected events

App initiates call from A to HP1. (None of the Huntmembers are registered or logged in).

Destination When There Are No Agents Logged In or Registered = ' B'

Call offered on B.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

B Answers the call.

 

 

 

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

 

At B:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x31(CallDeQueueAgentsUnavailable)

Caller = A,

Called = HP1

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = B

HuntPilot =

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x31(CallDeQueueAgentsUnavailable)

Caller = A

Called = HP1

Connected = A

App initiates call from A to HP1. (None of the Huntmembers are registered or logged in).

Destination When There Are No Agents Logged In or Registered = 'HP2'

Call offered on HP2.

 

 

 

 

 

 

 

 

 

 

 

 

 

HP2 Answers the call.

 

At A:

LINE_CALLSTATE -RINGBACK

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

 

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x31(CallDeQueueAgentsUnavailable)

Caller = A,

Called = HP1

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = B

HuntPilot = HP2

 

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x31(CallDeQueueAgentsUnavailable)

Caller = A

Called = HP1

Connected = A

Table 39 Basic Hunt List Call. A calls B, and B redirects/forwards/transfers the call to HP1

Action

Expected events

App initiates call from A to B

At A:

LINE_CALLSTATE -RINGBACK

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = B,

Connected = B

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = B,

Connected = A

The call on B is transferred to HP1 (Blind transfer).

At B:

LINE_CALLSTATE -IDLE

CallReason = x1(Direct)

ExtendedCallReason = x7(BlindTransferCall)

Caller = A

Called = B,

HuntPilot =

Connected =

HuntPilot =

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x100(LINECALLREASON_TRANSFER)

ExtendedCallReason = x7(BlindTransferCall)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected =

HuntPilot =

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A Called = B,

HuntPilot =

Connected = LG1

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x100(LINECALLREASON_TRANSFER)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = A

HuntPilot =

Variance:

Call on B is redirected to HP1

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

LG1 Answers the call.

 

At B:

LINE_CALLSTATE -IDLE

CallReason = x1(Direct)

ExtendedCallReason = x6(Redirect)

Caller = A

Called = B,

HuntPilot =

Connected =

HuntPilot =

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x40(LINECALLREASON_REDIRECT)

ExtendedCallReason = x6(Redirect)

Caller = A

Called = B,

HuntPilot =

Connected =

HuntPilot =

At A:

LIN_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = B,

HuntPilot =

Connected = LG1

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -CONNECTED

CallReason = x40(LINECALLREASON_REDIRECT)

ExtendedCallReason = x6(Redirect)

Caller = A,

Called = B

HuntPilot =

Connected = LG1

HuntPilot =

Variance:

Call on B is forwarded to HP1 (Forward All)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

LG1 Answers the call.

 

At A:

LINE_CALLSTATE -RING_BACK

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = B,

HuntPilot =

Connected =

HuntPilot =

 

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x8(LINECALLREASON_FWDUNCOND)

ExtendedCallReason = x5(ForwardAllCall)

Caller = A

Called = B,

HuntPilot =

Connected =

HuntPilot =

At A:

LIN_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = B,

HuntPilot =

Connected = LG1

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -CONNECTED

CallReason = x8(LINECALLREASON_FWDUNCOND)

ExtendedCallReason = x5(ForwardAllCall)

Caller = A,

Called = B

Connected = LG1

Table 40 Basic Hunt List Call. HP1 has all members busy (LG1), Queued call on A is redirected

Action

Expected events

App initiates call from A to HP1 and call is Queued.

 

At A:

LINE_CALLSTATE -RINGBACK

 

At A:

LINE_CALLSTATE -CONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x2d(CallQueue)

Caller = A

Called = HP1,

HuntPilot = HP1

Connected = HP1

HuntPilot =

 

Queued Call on A is redirected to B. B Answers.

Call on LG1 goes idle (LG1 is free). Queued call from B is de-queued and offered on LG1.

 

 

 

 

 

 

 

 

 

LG1 Answers the call.

 

 

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x40(LINECALLREASON_REDIRECT)

ExtendedCallReason = x6(Redirect)

Caller = HP1

Called = B,

HuntPilot =

Connected = HP1

HuntPilot =

 

 

At LG1:

LINE_CALLSTATE -ACCEPTED

CallReason = x400(unknown)

ExtendedCallReason = x2e(CallDeQueue)

Caller = B,

Called = HP1

HuntPilot = HP1

At B:

LINE_CALLSTATE -CONNECTED

CallReason = x40(LINECALLREASON_REDIRECT)

ExtendedCallReason = x2e(CallDeQueue)

Caller = B

Called = B

HuntPilot =

Connected = LG1

HuntPilot = HP1

At LG1:

LINE_CALLSTATE -CONNECTED

CallReason = x400(unknown)

ExtendedCallReason = x2e(CallDeQueue)

Caller = B

Called = HP1

HuntPilot = HP1

Connected = B

 

Table 41 Hunt List Call to HP1 and No Agents Logged In or Registered

Action

Expected events

App initiates call from A to HP1. (None of the Huntmembers are registered or logged in).

Call is disconnected.

 

At A:

LINE_CALLSTATE -DISCONNECTED

CallReason = x1(Direct)

ExtendedCallReason = x1(DirectCall)

Caller = A

Called = HP1,

HuntPilot = HP1

FailOver or FailBack scenario

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on 1000:P1

CallPickUp Group DN and Partition Information will be sent to application

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

LineGetCallInfo

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4000

dwCalledID : 1002

dwCallorigin: Internal

dwCallReason : Direct

Check for all fields of Calling and Called Information

Stop Primary CTI Manager

OutofService for the line P1:1111

INService for the line P1:1111.

Note   

There will not be any notification for the existing calls.

GroupCallPickup

Configuration

Service parameter "Auto Call Pickup Enabled" is enabled.

Pickup group P1:1111 is configured and opened

P1:1000, P1:1001, P1:1002 are all in pickup group P1:1111

P1:2000, P1:2001, P1:2002 are all in pickup group P1:2222

P1:4000 and P1:4001 are configured

Action

Expected

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on P1:2000

LineGetDevCaps with Extension Version – 000A0000 on P1:2000CallPickUp Group DN and Partition Information will be sent to application.(P1:2222)

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

LineGetCallInfo

LINE_CALLINFO

dwCallState : PickupCallState (0x10000000)

dwCallerId : 4000

dwCalledID : 1002

dwCallorigin: Internal

dwCallReason : Direct

Check for all fields of Calling and Called Information

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with GroupCallPickup option and GroupPickUp DN 1111 on P1:2000

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with GroupCallPickup option and GroupPickUp DN 1111 on P1:2000Events on P1:2000:

LINE_NEWCALL and

LINE_CALLSTATE with state = LINECALLSTATE_CONNECTED

Call Info :

Caller = 4000, Called = 1111, Connected = 4000, dwReason = Direct, dwOrigin = Internal

Note   

There is no notification at P1:1111 after the call has been pickup.

OtherCallPickup

Configuration

Service parameter "Auto Call Pickup Enabled" is enabled.

Pickup groups P1:1111, P1:2222, P1:3333 is configured and opened

P1:1000, P1:1001, P1:1002 are all in pickup group P1:1111

P1:2000, P1:2001, P1:2002 are all in pickup group P1:2222

P1:3000, P1:3001, P1:3002 are all in pickup group P1:3333

P1:1111, and P1:2222 are sub-groups, in order of priority, of pickup group P1:3333.

P1:4000 and P1:4001 are configured.

Action

Expected Event

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on P1:2000

CallPickUp Group DN and Partition Information will be sent to application.(P1:2222)

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:2000

 

 

 

P1:4001 calls P1:1000

Call1:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Call 2:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with OtherPickup option on P1:3000

Note   

Group DN is not required

Events on P1:3000:

LINE_NEWCALL and

LINE_CALLSTATE with state = LINECALLSTATE_CONNECTED

Call Info :

Caller = 4001, Called = 1000, Connected = 4001, dwReason = Direct, dwOrigin = Internal

DirectCallPickup

Action

Expected Event

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on P1:2000

CallPickUp Group DN and Partition Information will be sent to application.(P1:2222)

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

 

 

 

P1:4001 calls P1:1000

Call1:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Call 2:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with DirectCallPickup option with pickup groupDN (1000) on P1:10001

Events on P1:1001:

LINE_NEWCALL and

LINE_CALLSTATE with state = LINECALLSTATE_CONNECTED

Call Info :

Caller = 1001, Called = 1000, Connected = 4001, dwReason = Direct, dwOrigin = Internal

CallPickup (negative use case)

Configuration

Service parameter Auto Call Pickup Enabled is enabled.

P1:2000 is already opened by the application.

Pickup groups P1:1111, P1:2222, P1:3333 is configured and opened.

P1:1000, P1:1001, P1:1002 are all in pickup group P1:1111

P1:2000, P1:2001, P1:2002 are all in pickup group P1:2222

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on P1:2000

CallPickUp Group DN and Partition Information will be sent to application.(P1:2222)

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

Call1:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

 

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with CallPickup option on P1:2000

Line_Reply with Error LINEERR_OPERATIONUNAVAIL

GroupCallPickup with SuperSet Call PickupDN

Configuration

Service parameter Auto Call Pickup Enabled is enabled.

Pickup groups P1:1111, P1:2222, P1:3333 is configured and opened.

P1:1000, P1:1001, P1:1002 are all in pickup group P1:1111.

P1:2000, P1:2001, P1:2002 are all in pickup group P1:2222.

P1:3000, P1:3001, P1:3002 are all in pickup group P1:3333.

P1:1111, and P1:2222 are sub-groups, in order of priority, of pickup group P1:3333.

P1:4000 and P1:4001 are configured.

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on P1:2000

CallPickUp Group DN and Partition Information will be sent to application.(P1:2222)

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:2000

 

 

 

P1:4001 calls P1:1000

Call1:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Call 2:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with GroupPickup option with pickup group(3333) on P1:3000

Line_Reply with Error LINEERR_CALLUNAVAIL

Group or Direct CallPickup with invalid DN

Action

Expected events

LineIntialize

OpenLines – 1000:P1

Line Open Successful

LineGetDevCaps with Extension Version – 000A0000 on P1:2000

CallPickUp Group DN and Partition Information will be sent to application.(P1:2222)

Application sends CciscoLineDevSpecificRegisterCallPickupGroupForNotification with DN and Partition info of PickUpGroup P1:1111

Line_Reply with success.

LINE_CREATE event will sent to Application for P1:1111

LineOpen with new DeviceID

LineOpen Successful

P1:4000 calls P1:1002

Call1:

LINE_APPNEWCALL

LINE_CALLSTATE with State = LINECALLSTATE_UNKNOWN to Application on Line P1:1111

Application sends CciscoLineDevSpecificPickUpCallFromPickupGroup with GroupPickup option with pickup group(9999) on P1:3000

 

Variant -Direct Call Pickup with InValid DN

Line_Reply with Error LINEERR_OPERATIONFAILED Line_Reply with Error LINEERR_INVALLINESTATE

CCMEncryption Enhancements

Precondition: CTI service Parameter - "Require Public Key encryption" = true/false

Table 42  CiscoTSP connecting to 10.x CUCM
Action TAPI Messages TAPI Structures
PhoneInitializeEx/LineInitializeEx Devices are Enumerated/ Lines are Enumerated  

Note


Applications would be able to control /monitor devices/Lines as before no change.

Variant: Test the same with Secure CUCM and Secure Connection between CiscoTSP and CTI.


Precondition: CTI service Parameter - "Require Public Key encryption" = False

Table 43  9.x CiscoTSP connecting to 10.x CUCM
Action TAPI Messages TAPI Structures
PhoneInitializeEx/LineInitializeEx Devices are Enumerated/ Lines are Enumerated

Note


Applications would be able to control /monitor devices/Lines as before no change
Precondition: CTI service Parameter - "Require Public Key encryption" = False

Table 44 9.x CiscoTSP connecting to 10.x CUCM
Action TAPI Messages TAPI Structures
PhoneInitializeEx/LineInitializeEx Initialization fails and CiscoTSP devices won't be Enumerated.

Notifier will pop-up error message indicating that Provider Init failed.

Error - Provider Init failed - Incompatible protocol version

CIUS session persistency

Notify the line application and expose the changed IP address

Action

TAPI messages

TAPI structures

lineInitializeEx

lineDevices are Enumerated

 

lineOpen for a lineDevice on the wireless device TAPI100

lineOpen() returns success

 

lineGetDevCaps() with DeviceID = DeviceId of TAPI100

lineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv4_only

RegisteredIPv4Address = "10.77.31.250" (FA1F4D0A -Little endian Hex format)

The device TAPI100 moves across WiFi networks resulting in change in the IPv4 address from 10.77.31.250 to 10.77.31.176

Variation 1: The device TAPI100 moves from a IPv4 n/w to a Ipv6 n/w with new ip as 2001:db8::1:0:0:1

Variation 2: The device TAPI100 is docked/undocked and hence changes from WAN/LAN to wireless network

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_DEVICE_IPADDRESS

 

Variation result:

1) Same as above

2) Same as above

 

lineGetDevCaps() with DeviceID = DeviceId of TAPI100

lineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv4_only

RegisteredIPv4Address = "10.77.31.176" (B01F4D0A -Little endian Hex format)

Variation 1:

LINEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv6_only

RegisteredIPv6Address = "2001:db8::1:0:0:1"

(Application should use the Offset and size fields of IPv6 address from LINEDEVCAPS to retrieve the value of IPv6 address)

Variation 2:

LINEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv4_only

RegisteredIPv4Address = "10.77.31.176"

Notify the phone application and expose the changed IP address

Action

TAPI Message

TAPI structures

phoneInitializeEx

phoneDevices are Enumerated

 

phoneOpen for a phoneDevice of wireless device TAPI100

phoneOpen() returns success

 

phoneGetDevCaps() with DeviceID = DeviceId of TAPI100

phoneGetDevCaps() returns success

PHONEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv4_only

RegisteredIPv4Address = "10.77.31.250" (FA1F4D0A -Little endian Hex format)

The device TAPI100 moves across WiFi networks resulting in change in the IPv4 address from 10.77.31.250 to 10.77.31.176

Variation 1: The deivce TAPI100 moves from a IPv4 n/w to a Ipv6 n/w with new ip as 2001:db8::1:0:0:1

Variation 2: The deivce TAPI100 is docked/undocked and hence changes from WAN/LAN to wireless network

EVENT = PHONE_DEVSPECIFIC

dwParam1 = CPDSMT_PHONE_PROPERTY_ CHANGED_EVENT

dwParam2 = PPCT_DEVICE_IPADDRESS

 

Variation result:

1) Same as above

2) Same as above

 

phoneGetDevCaps() with DeviceID = DeviceId of TAPI100

phoneGetDevCaps() returns success

PHONEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv4_only

RegisteredIPv4Address = "10.77.31.176" (B01F4D0A -Little endian Hex format)

Phone Type = Cisco Cius.

Phone Name = Cisco Phone [SEP123456789000]

Variation 1:

PHONEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv6_only

RegisteredIPv6Address = "2001:db8::1:0:0:1"

(Application should use the Offset and size fields of IPv6 address from PHONEDEVCAPS to retrieve the value of IPv6 address)

Variation 2:

PHONEDEVCAPS::DevSpecific

RegisteredIPAddressMode = IPAddress_IPv4_only

RegisteredIPv4Address = "10.77.31.176" (B01F4D0A -Little endian Hex format)

Click to conference

Third-party conference gets created by using click-2-conference feature:

Action

Events

Use Click-to-Call to create call from A to B, and B answers

For A:

CONNECTED

reason = DIRECT

Calling = A, Called = B, Connected = B

For B:

CONNECTED

reason = DIRECT

Calling = A, Called = B, Connected = A

Use Click-2-Conference feature to add C into conference, and C answers

For A:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = B

CONFERENCED

Calling = A, Called = C, Connected = C

For B:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = A

CONFERENCED

Calling = B, Called = C, Connected = C

For C

CONNECTED

Reason = UNKNOWN

ExtendedCallReason = ClickToConference

CONFERENCED

Calling = C, Called = A, Connected = A

CONFERENCED

Calling = C, Called = B, Connected = B

Creating Four-Party conference by using Click-2-Conference feature

Action

Events

Use Click-to-Call to create call from A to B

For A:

CONNECTED

reason = DIRECT

Calling = A, Called = B, Connected = B

For B:

CONNECTED

reason = DIRECT

Calling = A, Called = B, Connected = A

Use Click-2-Conference feature to add C into conference

For A:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = B

CONFERENCED

Calling = A, Called = C, Connected = C

For B:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = A

CONFERENCED

Calling = C, Called = C, Connected = C

For C

CONNECTED

Reason = DIRECT

ExtendedCallReason = ClickToConference

CONFERENCED

Calling = C, Called = A, Connected = A

CONFERENCED

Calling = C, Called = B, Connected = B

Use Click-2-Conference feature to add party D

For A:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = B

CONFERENCED

Calling = A, Called = C, Connected = C

CONFERENCED

Calling = A, Called = D, Connected = D

For B:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = A

CONFERENCED

Calling = B, Called = C, Connected = C

CONFERENCED

Calling = B, Called = D, Connected = D

For C

CONNECTED

Reason = UNKNOWN

ExtendedCallReason = ClickToConference

CONFERENCED

Calling = C, Called = A, Connected = A

CONFERENCED

Calling = C, Called = B, Connected = B

CONFERENCED

Calling = C, Called = D, Connected = D

For D

CONNECTED

Reason = UNKNOWN

ExtendedCallReason = ClickToConference

 

CONFERENCED

Calling = D, Called = A, Connected = A

CONFERENCED

Calling = D, Called = B, Connected = B

CONFERENCED

Calling = D, Called = C, Connected = C

Drop Party by using Click-2-Conference

Action

Events

Conference gets created by using Click-2-Conference feature to add C into conference

For A:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = B

CONFERENCED

Calling = A, Called = C, Connected = C

For B:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = A

CONFERENCED

Calling = B, Called = C, Connected = C

For C

CONNECTED

Reason = UNKNOWN

ExtendedCallReason = ClickToConference

CONFERENCED

Calling = C, Called = A, Connected = A

CONFERENCED

Calling = C, Called = B, Connected = B

Drop C from Click-2-Conference feature

For A

CONNECTED

Reason = DIRECT

ExtendedCallReason = DIRECT

Calling = A, Called = B, Connected = B

For B

CONNECTED

Reason = DIRECT

ExtendedCallReason = DIRECT

Calling = A, Called = B, Connected = A

For C

IDLE

Drop Entire Conference by using Click-2-Conference feature

Action

Events

Conference gets created by using Click-2-Conference feature to add C into conference

For A:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = B

CONFERENCED

Calling = A, Called = C, Connected = C

For B:

CONNECTED

reason = DIRECT

ExtendedCallReason = DIRECT

CONFERENCED

Calling = A, Called = B, Connected = A

CONFERENCED

Calling = B, Called = C, Connected = C

For C

CONNECTED

Reason = UNKOWN

ExtendedCallReason = ClickToConference

CONFERENCED

Calling = C, Called = A, Connected = A

CONFERENCED

Calling = C, Called = B, Connected = B

Drop entire conference

For A

IDLE

 

For B

IDLE

 

For C

IDLE

Conference enhancements

Noncontroller adding parties to conferences

A,B, and C exist in a conference that A created.

Action

Events

A,B, and C exist in a conference

At A:

Conference – Caller = A, Called = B, Connected = B

Connected

Conference – Caller = A, Called = C, Connected = C

At B:

Conference – Caller = A, Called = B, Connected = A

Connected

Conference – Caller = B, Called = C, Connected = C

At C:

Conference – Caller = B, Called = C, Connected = B

Connected

Conference – Caller = C, Called = A, Connected = A

C issues a linePrepareAddToConference to D

At A:

Conference – Caller = A, Called = B, Connected = B

Connected

Conference – Caller = A, Called = C, Connected = C

At B:

Conference – Caller = A, Called = B, Connected = A

Connected

Conference – Caller = B, Called = C, Connected = C

At C:

Conference – Caller = B, Called = C, Connected = B

OnHoldPendConf

Conference – Caller = C, Called = A, Connected = A

Connected -Caller = C, Called = D, Connected = D

At D:

Connected -Caller = C, Called = D, Connected = C

C issues a lineAddToConference to D

At A:

Conference – Caller = A, Called = B, Connected = B

Connected

Conference – Caller = A, Called = C, Connected = C

Conference – Caller = A, Called = D, Connected = D

At B:

Conference – Caller = A, Called = B, Connected = A

Connected

Conference – Caller = B, Called = C, Connected = C

Conference – Caller = B, Called = D, Connected = D

At C:

Conference – Caller = B, Called = C, Connected = B

Connected

Conference – Caller = C, Called = A, Connected = A

Conference – Caller = C, Called = D, Connected = D

At D:

Conference – Caller = C, Called = D, Connected = C

Connected

Conference – Caller = D, Called = A, Connected = A

Conference – Caller = D, Called = B, Connected = B

Chaining two Ad Hoc conferences by using Join

Actions

TSP CallInfo

A calls B, B answers, then B initiates conference to C, C answers, and B completes the conference

At A:

GCID-1

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = A

Called = B

CONFERENCED : Caller = A

Called = C

At B:

GCID-1

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = A

Called = B

CONFERENCED : Caller = B

Called = C

At C:

GCID-1

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = B

Called = C

CONFERENCED : Caller = C

Called = A

C initiates or completes conference to D and E

No Change for A and B

At C:

-First conference

GCID-1

ONHOLD : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = A

Called = B

CONFERENCED : Caller = A

Called = C

-Second conference

GCID-2

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = C

Called = D

CONFERENCED : Caller = C

Called = E

At D:

GCID-2

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = C

Called = D

CONFERENCED : Caller = D

Called = E

At E:

GCID-2

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = C

Called = E

CONFERENCED : Caller = E

Called = D

C initiates JOIN request to join to conference call together, with GCID as the primary call

At A:

GCID-1

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = A

Called = B

CONFERENCED : Caller = A

Called = C

CONFERENCED : Caller = A

Called = Conference-2

At B :

GCID-1

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = A

Called = B

CONFERENCED : Caller = B

Called = C

CONFERENCED : Caller = B

Called = Conference-2

At C:

-First conference

GCID-1

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = B

Called = C

CONFERENCED : Caller = C

Called = A

CONFERENCED : Caller = C

Called = Conference-2

 

At D:

GCID-2

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = D

Called = E

CONFERENCED : Caller = D

Called = Conference-1

 

At E :

GCID-2

CONNECTED : Caller = Unknown

Caller = Unknown

CONFERENCED : Caller = E

Called = D

CONFERENCED : Caller = E

Called = Conference-1

CTI remote device

Expose remote destination info for CTI remote device in ProviderDeviceLineInfoEvent

PreCondition: User has a CTI remote device "CTIRD1" under it control list. CTIRD1 device has 3 remote destinations configured.

Action

CTI messages/Events

Application opens the provider.

CTI acquires the devices which are under control list of the user

Application sends GetSignleDeviceAndLineInfoRequest to CTI to fetch info for CTIRD1 device.

CTI sends ProviderDeviceLineInfoEvent to application and exposes 3 RDs configured on the device as part of "Remote Destination Info" structure.

Expose remote destination info for CTI remote device in ProviderDeviceRegisteredWithLineInfoNotify

PreCondition: User has a CTI remote device "CTIRD1" under it control list. CTIRD1 device has 3 remote destinations configured.

Action

CTI messages/Events

Application opens the provider.

CTI acquires the devices which are under control list of the user

Application sends GetSignleDeviceAndLineInfoRequest to application to fetch info for CTIRD1 device.

CTI sends ProviderDeviceLineInfoEvent to application and exposes 3 RDs configured on the device as part of "Remote Destination Info" structure.

Application resets the device CTIRD1 from the admin page.

CTI sends ProviderDeviceRegisteredWithLineInfoNotify to application and exposes 3 RDs configured on the device as part of "Remote Destination Info" structure.

Expose new device type for CTI remote device

Precondition:

CTIRD (CTI Remote Device -Name: CTIRDdrajesh)

Remote Destinations configured/will be configured on CTI Remote Device:

RD1-CTIRD -(Name: Mobile, Number: 914086271309)

RD2-CTIRD -(Name: Office, Number: 914089022131)

Line-A (DN -1000) -Line-A configured on CTI Remote Device (shared line of Enterprise DN -1000 configured on Device EP)

EP (Enter Prise Phone -SCCP -IP Phone)

Line-A' -DN -1000 configured on Device EP

CSF (CSF Device -Name: CSFdrajesh)

Line-A'' -DN -1000 configured on Device CSF

Remote Destination configured on CSF device:

RD1-CSF -(Name: CSF-Mobile, Number: 914086271310)

RD2-CSF -(Name: CSF-Office, Number: 914089022132)

Action

TAPI messages

TAPI structures

PhoneInitializeEx

Devices are Enumerated

PhoneGetDevCaps() with DeviceID = DeviceId of CTIRD.

PhoneGetDevCaps() returns success

PHONECAPS::PhoneInfo = "CTI Remote Device"

PHONECAPS:: PhoneName = "Cisco Phone: [CTIRDdrajesh]"

PhoneGetDevCaps() with DeviceID = DeviceId of CSF.

PhoneGetDevCaps() returns success

PHONECAPS::PhoneInfo = "Cisco Unified Client Services Framework"

PHONECAPS:: PhoneName = "Cisco Phone: [CSF-drajesh]"

Enumerating CTI remote devices and exposing remote Destination information to application

Precondition: same as above usecase; RD1-CTIRD and RD1-CSF are configured on respective devices

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A'' on CSF.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "91486271310"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Add remote Destination from Admin and Expose Multiple remote Destination information to application

Precondition: In addition to above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A on CTIRD

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Add other Remote Destination RD2-CTIRD on CTI Remote Device from Admin Pages

RD2-CTIRD Info -(Name: Office, Number: 4089022131)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "91486271310"

isActiveRD = 0x00000000

unicodeRDName = "CSF-Office"

RDNumber = "4089022132"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Update RD info(RDName/Number/Both) from Admin -RD info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A on CTIRD

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Update Remote Destination RD2-CTIRD Name on CTI Remote Device "CTIRD" from Admin Pages

RD2-CTIRD Info -(Name: Home, Number: 4089022132)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Home"

RDNumber = "4089022132"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Update Remote Destination RD2-CTIRD Number on CTI Remote Device CTIRD from Admin Pages

RD2Info -(Name: Home, Number: 4089021234)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID =

LineGetDevCaps() returns

LINEDEVCAPS::DevSpecific

LineDeviceId of Line-A on CTIRD.

success

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Home"

RDNumber = "4089021234"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Update Remote Destination RD2-CTIRD Name and Number on CTI Remote Device CTIRD from Admin Pages

RD2Info -(Name: Office, Number: 4089022131)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info with respective RD Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remove RD from Admin -RD info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Remove Remote Destination RD2-CTIRD on CTI Remote Device CTIRD from Admin Pages

RD2Info -(Name: Office, Number: 4089022131)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remote Destination information on CTI RemoteDevice/CSF device which doesnt have remote Destination's configured

Precondition: In addition to above usecase

CTIRD2 (CTI remote device -doesn't have any RemoteDestination's configured)

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-C on CTIRD2.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info is empty

RemoteDestinationOffset = 0

RemoteDestinationSize = 0

RemoteDestinationCount = 0

RemoteDestinationElementFixedSize = 0

IsMyAppLastToSetActiveRD = 0x00000000

Remote destination information on non CTI RemoteDevice / CSF device

Precondition: In addition to above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A' on EP.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

DeviceProtocolType =

DeviceProtocolType_SCCP (0x01)

Remote Destination Info is empty

RemoteDestinationOffset = 0

RemoteDestinationSize = 0

RemoteDestinationCount = 0

RemoteDestinationElementFixedSize = 0

IsMyAppLastToSetActiveRD = 0x00000000

Add RD from application -RD info Change notification to application

Precondition: Remove All RD's from Admin Page

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info:

RemoteDestinationOffset = 0

RemoteDestinationSize = 0

RemoteDestinationCount = 0

RemoteDestinationElementFixedSize = 0

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

Add Remote Destination RD2-CTIRD to CTI Remote Device CTIRD:

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "4089022131"

m_UnicodeRDName = "Office"

m_activeRD = 0x00000000

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

LINE_REPLY with success

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Update RD info(RDNumber/RDName/Both) from application -RD info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Update Remote Destination name of RD2-CTIRD on CTI Remote Device "CTIRD":

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "4089022131"

m_UnicodeRDName = "Office-Change"

m_NewRDNumber = "4089022131"

m_activeRD = 0x00000000

LINE_REPLY with success

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office-Change"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Update Remote Destination Number of RD2-CTIRD on CTI Remote Device "CTIRD":

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "4089022131"

m_UnicodeRDName = "Office-Change"

m_NewRDNumber = "4089020000"

m_activeRD = 0x00000000

LINE_REPLY with success

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office-Change"

RDNumber = "4089020000"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Update Remote Destination Name and Number of RD2-CTIRD on CTI Remote Device "CTIRD":

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "408902000"

m_UnicodeRDName = "Office"

m_NewRDNumber = "4089022131"

m_activeRD = 0x00000000

LINE_REPLY with success

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Update RD info(SetActive RD) from application -RD info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_REMOTE_ DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Set RD2-CTIRD as ActiveRD:

Req

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "4089022131"

m_UnicodeRDName = "Office"

m_RDNumber = "4089022131"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000001

LineShutdown()

LineShutdown success

Active RD will be RESET to False when the Application which has set RD as ACTIVE is shutdown or closed

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Add other RD (RD2-CTIRD with IsActive Set) from application -RD info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A on CTIRD

LineOpen() returns Success

Set RD2-CTIRD -"Office" as ACTIVE

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000001

Add Remote Destination RD1-CTIRD on CTI Remote Device CTIRD with "IsActive" set to true

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

Variation :

Add RD1-CTIRD with IsActive RD = False

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000001

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Update RD (RD1-CTIRD -Name, Number and set IsActive) from application -RD Info Change notification to application

Precondition: continuation from previous UseCase Variation (RD2 is added with IsActive = false)

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Set RD2-CTIRD-"Office" as ACTIVE

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000001

Update Remote Destination RD1-CTIRD on CTI Remote Device "CTIRD" with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile-t"

m_NewRDNumber = "91408627130900"

m_activeRD = 0x00000001

*** 2 Change Nofitications

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile-t"

RDNumber = "9148627130900"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remove RD (RD1-CTIRD which is Active RD) from application -RD Info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Set RD1-CTIRD-"Mobile-t" as ACTIVE

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile-t"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

Remove Remote Destination RD1-CTIRD on CTI Remote Device "CTIRD"

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "9148627130900"

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Negative -Add RD from application -RD Info change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A of CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Add Remote Destination on CTI Remote Device CTIRD

Variation 1:

Empty RD Number :

m_RDNumber = ""

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = ""

m_UnicodeRDName = ""

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_INVALPARAM

Variation 2:

RDNumber : same RD Number as any of the existing RD's Name

"12345" -RD already configured on CUCM.

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "12345"

m_UnicodeRDName = "Office"

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_DUPLICATE_INFORMATION (0xC0000013)

Variation 3:

Add RD when the user Limit for UserID used for CTI RD is reached.

For example : if User has limit set to 4 and then if Remote Device is already configured with 4 Remote Destination and User tries to Add 5th one from Application.

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "12345"

m_UnicodeRDName = "temp"

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_REMOTE_DESTINATION_LIMIT_EXCEEDED (0xC0000015)

Variation 4:

RDNumber : Invalid Remote Destination Name [name has unsupported characters, eg-name&] or invalid number [cant configure any of the local device DN as number which is not supported]

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "1000"

m_UnicodeRDName = "Office&"

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_INVALPARAM

Variation 5:

Add RD to a CSF device which doesn't have Owner/END User ID configured

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "12345"

m_UnicodeRDName = "Office"

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_ENDUSER_NOT_ASSOCIATED_WITH_DEVICE (0xC000001B)

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Negative -Update RD from application -RD Info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Update Remote Destination on CTI Remote Device:

Variation 1:

Empty RD Number :

m_RDNumber = ""

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = ""

m_UnicodeRDName = ""

m_NewRDNumber = ""

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_INVALPARAM

Variation 2:

RDNNumber : RD Number in Request doesn't match with any of the existing RD in the RD List on Device

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "12345"

m_UnicodeRDName = "Temp"

m_RDNumber = "12345"

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_REMOTE_DESTINATION_UNAVAIL (0xC0000014)

Variation 3:

RDNaumber : same RD Number as any of the existing RD's Name

*** RDNumber "4086271309" is already configured on other RemoteDestination

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "4089022131"

m_UnicodeRDName = "Office"

m_RDNumber = "4086271309"

m_activeRD = 0x00000000

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR _DUPLICATE_INFORMATION (0xC0000013)

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Negative -Remove RD from application -RD Info Change notification to application

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A on CTIRD.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Remove Remote Destination on CTI Remote Device:

Empty RDNumber :

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = ""

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_INVALPARAM

Variation 1:

RDNumber : RD Number in Request doesn't match with any of the existing RD in the List

CiscoLineDevSpecific AddRemoteDestination Req

m_RDNumber = "1234567"

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_REMOTE_DESTINATION_UNAVAIL (0xC0000014)

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Negative -Add/remove/update RD from application -on non-CTI RD /CSF device line or line is not opened with required extension

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Add/Remove/Update Remote Destination on CTI Remote Device CTIRD

Variation 1:

Previous step Line is not opened with required ext Version -(0x000C0000 or greater)

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_OPERATIONUNAVAIL

Variation 2:

Req on Line which is not on CTI Remote Device / CSF device

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_OPERATIONUNAVAIL

Variation 3:

Failure of Add/Remove/update Req for any other reasons not captured in above useCases

LineDevSpecific() returns dwRequestID

LINE_REPLY

lResult = LINEERR_OPERATIONFAILED

Multiple Apps setting Active RD

Precondition: same as UseCase 1

Action

TAPI messages

TAPI structures

App1 and App2:

LineInitializeEx

Lines are Enumerated

App1 and App2:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

App1 and App2:

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

App1:

Update Remote Destination RD2 on CTI Remote Device "CTIRD" with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_NewRDNumber = "914086271309"

m_activeRD = 0x00000001

Change Notification to App1 and App2:

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

App1:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

App2:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

App2:

Update Remote Destination RD2 on CTI Remote Device "CTIRD" with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914089022131"

m_UnicodeRDName = "Office"

m_NewRDNumber = "914089022131"

m_activeRD = 0x00000001

Change Notification to App1 and App2:

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

App1:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000000

App2:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000001

Variant 1:

App2:

LineShutdown()

LineShutdown() returns success

Change Notification to App1:

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000

App1:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Variant 2:

App1:

LineShutdown()

LineShutdown() returns success

No Change Notification to App2

App2:

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000001

IsMyAppLastToSetActiveRD = 0x00000001

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

CTI/CCM Manager FailOver scenario-Active RD

Precondition: same as UseCase 1

TSP is configured with Primary and Secondary CTI Manager

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Update Remote Destination RD1 on CTI Remote Device "CTIRD" with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_NewRDNumber = "914086271309"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

Stop Primary CTI Manager

TSP connects to Secondary CTIManager

and

Active RD configuration is RE-SET by CiscoTSP

Event on Line A :

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

Set RD -Mobile to ACTIVE RD and then Stop Call Manager on the node of Secondary CTI Manager

ActiveRD configuration is not changed/ not RESET

Event on Line A :

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

CTI/CCM Manager FailOver scenario-Active RD set by other application

Precondition: same as UseCase 1

TSP is configured with Primary and Secondary CTI Manager

Other Application has set the ACTIVE RD on the Device and Application is connected to Secondary CTI Manager

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A

LineOpen() returns Success

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Stop Primary CTI Manager

Active RD configuration is not RESET as the this Application has not set the ACTIVE RD

Event on Line A :

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = LINEDEVCAPSDEVSPECIFIC_ REMOTEDEVICE (0x00000008)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE(0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "91486271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Stop Call Manager on the node of Secondary CTI Manager

ActiveRD configuration is not changed/ not RESET

Event on Line A :

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

Variation :

Test the same on CSF device [CSF -Line-A'']

Same as for CTI Remote Device other than dwLineTypes and DeviceProtocolType Info.

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Monitoring CSF device in Soft Phone/Desk Phone mode

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A'' on CSF Device.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A"

LineOpen() returns Success

LineSetStatusMessages()on Line-A" with dwLineStates = INSERVICE and OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

LineMake Call() or any Incoming Call

Call Events are reported to Application

Lineclose and ShutDown

LineClose and LineShutdown Success

Monitoring CSF device switching mode from Soft/Desk Phone Mode to Extend Mode

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A" on CSF device.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A"

LineOpen() returns Success

LineSetStatusMessages() on Line-A" with dwLineStates = INSERVICE and OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

From Jabber Client Switch the mode to Extend Mode

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_DEVICE_PROTOCOL_TYPE (0x00008000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A".

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

Lineclose and ShutDown

LineClose and LineShutdown Success

Monitoring CSF device in Extend Mode, switches back to Soft / Desk Phone mode

Precondition: continuation from previous UseCase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A" on CSF device.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

LineOpen() with ExtVer-0x000C0000 dwDeviceID = LineDeviceID of Line-A"

LineOpen() returns Success

LineSetStatusMessages()on Line-A" with dwLineStates = INSERVICE and OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

From Jabber Client Switch the mode to Soft Mode

Or

From Jabber Client Switch the mode to Deskphone Mode

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_OUTOFSERVICE

Line INSERVICE EVENT

Event = LINE_LINEDEVSTATE

dwParam1 = LINEDEVSTATE_INSERVICE

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_DEVICE_PROTOCOL_TYPE (0x00008000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A".

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_SIP (0x02)

Remote Destination Info:

unicodeRDName = "CSF-Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Lineclose and ShutDown

LineClose and LineShutdown Success

Basic incoming call to CTI remote device

CTI remote device:

A (CTI Remote Device -Name: CTIRD1)

Remote Destination:

RD1 -Remote Destination configured on CTI Remote Device A

(Name: Mobile, Number: 914086271309)

RD2 -Remote Destination configured on CTI Remote Device A

(Name: Office, Number: 914089022131)

Line:

Line-A1 (DN -2000) (Alerting Name:2000name, Display Name: CTIRD-2000name) configured on CTI Remote Device A (shared line of Enterprise DN -2000 configured on Device B)

Line-A2 (DN -2001) (Alerting Name:2001name, Display Name: CTIRD-2001name) configured on CTI Remote Device A (shared line of Enterprise DN -2001 configured on Device B)

Enterprise Phones:

B (IP Phone -Name: SEPxxxxxxxx)

Line:

Line-A1' -DN -2000(Alerting Name: 2000name, Display Name: EP-2000name) configured on Device B

Line-A2' -DN -2001(Alerting Name: 2001name, Display Name: EP-2001name) configured on Device B

C (IP Phone -Name: SEPxxxxxxxx)

Line:

Line-C -DN -1000(Alerting Name: 1000name, Display Name: 1000Name) configured on Device C

D (IP Phone -Name: SEPxxxxxxxx)

Line:

Line-D -DN -1001(Alerting Name: 1001name, Display Name: 1001Name) configured on Device D

CSF Device:

D (CSF Device -Name: CSF-drajesh)

Remote Destination:

RD-01 -Remote Destination configured on CSF device D

(Name: CSF-Mobile, Number: 914086271309)

RD-02 -Remote Destination configured on CSF device D

(Name: CSF-Office, Number: 914089022131)

Line:

Line-A'' (DN -2000) -Line-A (Alerting Name: 2000name, Display Name: CSF-2000) configured on CSF device D (shared line of Enterprise DN -2000 configured on Device B)

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Open all Lines (A, A' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

LineMakeCall on Line-C with DN (A -DN 2000)

LineMakeCall() success

Call on C :

LINE_CALLSTATE -Param1 = DIALING

LINE_CALLSTATE -Param1 = PROCEEDING

LINE_CALLSTATE -Param1 = RINGBACK

Call on CTI Remote Device :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Call on Enterprise Phone :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

After "Delay Before Ringing Timer" expires the call is offered on Remote Destinations and all Remote Destinations Ring

LineGetCallInfo() on call on Device C

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName =

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID =

LineGetCallInfo() on call on Device A/B

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName =

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID =

Answer on any of the Remote Destination

Call on C :

LINE_CALLSTATE -Param1 = CONNECTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = CONNECTED (active)

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LineGetCallInfo() on call on Device C

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

dwConnectedID = 2000

dwConnectedIDName = CTIRD-2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName = CTIRD-2000name

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID = 2000

LineGetCallInfo() on call on Device A/B

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

dwConnectedID = 2000

dwConnectedIDName = CTIRD-2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName = CTIRD-2000name

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID = 2000

LineDrop() for the call on Device A (CTI-RD)

*** Call on Remote Destination is dropped

LineDrop() success

Call on C :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LINE_CALLSTATE -Param1 = IDLE

Variation :

Answer the call on Enterprise Phone (B)

LineAnswer() on the call on Device B

*** Call on Remote Device/Remote Destination drops

Call on C :

LINE_CALLSTATE -Param1 = CONNECTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Variation :

One of the Remote Destination answers the call before the "Answer Too Soon Timer"

Expected Result :

All calls go to Disconnected/IDLE State

Variation :

Active RD set on CTI Remote Device

Expected result:

only Remote Destination which is set ACTIVE rings

Call rings immediately and "Delay before Ringing Timer" wouldn't be effective when ACTIVE RD is set.

Remote Destination can answer the call Immediately and "Answer Too Soon Timer" wouldn't be effective when ACTIVE RD is set.

Continuation to above variation

On second Incoming Call...

There won't be second call on Remote Destination, only at Remote Device second call will present and reported to Application.

Variation :

Test with CSF Device in Extend Mode

Expected result:

would be same as observed on CTI Remote Device

DVO Call (Outgoing Call initiation from CTI remote device)

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Open all Lines (A, A' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

LineMakeCall on Line-A with DN (C -DN 1000)

LineMakeCall() returns RequestID

LINE_REPLY

Param1 = RequestID

Param2 = LINEERR_OPERATION_FAIL_NO_ACTIVE_RD_SET (0xC0000016)

Update Remote Destination RD1 "Mobile"on CTI Remote Device A with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_NewRDNumber = "914086271309"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

LineMakeCall on Line-A with DN (C -DN 1000)

*** Only Remote Destination "Mobile" rings and it rings immediately as the RD is set Active

*** No Call presented on EP

LineMakeCall() success

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = OFFERING

Answer the first Call on CTI Remote Device:

Answer() on the call on CTIRemote Device(A)

LineAnswer() fail with Error LINEEE_OPERATIONUNAVAIL

LineGetCallInfo() on call on Device A(CTIRD)

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 2000

dwCallerIDName = voiceConnect

dwCalledID = 2000

dwCalledIDName = 2000name

DevSpecific ::

UnicodeCallerPartyName =

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName =

ModifiedCallingParty = 2000

ModifiedCalledParty = 2000

ModifiedConnectedID =

Once Remote Destination answers the call, call will be offered on initial dialed number C

Call will be present on Enterprise Phone and call will be Remote In Use Call

Call on C :

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = CONNECTED

LINE_CALLSTATE -Param1 = RINGBACK

Call on Enterprise Phone :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = ACCEPTED

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

C answers the call

LineAnswer() on call on Device-C

LineAnswer() success

Call on C :

LINE_CALLSTATE -Param1 = CONNECTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = CONNECTED (active)

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LineGetCallInfo() on call on Device C

LineGetCallInfo() success

LineCallInfo ::

CallReason = UNKNOWN (0x400)

dwCallerID = 2000

dwCallerIDName = 2000name

dwCalledID = 1000

dwCalledIDName = 1000name

dwConnectedID = 2000

dwConnectedIDName = CTIRD-2000name

DevSpecific ::

ExtendedCallReason = CtiReasonMobility(0x021 = 33)

UnicodeCallerPartyName = 2000name

UnicodeCalledPartyName = 1000name

UnicodeConnectedPartyName = 2000name

ModifiedCallingParty = 2000

ModifiedCalledParty = 1000

ModifiedConnectedID = 2000

LineGetCallInfo() on call on Device A/B

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 2000

dwCallerIDName = 2000name

dwCalledID = 2000

dwCalledIDName = 2000name

dwConnectedID = 1000

dwConnectedIDName = 1000name

DevSpecific ::

CallAttributeType = TSPCallAttribute_DVOCall (0x00002000)

UnicodeCallerPartyName = 2000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName = 1000name

ModifiedCallingParty = 2000

ModifiedCalledParty = 2000

ModifiedConnectedID = 1000

LineDrop() for the call on Device A (CTI-RD)

LineDrop() success

Call on C :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LINE_CALLSTATE -Param1 = IDLE

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Multiple Calls -Answer/hold/Resume

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000000

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000000

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Update Remote Destination RD1 "Mobile"on CTI Remote Device A with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_NewRDNumber = "914086271309"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

Make Call between C and A[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same as above test cases

LineMakeCall on Line-D with DN (A -DN 2000)

LineMakeCall() success

Call on Device-D :

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Second Call on CTI Remote Device[A] [D ' A] :

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Second Call on Enterprise Phone[B] [D ' A]:

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

There won't be second call offered to Remote Destination

Answer() on the second call on CTIRemote Device(A)

Remote Destination and D will be talking/ will have Media connection

LineAnswer() returns success

Calls on CTI Remote Device :

Call1 [C ' A]:

LINE_CALLSTATE -Param1 = ONHOLD

Call1 [D ' A]:

LINE_CALLSTATE -Param1 = CONNECTED

Calls on Enterprise Phone[B] :

Call1 [C ' A]:

LINE_CALLSTATE -Param1 = ONHOLD

Call1 [D ' A]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Resume the first call on CTIRemote Device [A]

LineUnhold() on the call [c ' A] on Device A

Remote Destination and C will be talking/ will have Media connection

LineUnHold() returns success

Calls on CTI Remote Device :

Call1 [C ' A]:

LINE_CALLSTATE -Param1 = CONNECTED

Call1 [D ' A]:

LINE_CALLSTATE -Param1 = ONHOLD

Calls on Enterprise Phone[B] :

Call1 [C ' A]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Call1 [D ' A]:

LINE_CALLSTATE -

Param1 = ONHOLD

Resume the ONHOLD call [D ' A]from Enterprise Phone

LineUnHold() on the call [D ' A] on Device B

LineUnHold() returns success

Calls on CTI Remote Device :

Call1 [C ' A]:

LINE_CALLSTATE -Param1 = CONNECTED

Call1 [D ' A]:

LINE_CALLSTATE -Param1 = IDLE

Calls on Enterprise Phone[B] :

Call1 [C ' A]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Call1 [D ' A]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x01(active)

LineDrop() for the call on Device A (CTI-RD)

Call on Remote Destination will be dropped

LineDrop() success

Call on C :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LINE_CALLSTATE -Param1 = IDLE

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Multiple Calls -Multiple Lines -Answer/hold/Resume

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Update Remote Destination RD1 "Mobile"on CTI Remote Device A with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_NewRDNumber = "914086271309"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

Make Call between C and A[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same above test cases

LineMakeCall on Line-D with DN (A2 -DN 2001)

LineMakeCall() success

Call on Device-D :

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Second Call on CTI Remote Device[A] [D ' A2]:

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Second Call on Enterprise Phone[B] [D ' A2]:

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

There won't be second call offered to Remote Destination

Answer() on the second call on CTIRemote Device(A)

Remote Destination and D will be talking/ will have Media connection

LineAnswer() returns success

Calls on CTI Remote Device :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = ONHOLD

Call1 [D ' A2]:

LINE_CALLSTATE -Param1 = CONNECTED

Calls on Enterprise Phone[B] :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = ONHOLD

Call1 [D ' A2]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Resume the first call on CTIRemote Device [A]

LineUnhold() on the call [c ' A1] on Device A

Remote Destination and C will be talking/ will have Media connection

LineUnHold() returns success

Calls on CTI Remote Device :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = CONNECTED

Call1 [D ' A2]:

LINE_CALLSTATE -Param1 = ONHOLD

Calls on Enterprise Phone[B] :

Call1 [C ' A1]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Call1 [D ' A2]:

LINE_CALLSTATE -

Param1 = ONHOLD

Drop the Connected Active Call on CTI Remote Device.

LineDrop() for the call[C ' A1] on Device A (CTI-RD)

Call on Remote Destination will not be dropped as there is other Active/OnHold call on CTI Remote Device

As second Call is on OnHold state, Remote Destination will listen Dead Air

LineDrop() success

Call on C :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Calls on CTI Remote Device :

[C ' A1] :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

Call [C ' A1]

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LINE_CALLSTATE -Param1 = IDLE

Drop the onHold call on CTI Remote Device

LineDrop() for the call on Device A (CTI-RD)

Call on Remote Destination is dropped

C and EP call will not be disconnected.

On C call will be in Connected state and on EP call will be in OnHold state.

LineDrop() success

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Transfer

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Make Call between C and A1[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same as above test cases

Setup Transfer and Dial D

LineSetupTransfer() on the call [C ' A1] on Device A

LineSetupTransfer returns success

Primary Call on CTI Remote Device[A] [C ' A1] :

LINE_CALLSTATE -Param1 = OnholdPendingTransfer

Consult Call on CTI Remote Device[A] [A1 ' D]:

LineDial() on Consult call with DN -D

LINE_CALLSTATE -Param1 = DIALTONE

LINE_CALLSTATE -Param1 = DIALING

Calls on Enterprise Phone[B] :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = ONHOLD

Call1 [A1 ' D]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Consult Call on CTI Remote Device[A] [A1 ' D]:

LINE_CALLSTATE -Param1 = PROCEEDING

LINE_CALLSTATE -Param1 = RINGBACK

Answer the Call on Device D

Remote Destination and D will be talking/ will have Media connection

Secondary Call on CTI Remote Device:

Call1 [A1 ' D]:

LINE_CALLSTATE -Param1 = CONNECTED

Param2 = 0x01(active)

Complete Transfer on the Primary Call[C ' A]with [A ' D ] call as consult call

LineCompleteTranfer() on the call [c ' A1] on Device A

D and C will be talking/ will have Media connection

Both the Calls on CTI Remote Device Drop

Primary Call on CTI Remote Device :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Secondary Call on CTI Remote Device:

Call1 [A ' D]:

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Direct Transfer on same Line

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Make Call between C and A1[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same above test cases

Make Call between D and A1

Call Info is same above Multiple Call across lines test case

DirectTrnasfer on the calls on CTI Remote Device

Both Calls on Remote Device and call on Remote Destination drop

Both the Calls on CTI Remote Device Drop

Primary Call on CTI Remote Device :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Secondary Call on CTI Remote Device:

Call1 [A1 ' D]:

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

DirectTrnasfer on the calls on CTI Remote Device

Both Calls on Remote Device and call on Remote Destination drop

CciscoLineDevSpecificDirectTransfer on the call [c ' A1] on Device A with ConsultCallID = CallID of [D ' A1]

D and C will be talking/ will have Media connection

Both the Calls on CTI Remote Device Drop

Primary Call on CTI Remote Device :

Call1 [C ' A1]:

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Secondary Call on CTI Remote Device:

Call1 [A1 ' D]:

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Conference -Setupconference/AddtoConference

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Make Call between C and A1[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same above test cases

Setup Conference and Dial D

LineSetupConference() on the call [C ' A1] on Device A

LineDial() on Consult call with DN -D

LineSetupConference returns success

Original Call on CTI Remote Device[A] :

LINE_CALSTATE = CONFERENCE

Conference Parent Call on CTI Remote Device[A] :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = OnholdPendingConference

Consult Call on CTI Remote Device[A] :

LINE_CALLSTATE -Param1 = DIALTONE

LINE_CALLSTATE -Param1 = DIALING

Calls on Enterprise Phone[B] :

Call1 [C ' A]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Call1 [A ' D]:

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

Consult Call on CTI Remote Device[A] :

LINE_CALLSTATE -Param1 = PROCEEDING

LINE_CALLSTATE -Param1 = RINGBACK

Answer the Call on Device D

Remote Destination and D will be talking/ will have Media connection

Secondary Call on CTI Remote Device:

Call1 [A ' D]:

LINE_CALLSTATE -Param1 = CONNECTED

LINE_CALLSTATE -Param1 = IDLE

Complete Conference on the Primary Call[C ' A]with [A ' D ] call as consult call

LineAddtoConference() on the call [c ' A1] on Device A

All 3 parties C, D and CTI Remote Device[Remote Destination] will be in Conference

Call model on CTI Remote Device :

[C ' A1]-[ Original Call1]-[ state = Conference]

[A1 ' Conference]-[ Conference Parent Call]-[State = CONNECTED]

[A1 ' D]-[Consult Call]-[state -CONFERENCE]

Call Model on Enterprise Phone:

Same as CTI Remote Device, all calls are RIU Calls

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Join on same Line

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Make Call between C and A1[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same above test cases

Make Call between D and A1

Call Info is same above Multiple Call across lines test case

Join on the Primary Call[C ' A1]with [A1 ' D ] call as consult call

CCiscoLineDevSpecificJoin() on the call [c ' A1] on Device A with CallIDstoJoin = CallID of Call [D ' A1]

CTIRemoteDevice [A -Remote Destination], D and C will be in Conference.

Original Call on CTI Remote Device[A] [C ' A1]:

LINE_CALSTATE = CONFERENCE

Conference Parent Call on CTI Remote Device[A] :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = CONNECTED

Consult Call on CTI Remote Device[A] [D ' A1]:

LINE_CALLSTATE -Param1 = CONFERENCE

Conference Model will be created on CTI Remote Device and RIU Conference Model on EP

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Direct Transfer/Join across Line on CTI Remote Device

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Make Call between C and A1[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same above test cases

Make Call between D and A2

Call Info is same above Multiple Call across lines test case

Join on the Primary Call[C ' A1]with [A2 ' D ] call as consult call

CCiscoLineDevSpecificJoin() on the call [c ' A1] on Device A with CallIDstoJoin = CallID of Call [D ' A2]

Or

CciscoLineDevSpecificDirectTransfer on the call [c ' A1] on Device A with ConsultCallID = CallID of [D ' A2]

Direct Transfer / Join Across Line is not supported on CTI Remote Device

Line_Reply with error = LINEERR_OPERATIONUNAVAIL

Variation:

On any unsupported Feature Request

For Example:

CallAcceptRequest

CallAnswerRequest

CallParkRequest

LineCallUnParkRequest

LINEERR_OPERATIONUNAVAIL

Or PHONEERR_OPERATIONUNAVAIL

Depending on the Line/Phone API request.

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

Cbarge

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A', A'' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

Make Call between C and A1[Remote Destinaton], either normal incoming or DVO call on CTI Remote Device

Call Info is same above test cases

cBarge from CTI Remote Device is not supported as CTI Remote Device is a Static virtual Device.

cBarge from EP [Enterprise phone]

*** cBarge will be successful and CTIRemote Device, EP and Caller will be in Conference.

*** as CTI Remote Device doesn't report RIU calls, there won't be RIU Conference created on CTI Remote Device reflecting Active Conference Call on EP

Conference Call model on CTI Remote Device :

[C ' A1]-[ Original Call1]-[ state = Conference]

[A1 ' Conference]-[ Conference Parent Call]-[State = CONNECTED]

[A1 ' A1(EP)]-[Consult Call]-[state -CONFERENCE]

Call Model on Enterprise Phone:

Active Conference Calls:

[C ' A1(CTIRD)]-[ Original Call1]-[ state = Conference]

[A1(EP) ' Conference]-[ Conference Parent Call]-[State = CONNECTED]

[A1(EP) ' A1(CTIRD)]-[Consult Call]-[state -CONFERENCE]

RIU Conference Calls:

[C ' A1]-[ Original Call1]-[ state = Conference]

[A1 ' Conference]-[ Conference Parent Call]-[State = CONNECTED]

[A1 ' A1(EP)]-[Consult Call]-[state -CONFERENCE]

Variation:

Barge Operation on Enterprise Phone

Barge Operation will fail as CTI Remote Devices doesn't have BIB.

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

URI Dialing -Basic Incoming Call to CTI Remote Device

Precondition: InAddition to configuration from previous usecases

CTI Remote Device:

Line:

Line-A (DN -2000) (URI Configured -drajesh@cisco.com)

C (IP Phone -Name: SEPxxxxxxxx)

Line:

Line-C -DN -1000(URI configured -1000@cisco.com)

D (IP Phone -Name: SEPxxxxxxxx)

Line:

Line-D -DN -1001(URI configured -1001@cisco.com)

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

LineMakeCall on Line-C with URI of CTI Remote Device (DestinationAddress -drajesh@cisco.com)

LineMakeCall() success

Call on C :

LINE_CALLSTATE -Param1 = DIALING

LINE_CALLSTATE -Param1 = PROCEEDING

LINE_CALLSTATE -Param1 = RINGBACK

Call on CTI Remote Device :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Call on Enterprise Phone :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

After "Delay Before Ringing Timer" expires the call is offered on Remote Destinations and all Remote Destinations Ring

LineGetCallInfo() on call on Device C

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName =

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = [100 | Cisco.com | 0x0 | 0x0 | 0x1]

Called :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Connected : Empty

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID =

LineGetCallInfo() on call on Device A/B

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName =

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = [100 | Cisco.com | 0x0 | 0x0 | 0x1]

Called :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Connected : Empty

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID =

Answer on any of the Remote Destination

Call on C :

LINE_CALLSTATE -Param1 = CONNECTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = CONNECTED (active)

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LineGetCallInfo() on call on Device C

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

dwConnectedID = 2000

dwConnectedIDName = CTIRD-2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName = CTIRD-2000name

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = [100 | Cisco.com | 0x0 | 0x0 | 0x1]

Called :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Connected :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID = 2000

LineGetCallInfo() on call on Device A/B

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 1000

dwCallerIDName = 1000name

dwCalledID = 2000

dwCalledIDName = 2000name

dwConnectedID = 2000

dwConnectedIDName = CTIRD-2000name

DevSpecific ::

UnicodeCallerPartyName = 1000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName = CTIRD-2000name

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = [100 | Cisco.com | 0x0 | 0x0 | 0x1]

Called :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Connected :

[User | Host | Port | TransportType | URI Type] = [100 | Cisco.com | 0x0 | 0x0 | 0x1]

ModifiedCallingParty = 1000

ModifiedCalledParty = 2000

ModifiedConnectedID = 2000

LineDrop() for the call on Device A (CTI-RD)

Call on Remote Destination is dropped

LineDrop() success

Call on C :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LINE_CALLSTATE -Param1 = IDLE

Variation :

Answer the call on Enterprise Phone (B)

LineAnswer() on the call on Device B

Call on Remote Device/Remote Destination drops

Call on C :

LINE_CALLSTATE -Param1 = CONNECTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

URI Dialing -DVO Call (Outgoing Call initiation from CTI Remote device)

Precondition: same as above usecase

Action

TAPI messages

TAPI structures

LineInitializeEx

Lines are Enumerated

Open all Lines (A, A' and C)

LineOpen() with ExtVer-0x000C0000

LineOpen() returns Success

LineMakeCall on Line-A with DN (C -DN 1000)

LineMakeCall() returns RequestID

LINE_REPLY

Param1 = RequestID

Param2 = LINEERR_OPERATION_FAIL_NO_ACTIVE_RD_SET (0xC0000016)

Update Remote Destination RD1 "Mobile"on CTI Remote Device A with IsActive set to true

CiscoLineDevSpecific UpdateRemoteDestination Req

m_RDNumber = "914086271309"

m_UnicodeRDName = "Mobile"

m_NewRDNumber = "914086271309"

m_activeRD = 0x00000001

EVENT = LINE_DEVSPECIFIC

dwParam1 = SLDSMT_LINE_PROPERTY_CHANGED

dwParam2 = LPCT_REMOTE_DESTINATION_INFO (0x00004000)

LineGetDevCaps() with dwDeviceID = LineDeviceId of Line-A.

LineGetDevCaps() returns success

LINEDEVCAPS::DevSpecific

dwLineTypes = (0x00000000)

DeviceProtocolType =

DeviceProtocolType_CTI_ REMOTE_DEVICE (0x03)

Remote Destination Info:

unicodeRDName = "Mobile"

RDNumber = "4086271309"

isActiveRD = 0x00000001

unicodeRDName = "Office"

RDNumber = "4089022131"

isActiveRD = 0x00000000

IsMyAppLastToSetActiveRD = 0x00000001

LineMakeCall on Line-A with URI of C (DestinationAddress -1000@cisco.com)

*** Only Remote Destination "Mobile" rings and it rings immediately as the RD is set Active

*** No Call presented on EP

LineMakeCall() success

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = OFFERING

Answer the first Call on CTI Remote Device:

Answer() on the call on CTIRemote Device(A)

LineAnswer() fail with Error LINEEE_OPERATIONUNAVAIL

LineGetCallInfo() on call on Device A(CTIRD)

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 2000

dwCallerIDName = voiceConnect

dwCalledID = 2000

dwCalledIDName = 2000name

DevSpecific ::

UnicodeCallerPartyName =

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName =

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = empty

Called :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Connected :

[User | Host | Port | TransportType | URI Type] = empty

ModifiedCallingParty = 2000

ModifiedCalledParty = 2000

ModifiedConnectedID =

Once Remote Destination answers the call, call will be offered on initial dialed number C

Call will be present on Enterprise Phone and call will be Remote In Use Call

Call on C :

LINE_CALLSTATE -Param1 = OFFERING

LINE_CALLSTATE -Param1 = ACCEPTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = CONNECTED

LINE_CALLSTATE -Param1 = RINGBACK

Call on Enterprise Phone :

LINE_APPNEWCALL

LINE_CALLSTATE -Param1 = ACCEPTED

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

C answers the call

LineAnswer() on call on Device-C

LineAnswer() success

Call on C :

LINE_CALLSTATE -Param1 = CONNECTED

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = CONNECTED (active)

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LineGetCallInfo() on call on Device C

LineGetCallInfo() success

LineCallInfo ::

CallReason = UNKNOWN (0x400)

dwCallerID = 2000

dwCallerIDName = 2000name

dwCalledID = 1000

dwCalledIDName = 1000name

dwConnectedID = 2000

dwConnectedIDName = CTIRD-2000name

DevSpecific ::

ExtendedCallReason = CtiReasonMobility(0x021 = 33)

UnicodeCallerPartyName = 2000name

UnicodeCalledPartyName = 1000name

UnicodeConnectedPartyName = 2000name

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Called :

[User | Host | Port | TransportType | URI Type] = [100 | Cisco.com | 0x0 | 0x0 | 0x1]

Connected :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

ModifiedCallingParty = 2000

ModifiedCalledParty = 1000

ModifiedConnectedID = 2000

LineGetCallInfo() on call on Device A/B

LineGetCallInfo() success

LineCallInfo ::

dwCallerID = 2000

dwCallerIDName = 2000name

dwCalledID = 2000

dwCalledIDName = 2000name

dwConnectedID = 1000

dwConnectedIDName = 1000name

DevSpecific ::

CallAttributeType = TSPCallAttribute_DVOCall (0x00002000)

UnicodeCallerPartyName = 2000name

UnicodeCalledPartyName = 2000name

UnicodeConnectedPartyName = 1000name

SIP URI Info:

Caller :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Called :

[User | Host | Port | TransportType | URI Type] = [drajesh | Cisco.com | 0x0 | 0x0 | 0x1]

Connected :

[User | Host | Port | TransportType | URI Type] = [1000 | Cisco.com | 0x0 | 0x0 | 0x1]

ModifiedCallingParty = 2000

ModifiedCalledParty = 2000

ModifiedConnectedID = 1000

LineDrop() for the call on Device A (CTI-RD)

LineDrop() success

Call on C :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on CTI Remote Device :

LINE_CALLSTATE -Param1 = DISCONNECTED

LINE_CALLSTATE -Param1 = IDLE

Call on Enterprise Phone :

LINE_CALLSTATE -

Param1 = CONNECTED

Param2 = 0x02 (Inactive)

LINE_CALLSTATE -Param1 = IDLE

Variation :

Test the same with CSF Device in Extend Mode

Expected result would be same as observed on CTI Remote Device

CTI RD Call Forwarding

Table 45  Use Case 1: Device A calls CTIRD when Active RD is not set and "Route calls to all remote destinations when client is not connected" is enabled.
Scenario Expected Result
1. Provider Open request

2. Issue Line Open on remote device and devices which have the remote destinations

3. Phone A makes a call to CTIRD

Incoming calls are Forwarded to all remote destinations.
Table 46  Use Case 2: Device A calls CTIRD when Active RD is not set and "Route calls to all remote destinations when client is not connected" is disabled. There is no Call Forward number set on on the shared enterprise phone.
Scenario Expected Result
1. Provider Open request

2. Issue Line Open on remote device and devices which have the remote destinations

3. Phone A makes a call to CTIRD

Call is disconnected with reason code -USER_BUSY.
Table 47  Use Case 3: Device A Calls CTIRD when CTI remote device is observed , Remote destination is not configured and "Route calls to all remote destinations when client is not connected" is enabled(CFNA is configured on enterprise number to Voice mail box)
Scenario Expected Result
1. Provider Open request

2. Issue Line Open on remote device and devices which have the remote destinations

3. Phone A makes a call to CTIRD

Call will route to voice mail number.
Table 48  Use Case 4: Device A Calls CTIRD when CTI remote device is observed , Remote destination is not configured and "Route calls to all remote destinations when client is not connected" is disabled(CFNA is configured on enterprise number to Voice mail box)
Scenario Expected Result
1. Provider Open request

2. Issue Line Open on remote device and devices which have the remote destinations

3. Phone A makes a call to CTIRD

Call will route to voice mail number.
Table 49  Use Case 5: DeviceA calls CTIRD when Active RD is set and "Route calls to all remote destinations when client is not connected" is enabled. Setup: A IP Phone, B CTI-RD, C RDD1, D RDD2. Active RD is set to C
Scenario Expected Result

1. Provider Open request

2. Issue Line Open on remote device and devices which have the remote destinations

3. Phone A makes a call to B

4. C answers the call

Incoming calls is routed to active remote destination, such as C.
Table 50  Use Case 6: Device A calls CTIRD when Active RD is set and "Route calls to all remote destinations when client is not connected" is enabled. Setup: A IP Phone, B CTI-RD, C RDD1, D RDD2. Active RD is set to C
Scenario Expected Result
1. Provider Open request

2. Issue Line Open on remote device and devices which have the remote destinations

3. Phone A makes a call to B

Incoming calls is routed to active remote destination.

Video capabilities and multimedia information

Use cases related to Video Capabilities and Multi-Media Information feature are mentioned below:

Media Capability on device A (SIP phone with camera) which is video-enabled, supports telepresence, and has 2 screens

Action

Expected events

LineInitializeEx

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice A

 

 

 

 

LineShutdown

 

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Video Capability =

0x00000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 1

ScreenCount = 2

 

Media Capability on device A (SIP phone) which is not video-enabled, supports telepresence, and has 2 screens

Action

Expected events

LineInitializeEx

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice A

 

 

 

 

LineShutdown

 

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Media Capability =

0x00000000 [CiscoDeviceVideoCapability_None]

TelepresenceInfo = 1

ScreenCount = 2

 

Media Capability on device A (CTI Port/Remote Point)

Action

Expected events

LineInitializeEx

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice A

 

 

 

LineShutdown

 

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Media Capability = 0x00000000 [CiscoDeviceVideoCapability_None]

TelepresenceInfo = 0

Screen Count = 0

 

Media Capability on an Acquired device B which is media-enabled (super provider scenario), supports telepresence, and has 3 screens

Action

Expected events

LineInitializeEx

 

LineOpen with Ext version 0x000D0000 with deviceId for linedevice A

 

Issue CCiscoLineDevSpecificAcquire to Acquire Device B.

 

 

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice B

 

LineShutdown

 

LineOpen successful.

 

Device Acquired Successfully. LINE_CREATE message fired.

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Media Capability = 0x00000001 [CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 1

Screen Count = 3

 

Media Capability on device A (ParkDN/Pickupdevice)

Action

Expected events

LineInitializeEx

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice A

 

 

 

LineShutdown

 

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Media Capability = 0x00000000 [CiscoDeviceVideoCapability_None]

TelepresenceInfo = 0

Screen Count = 0

Media Capability on device A (SIP phone which is unregistered and is video-enabled)

Action

Expected events

LineInitializeEx

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice A

 

 

 

LineShutdown

 

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Media Capability = 0x00000000 [CiscoDeviceVideoCapability_None]

TelepresenceInfo = 0

Screen Count = 0

Video Capability on device B (A is a SIP phone with video-enabled and B is SIP phone with video-enabled) , both devices support telepresence, and have 3 screens.

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B, B answers.

 

Issue LineGetcallInfo() with Ext version for linedevice B

 

 

 

LineShutdown

 

 

 

B :

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapabilities :

VideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000001(Telepresence Enabled)

Screen Count = 3

CalledPartyVideoCapabilities :

VideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000001(Telepresence Enabled)

Screen Count = 3

Variation 1:

A has video enabled and B has video disabled. A has Telepresence enabled and has 3 screens, B has Telepresence disabled and has 1 screens.

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapabilities :

VideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000001(Telepresence Enabled)

Screen Count = 3

CalledPartyVideoCapabilities :

 

VideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None]

 

TelepresenceInfo = 0x000000000(Telepresence Disabled)

 

Screen Count = 1

Variation 2:

A has video enabled,1 scren and B is a CTI Port or Route Point.

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapabilities :

VideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000000(Telepresence Disabled)

Screen Count = 1

CalledPartyVideoCapabilities :

VideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None]

TelepresenceInfo = 0x000000000(Telepresence Disabled)

Screen Count = 0

Video Capability on device C after redirect (A is a SIP phone which is video-disabled, B and C are video-enabled)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B.

 

B redirects to C, C answers

 

Issue LineGetcallInfo() with Ext version for linedevice C

 

 

LineShutdown

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled

Video Capability on device C after Blindtransfer (A is a SIP phone which is video-disabled, B and C are video-enabled )

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B.

 

B does a blindtransfers to C, C answers

 

Issue LineGetcallInfo() with Ext version for linedevice C

 

 

LineShutdown

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled

Video Capability on device C after consult transfer (A is a SIP phone which is video-disabled, B and C are video-enabled )

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B.

 

B does a LineSetupTransfer to C,

C answers

 

B does a LineCompleteTransfer

 

Issue LineGetcallInfo() with Ext version for linedevice C

 

 

LineShutdown

 

 

 

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled

Video Capability on device B on an existing call (Both A and B are SIP phones which are video-enabled)

Action

Expected events

 

A does a Call to B, B answers.

 

LineInitializeEx

 

Issue LineGetcallInfo() with Ext version for linedevice B

 

 

 

LineShutdown

 

 

 

 

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

Variation 1:

A has video enabled and B has video disabled.

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None

Variation 2:

A has video enabled and B is a CTI Port or Route Point.

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None

Dynamic Media Capability Change on device A (SIP phone with camera) which is video enabled

Action

Expected events

LineInitializeEx

 

LineOpen on A

 

Issue LineGetDevCaps() with Ext version 0x000D0000 with deviceId for linedevice A

 

 

Change Video Capability of device to Disabled from CUCM Admin page

 

LineShutdown

 

 

LINEGETDEVCAPS::DEVSPECIFIC exposes Video Capability =

0x00000001[CiscoDeviceVideoCapability_Enabled]

TSP will fire SLDSMT_LINE_PROPERTY_CHANGED event to application with dwParam2 = LPCT_DEVICE_VIDEO_INFO(0x00010000).

 

Variation 1:

Intially Device A has Video disabled and then change Video Capability of device to enabled from CUCM Admin page.

TSP will fire SLDSMT_LINE_PROPERTY_CHANGED event to application with dwParam2 = LPCT_DEVICE_VIDEO_INFO(0x00010000).

Video Capability on Device A and B; both are video-enabled SIP phones and, both devices support Telepresence and has 3 screens

Action

Expected events

LineInitializeEx

 

LineOpen on A and B

 

A does a LineMakeCall to B, B answers.

 

 Issue LineGetcallInfo() with Ext version for linedevice A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

LineShutdown

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyMultiMediaCapBitMask = 0x00000007

CalledPartyMultiMediaCapBitMask = 0x00000007

 

CallingPartyMultiMediaCapInfo :

VideoCapability = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000001(Telepresence Enabled)

Screen Count = 3

CalledPartyMultiMediaCapInfo :

VideoCapability = 0x00000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x00000001(Telepresence Enabled

Screen Count = 3

Variation 1:

A has video enabled and B has video disabled. A has Telepresence enabled and has 3 screens, B has Telepresence disabled and has 1 screens.

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyMultiMediaCapBitMask = 0x00000007

CalledPartyMultiMediaCapBitMask = 0x00000007

CallingPartyMultiMediaCapInfo :

VideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000001(Telepresence Enabled)

Screen Count = 3

CalledPartyMultiMediaCapInfo :

VideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None]

TelepresenceInfo = 0x000000000(Telepresence Disabled)

Screen Count = 1

Variation 2:

A has video enabled,1 screen and B is a CTI Port or Route Point.

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyMultiMediaCapBitMask = 0x00000007

CalledPartyMultiMediaCapBitMask = 0x00000000

CallingPartyMultiMediaCapInfo :

VideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

TelepresenceInfo = 0x000000000(Telepresence Disabled)

Screen Count = 0x00000001

CalledPartyMultiMediaCapInfo :

VideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_None]

TelepresenceInfo = 0x000000000(Telepresence Disabled)

Screen Count = 0x00000000

Check if the Multimedia streams info has not returned on the call from both calling party and called party, if lines are opened with Ext 0x000B0000 (TLS connections must be disabled, Phone A and B are video-disabled).

Action

Expected events

LineInitializeEx

 

LineOpen at A and B with extension version 0x000B0000

 

A does a LineMakeCall to B / B answers the call

 

Check there is no CallDevSpecific event returned.

 

 

 

 

 

 

 

No CallDevSpecific event returned -SLDSMT_MULTIMEDIA_STREAMSDATA

Check if the Multimedia streams info has returned on the call from both calling party and called party, if lines are opened with Ext 0x000D0000 (TLS connections must be disabled, Phone A and B are video-enabled)

Action

Expected events

LineInitializeEx

LineOpen at A and B with extension version 0x000B0000

A does a LineMakeCall to B / B answers the call

Check there is CallDevSpecific event returned.

 

LineGetCallInfo on A

 

 

 

CallDevSpecific event returned -SLDSMT_MULTIMEDIA_STREAMSDATA

DevSpecificPart of LINECALLINFO For Party A: Video Stream Information returned for the following:

CompressionType = The actual compression type

BitRate = The actual bit rate

MediaMode = 0x00000000

PacketSize = The actual packet size

bSilenceSupressionFlag = 0x00000000

bKeyInfoPresen = 0x00000000

RxRTPDestinationV6Offset = The actual IPV6 address offset

RxRTPDestinationV6Size = The actual IPV6 address size

RxRTPIPV4Address = The actual IPV4 address

RxRTPIPV4Por t = The actual IPV4 port

RxIpAddrMode = The actual IPV4 mode

TxRTPDestinationV6Offset = The actual IPV6 address offset

TxRTPDestinationV6Size = The actual IPV6 address size

TxRTPIPV4Address = The actual IPV4 address

TxRTPIPV4Port = The actual IPV4 port

TxIpAddrMode = The actual IPV4 mode

MultiMediaEncryptionKey Information returned is the following

AlgorithmID = 0x00000000

TxKeyOffset = 0x00000000

TxKeySize = The actual size

RxKeyOffset = The actual offset

RxKeySize = The actual size

TxSaltOffset = The actual offset

TxSaltSize = The actual size

RxSaltOffset = The actual offset

RxSaltSize = The actual size

TxIsMKIPresent = 0x00000000

RxIsMKIPresent = 0x00000000

SecurityIndicator = 0x00000001

Variation 1:

 

A does a LineMakeCall to B / B answers the call

 

Application does LineHold on B

 

LineGetCallInfo on A and B

 

 

 

 

Application does LineUnHold on B

 

LineGetCallInfo on A and B

 

 

Application does a LineDrop on B.

 

LineGetCallInfo on A and B

 

 

 

 

 

 

 

CallDevSpecific event returned -SLDSMT_MULTIMEDIA_STREAMSDATA

The value of MediaMode should be changed 0x000000003

 

 

CallDevSpecific event returned -SLDSMT_MULTIMEDIA_STREAMSDATA

The value of MediaMode should be changed 0x000000000

 

 

CallDevSpecific event returned -SLDSMT_MULTIMEDIA_STREAMSDATA

The value of MediaMode should be changed 0x000000003

Negotiated video capability will be reported to the called party accross a inter cluster call (over SIP – ICT trunk) using early offer (Phone A is a video disabled SIP Phone and Phone B has video enabled, A is in cluster 1 and B is in cluster 2)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B. B answers.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

LineGetCallInfo on B

 

LineShutdown

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

Variation 1:

 

A and B are SIP Phone and have video enabled.

 

LineGetCallInfo on A

 

 

 

 

 

LineGetCallInfo on B

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

Multiple redirect over SIP trunk (Phone A, B, and C are video enabled SIP Phones, Phone D has video disabled. Phone A is in cluster 1 and Phone B, C, and D are in cluster 2)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B.

 

LineGetCallInfo on B

 

 

 

 

 

 

 

 

B redirects the call to C,

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

 

C redirects the call to D,

 

 

LineGetCallInfo on D

 

 

 

 

 

 

 

 

LineShutdown

 

 

 

 

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

 

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

 

 

 

D:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

Redirect over SIP trunk (Phone A is video enabled SIP Phone and Phone B and C have video disabled, Phone A is in cluster 1 and Phone B and C are in cluster 2)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B. B answers.

 

B redirects to C, C answers.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

 

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

 

 

 

 

LineShutdown

 

A and B have video enabled, C has video disabled

 

A does a LineMakeCall to B. B answers.

 

B redirects to C, C answers.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

 

 

 

 

 

 

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus =

0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

Shared Line – Hold and Resume scenario over SIP trunk (Phone A and C are video enabled SIP Phones and Phone B has video disabled, Phone A is in cluster 1 and Phone B and C are in cluster 2. Phone B and C are shared lines)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B. B answers.

 

B Holds the call.

 

C Unholds the call.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

 

LineShutdown

 

A and B are have video enabled and C has video disabled.

 

A does a LineMakeCall to B. B answers.

 

B Holds the call.

 

C Unholds the call.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

 

 

 

 

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

Multiple redirect over H323 ICT trunk (Phone A, B, C and D are video enabled SIP Phones, Phone A is in cluster 1 and Phone B, C, and D are in cluster 2)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B.

 

 

 

 

 

 

LineGetCallInfo on B

 

 

 

 

 

 

 

 

 

 

 

 

 

 

B redirects the call to C.

 

LineGetCallInfo on C

 

 

 

 

 

 

 

 

 

 

 

C redirects the call to D.

 

LineGetCallInfo on D

 

LineShutdown

 

 

 

 

 

 

 

 

 

B:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyMultiMediaCapabilityBitMask = 0x000000001

CalledPartyMultiMediaCapabilityBitMask = 0x000000001

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyMultiMediaCapabilityBitMask = 0x000000001

CalledPartyMultiMediaCapabilityBitMask = 0x000000001

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

D:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyMultiMediaCapabilityBitMask = 0x000000001

CalledPartyMultiMediaCapabilityBitMask = 0x000000001

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

Redirect over H323 trunk (Phone A is video enabled SIP Phone and Phone B and C have video disabled, Phone A is in cluster 1 and Phone B and C are in cluster 2)

Action

Expected events

LineInitializeEx

 

A does a LineMakeCall to B. B answers.

 

B redirects to C, C answers.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

 

LineShutdown

 

A and B have video enabled, C has video disabled

 

A does a LineMakeCall to B. B answers.

 

B redirects to C, C answers.

 

LineGetCallInfo on A

 

 

 

 

 

 

 

 

 

LineGetCallInfo on C

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

 

 

 

 

 

 

 

 

 

A:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000000[CiscoDeviceVideoCapability_Disabled]

 

 

C:

LINEGETCALLINFO::DEVSPECIFIC exposes

CallingPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

CalledPartyVideoCapStatus = 0x000000001[CiscoDeviceVideoCapability_Enabled]

Direct transfer across lines

Use cases related to Direct Transfer Across Lines feature are mentioned below:


Note


The device mentioned in the use cases also apply to SCCP device and SIP TNP phones when Direct Transfer is issued from application.


Direct Transfer across Lines on RoundTable phones via application

Device A, B, and C where B is roundtable phone and has line B1 and B2 configured.

Action

Expected events

A ‡B1 is connected,

C ‡B2 is on hold

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1 Connected B1

For B1:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1, Connected = A

For B2:

LINE_CALLSTATE

param1 = x100, HOLD

Caller = C, Called = B2 , Connected = C

For C:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = C, Called = B2, Connected = B2

Application sends CciscoLineDevSpecificDirectTransfer on B1 with B2 as consult call

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1 Connected C

For B1:

Call goes IDLE

For B2:

Call goes IDLE

For C:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = C, Called = B2, Connected = A

Direct Transfer on Same Line on RoundTable phones via application

Device A, B, C where B is roundtable phone.

Action

Expected events

A ‡ B (c1) is connected,

C ‡ B (c2) is on hold

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B Connected B

For B:

Call-1

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B, Connected = A

Call-2

LINE_CALLSTATE

param1 = x100, HOLD

Caller = C, Called = B, Connected = C

For C:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = C, Called = B, Connected = B

Application sends CciscoLineDevSpecificDirectTransfer on B (c1) with c2 as consult call

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B Connected C

For B:

Call-1 and Call-2 will go IDLE

For C:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = C, Called = B, Connected = A

Direct Transfer Across Lines on RoundTable phones via application with call in Offering State

Device A, B, C where B is roundtable phone and has line B1 and B2 configured.

Action

Expected events

A (c1) ‡ B1(c2) is on hold,

B2 (c3) ‡ C (c4) is ringing

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1 Connected B1

For B1:

LINE_CALLSTATE

param1 = x100, HOLD

Caller = A, Called = B1, Connected = A

For B2:

LINE_CALLSTATE

param1 = x100, RINGBACK

Caller = B2, Called = C

For C:

LINE_CALLSTATE

param1 = x100, OFFERING

Caller = B2, Called = C

Application sends CciscoLineDevSpecificDirectTransfer on B1 (c2) with B2 (c3) as consult call

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B Connected C

For B1:

Call goES IDLE

For B2:

Call goes IDLE

For C:

LINE_CALLSTATE

param1 = x100, OFFERING

Caller = C, Called = B,

Failure of Direct Transfer Calls Across Lines

Device A, B, C where B is roundtable phone and has line B1 and B2 configured.

Action

Expected events

A (c1) ‡ B1(c2) is on hold,

Initiate new call (c3) on B2

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1 Connected B1

For B1:

LINE_CALLSTATE

param1 = x100, HOLD

Caller = A, Called = B1, Connected = A

For B2:

LINE_CALLSTATE

param1 = x100, DIALTONE

Application sends CciscoLineDevSpecificDirectTransfer on B1 (c2) with B2 (c3) as consult call

CciscoLineDevSpecificDirectTransfer gets error as LINEERR_INVALCALLSTATE.

Direct Transfer Calls Across Lines in Conference scenario

Device A, B, C, D and E where C is roundtable phone and has line C1 and C2 configured.

Action

Expected events

A/B/C1 in conference, B is controller, call on C1 is in hold state.

C2 /D/E in conference, D is controller, call on C2 is in connect state.

For A:

CONNECTED

CONFERENCED

Caller = A, called = B, connected = B

CONFERENCED

Caller = A, called = C1, connected = C1

For B:

CONNECTED

CONFERENCED

Caller = A, called = B, connected = B

CONFERENCED

Caller = B, called = C1, connected = C1

For C1:

ONHOLD

CONFERENCED

Caller = B, called = C1, connected = B

CONFERENCED

Caller = C1, called = A, connected = A

For C2:

CONNECTED

CONFERENCED

Caller = C2, called = D, connected = D

CONFERENCED

Caller = C2, called = E, connected = E

For D:

CONNECTED

CONFERENCED

Caller = D, called = C1, connected = C1

CONFERENCED

Caller = D, called = E, connected = E

 

For E:

CONNECTED

CONFERENCED

Caller = D, called = E, connected = D

CONFERENCED

Caller = E, called = C2, connected = C2

Application sends CciscoLineDevSpecificDirectTransfer on C1 with C2-call as consult call

CciscoLineDevSpecificDirectTransfer will succeed.

For A:

CONNECTED

CONFERENCED

Caller = A, called = B, connected = B

CONFERENCED

Caller = A, called = CB-2, connected = CB-2

For B:

CONNECTED

CONFERENCED

Caller = A, called = B, connected = B

CONFERENCED

Caller = B, called = CB-2, connected = CB-2

For C1:

IDLE

For C2:

IDLE

For D:

CONNECTED

CONFERENCED

Caller = D, called = CB-1, connected = CB-1

CONFERENCED

Caller = D, called = E, connected = E

For E:

CONNECTED

CONFERENCED

Caller = D, called = E, connected = D

CONFERENCED

Caller = E, called = CB-1, connected = CB-1

Connect Transfer Across Lines on RoundTable phones

Device A, B, C where B is roundtable phone and has line B1 and B2 configured.

Action

Expected events

A ‡ B1 is connected,

C ‡ B2 is on hold

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1 Connected B1

For B1:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1, Connected = A

For B2:

LINE_CALLSTATE

param1 = x100, HOLD

Caller = C, Called = B2, Connected = C

For C:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = C, Called = B2, Connected = B2

User performs connect transfer on B.

For A:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = A, Called = B1 Connected C

For B1:

Call goes IDLE

 

For B2:

Call goes IDLE

For C:

LINE_CALLSTATE

param1 = x100, CONNECTED

Caller = C, Called = B2, Connected = A

Do Not Disturb-Reject

Application enables DND-R on a phone

Action

TAPI messages

TAPI structures

Phone A enables DND-Reject in the admin pages

LINE_CALLDEVSPECIFIC

hDevice = C

dwCallbackInstance = 0

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_DND_OPTION_STATUS

dwParam3 = 2

Normal feature Priority

Action

TAPI messages

TAPI structures

With Phone B DND-R enabled, Phone A calls Phone B with feature priority as Normal

Party A

LINE_CALLSTATE = IDLE

Party B

No TAPI messages

Feature Priority - Emergency

Action

TAPI messages

TAPI structures

With Phone B DND-R enabled, Phone A calls Phone B with feature priority as Emergency

Party A

LINE_CALLSTATE = CONNECTED

dwParam1 = 0x00000100

dwParam2 = 0x00000001

LINECALLINFO (hCall-1)

hLine = C

dwCallID = T2

dwOrigin = INTERNAL

dwCallerID = A

dwCalledID = B

dwRedirectionID = NP

dwRedirectingID = NP

Party B

LINE_CALLSTATE = CONNECTED

dwParam1 = 0x00000100

dwParam2 = 0x00000001

LINECALLINFO (hCall-1)

hLine = C

dwCallID = T2

dwOrigin = INTERNAL

dwCallerID = A

dwCalledID = B

dwRedirectionID = NP

dwRedirectingID = NP

Shared Line scenario for DND-R

Action

TAPI messages

TAPI structures

Phones B and B’ represents shared lines. Phone B’ is DND-R enabled but not B. Phone A calls Phone B with feature priority normal

Party A

LINE_CALLSTATE = CONNECTED

dwParam1 = 0x00000100

dwParam2 = 0x00000001

LINECALLINFO (hCall-1)

hLine = C

dwCallID = T2

dwOrigin = INTERNAL

dwCallerID = A

dwCalledID = B

dwRedirectionID = NP

dwRedirectingID = NP

Party B

LINE_CALLSTATE = CONNECTED

dwParam1 = 0x00000100

dwParam2 = 0x00000001

LINECALLINFO (hCall-1)

hLine = C

dwCallID = T2

dwOrigin = INTERNAL

dwCallerID = A

dwCalledID = B

dwRedirectionID = NP

dwRedirectingID = NP

Party B’

 

LINE_CALLSTATE = CONNECTED

dwParam1 = 0x00000100

dwParam2 = 0x00000002

Application disables DND-R or changes the option for DND

Action

TAPI messages

TAPI structures

Phone A changes from DND-Reject to DND-RingerOff.

LINE_CALLDEVSPECIFIC

hDevice = C

dwCallbackInstance = 0

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_DND_OPTION_STATUS

dwParam3 = 1

Drop Any Party

Use cases related to Drop Any Party feature are mentioned below:

Conference: Unified CM Service Parameter Advanced Ad Hoc Conference Enabled = False.

Action

Expected events

A,B,C and D are in conference; B is conference Controller.

Conference Model:

Each line in conference will be having 4 callLegs, 3 conferenced and 1 connected

CallLegs on A:

Connected -to Conference Bridge

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -C)

Conferenced -(Connected Id -D)

CallLegs on B:

Connected -to Conference Bridge

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -C)

Conferenced -(Connected Id -D)

CallLegs on C:

Connected -to Conference Bridge

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -D)

CallLegs on D:

Connected -to Conference Bridge

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -C)

Application does a LineOpen (B) with new Ext ver.

 

  1. Application does LineRemoveFromConference on the ‘Conferenced’ callLeg on B which is connected to A.

A is dropped out of conference.

CallLegs after the Party is dropped from Conference:

Each line in conference will be having 4 callLegs, 2 Conferenced,1 IDLE and 1 connected

CallLegs on A:

All 4 CallLegs will be in IDLE state

CallLegs on B:

Connected -to Conference Bridge

Conferenced -(Connected Id -C)

Conferenced -(Connected Id -D)

IDLE -( on the conferenced callLeg which was connected to A)

CallLegs on C:

Connected -to Conference Bridge

IDLE -( on the conferenced callLeg which was connected to A)

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -D)

CallLegs on D:

Connected -to Conference Bridge

IDLE -( on the conferenced callLeg which was connected to A)

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -C)

Note   

All IDLE CallLegs will have CallStateChange Reason as CtiDropConferee.

Application does a LineOpen (A) with new Ext ver.

 

  1. Application does LineRemoveFromConference on the ‘Conferenced’ callLeg on A which is connected to B.

Error Message LINEERR_OPERATIONUNAVAIL will be sent to application

Conference -Unified CM Service Parameter Advanced Ad Hoc Conference Enabled = True’

Action

Expected events

A,B,C and D are in conference; B is conference Controller.

Conference Model:

Each line in conference will be having 4 callLegs, 3 conferenced and 1 connected

CallLegs on A:

Connected -to Conference Bridge

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -C)

Conferenced -(Connected Id -D)

CallLegs on B:

Connected -to Conference Bridge

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -C)

Conferenced -(Connected Id -D)

CallLegs on C:

Connected -to Conference Bridge

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -D)

CallLegs on D:

Connected -to Conference Bridge

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -B)

Conferenced -(Connected Id -C)

Application does a LineOpen (A) with new Ext ver.

Application does LineRemoveFromConference on the ‘Conferenced’ callLeg on A which is connected to B.

 

  1. Drop Ad Hoc Conference = Never

B is dropped out of conference.

CallLegs after the Party is dropped from Conference:

Each line in conference will be having 4 callLegs, 2 Conferenced,1 IDLE and 1 connected

CallLegs on B:

All 4 CallLegs will be in IDLE state

CallLegs on A:

Connected -to Conference Bridge

Conferenced -(Connected Id -C)

Conferenced -(Connected Id -D)

IDLE -( on the conferenced callLeg which was connected to B)

CallLegs on C:

Connected -to Conference Bridge

IDLE -( on the conferenced callLeg which was connected to B)

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -D)

CallLegs on D:

Connected -to Conference Bridge

IDLE -( on the conferenced callLeg which was connected to B)

Conferenced -(Connected Id -A)

Conferenced -(Connected Id -C)

Note   

All IDLE CallLegs will have CallStateChange Reason as CtiDropConferee.

  1. Drop Ad Hoc Conference = ‘When Conference Controller Leaves’

B is dropped out of conference and Conference will be ended.

CallLegs after the Party is dropped from Conference:

Each line in conference will be having 4 callLegs, all in IDLE state

CallLegs on A,B,C and D:

All 4 CallLegs will be in IDLE state

Shared Line-scenario

Action

Expected events

A,B,C and A' are in conference; A is conference Controller

Unified CM Parameter "Drop Ad Hoc Conference = Never"

Conference Model:

Lines B and C in conference will be having 4 callLegs, 3 conferenced and 1 connected

Lines A and A' will be having 8 CallLegs

CallLegs on A:

Connected -to Conference Bridge (Active)

Conferenced -(caller Id -A ;Called Id -B; Connected Id -B) (Active)

Conferenced -(caller Id -A ;Called Id -C; Connected Id -C) (Active)

Conferenced -(caller Id -A ;Called Id -A' ; Connected Id -A') (Active)

Connected -to Conference Bridge (Remote in Use)

Conferenced -(caller Id -A' ;Called Id -B; Connected Id -B) (Remote in Use)

Conferenced -(caller Id -A' ;Called Id -C; Connected Id -C) (Remote in Use)

Conferenced -(caller Id -A' ;Called Id -A; Connected Id -A) (Remote in Use)

CallLegs on A':

Connected -to Conference Bridge (Active)

Conferenced -(caller Id -A' ;Called Id -B; Connected Id -B) (Active)

Conferenced -(caller Id -A' ;Called Id -C; Connected Id -C) (Active)

Conferenced -(caller Id -A' ;Called Id -A; Connected Id -A) (Active)

Connected -to Conference Bridge (Remote in Use)

Conferenced -(caller Id -A ;Called Id -B; Connected Id -B) (Remote in Use)

Conferenced -(caller Id -A ;Called Id -C; Connected Id -C) (Remote in Use)

Conferenced -(caller Id -A ;Called Id -A'; Connected Id -A') (Remote in Use)

CallLegs on B:

Connected -to Conference Bridge

Conferenced -(caller Id -B ;Called Id -A; Connected Id -A)

Conferenced -(caller Id -B ;Called Id -C; Connected Id -C)

Conferenced -(caller Id -B ;Called Id -A'; Connected Id -A')

CallLegs on C:

Connected -to Conference Bridge

Conferenced -(caller Id -C ;Called Id -A; Connected Id -A)

Conferenced -(caller Id -C ;Called Id -B; Connected Id -B)

Conferenced -(caller Id -C ;Called Id -A' ; Connected Id -A')

Application does a LineOpen (A) with new Ext ver.

Unified CM Parameter ‘Advanced Ad Hoc Conference Enabled = False

 

  1. Application does LineRemoveFromConference on the ‘Conferenced’ CallLeg on A which is connected to B and mode is "Inactive or Remote In use".

Error LINEERR_INVALCALLSTATE is sent to application.

  1. Application does LineRemoveFromConference on the ‘Conferenced’ CallLeg on A which is connected to B and mode is ‘Active’.

B will be dropped out of conference.

LINECALLSTATE Event will be sent to Application with state = Idle.

CallLegs after the Party is dropped from Conference:

CallLegs on A:

Connected -to Conference Bridge (Active)

IDLE -(on the conferenced callLeg which was connected to A -B)

Conferenced -(caller Id -A ;Called Id -C; Connected Id -C) (Active)

Conferenced -(caller Id -A ;Called Id -A'; Connected Id -A') (Active)

Connected -to Conference Bridge (Remote in Use)

IDLE -(on the conferenced callLeg which was connected to A' -B)

Conferenced -(caller Id -A' ;Called Id -C; Connected Id -C) (Remote in Use)

Conferenced -(caller Id -A' ;Called Id -A; Connected Id -A) (Remote in Use)

CallLegs on A':

Connected -to Conference Bridge (Active)

IDLE -(on the conferenced callLeg which was connected to A' -B)

Conferenced -(caller Id -A' ;Called Id -C; Connected Id -C) (Active)

Conferenced -(caller Id -A' ;Called Id -A; Connected Id -A) (Active)

Connected -to Conference Bridge (Remote in Use)

IDLE -(on the conferenced callLeg which was connected to A -B)

Conferenced -(caller Id -A ;Called Id -C; Connected Id -C) (Remote in Use)

Conferenced -(caller Id -A ;Called Id -A'; Connected Id -A') (Remote in Use)

CallLegs on B:

All 4 CallLegs are in IDLE state

CallLegs on C:

Connected -to Conference Bridge

Conferenced -(caller Id -C ;Called Id -A; Connected Id -A)

IDLE -(on the conferenced callLeg which was connected to C -B)

Conferenced -(caller Id -C ;Called Id -A'; Connected Id -A')

Application does a LineOpen (B) with new Ext ver. Unified CM Parameter Advanced Ad Hoc Conference Enabled = True

 

  1. Application does LineRemoveFromConference on the ‘Conferenced’ CallLeg on B which is connected to A and mode is "Active".

A will be dropped out of conference.

LINECALLSTATE Event will be sent to Application with state = Idle.

CallLegs after the Party is dropped from Conference:

CallLegs on A:

IDLE -(on the Connected callLeg which was connected to Conference Bridge,A-CFB)

IDLE -(on the conferenced callLeg which is connected to A -B)

IDLE -(on the conferenced callLeg which is connected to A -C)

IDLE -(on the conferenced callLeg which is connected to A -A')

Connected -to Conference Bridge (Remote in Use)

Conferenced -(caller Id -A' ;Called Id -C; Connected Id -C) (Remote in Use)

Conferenced -(caller Id -A' ;Called Id -B; Connected Id -B) (Remote in Use)

CallLegs on A':

IDLE -(on the Connected callLeg which was connected to Conference Bridge,A -CFB)

IDLE -(on the conferenced callLeg which is connected to A -B)

IDLE -(on the conferenced callLeg which is connected to A -C)

IDLE -(on the conferenced callLeg which is connected to A -A')

Connected -to Conference Bridge

Conferenced -(caller Id -A' ;Called Id -C; Connected Id -C) (Active)

Conferenced -(caller Id -A' ;Called Id -B; Connected Id -B) (Active)

CallLegs on B:

Connected -to Conference Bridge

Conferenced -(caller Id -B ;Called Id -A; Connected Id -A')

IDLE -(on the conferenced callLeg which was connected to B -A)

Conferenced -(caller Id -B ;Called Id -C; Connected Id -C)

 

CallLegs on C:

Connected -to Conference Bridge

Conferenced -(caller Id -C ;Called Id -A'; Connected Id -A')

IDLE -(on the conferenced callLeg which was connected to C -A)

Conferenced -(caller Id -C ;Called Id -B; Connected Id -B)

Chained Conference

Action

Expected events

A,B and CB2 are in conference(CB1); B is conference Controller

C,D and E are in Conference (CB2); D is conference Controller

Unified CM Parameter Advanced Ad Hoc Conference Enabled = True

Application does a LineOpen (A) with new Ext ver.

  1. Application does LineRemoveFromConference on the Conferenced" CallLeg on A which is connected to B.

 

 

 

 

 

 

 

B is disconnected and dropped out of Conference.

A is now in conference with CB2.

LINECALLSTATE Event is sent to Application for Line B with state = Idle.

C-Barge: Unified CM Service Parameter Advanced Ad Hoc Conference Enabled = True.

Action

Expected events

B call A and A';

A answers the call and on A' do c-Barge;

A,B and A' will be in conference; A is conference Controller

Unified CM Parameter "Drop Ad Hoc Conference = Never"

Application does a LineOpen (A) with new Ext ver.

 

Application does a LineOpen (A) with new Ext ver.

  1. Application does LineRemoveFromConference on the "Conferenced" CallLeg on A which is connected to B and mode is Active

B is dropped out of conference.

LINECALLSTATE Event will be sent to Application with state = Idle.

 

CallLegs after the Party is dropped from Conference:

CallLegs on A:

Connected -(on the conferenced callLeg which was connected to A -A') (Active)

Connected -on the conferenced callLeg which was connected to A' -A) (Remote in Use)

IDLE -(on the conferenced callLeg which was connected to A -B)

IDLE -(on the connected callLeg which is connected to conference Bridge; A -CFB)

IDLE -(on the conferenced callLeg which was connected to A' -B)

IDLE -(on the connected callLeg which is connected to conference Bridge; A' -CFB)

CallLegs on A':

Connected -(on the conferenced callLeg which was connected to A' -A) (Active)

Connected -on the conferenced callLeg which was connected to A -A') (Remote in Use)

IDLE -(on the conferenced callLeg which was connected to A -B)

IDLE -(on the connected callLeg which is connected to conference Bridge; A -CFB)

IDLE -(on the conferenced callLeg which was connected to A' -B)

IDLE -(on the connected callLeg which is connected to conference Bridge; A' -CFB)

CallLegs on B:

All 4 CallLegs are in IDLE state

A' is dropped out of conference.

LINECALLSTATE Event will be sent to Application with state = Idle.

  1. Application does LineRemoveFromConference on the Conferenced CallLeg on A which is connected to A' and mode is Active.

CallLegs on A':

Connected -(on the conferenced callLeg which was connected to A -B) (Remote in Use)

IDLE -(on the conferenced callLeg which was connected to A' -B)

IDLE -(on the conferenced callLeg which was connected to A -A') (active)

IDLE -(on the connected callLeg which is connected to conference Bridge; A -CFB)

IDLE -(on the conferenced callLeg which was connected to A' -A) (Remote in Use)

IDLE -(on the connected callLeg which is connected to conference Bridge; A' -CFB)

CallLegs on B:

Connected -(on the conferenced callLeg which was connected to B -A)

IDLE -(on the conferenced callLeg which was connected to A' -B)

IDLE -(on the connected callLeg which is connected to conference Bridge; B -CFB)

CallLegs after the Party is dropped from Conference:

CallLegs on A:

Connected -(on the conferenced callLeg which was connected to A -B) (Active)

IDLE -(on the conferenced callLeg which was connected to A' -B) (Remote in Use)

IDLE -(on the conferenced callLeg which was connected to A -A') (active)

IDLE -(on the connected callLeg which is connected to conference Bridge; A -CFB)

IDLE -(on the conferenced callLeg which was connected to A' -A) (Remote in Use)

IDLE -(on the connected callLeg which is connected to conference Bridge; A' -CFB)

Early Offer

The following section describes how the application dynamically registers for various port with Early Offer Support.

Application dynamically registers CTI Port with Early Offer Support

Configuration

A – CTI Port in Cluster1

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Action

TSP message to application data

lineInitialize

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x800B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

Line_Reply with Success

Application sends lineDevSpecific(CciscoLineDevSpecificPortRegistrationPerCall) with MediaCaps Info

Line_Reply with Success

LineInserviceEvent reports to Application

Line_LineDevState

dwParam1 = x040, InService

Application sends lineDevSpecific(CCiscoLineDevSpecificSetStatusMsgs) with m_DevSpecificStatusMsgsFlag = DEVSPECIFIC_GET_IP_PORT -0x00000400

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster2

 

Call is being routed through the SIP trunk with Early Offer Enabled

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

 

LINE_DEVSPECIFIC

dwParam1 = SLDSMT_RTP_GET_IP_PORT

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 1 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy (8 bits) – IPAddressing Mode

Application sends lineDevSpecific(CciscoLineDevSpecificSetRTPParamsForCall) with IPAddress and Port Info

Line_Reply with Success

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

LINE_DEVSPECIFIC

dwParam1 = compressionType & SLDSMT_OPEN_LOGICAL_CHANNEL

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 0 – SetRTP

( 1-App has to set RTP / 0 – App need not set RTP)

yy (8 bits) – IPAddressing Mode

Hold and unHold the Call

A:

LINE_CALLSTATE (LINECALLSTATE_HOLD/LINECALLSTATE_CONNECTED)

 

LINE_DEVSPECIFIC

dwParam1 = compressionType & SLDSMT_OPEN_LOGICAL_CHANNEL

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 1 – SetRTP

( 1-App has to set RTP / 0 – App need not set RTP)

yy (8 bits) – IPAddressing Mode

*** Applications have to set the RTP info as the SetRTP flag is set.

Application sends lineDevSpecific(CciscoLineDevSpecificSetRTPParamsForCall) with IPAddress and Port Info

Line_Reply with Success

Media will be set and Media events will be reported

*** Application should not set the RTP Info Again

Variant 1:

Application sends lineDevSpecific(CciscoLineDevSpecificSetRTPParamsForCall) with IPAddress and Port Info

 

 

 

Line_Reply with Error LINEERR_OPERATIONUNAVAIL

But the Media is setup with the RTP information provided at the SLDSMT_RTP_GET_IP_PORT information request

Variant 2:

Application does not set the Filter to receive new Notification using lineDevSpecific (CCiscoLineDevSpecificSetStatusMsgs) and Application does not Set RTP at Proceeding State as there is no Notification

Or

Application does not set RTP info on New Notification

New Notification not reported to Application

Call goes to Disconnect State with cause as LINEDISCONNECTMODE_UNKNOWN

Variant 3: A – CTI Port is Registered Secure

Behavior should be same

Variant 4: Application tried to disable the Early Offer support on the CTI Port that is Dynamically Registered with the Early Offer support

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability -0x00000000

Line_Devspecific fails with Error

LINEERR_OPERATIONUNAVAIL

Application dynamically registers CTI Port without Early Offer Support

Configuration

A – CTI Port in Cluster1

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Delayed Offer

Action

TSP message to application data

lineInitialize

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x800B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

Application sends lineDevSpecific(CciscoLineDevSpecificPortRegistrationPerCall) with MediaCaps Info

Line_Reply with Success

LineInserviceEvent reports to Application

Line_LineDevState

Dwparam1 = x040, InService

Application calls LineMakeCall() on A dialing a Party in Cluster2

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

LINE_DEVSPECIFIC

dwParam1 = compressionType & SLDSMT_OPEN_LOGICAL_CHANNEL

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 1 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy (8 bits) -IPAddressingMode

Application sends lineDevSpecific(CciscoLineDevSpecificSetRTPParamsForCall) with IPAddress and Port Inf0

Line_Reply with Success

Media will be Setup

Variant 1: A – SCCP/SIP Phone

Behavior is same and new SLDSMT_RTP_GET_IP_PORT Notification will not be fired to application.

Application dynamically registers IPV6 CTI Port with Early Offer Support

Configuration

A – CTI Port; CDC – IPV6 Only

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Action

TSP message to application data

lineInitialize

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x800B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

Line_Reply with Success

Application sends lineDevSpecific(CciscoLineDevSpecificSetIPv6AddressAndMode) with MediaCaps Info

Application sends lineDevSpecific(CciscoLineDevSpecificPortRegistrationPerCall) with MediaCaps Info

Line_Reply with Success

 

 

Line_Reply with Success

 

LineInserviceEvent will be repored to Application

Line_LineDevState

Dwparam1 = x040, InService

Application sends lineDevSpecific(CCiscoLineDevSpecificSetStatusMsgs) with m_DevSpecificStatusMsgsFlag = DEVSPECIFIC_GET_IP_PORT -0x00000400

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster2

Call is routed through SIP trunk with Early Offer Enabled

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

Note   

SLDSMT_RTP_GET_IP_PORT Notification for IPV6 CTI Port is not supported.

Application has to set the RTP info after OpenLogicalChannel Notification.

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

 

LINE_DEVSPECIFIC

dwParam1 = compressionType & SLDSMT_OPEN_LOGICAL_CHANNEL

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 1 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy (8 bits )-IPAddressingMode

Application sends lineDevSpecific(CciscoLineDevSpecificSetRTPParamsForCallIPv6) with IPAddress and Port Info

Line_Reply with Success

Media will be Setup

Mutiple applications dynamically register CTI Port/RP

Configuration

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Applications:

  • App1 – Dynamically Registers CTI Port/RP with Early Offer Support
  • App2 – Dynamically Registers CTI Port/RP without Early Offer Support

*** App1 and App2 are running on Different Client Machines.

Action

TSP message to application data

App1 and App2:

lineInitialize

 

Line_reply with Success

Lines will be Enumerated to Application.

App1 and App2:

lineOpen() with Extversion – 0x800B0000 for Line A

Line_Open successful

App1 and App2:

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

App1:

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

 

 

Line_Reply with Success

App1:

Application sends lineDevSpecific(CciscoLineDevSpecificPortRegistrationPerCall) with MediaCaps Info

 

 

Line_Reply with Success

LineInserviceEvent reports to the application.

App2:

Application sends lineDevSpecific(CciscoLineDevSpecificPortRegistrationPerCall) with MediaCaps Info

 

Line_Devspecific fails with Error

LINEERR_REGISTER_GETPORT_SUPPORT_MISMATCH

Multiple applications dynamically register CTI Port/RP with Early Offer Support

Configuration

A – CTI Port in Cluster1

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Applications:

  • App1 – Dynamically Registers CTI Port/RP with Early Offer Support
  • App2 – Dynamically Registers CTI Port/RP with Early Offer Support

*** App1 and App2 are running on Different Client Machines.

Action

TSP Message to application data

App1 and App2:

lineInitialize

 

Line_reply with Success

Lines will be Enumerated to Application.

App1 and App2:

lineOpen() with Extversion – 0x800B0000 for Line A

 

Line_Open successful

App1 and App2:

LineSetStatusMessages() – with dwLinestates – 0xcc

 

LineSetStatusMessages returns Success

App1 and App2:

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

 

 

Line_Reply with Success

App1 and App2:

Application sends lineDevSpecific(CciscoLineDevSpecificPortRegistrationPerCall) with MediaCaps Info

*** Both Applications set with same Capabilities

 

 

Line_Reply with Success

 

LineInserviceEvent reports to Application.

App1:

Application calls LineMakeCall() on A dialing a Party in Cluster2

Call is being routed through the SIP trunk with Early Offer Enabled

 

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

App1 and App2:

LINE_DEVSPECIFIC

dwParam1 = SLDSMT_RTP_GET_IP_PORT

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 1 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

uy (8 bits) – IPAddressing Mode

App1:

Application sends lineDevSpecific(CciscoLineDevSpecificSetRTPParamsForCall) with IPAddress and Port Info

 

Line_Reply with Success

App2:

Application sends LineDevSpecific (CciscoLineDevSpecificSetRTPParamsForCall) with IPAddress and Port Info different from the Info App1 has set.

 

Line_Reply with error LINEERR_OPERATIONUNAVAIL

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

LINE_DEVSPECIFIC

dwParam1 = compressionType & SLDSMT_OPEN_LOGICAL_CHANNEL

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 0 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy (8 bits) – IPAddressingMode

Application statically registers CTI Port with Early Offer Support and then disable the Early Offer Support

Configuration

A – CTI Port in Cluster1

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Action

TSP Message to application data

lineInitialize

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x800B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

Line_Reply with Success

Application sends lineDevSpecific(CCiscoLineDevSpecificUserControlRTPStream) with MediaCaps Info

Line_Reply with Success

LineInserviceEvent reports to Application

Line_LineDevState

dwParam1 = x040, InService

Application sends lineDevSpecific(CCiscoLineDevSpecificSetStatusMsgs) with m_DevSpecificStatusMsgsFlag = DEVSPECIFIC_GET_IP_PORT -0x00000400

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster 2

 

Call is being routed through the SIP trunk with Early Offer Enabled

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

 

LINE_DEVSPECIFIC

dwParam1 = SLDSMT_RTP_GET_IP_PORT

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 0 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy – IPAddressing Mode

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

*** Disconnect the Existing Call

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability -0x00000000 – to disable the Early Offer support

 

 

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster 2

Call is being routed through the SIP trunk with Early Offer Enabled

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING/ LINECALLSTATE_RINGBACK)

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

Application statically registers CTI Port with out Early Offer Support and then enables Early Offer Support

Configuration

A – CTI Port in Cluster1

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Action

TSP Message to application data

lineInitialize

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x800B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

Application sends lineDevSpecific(CCiscoLineDevSpecificUserControlRTPStream) with MediaCaps Info

Line_Reply with Success

LineInserviceEvent reports to Application

Line_LineDevState

Dwparam1 = x040, InService

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001 – to enable the Early Offer support

Line_Reply with Success

Application sends lineDevSpecific(CCiscoLineDevSpecificSetStatusMsgs) with m_DevSpecificStatusMsgsFlag = DEVSPECIFIC_GET_IP_PORT -0x00000400

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster2

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

 

LINE_DEVSPECIFIC

dwParam1 = SLDSMT_RTP_GET_IP_PORT

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 0 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy – IPAddressing Mode

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

 

Media will be set and Media Events will be Reported to Application

Variant 1: A – SCCP/SIP Phone

Behavior is same and new SLDSMT_RTP_GET_IP_PORT Notification will not be fired to application.

Application registers CTI Port with Legacy Wave Driver and enables Early Offer Support

Configuration

A – CTI Port;

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Action

TSP Message to application data

lineInitialize

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x000B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

LineInserviceEvent reports to Application Line_LineDevState

Dwparam1 = x040, InService

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

Line_Devspecific fails with error LINEERR_OPERATIONUNAVAIL

Application sends lineDevSpecific(CCiscoLineDevSpecificSetStatusMsgs) with m_DevSpecificStatusMsgsFlag = DEVSPECIFIC_GET_IP_PORT -0x00000400

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster2

Call is routed through SIP trunk with Early Offer Enabled

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

Media will be set and Media Events will be reported to Application

Application registers CTI Port with new Cisco Wave Driver and enables Early Offer Support

Configuration

A – CTI Port;

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Action

TSP Message to application data

During Installation of CiscoTSP User has to select New Wave Driver.

lineInitialize

 

 

Line_reply with Success

Lines will be Enumerated to Application.

lineOpen() with Extversion – 0x000B0000 for Line A

Line_Open successful

LineSetStatusMessages() – with dwLinestates – 0xcc

LineSetStatusMessages returns Success

LineInserviceEvent reports to Application Line_LineDevState

Dwparam1 = x040, InService

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

Line_Reply with Success

Application sends lineDevSpecific(CCiscoLineDevSpecificSetStatusMsgs) with m_DevSpecificStatusMsgsFlag = DEVSPECIFIC_GET_IP_PORT -0x00000400

Line_Reply with Success

Application calls LineMakeCall() on A dialing a Party in Cluster2

Call is routed through SIP trunk with Early Offer Enabled

A:

LINE_CALLSTATE (LINECALLSTATE_PROCEEDING)

 

LINE_DEVSPECIFIC

dwParam1 = SLDSMT_RTP_GET_IP_PORT

dwParam2 = 0x00000xyy

x (ninth Bit from LSB) – 0 – SetRTP

(1-App has to set RTP / 0 – App need not set RTP)

yy – IPAddressing Mode

Note   

On this new Notification, applications has to Open the Port.

Other Party answers the Call

A:

LINE_CALLSTATE (LINECALLSTATE_CONNECTED)

Media will be set and Media Events will be reported to Application

Mutiple applications statically register CTI Port

Configuration

A – CTI Port in Cluster 1

Cluster1 and Cluster2 connected via SIP trunk

SIP trunk Supports Early Offer

Applications:

  • App1 – Statically Registers CTI Port/RP with Early Offer Support
  • App2 – Statically Registers CTI Port/RP without Early Offer Support

*** App1 and App2 are running on Different Client Machines.

Action

TSP Message to application data

App1 and App2: Both Connecting to same CTI Manager

lineInitialize

 

Line_reply with Success

Lines will be Enumerated to Application.

App1 and App2:

lineOpen() with Extversion – 0x800B0000 for Line A

 

Line_Open successful

App1 and App2:

LineSetStatusMessages() – with dwLinestates – 0xcc

 

LineSetStatusMessages returns Success

App1:

Application sends lineDevSpecific(CciscoLineDevSpecificEnableFeatureSupport) with m_Feature – 0x00000001, m_Feature_Capability - 0x00000001

 

 

Line_Reply with Success

App1:

Application sends lineDevSpecific(CCiscoLineDevSpecificUserControlRTPStream) with MediaCaps Info to Register A

 

Line_Reply with Success

LineInserviceEvent reports to Application.

App2:

Application sends lineDevSpecific(CCiscoLineDevSpecificUserControlRTPStream) with MediaCaps Info to Register A

 

Line_Devspecific fails with Error

LINEERR_REGISTER_GETPORT_SUPPORT_MISMATCH

Variant: App1 and App2 connecting to different Cti Managers

App2: (After App1 has already registered CtiPort -A)

Application sends lineDevSpecific(CCiscoLineDevSpecificUserControlRTPStream) with MediaCaps Info to register CtiPort A

 

 

 

LineReply – success

LINE_CLOSE for the CTI Port

End-To-End Call Trace

Direct Call scenario: Variation 1

Application does a LineInitializ. Application opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call.

Action

CTI events

Expected results

LineInitialize

LineOpen on A, LineOpen on B with new ExtVesrion 0x000A0000

 

 

A calls B

NewCallEvent received for A

 

 

 

 

 

 

 

 

NewCallEvent received for B

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

Direct Call scenario: Variation 2

A calls B and B answers the call. Application does a LineInitialize. Application opens all lines with new ExtVersion 0x000A0000.

Action

CTI events

Expected results

A calls B. B answers the call

 

 

LineInitialize

LineOpen on A, LineOpen on B with new ExtVesrion 0x000A0000

ExistingCallEvent received for A

 

 

 

 

 

 

 

 

ExistingCallEvent received for A

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

Consult Transfer scenario: Variation 1

Application does a LineInitialize and opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call. B sets up transfer to C, C answers the call, and B completes the transfer. A is connected to C.

Action

CTI event

Expected results

LineInitialize

LineOpen on A, LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

 

 

A calls B

NewCallEvent received for A

 

 

 

 

 

 

 

 

 

NewCallEvent received for B

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

 

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

B SetupTransfer to C

NewCallEvent received for B

 

 

 

 

 

 

 

 

 

NewCallEvent received for C

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

 

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on B

(Consultation call between B and C)

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B2

LineGetCallInfo on C

(Consultation call between B and C)

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

C answers the call. B completes transfer.

CallGlobalCallHandleChangedEvent received for C

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C2

LineGetCallInfo on A

(Call between A and C)

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on C2

(Consultation call between B and C)

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C2

Consult Transfer scenario: Variation 2

A calls B and B answers the call. B sets up transfer to C. Application does a LineInitialize and opens all lines with new ExtVersion 0x000A0000. Application completes the transfer. A is connected to C.

Action

CTI events

Expected Results

A calls B and B answers the call. B setups transfer to C and C answers the call

LineInitialize

LineOpen on A , LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

 

LineInitialize

LineOpen on A, LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

ExistingCallEvent received for A (Primary Call between A and B)

 

 

 

 

 

 

 

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

 

ExistingCallEvent received for B (Primary Call between A and B)

 

 

 

 

 

 

 

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

 

ExistingCallEvent received for B (Consultation Call between B and C)

 

 

 

 

 

 

 

 

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For C

LINE_CALLDEVSPECIFIC event is received

 

ExistingCallEvent received for C (Consultation Call between B and C)

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

(Primary Call between A and B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

(Primary Call between A and B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

LineGetCallInfo on B

(Consultation Call between B and C)

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B2

LineGetCallInfo on C

(Consultation Call between B and C)

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

Applications completes Transfer

CallGlobalCallHandleChangedEvent received for C

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on C

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C2

Blind Transfer scenario

Application does a LineInitialize.Application opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call. B does lineBlindTransfer to C. A is connected to C.

Action

CTI event

Expected results

LineInitialize

LineOpen on A, LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

 

 

A calls B

NewCallEvent received for A

 

 

 

 

 

 

 

NewCallEvent received for B

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

B lineBlindTransfer to C

NewCallEvent received for C

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on C

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

Redirect scenario

Application does a LineInitialize and opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call. Application redirects B to C; A is connected to C.

Action

CTI events

Expected results

LineInitialize

LineOpen on A , LineOpen on B with new ExtVesrion 0x000A0000

 

 

A calls B

NewCallEvent received for A

 

 

 

 

 

 

 

NewCallEvent received for B

 

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

B redirects call to C.C answers the call

NewCallEvent received for C

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on C

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

Shared Line scenario

Application does a LineInitialize. Application opens all lines with new ExtVersion 0x000A0000. A calls B, B’. B answers the call.

Action

CTI events

Expected results

LineInitialize

LineOpen on A , LineOpen on B,

LineOpen on B’ with new ExtVesrion 0x000A0000

 

 

A calls B

NewCallEvent received for A

 

 

 

 

 

 

 

 

NewCallEvent received for B

 

 

 

 

 

 

 

 

NewCallEvent received for B’

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

 

For B’

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

LineGetCallInfo on B’

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

Shared Line scenario with Barge

Application does a LineInitialize.Application opens all lines with new ExtVersion 0x000A0000. A calls B, B’. B answers the call.

Action

CTI events

Expected results

LineInitialize

LineOpen on A , LineOpen on B,

LineOpen on B’ with new ExtVesrion 0x000A0000

 

 

A calls B, B’answers the call

NewCallEvent received for A

 

 

 

 

 

 

 

 

NewCallEvent received for B

 

 

 

 

 

 

 

 

NewCallEvent received for B’

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

 

For B’

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

LineGetCallInfo on B’

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

B’ barges in

NewCallEvent received for B

 

 

 

 

 

 

 

 

 

 

 

NewCallEvent received for B’

 

 

 

 

 

 

 

 

 

 

 

 

CallGlobalCallHandleChangedEvent received for B

 

 

 

 

 

 

 

 

 

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B2

For B’

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B2

 

 

 

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B3

 

CallGlobalCallHandleChangedEvent received for B’

For B’

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B3

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B3

LineGetCallInfo on B’

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B3

Call Park scenario: Variation 1

Application does a LineInitialize and opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call. Application initiates a CallPark on B. A is parked on parkedDn. C calls parkDn and C is connected to A

Service Parameter Preserve globalcallid For Parked Calls set to False

Action

CTI events

Expected results

LineInitialize

LineOpen on A, LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

 

 

A calls B

NewCallEvent received for A

 

 

 

 

 

 

 

 

NewCallEvent received for B

 

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

Application initiates linepark on B

 

 

C dials parkDn

NewCallEvent received for C

 

 

 

 

 

 

 

 

 

 

 

CallGlobalCallHandleChangedEvent received for A

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

 

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A2

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A2

LineGetCallInfo on C

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

Call Park scenario: Variation 2

Application does a LineInitialize.Application opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call. Application initiates a CallPark on B. A is parked on parkedDn. C calls parkDn and C is connected to A

Service Parameter Preserve globalcallid For Parked Calls set to True

Action

CTI events

Expected results

LineInitialize

LineOpen on A, LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

NewCallEvent received for A

 

 

 

 

 

 

 

NewCallEvent received for B

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on B

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

Application initiates linepark on B

 

 

C dials parkDn

NewCallEvent received for C

 

 

 

 

 

 

 

 

 

CallGlobalCallHandleChangedEvent received for C

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C1

For C

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C2

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

LineGetCallInfo on C

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference C2

3-Party Conference Call scenario

Application does a LineInitialize and opens all lines with new ExtVersion 0x000A0000. A calls B and B answers the call. B sets up conference to C, C answers the call, and B completes conference. A, B and C are in conference.


Note


For all conference scenarios, conference call leg’s Unique Call Reference ID is 0.


Action

CTI events

Expected results

LineInitialize

LineOpen on A , LineOpen on B,

LineOpen on C with new ExtVesrion 0x000A0000

NewCallEvent received for A

 

 

 

 

 

 

 

 

 

NewCallEvent received for B

For A

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1

For B

LINE_CALLDEVSPECIFIC event is received

dwParam1 = SLDSMT_LINECALLINFO_ DEVSPECIFICDATA

dwParam2 = SLDST_UNIQUE_CALL_REF_ID_INFO

dwParam3 = 0

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference B1

LineGetCallInfo on A

 

LINECALLINFO::DEVSPECIFIC would contain Unique Call Reference A1