Cisco Cisco Computer Telephony Integration OS 8.5 Technical References

Page of 274
   
14
CTI Server Message Reference Guide (Protocol Version 17) for Cisco Unified Contact Center Enterprise
Release 10.0(1)
Message Formats
Message Formats
Messages contain either a fixed part only or a fixed part and a floating part. The fixed part of a message 
contains the message header and all required, fixed length fields. The variable part of a message 
immediately follows the fixed part. It contains one or more floating fields that are optional and/or 
variable in length. The message type field in the message header determines the format of the message, 
and therefore indicates if the message includes a floating part and what types of floating fields may 
appear within it. 
 illustrates the CTI Server message format.
Figure 3-1
CTI Server Message Format
Floating Fields
Each floating field has the format listed in 
. The field begins with a one byte tag, which 
identifies the field type. Following the tag is a one byte field length, which indicates the number of bytes 
of data in the field (excluding the tag and field length). The data immediately follows the FieldLength. 
The maximum size listed for each floating field is the maximum number of data bytes allowed. It does 
not include the tag and field length bytes. For string data, it includes the null termination byte.
Floating fields are packed together in the floating part of the message. The tag of one floating field 
immediately follows the data of the previous field. The message length (in the message header) indicates 
the end of the message. 
 illustrates the format of a floating field.
Figure 3-2
Floating Field Format
Message
Length
Message
Type
Fixed-length
Field
...
Floating
Field
...
Message Header
Fixed Part
Floating Part
Tag
Field Length
Floating Field
Data...
Tag
Field Length
Data...