2. Cisco
  3. Unified Communications Manager IM and Presence Service Version 11.0
Unified Communications Manager IM and Presence Service Version 11.0

Cisco Unified Communications Manager IM and Presence Service Version 11.0 , Unified Communications Manager (CallManager), Unified Communications Manager IM & Presence Service, Unified Communications Manager Version 11.0 User guide

  • Hello! I am an AI chatbot trained to assist you with the Cisco Unified Communications Manager IM and Presence Service Version 11.0 User guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
Cisco Unified JTAPI Developers Guide for Cisco Unified
Communications Manager, Release 11.0(1)
First Published: 2015-06-10
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
©2019 Cisco Systems, Inc. All rights reserved.
CONTENTS
Overview 1
CHAPTER 1
Cisco Unified Communications Manager Interfaces 1
Provisioning Interfaces 1
Administrative XML 2
Cisco Extension Mobility 2
Device Monitoring and Call Control Interfaces 2
Cisco TAPI and Media Driver 2
Cisco JTAPI 3
Cisco Web Dialer 3
Serviceability Interfaces 3
Serviceability XML 3
SNMP/MIBs 4
Routing Rules Interface 4
JTAPI Overview 4
Cisco Unified JTAPI and Contact Centers 5
Cisco Unified JTAPI and Enterprises 5
Cisco Unified JTAPI Applications 6
Jtprefs Application 6
Cisco Unified JTAPI Concepts 7
CiscoObjectContainer Interface 7
JtapiPeer and Provider 8
Initialization 8
Shutdown 8
Provider.getTerminals() 9
Provider.getAddresses() 9
Changes to the User Control List in the Directory 9
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
iii
Address and Terminal Relationships 9
Unobserved Addresses and Terminals 10
Connections 10
Terminal Connections 11
Terminal and Address Restrictions 11
CiscoConnectionID 14
Threaded Callbacks 14
CiscoSynchronousObserver Interface 14
Querying Dynamic Objects 15
callChangeEvent() 15
CiscoConsultCall 15
CiscoTransferStartEv 15
Alarm Services 15
Software Requirements 16
Development Guidelines 16
New and Changed Information 19
CHAPTER 2
Cisco Unified Communications Manager, Release 11.0(1) 19
Features Supported in Previous Releases 19
Cisco Unified Communications Manager Release 10.5(2) 20
Cisco Unified Communications Manager Release 10.0(1) 20
Cisco Unified Communications Manager Release 9.0(1) 21
Cisco Unified Communications Manager Release 8.6(1) 21
Cisco Unified Communications Manager Release 8.5(1) 21
Cisco Unified Communications Manager Release 8.0(1) 22
Cisco Unified Communications Manager Release 7.1(3) 22
Cisco Unified Communications Manager Release 7.1(2) 22
Cisco Unified Communications Manager Release 7.0(1) 23
Cisco Unified Communications Manager Release 6.1 24
Cisco Unified Communications Manager Release 6.0 25
Cisco Unified Communications Manager Release 5.1 25
Cisco Unified Communications Manager Release 5.0 26
Features Supported by Cisco Unified JTAPI 27
CHAPTER 3
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
iv
Contents
Account Lockout 31
Agent Greeting 31
AES 256 Algorithm IDs 32
Alternate Script Support 33
API for Exposing Built-In-Bridge Status 33
Arabic and Hebrew Language Support 34
Auto Updater for Linux 34
AutoAccept Support for CTI Ports and Route Points 34
Autoupdate of API 36
Barge and Privacy Event Notification 38
Call Control Discovery 39
Call Forward 39
Call Forward Override 39
Call Park 40
Call Pickup 40
Call Select Status 41
Calling Party Display Name 41
Calling Party IP Address 42
Calling Party IP Address 42
Calling Party Normalization 43
CallFwdAll Key Press Notification 43
CallSelect and UnSelect Event Notification 44
Certificate Download API Enhancement 44
Changes in DeviceType Name Handling 45
Cisco MediaTerminal 45
Provisioning 46
Registration 46
Adding Observers 47
Accepting Calls 48
Cisco Unified Communications Manager Media Endpoint Model 48
Payload and Parameter Negotiation 48
Initialization 49
Payload Selection 49
Receive Channel Allocation 49
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
v
Contents
Starting Transmission and Reception 50
Stopping Transmission and Reception 50
Cisco Unified Communications Manager Server Failure 50
Cisco Unified IP 7931G Phone Interaction 51
Cisco Unified JTAPI Install Internationalization 52
Cisco VG248 and ATA 186 Analog Phone Gateways 52
CiscoJtapiExceptions 52
Errors 53
CiscoProvAuthenticationInfoEv 54
CiscoRTPHandle Interface on Cisco RTP Events 54
Cisco Terminal Filter and ButtonPressedEvents 54
CiscoTermRegistrationfailed Event 55
Errors 56
Cius Persistency 56
Clear Calls 58
Click to Conference 58
Cluster Abstraction 58
Command Line Invocation 59
Component Updater 60
Conference 60
Cisco Extensions 61
Conference Scenarios 61
Conference Events 62
Transfer and Conference Enhancement 63
Conference and Join 63
Conference Chaining 64
Consult Without Media 65
CTI Ports 66
CTI RoutePoints 66
CTI Remote Device for JTAPI 66
Play Announcement 67
Verify Remote Destination Support 68
NuRD (Number Matching for Remote Destination) Support 69
Mobility Interaction Support 69
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
vi
Contents
CTI RD Call Forward 70
CTI Video Support 70
Default CTI IP Addressing for Devices 72
DeleteCall 72
Device Recovery 72
Device Recovery for Phones 73
Device State Server 73
Direct Transfer Across Lines 74
Usage Guidelines 74
Event Flow Comparison and Sample Code 75
Directed Call Park 79
Directory Change Notification 80
Do Not Disturb 80
Do Not Disturb-Reject 81
Drop Any Party 82
Dynamic CTI Port Registration 83
E911 Teleworker 85
Enable or Disable Ringer 85
Encryption Enhancement 86
End to End Call Tracing 86
EnergyWise Deep Sleep Mode 87
Extension Mobility Cross Cluster 89
Extension Mobility Username Login 90
External Call Control 90
FIPS Compliance 91
Forced Authorization and Client Matter Codes 93
Supported Interfaces 93
Call.Connect() and Call.Consult() 93
Call.transfer(String) and Connection.redirect() 95
RouteSession.selectRoute() 95
Forwarding on No Bandwidth and Unregistered DN 95
GetCallID in RTP Events 95
GetCallInfo 96
GetGlobalCallID 96
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
vii
Contents
Hairpin Support 96
Half-Duplex Media Support 97
Hold Reversion 98
Hunt List 98
Hunt List Connected Number 100
Intercom 100
Intercom Support for Extension Mobility 102
IPv6 Support 102
iSac Codec 103
Java Socket Connect Timeout 104
Join Across Lines 104
Join Across Lines (Only SCCP) 105
Join Across Lines or Connected Conference Across Lines 106
Usage Guidelines 106
Event Flow Comparison and Sample Code 106
Join Across Lines with Conference Enhancements (SCCP and SIP) 110
JRE 1.2 and JRE 1.3 Support Removal 111
JTAPI Version Information 112
Linux and Windows Installation 112
Locale Infrastructure Development 113
Logical Partitioning 113
Media Termination at Route Point 114
Media Termination Extensions 116
Message Waiting Indicator Enhancement 117
Modifying Calling Number 118
Multilevel Precedence and Preemption Support 119
Multiple Calls Per DN 120
Native Queuing 120
Network Alerting 121
Network Events 122
New Error Code in CiscoTermRegistrationFailedEv 123
Noncontroller Adding of Parties to Conferences 123
Park DN Monitor 123
Park Monitoring and Assisted DPark Support 124
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
viii
Contents
Park Reminder 126
Park Retrieval 126
Partition Support 126
Password Expiry 129
Persistent Connection 129
Play Zip Tone 131
Presentation Indicator for Calls 132
Privacy On Hold 133
Progress State Converted to Disconnect State 134
Q.Signaling (QSIG) Path Replacement 134
QoS Support 134
QoS Setup on Windows 2000 135
QoS Setup on Windows XP Server 2003 135
Quiet Clear 136
Receiving and Responding to Media Flow Events 136
Inbound Call Media Flow Event Diagram 137
Cisco Unified Communications Solutions RTP Implementation 138
Recording 138
Redirect 141
Redirect Set Original Called ID 142
Redundancy 143
Redundancy in CTI Managers 143
Invoking CTIManager Redundancy 143
CTIManager Failure 144
Heartbeats 145
Ringback on SIP 183 for Transferred Calls 145
Routing 145
Cisco Route Session Implementation 146
Select Route Timer 147
Forwarding Timer 147
Route Session Extension 147
Caller Options Summary 147
Fault Tolerance When Using Route Points 148
Secure Conferencing 148
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
ix
Contents
Secure Real-Time Protocol Key Material 148
Secured Monitoring and Recording 154
SelectRoute Interface Enhancement 155
selectRoute() with Calling Search Space and Feature Priority 157
Set MessageWaiting 157
Shared Line Support 157
Silent Install 160
Silent Monitoring 160
Single Sign-On 163
Single Step Transfer 164
SIP 3XX Redirection 165
SIP Phone Support 165
SIP REFER or REPLACE 168
SIP Trunk Early Offer 170
Star (*) 50 Update 172
Super Provider (Disable Device Validation) 173
Superprovider and Change Notification 173
Support for Cisco Unified IP Phone 6901 176
Support for Cisco Unified IP Phone 6900 Series 177
Support for 100+ Directory Numbers 178
Support for VMware 178
Swap or Cancel and Transfer or Conference Behavior 180
Terminal and Address Capability Settings 181
Terminal and Address Restrictions 182
Transfer 186
CiscoTransferStartEv 186
CiscoTransferEndEv 186
Transfer Scenarios 186
Transfer and Conference Extensions 189
Transfer and DirectTransfer 189
Translation Pattern Support 190
Transport Layer Security (TLS) 190
Unicode Support 196
Unrestricted Unified CM 199
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
x
Contents
URI Dialing 200
Version Format Change 200
Verification Involving PSTN Reachability 200
Video Capabilities and Multi-Media Information 201
Exposing Multimedia Capability on CiscoTerminal 201
Exposing Changes in Multimedia Capability Via a New Provider Event 201
Exposing Multimedia Capability on a CiscoCall 202
Exposing Multimedia Streams Information on CiscoTerminal 202
Supported Features (Within the Same Cluster) 203
Supported Features (Across Clusters) 203
Limitations 204
Video On Hold Support 205
Voice MailBox Support 205
XSI Object Pass Through 206
CiscoTerminal Method 206
Authentication and Mechanism 206
Cisco Unified JTAPI Installation 207
CHAPTER 4
Required Software 207
Supported Platforms 207
Overview 207
Installing the Cisco Unified JTAPI Software 208
Silent Install Invocation 208
Command Line Invocation 209
End User Installation 210
Installation Procedures 211
Linux Platforms 211
Verifying Linux Installation 213
Windows Platforms 214
Installing Cisco JTAPI on 32 bit Windows Platforms 215
Installing Cisco JTAPI on 64 bit Windows Platforms 220
Verifying Windows Installation 223
Determining the Current JTAPI Version 224
Using Cisco Unified CM JTAPI 224
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xi
Contents
Program Group and Program Elements 225
Cisco Unified JTAPI Configuration Settings 225
JTAPI Tracing Tab 225
Log Destination Tab 227
Cisco Unified CM Tab 229
Advanced Tab 230
Security Tab 233
Language Tab 235
Managing the Cisco Unified CM JTAPI 237
Reinstalling or Upgrading or Downgrading the Cisco JTAPI 237
Uninstalling the Cisco JTAPI 237
Administering User Information for JTAPI Applications 238
Fields in the jtapi.ini File 238
Sample jtapi.ini File with Default Values 244
Hierarchy for All Cisco Unified JTAPI Packages 247
CHAPTER 5
Class Hierarchy 247
Interface Hierarchy 248
Cisco Unified JTAPI Extensions 257
CHAPTER 6
Class Hierarchy 261
CiscoAddressCallInfo 261
Declaration 261
Constructors 261
Fields 262
Methods 262
Inherited Methods 262
Related Documentation 262
CiscoG711MediaCapability 262
Declaration 263
Constructors 263
Fields 263
Inherited Fields 263
Methods 263
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xii
Contents
Inherited Methods 264
Related Documentation 264
CiscoG723MediaCapability 264
Declaration 264
Constructors 264
Fields 265
Inherited Fields 265
Methods 265
Inherited Methods 265
Related Documentation 265
CiscoG729MediaCapability 266
Declaration 266
Constructors 266
Fields 266
Inherited Fields 267
Methods 267
Inherited Methods 267
Related Documentation 267
CiscoGSMMediaCapability 267
Declaration 267
Constructors 268
Fields 268
Inherited Fields 268
Methods 268
Inherited Methods 268
Related Documentation 268
CiscoJtapiVersion 269
Declaration 269
Constructors 269
Fields 269
Methods 269
Inherited Methods 270
Related Documentation 270
CiscoMediaCapability 270
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xiii
Contents
Declaration 270
Subclasses 270
Constructors 271
Fields 271
Methods 271
Inherited Methods 272
Related Documentation 272
CiscoMultiMediaCapabilityInfo 272
Declaration 272
Fields 272
Methods 273
CiscoRegistrationException 273
Declaration 273
Implemented Interfaces 274
Constructors 274
Methods 274
Inherited Methods 274
Related Documentation 274
CiscoRTPParams 274
Declaration 275
Constructors 275
Fields 275
Methods 275
Inherited Methods 275
Related Documentation 275
CiscoUnregistrationException 276
Declaration 276
Implemented Interfaces 276
Constructors 276
Fields 276
Methods 276
Inherited Methods 277
Related Documentation 277
CiscoWideBandMediaCapability 277
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xiv
Contents
Declaration 277
Constructors 277
Fields 278
Inherited Fields 278
Methods 278
Inherited Methods 278
Related Documentation 278
Interface Hierarchy 278
CiscoAddrActivatedEv 285
Superinterfaces 285
Declaration 285
Fields 286
Inherited Fields 286
Methods 286
Inherited Methods 286
Related Documentation 287
Superinterfaces 287
Declaration 287
Fields 287
Inherited Fields 287
Methods 288
Inherited Methods 288
Related Documentation 289
CiscoAddrActivatedOnTerminalEv 289
Superinterfaces 289
Declaration 289
Fields 289
Inherited Fields 289
Methods 290
Inherited Methods 290
Related Documentation 290
CiscoAddrAddedToTerminalEv 290
Superinterfaces 291
Declaration 291
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xv
Contents
Fields 291
Inherited Fields 291
Methods 292
Inherited Methods 292
Related Documentation 292
CiscoAddrAutoAcceptStatusChangedEv 292
Superinterfaces 292
Declaration 293
Fields 293
Inherited Fields 293
Methods 293
Inherited Methods 294
Related Documentation 294
CiscoAddrCreatedEv 294
Superinterfaces 294
Declaration 294
Fields 294
Inherited Fields 295
Methods 295
Inherited Methods 295
Related Documentation 295
CiscoAddrMonitorTerminatedEv 296
Declaration 296
Methods 296
Related Documentation 296
CiscoAddress 296
Superinterfaces 297
Subinterfaces 297
Fields 298
Methods 299
Inherited Methods 311
Parameters 311
Related Documentation 311
CiscoAddressObserver 311
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xvi
Contents
Superinterfaces 311
Declaration 311
Fields 311
Methods 312
Inherited Methods 312
Related Documentation 312
CiscoAddrEv 312
Superinterfaces 312
Subinterfaces 312
Declaration 312
Fields 312
Inherited Fields 313
Methods 313
Inherited Methods 313
Related Documentation 313
CiscoAddrEvFilter 313
Fields 314
Methods 314
Inherited Methods 316
Parameters 316
Value Range 316
Related Documentation 316
CiscoAddrInServiceEv 316
Superinterfaces 316
Declaration 316
Fields 316
Inherited Fields 317
Methods 317
Inherited Methods 317
Related Documentation 317
CiscoAddrIntercomInfoChangedEv 318
Superinterfaces 318
Declaration 318
Fields 318
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xvii
Contents
Inherited Fields 318
Methods 319
Inherited Methods 319
Related Documentation 319
CiscoAddrIntercomInfoRestorationFailedEv 319
Superinterfaces 320
Declaration 320
Fields 320
Inherited Fields 320
Methods 320
Inherited Methods 321
Related Documentation 321
CiscoAddrPickupGroupChangedEv 321
Declaration 321
Methods 321
New Error Code 322
CiscoAddrOutOfServiceEv 322
Superinterfaces 322
Declaration 322
Fields 322
Inherited Fields 322
Methods 323
Inherited Methods 323
Related Documentation 324
CiscoAddrParkStatusEv 324
Declaration 324
Fields 324
Inherited Fields 325
Methods 325
Value Ranges 325
Related Documentation 325
CiscoAddrRecordingConfigChangedEv 326
Superinterfaces 326
Declaration 326
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xviii
Contents
Fields 326
Inherited Fields 326
Methods 327
Inherited Methods 327
Related Documentation 327
CiscoAddrRemovedEv 327
Superinterfaces 328
Declaration 328
Fields 328
Inherited Fields 328
Methods 328
Inherited Methods 329
Related Documentation 329
CiscoAddrRemovedFromTerminalEv 329
Superinterfaces 329
Declaration 329
Fields 330
Inherited Fields 330
Methods 330
Inherited Methods 330
Related Documentation 331
CiscoAddrRestrictedEv 331
Superinterfaces 331
Declaration 331
Fields 331
Inherited Fields 332
Methods 332
Inherited Methods 332
Related Documentation 333
CiscoAddrRestrictedOnTerminalEv 333
Superinterfaces 333
Declaration 333
Fields 333
Inherited Fields 333
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xix
Contents
Methods 334
Inherited Methods 334
Related Documentation 334
CiscoAddrVoiceMailPilotChangedEv 334
Superinterfaces 335
Declaration 335
Fields 335
Inherited Fields 335
Methods 335
Inherited Methods 336
Related Documentation 336
CiscoAnnouncementStartedEv 336
Declaration 336
Methods 336
CiscoAnnouncementEndedEv 336
Declaration 336
Methods 337
CiscoAnnouncementErrorEv 337
Declaration 337
Methods 337
CiscoBaseMediaTerminal 337
Declaration 338
Superinterfaces 338
Fields 338
Inherited Fields 338
Methods 338
Inherited Methods 339
Parameters 339
Data Types 339
Range of Values 339
CiscoCall 340
Superinterfaces 341
Subinterfaces 341
Declaration 341
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 11.0(1)
xx
Contents
/