McDewey

Multi-vendor documentation library · semantic search · MCP endpoint at /mcp

Page 236

↗ View in doc context
page
236
source
cucm/v15/jtapi-dev-guide/jtapi-dev-guide.md
chunk_id
cucm::v15::jtapi-dev-guide::jtapi-dev-guide::222

a held state, and applications retrieve the call. CiscoTransferStart and end events get delivered to the applications at the start and completion of the transfer operation. Applications get the following changes: • A new call does not get created. • CiscoTransferStartEv and CiscoTransferEndEv do not get delivered to applications. • The state of the original call is retained if the transfer operation fails. The pre and post conditions of this interface did not change. To view the message flow for Single Step Transfer, see Message Sequence Charts, on page 761 SIP 3XX Redirection The SIP Redirect server receives SIP requests and responds with 3xx(redirection) responses, which direct the client to contact an alternate set of SIP addresses. This enhancement supports the Cisco Unified Communications Manager Redirection (3xx) Call Control primitive in compliance with RFC 3261. The Cisco Unified Communications Manager Redirection primitive processes SIP 3xx responses and does sequential hunting to each contact address from the 3xx response. Cisco Unified Communications Manager Redirection primitive also handles feature interactions that result from performing this operation. Cisco Unified JTAPI exposes new reason codes in all CallEvs, which indicate when connection and terminalConnection are created and destroyed as a result of this primitive. LastRedirectAddress may change if feature interactions like JTAPI Redirect or CallForwardNoAnswer occur when the Redirection primitive is hunting for a target. If the target does not answer and Cisco Unified Communications Manager Redirect takes control of the call to send it to next target, lastRedirectAddress is set to the party who originally sent the SIP 3xx response. If a diversion header is present in the SIP 3xx response, the 3xx primitive uses the first value of the diversion header for lastRedirectParty, and JTAPI applications will see the diversion header element as lastRedirectAddress. To maintain backward compatibility, JTAPI exposes the new API CiscoCallEv.getCiscoFeatureReason() in the CiscoCallEv interface, which contains the reason as CM_REDIRECTION. Applications should be aware that new feature-specific reason codes could be returned from this API, and applications should provide default behavior for unrecognized reason codes. Note The following sections describe the interface changes for SIP 3XX Redirection. Public Interface CiscoFeatureReason REASON_CM_REDIRECTION This reason indicates that event is a result of 3xx response from the CM_REDIRECTION primitive in Cisco Unified Communications Manager. static int Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 172 Features Supported by Cisco Unified JTAPI SIP 3XX Redirection