You are here: CSP Developer’s Guide: Internet Protocol > 5 Session-Initiation Protocol (SIP) Software > Support SIP Max Forward in INVITE Message

Support SIP Max Forward in INVITE Message

Overview

This feature allows the CSP to insert the Max-Forwards header in outbound requests from the CSP SIP stack.

The Max-Forwards header is optional and is disabled by default. The host can also configure the Max-Forwards value.

Specification Built From

RFC 3261

Description

Max-Forwards header limits the number of hops a request can make on the way to its destination. It consists of an integer that is decremented by one at each hop. If the Max-Forwards value reaches 0 before the request reaches its destination, it is rejected with a 483 (Too Many Hops) error response.

For example, this feature is needed by customer applications that require the Max-Forwards header in the inbound INVITE message so the application can respond to it. The host inserts this header in the INVITE message generated by the CSP SIP stack.

This feature applies to the following requests generated by the CSP SIP stack:

• INVITE

• Re-INVITE

• ACK

• BYE

• NOTIFY

• REFER

• INFO

• SUBSCRIBE

• CANCEL

• PRACK

Example: Below is an example of the INVITE message with this feature enabled:

INVITE sip:35751@10.10.1.19:5060 SIP/2.0

Via: SIP/2.0/UDP 10.10.1.135

To: 35751<sip:35751@10.10.1.19:5060>

From: 00000000<sip:00000000@10.10.1.135:5060>;tag=734407b2

Call-ID: EXCEL-CSP16.7.1970.350@10.10.1.135

Contact: 00000000<sip:00000000@10.10.1.135:5060>

User-Agent: Excel_CSP/84.10.1

Supported: timer

Session-Expires: 1800

Min-SE: 300

CSeq: 1 INVITE

Max-Forwards: 80

Content-Type: application/sdp

Content-Length: 100

v=0

o=sip 0 0 IN IP4 10.10.1.135

s=SIP_Call

c=IN IP4 10.10.1.206

t=0 0

m=audio 8028 RTP/AVP 0

API Configuring and Querying

To enable this feature using the EXS API, use the SIP Max Forwards (0x0286) TLV in the VoIP Protocol Configure (0x00EE) message. Refer to 0x2946 - SIP Request URI Password .

You can query this feature with the VoIP Protocol Query (0x00EF) message.

CSA Configuring and Querying

Follow the steps below to configure or query this feature from SwitchKit CSA.

1 To open the CSP SIP Configuration dialog box, do one of the following:

• Select the CSP Matrix Series 3 Card in the node view. Go to the Configuration menu and select SIP®SIP Configuration.

• Right-click the node view window (outside the card slots) and select SIP Configuration from the menu list.

2 Click the Show Advanced button. The SIP Configuration, Advanced dialog box opens.

3 Select SIP MAX Forwards.

Call Flow

Session-Initiation Protocol. A signaling protocol used for establishing sessions in an IP network. A session could be a simple, two-way telephone call, or it could be a collaborative multi-media conference session.
Positive acknowledgment to a message
Real-Time Transport Protocol. Supports transport of real-time data like interactive voice and video over packet-switched networks.
Tag-Length-Value block. A standardized block that allows data to inserted in a standard way into API messages.
Voice over Internet Protocol. The delivery of voice information in digital form in discrete packets rather than in the traditional circuit-committed protocols of the public-switched telephone network (PSTN).
See Converged Services Administrator.