Cisco IOS XR Session Border Controller Configuration Guide Release 3.6
SIP Call Hold

Table Of Contents

SIP Call Hold

Contents

Information About SIP Call Hold in SBC

How to Configure SIP Call Hold

Configuring SIP Call Hold

Example of Configuring SIP Call Hold

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance


SIP Call Hold


The SIP call hold feature in SBC provides a standard telephony service of putting a caller on hold. If a party in a call wants to put the other party "on hold", a party re-invites the other by sending an INVITE request with a modified session description protocol (SDP). When a SIP endpoint wishes to place a call on hold or respond to a call hold re-INVITE, it chooses an appropriate method. SBC modifies call hold SDPs to use any available methods in order to maximize inter-operating with SIP devices.

Feature History for SIP Call Hold

Release
Modification

Release 3.4.1

This feature was introduced on the Cisco XR 12000 Series Router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Contents

This module contains the following sections:

Information About SIP Call Hold in SBC

How to Configure SIP Call Hold

Additional References

Information About SIP Call Hold in SBC

SBC accepts a SIP re-INVITE with an SDP, signaling that the sender wishes to put the call on hold. SBC modifies the SDP offer as needed and replaces remote endpoint addresses with known DBE media addresses. SBC then forwards the SIP message, containing the modified SDP to the remote endpoint.

If the re-INVITE is rejected by the endpoint going on hold, then the error response is returned to the holding endpoint (the endpoint that initiated the call hold). The media gate on the DBE continues to be connected and media continues to flow as before.

How to Configure SIP Call Hold

This section contains the steps for configuring the "no media" timeout duration for on-hold calls.

Configuring SIP Call Hold

SUMMARY STEPS

1. configure

2. sbc service-name

3. sbe

4. hold-media-timeout timeout

5. commit

6. exit

7. show services sbc service-name sbe hold-media-timeout

8. show services sbc service-name sbe calls

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

configure

Example:

RP/0/0/CPU0:router# configure

Enables global configuration mode.

Step 2 

sbc service-name

Example:

RP/0/0/CPU0:router(config)# sbc mysbc

Enters the mode of an SBC service.

Use the service-name argument to define the name of the service.

Step 3 

sbe

Example:

RP/0/0/CPU0:router(config-sbc)# sbe

Enters the mode of the signaling border element (SBE) function of the SBC.

Step 4 

hold-media-timeout timeout

Example:

RP/0/0/CPU0:router(config-sbc-sbe)# hold-media-timeout 7200

The time an SBE will wait after receiving a media timeout notification from the DBE for an on hold call before tearing that call down.

When the DBE detects that media has stopped on a call, it will start a timer for the specified duration, using the DBE media timeout CLI command.

If no media flows before this timer expires, then the DBE will send a pin hole timeout event notification to the SBE.

If the call is on hold, the SBE will set a timer with a duration matching the configured value using this command.

If the call is not taken off hold before the SBE timer expires, then the call will be torn down.

The default value for this command is off. Unless a specific duration is set, on hold calls never time out.

Step 5 

commit

Example:

RP/0/0/CPU0:router(config-sbc-sbe)# commit

Saves configuration changes. Use the commit command to save the configuration changes to the running configuration file and remain within the configuration session.

Step 6 

exit

Example:

RP/0/0/CPU0:router(config-sbc-sbe)# exit

Exits the configuration session and returns to the SBC mode.

Step 7 

show services sbc sbc-name sbe hold-media-timeout

Example:

RP/0/0/CPU0:router(config-sbc)# show services sbc mysbc sbe hold-media-timeout

Shows the currently configured duration of the media timeout timer for on-hold calls.

Step 8 

show services sbc sbc-name sbe calls

Example:

RP/0/0/CPU0:router(config-sbc)# show services sbc mysbc sbe calls

Lists all the calls on the SBE.

Example of Configuring SIP Call Hold

The following command configures the SBE to wait for two hours after receiving the last media packet on an on-hold call before cleaning up the call resources.

RP/0/0/CPU0:router(config)# sbc mysbc sbe hold-media-timeout 7200

Additional References

The following sections provide references related to SIP call hold support in SBC.

Related Documents

Related Topic
Document Title

Cisco IOS XR master command reference

Cisco IOS XR Master Commands List

Cisco IOS XR SBC interface configuration commands

Cisco IOS XR Session Border Controller Command Reference

Initial system bootup and configuration information for a router using the Cisco IOS XR Software

Cisco IOS XR Getting Started Guide

Cisco IOS XR command modes

Cisco IOS XR Command Mode Reference


Standards

Standards
Title

No new or modified standards are supported by this feature, and support from existing standards has not been modified by this feature.


MIBs

MIBs
MIBs Link

To locate and download MIBs using Cisco IOS XR software, use the Cisco MIB Locator found at the following URL and choose a platform under the Cisco Access Products menu:

http://cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml


RFCs

RFCs
Title

RFC 3261

SIP: Session Initiation Protocol

RFC 2543

Session Initiation Protocol

RFC 3515

Session Initiation Protocol (SIP) Refer Method


Technical Assistance

Description
Link

The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/techsupport