Developer's Guide

5-148
CTI Server Message Reference Guide (Protocol Version 15) for Cisco Unified Contact Center Enterprise
Release 8.5(1)
Chapter 5 Application Level Interfaces
Server Service
The server service optionally allows multiple server applications to supply the same service. The
ServerMode registration parameter determines how a server is selected to handle a given request. All
server applications that wish to provide the same service must use the same ServerMode:
• Exclusive. The first server application to register the service is the only one to serve requests. All
other requests to register a server application for that service are refused with an
E_CTI_NO_SERVER_FOR_REQUEST.
• Round-Robin. Multiple server applications may register the service. The server application that has
been waiting the longest for a request of this service type is chosen to service the request.
• Parallel. Multiple server applications may register the service. Every request is sent to all registered
servers concurrently. Every server response is forwarded back to the requesting client.
REGISTER_SERVICE_REQ
Initially, the only service that server applications may provide is call recording by registering the
“Cisco:CallRecording” service using a REGISTER_SERVICE_REQ message, defined in Table 5-140:
The REGISTER_SERVICE_CONF message (Table 5-141) confirms successful completion of the
request:
Table 5-140 REGISTER_SERVICE_REQ Message Format
Fixed Part
Field Name Value Data Type
Byte Size
MessageHeader Standard message header. MessageType = 143. MHDR
8
InvokeID An ID for this request message that will be returned in the
corresponding confirm message.
UINT
4
ServerMode The CTI Server method is for selecting among multiple
server applications that register to provide this service. All
servers must specify the same ServerMode, one of the
following values:
0: Exclusive;
1: Round-Robin;
2: Parallel.
USHORT
2
Floating Part
Field Name Value Data Type Max. Size
ServiceName The name of the service that the application wishes to
provide.
STRING 64
Maximum message size (including header) 80
Table 5-141 REGISTER_SERVICE_CONF Message Format
Field Name Value
Data
Type
Byte
Size
MessageHeader Standard message header. MessageType = 144. MHDR 8