As of February 1, 2012, Genesys is no longer an affiliate of Alcatel-Lucent; any indication of such affiliation within Genesys products or packaging is no longer applicable. Please see the Genesys website at http://www.genesys.com for more details.
This release note applies to all 8.1 releases of Platform SDK & Application Blocks for .NET.
Genesys follows applicable third-party redistribution policies to the extent that Genesys solutions utilize third-party functionality. For additional information about third-party software used in this product, see the Read Me. Please contact your Genesys Customer Care representative if you have any questions.
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
TargetStateCodec no longer causes an IndexOutOfRangeException.RealDn property parser works correctly with empty data as well as with data for many instances of DnStatus.(PSDK-8544)
The Campaign Actions enumeration in Stat Server protocol now contains the DialWrongNumber and LeadWrongNumber items, and changed the order of enumeration items order to be in sync with StatServer Campaign Actions Mapping. (PSDK-8560)
Improved logic of acquiring ticket in order to support work in trusted domains. (PSDK-8564)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Message Server protocol now correctly parses inner messages sent by Platform SDK. Previously, parsing failed when incorrect inner messages were sent by older releases of Platform SDK, causing the protocol to lose its connection to Message Server. (PSDK-7380, PSDK-7770)
Support for the LCA Hang-up Detection feature has been fixed. (PSDK-7467)
Configuration Server enumerations have been updated to include the new KnowledgeCenter and KnowledgeCenterCMS application types. (PSDK-7803)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Message transport now correctly sends the binary array attribute when its length is equal to 0xFFFE or 0xFFFF bytes. (PSDK-7282)
Platform SDK connections now include improved detection of closed sockets. (PSDK-7193)
Conversion of dates to string values now works correctly. Previously, this conversion could return incorrect results if using some non-standard calendars such as Arabic. (PSDK-7177)
Configuration Object Model Application Block: Debug level logging has been added for the scenario where a response is not received due to a timeout occurring. (PSDK-7196)
Configuration Platform SDK: The protocol handshake is improved, with RequestRegisterClient now including the IATRCFG_CLIENTENCODING attribute in all scenarios. Previously, if an application tried to restore a session in multi-language Configuration Server Proxy and the session was not found, an error could occur because RequestRegisterClient was sent without the IATRCFG_CLIENTENCODING attribute. (PSDK-7220)
Management Platform SDK: Message Server protocol now sends large (greater than 16 KB) inner messages correctly into the binary stream. (PSDK-7284)
Statistics Platform SDK: The handshake procedure for Stat Server protocol now includes information about extended client capabilities, allowing Stat Server to send extra data to fill the DnStatusEx structure correctly. (PSDK-7154)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Platform SDK now provides improved handling of broken connections when using High Availability (HA) connections. Previously, attempts to reconnect to Genesys servers could fail because the HA Connection incorrectly processed one of its states (StatePrimaryDown) and did not update the connection state to ConnectionState.Closed. (PSDK-7048)
The sequence of logging a message and delivering it to the user has been changed to prevent an exception if user code changes the attributes of a message during logging of the message. (PSDK-7054)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK & Application Blocks for .NET.
This release also includes the following corrections and modifications:
By default, QueueMessageReceiver and QueueRequestReceiver now allow queue size to increase over the limit for a short time to make management easier. (PSDK-6919)
The order of user events now ensures that incoming messages are delivered correctly after the channel is opened. (PSDK-6806)
Configuration Object Model Application Block: The lifecycle of cloned XML-objects now provides consistent results. Previously, mixed usage of ConfServerProtocol and the COM Application Block could form delta documents incorrectly. (PSDK-6815)
Configuration Object Model Application Block: Platform SDK now provides improved stability for Message Broker threads. Previously, RetriveMultipleObjects could block the thread if an exception was raised during Notify. (PSDK-6718)
Switch Policy Library: Platform SDK now supports the Do Not Disturb (DND) Call Reject feature for Cisco Unified Communications Manager 8.1.2. (PSDK-6859)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK & Application Blocks for .NET.
ObjectPath and FolderDbid data.This release also includes the following corrections and modifications:
The ServerChannel receiver now allows the queue length for incoming messages to be increased for a short time. (PSDK-6549)
Configuration Object Model Application Block: This application block now works correctly when a read request is submitted for multiple objects. Previously, the read request could fail if Configuration Server did not provide enough information about the object folders (due to permission restrictions or database corruption). (PSDK-6494)
Configuration Platform SDK: The XObjectSerializerV7 class can now parse CfgObjects with empty keys in KeyValueCollections. (PSDK-6519, PSDK-6561)
Configuration Platform SDK: This protocol includes the following improvements:
(PSDK-6474, PSDK-6505)
Configuration Platform SDK: Requests to read objects from Configuration Server have been updated to check for incorrect values (null, negative values, or values which do not match with the XPath request type) in the objectType field. (PSDK-6336)
Configuration Platform SDK: The delta object creation logic for Configuration Server has been corrected to properly handle empty sections in Options and UserProperties KVLists. (PSDK-6530)
Contacts Platform SDK: The EntityAttributes class now includes full support for NullAttributes. (PSDK-6564)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Platform SDK now provides improved handling of broken connections when using High Availability (HA) connections. Previously, attempts to reconnect to Genesys servers could fail because the HA Connection incorrectly processed one of its states (StatePrimaryDown) and did not update the connection state to ConnectionState.Closed. (PSDK-7031)
The sequence of logging a message and delivering it to the user has been changed to prevent an exception if user code changes the attributes of a message during logging of the message. (PSDK-7056)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
The Platform SDK includes the following improvements:
(PSDK-6474, PSDK-6505)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK & Application Blocks for .NET.
OptimizationMethod enumeration now includes the MaximumGain value.RequestGetBriefInfo and related EventBriefInfo classes.CfgAccessGroupBrief, CfgPersonBrief, and CfgTenantBrief structures.ChannelClosedOnCloseException : ProtocolException - Created when trying to close a channel that is already closed.ChannelClosedOnSendException : ProtocolException - Created when trying to send data through a closed channel.ChannelClosedOnReceiveException : ProtocolException - Created when trying to receive data from closed channel (ServerChannel).This release also includes the following corrections and modifications:
Voice Platform SDK: Values for CallMonitoringProperties attributes in TEvent objects (such as DialedNumber, CtrlParty and ISLinkList) are now public values, and are recorded in log files. (PSDK-6267)
Configuration Object Model Application Block: Delta fields of the collection type (added*, changed*, and deleted*) now only expose empty collections if they are explicitly sent by the server. This change was made to separate cases such as:
deleted* collection - all values were removeddeleted* collection - no values were removed(PSDK-6253)
Platform SDK now sends all messages from the buffer before closing a connection. If all messages cannot be sent before the specified timeout value expires, then an OnError event is created with the ChannelCloseConnectionException exception. (PSDK-6224)
The system performance counter exception (System.InvalidOperationException: Custom counters file view is out of memory) is now handled and recorded in logs. If exceptions occur, then counter memory can be increased in the app.config configuration file as shown below:
<configuration>
<system.diagnostics>
<performanceCounters filemappingsize="1048576" />
</system.diagnostics>
</configuration>
For more information about this known issue, see: http://social.technet.microsoft.com/Forums/exchange/en-US/d4ad62ba-e8ca-4d3c-87bc-dac1fff7195b/custom-counters-file-view-is-out-of-memory-msexchange-common-event-id-106
(PSDK-6201)
This release of Platform SDK offers increased performance and stability, especially in multithreading environments, due to improvements in the mechanisms for sending, receiving, and parsing messages. Previously, synchronization issues might cause output streams to stop responding in some cases, most commonly with XML message transport. (PSDK-745, PSDK-757)
Voice Platform SDK: Improved compatibility for FIPS (with backwards compatibility maintained). Previously, a TargetInvocationException exception might be thrown if FIPS was enabled. (PSDK-671, ER# 322379978)
ADDP support has been improved: ADDP parameters can now be changed on an opened channel. Previously, a ConnectionException exception might occur when ADDP parameters were configured on an open connection. (PSDK-658, ER# 321739230)
Voice Platform SDK: Connections used with Voice HA are now managed correctly. Previously, underlying connections might be left open in some cases if a Voice HA connection was closed immediately after opening. (PSDK-639)
Configuration Platform SDK: Improved compatibility for FIPS (with backwards compatibility maintained). Previously, FIPS-compliant mode might not be enabled on Windows at a machine level. (PSDK-632, ER# 320948868)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Work in multi-threaded environments is now more stable. Previously, mutual intersection could occur for data packets and packets with ADDP. (PSDK-6717)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Platform SDK now uses FIPS-compatible algorithms for KVList operations when FIPS is enabled. Previously, an error might occur when the following methods were used with FIPS enabled:
KeyValueCollection.GetHashCode()KeyValueCollection.Equals()Genesyslab.Platform.Voice.Protocols.EventMask()(ER# 322379978)
Platform SDK now provides improved support for initializing ADDP on an open channel. Previously, configuring ADDP parameters on a connection that was already open could result in a ConnectionException. (ER# 321739230)
Platform SDK now uses a FIPS-compliant algorithm to encode passwords when FIPS is enabled, and raises a ProtocolException if none of the default encryption classes are supported. Previously, password encryption would not work correctly on Windows when FIPS was enabled. (ER# 320948868)
Improved exception handling in the AsyncConnect() method provides improved performance for softphones. Previously, softphones could freeze if the backup SIP Server was restarted while the CPU was under high load. (ER# 322246028)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK & Application Blocks for .NET.
TServerPrivateServices.TServerPrivateServiceMessages helper class.KeyValueCollections now allow for strings with Unicode and non-Unicode encoding to be mixed.This release also includes the following corrections and modifications:
Selector threads can now be released correctly when an exception is thrown between the time that connection is created and opened. (ER# 312899683)
ADDP packets no longer interrupt the TLS handshake when the specified addp-timeout value is short. (ER# 312653105)
The handshake procedure now provides synchronization for incoming messages. Starting with release 8.1.2, all incoming messages received during the handshake are posted into a queue. Registering messages are processed as before, while other messages are delivered to the client after the Opened event is received. Use the RegUnsolicitedEventsPassLimit property to limit the number of unexpected messages between the first and last registering messages. (ER# 315972815)
Statistics Platform SDK: RequestOpenStatisticEx now handles insensitivity values correctly. Previously, when a time-based statistic request was created, the insensitivity attribute was overwritten with the notification frequency value that was passed. (ER# 319440327)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. There were no new features or functionality introduced in this release of Platform SDK & Application Blocks for .NET.
This release also includes the following corrections and modifications:
ConfService and ConfServiceFactory have been extended to work with the new event receiving mechanism without the explicit creation of the MessageBroker service in user code. (ER# 312176103)
The client and server no longer check their own certificates when making a connection; this task belongs to the remote peer. (ER# 312577651)
Thumbprint validation logic is now stricter, resulting in a ConnectionException if the thumbprint contains anything but hexadecimal and whitespace characters. This exception contains the position of the first invalid character and its character code. (ER# 312069443)
The AddpTraceMode property (from the IClientADDPOptions interface) can now be used as enumeration, as shown in the following examples:
// do not log ADDP traces
var config = new PropertyConfiguration();
config.AddpTraceMode = AddpTraceMode.None;
// log ADDP traces on client side only
var config = new PropertyConfiguration();
config.AddpTraceMode = AddpTraceMode.Local;
// query server to log ADDP traces in server logs
var config = new PropertyConfiguration();
config.AddpTraceMode = AddpTraceMode.Remote;
// log ADDP traces on client side and query server to log ADDP traces in server logs
var config = new PropertyConfiguration();
config.AddpTraceMode = AddpTraceMode.Both;
(ER# 311792271)
The DuplexChannel.UpgradeConnection() method, which initiates TLS authentication and creates a secured connection, is now declared as protected and cannot be used directly. This method can only be used from a child class. (ER# 311597805)
The ProtocolDescription property now returns "ContactServer" for the UCS protocol, or "EspEmail" name for the ESPEmail protocol. Previously, this property would always return "ExternalService". Additionally, the static GetProtocolDescription() method that duplicates the ProtocolDescription property was deprecated. (ER# 311542870)
Logging has been improved when a timeout occurs for a request. A more descriptive message is now used, which includes details about the related request. Previously, the log message was limited to: Response is null. Timeout? (ER# 311512673)
Configuration Platform SDK: User passwords with Unicode symbols are now encrypted and decrypted properly. (ER# 311018371)
In the AbstractConnectionConfiguration class, the TLSEnabled property has been renamed to TlsEnabled. (ER# 310405951)
In the AbstractChannel class, the Configuration property and Configure(...) method have been deprecated. Several classes in the Protocol Manager and Message Broker Application Blocks have also been deprecated because of enhanced classes introduced in the previous release. (ER# 310039446)
Requests now include the AttributeReferenceId attribute in the correct location. Previously, this attribute could be incorrectly placed within the UserEvent attribute in some cases. (ER# 308165521)
When a TLS connection is attempted with an expired certificate, the client application (server channel) log file now contains a warning that the certificate has expired and showing the last valid date. This indicates that an exception may have occurred during connection. Previously, there was no client-side notification. (ER# 307731777)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK & Application Blocks for .NET.
This release also includes the following corrections and modifications:
Synchronization issues with lazy parsing have been fixed with this release. (ER# 283529755)
Shortcuts for the Platform SDK Application Blocks now appear in the correct location when more than one instance of the Genesys Platform SDKs are installed. (ER# 248860531)
The internal message handling queue for Platform SDK has been improved to avoid possible concurrency issues. (ER# 300520643)
KVList serialization now handles binary values with a length of 65536 (0x1'00'00) correctly. (ER# 307679221)
To ensure backwards compatibility, the default mode of operation for platforms where IPv6 support is available is still IPv4. IPv6 support must be explicitly turned on for each application by configuring the enable-ipv6 and ip-version options in the common section of the Options tab for the related Application Object. Older settings affecting IPv6 usage are now deprecated.
(ER# 300346341)
Configuration Platform SDK: Enumeration type properties now support null values. (ER# 297267459)
Configuration Platform SDK: Delta objects have been updated with the following improvements:
CfgAccessGroups, which can contain thousands of members).(ER#s 300178868, 297311587, 295767129, 291633573)
Management Platform SDK: Message Server records are now handled correctly, even when they include attributes with string terminating zero characters. (ER# 296234701)
Statistics Platform SDK: The StatServerProtocol object is now able to handle locale-sensitive string values inside statistic structures, such as agent or group names. (ER# 303549217)
Warm Standby Application Block: Default behavior for the WarmStandbyService has been corrected to:
(ER# 296314976)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following correction and modification:
The client registration handler has been extended with a synchronization solution to ensure registration responses and immediate notification events are handled correctly. Previously, connecting to StatServer in cluster mode could cause a RegistrationException error to occur or server mode notifications to be lost. (ER# 316880981)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following correction and modification:
T-Server protocol now creates new loggers from the parent class, which is an instance of the connection, in order to prevent the creation of multiple new logger instances. Previously, large amounts of memory could be consumed due to endless requests for new logger creation when an HA T-Server connection entered the change connection state. (ER# 312998258)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
SIP Server failover now behaves correctly when LCA stops working, with the backup client connection switching to primary state once an EventPrimaryChanged message is received. Previously, the backup connection would not change state until an EventRestoreConnection event arrived. (ER# 304650145)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Voice Platform SDK for .NET now includes EventReserved_2, which can be parsed as a normal message without throwing an exception. (ER# 300890348)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
This is a hot fix for this product. This release contains no new features or functionality.
This release also includes the following corrections and modifications:
Thread synchronization is now implemented in the Genesyslab.Diagnostics.ThreadMonitoring class. Previously, in rare cases, applications using the Platform SDK would unexpectedly stop running due to unhandled KeyNotFoundException and IndexOutOfRangeException exceptions. (ER#s 300784371, 301677463)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK & Application Blocks for .NET.
UniversalContactServerProtocol has been extended with the following configuration options:
UseUtfForResponsesUseUtfForRequestsUseUtfForRequests and UseUtfForResponses options in the UcsConfiguration class. (ER# 298769616)
This release also includes the following corrections and modifications:
Log Library: The expire log option now works correctly. Previously, the latest file was always replaced instead of oldest one. (ER# 283906298)
Web Media Platform SDK: After an HA switchover for a chat sessions occurs, all processes are now ended correctly. Previously, a Genesyslab.PCT.Invoker thread could stay alive in the following scenario:
beginOpen function.(ER# 288641743)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Subcomponents in This Release
There are no restrictions for this release. This section describes new features that were introduced in the initial 8.1 release of Platform SDK & Application Blocks for .NET.
This release includes the following corrections and modifications that were made between Release 8.0 or earlier releases and the initial 8.1 release:
ADDP functionality has been enhanced. (ER#s 263625267, 279625820, 279625701, 281245961, 273952801, 273952816, 270782765)
Using the Contains() method to check for endpoints in a collection now behaves correctly. Previously, this method would always return false because collections were comparing endpoints by reference instead of by value. (ER# 270960350)
Threading for ADDP messaging has been improved. Previously, some ADDP packets could be sent twice which caused the connection with SIP Server to break. (ER# 278530958)
Configuration Platform SDK: The ConfServerMessages.xsd file has been updated. Previously, a System.Xml.Schema.XmlSchemaValidationException occurred when reading the schemas. (ER# 250028275)
Configuration Platform SDK: Passwords containing non-ASCII characters are now handled correctly. Specify the type of encoding to use as shown below:
PropertyConfiguration conf = new PropertyConfiguration(); conf.SetOption(ConnectionBase.StringAttributeEncodingKey, "windows-1252"); protocol.Configure(conf);
(ER# 264477941)
Voice Platform SDK: RequestStartCallMonitoring and RequestStopCallMonitoring are now handled as registration messages. Previously, these messages were not mirrored between primary and backup servers so that call monitoring events would be missed after a switch over. (ER# 272089838)
Voice Platform SDK: The default code has been expanded to convert unexpected data types. Previously, an InvalidCastException would occur when retrieving the NetworkCallID attribute from RequestMakePredictiveCall. (ER# 264042634)
This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:
This section provides the latest information on known issues and recommendations associated with this product.
Documentation provided with the Platform SDKs is still being improved and enhanced. To ensure you are working with the most correct and comprehensive information, check the latest SDK documentation updates online at Genesys Documentation website.
Note: Clients who use Platform SDK for .Net starting from release 8.1.1 should have the CA certificate for their server's certificate located in the Trusted Root Certification Authority.
The deprecated Packaged Statistics Platform SDK is officially not supported starting with the 8.1.1 release of Stat Server. Please use the Statistics Platform SDK instead.
Protocol connections do not open correctly in the following scenarios:
Platform SDK attempts to load the certificate even if the TlsEnabled key is set to false. In either scenario, an Exception is thrown and the connection is not be opened. This special behavior occurs to provide compatibility with Configuration server, and is required to allow connections to be upgraded to TLS. (ER# 308010414)
Windows performance counters allow applications and components to publish, capture, and analyze the performance data that applications, services, and drivers provide. It is possible to turn on the monitoring and performance profiling feature for Platform SDK using the ProfilingEnabled key which can be optionally set in the app.config file. By default the ProfilingEnabled key is disabled and Platform SDK does not try to create performance counters.
If a user enables the ProfilingEnabled property on a system where performance counters are corrupted, then unhandled System.InvalidOperationException exceptions can occur. To fix this issue and allow use of Performance Counters, repair the Windows registry. For more information, please see the related MSDN article. (ER# 308212210)
Protocol Manager Application Block: The Protocol Manager Application Block included with this release has been designed to support the Statistics Platform SDK, but does not support the deprecated Packaged Statistics Platform SDK. If you require the deprecated Packaged Statistics SDK to provide backwards compatibility for existing applications, please see the Platform SDK 8.0 API Reference for instructions on how to support new protocols.
Switch Policy Library: When using this library with your application, the following line may appear in debug output:
A first chance exception of type 'System.Threading.SynchronizationLockException' occurred in Microsoft.Practices.Unity.dll.
Switch Policy Library for .NET has a dependency on the Unity component, and this exception is standard behavior for that component. It does not indicate a problem with the code. (ER# 236306859)
Using ConfService constructors causes deprecation warnings due to the the Message Broker Application Block being deprecated. Future releases will include a ConfService that is independent of Message Broker to avoid these warnings.
| Found In: 8.1.100.12 | Fixed In: |
If an exception is thrown after a connection is created but before the connection is opened, then the selector thread can not be released because the reference counter of the selector thread has not yet been decremented in the protocol layer exception handler. (ER# 312899683)
| Found In: 8.1.100.12 | Fixed In: 8.1.200.50 |
If the specified addp-timeout value is short, then ADDP packets can interrupt the TLS handshake and break a connection. Genesys recommends setting the ADDP timeout to a value that is large enough for TLS initialization and handshake to complete. (ER# 312653105)
| Found In: 8.1.100.12 | Fixed In: 8.1.200.50 |
Synchronization issues exist with lazy parsing, that may cause exceptions to occur. (ER# 283529755)
| Found In: 8.1.000.11 | Fixed In: 8.1.100.11 |
Log Library: The expire log option does not work correctly. Currently, the latest file is always replaced instead of oldest one. (ER# 283906298)
| Found In: 8.1.000.11 | Fixed In: 8.1.000.16 |
Shortcuts for the Platform SDK Application Blocks may appear at an incorrect location (under a previously installed instance of the Platform SDK for .NET shortcuts folder) if more than one instance of the Genesys Platform SDKs are installed. (ER# 248860531)
| Found In: 8.0.100.15 | Fixed In: 8.1.100.11 |
This section documents features that are no longer supported in this software. This cumulative list is in release-number order with the most recently discontinued features at the top of the list.
There are no discontinued items for this product.
Information in this section is included for international customers.
There are no internationalization issues for this product.
Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Customer Care website. The following documentation also contains information about this software. Please consult the Deployment Guide first.
Platform SDK 8.1 Deployment Guide, which provides details about installing and configuring the Platform SDKs along with an overview of the Platform SDKs, their related application blocks, and available code examples.
The Platform SDK 8.1 API Reference for the version of the Platform SDK that you are using. This combined guide provides an introduction to the Platform SDKs, together with tips and recommendations about using the Platform SDK to interact with Genesys Servers. It also includes details about the messages, events, data types, and constants defined by each protocol within the Platform SDK.
Information about the Application Blocks that are packaged with this release of the Platform SDK is also included in the Platform SDK 8.1 API Reference, including tips and suggestions about how to use each application block, along with details about the classes, methods, and properties that are defined by the application block.
Product documentation is provided on the Customer Care website, the Genesys Documentation website, and the Documentation Library DVD (produced monthly).
Note: For the DVD, the New Documents on this DVD page indicates the production date for that disc. Due to disc production schedules, documentation on the Genesys Documentation website may be more up-to-date than what is available on disc immediately after a product is released or updated. To determine the version of a document, check the version number that is located on the second page in PDFs or on the About This File topic in Help files.