You are here: CSP Developer’s Guide: Internet Protocol > 5 Session-Initiation Protocol (SIP) Software > SIP Access To Parameters in To Header
SIP Access To Parameters in To Header
Overview
This feature gives the host read and write access to the parameter field of the "To" header of the initial INVITE request. The SIP stack reports to the host the parameters (if present) in the "To" header of the INVITE within the Request for Service with Data or PPL Event Indication for subsequent data. This reporting is disabled by default.
The SIP stack uses the parameters provided by the host in the Outseize or Route Control messages (and PPL Event Request message for subsequent data) for the "To" header of an outbound initial INVITE message.
Pertinent Specifications
• RFC 3398 - ISUP to SIP Mapping
• RCF 3261 - Session Initiation Protocol
• Internet draft-yu-tel-url-08.txt
Benefits to Customer
The Internet draft-yu-tel-url-08.txt introduced the following three parameters in the tel URI to support number portability (NP) and free phone service:
• routing number ("rn=")
• npdi-dip-indicator ("npdi")
• carrier-id-code ("cic=")
The required or desired parameters might be included in the parameter field of the "To" header in the INVITE request. In particular, customers can have the CSP report the "cic=" parameter to the host. For outbound calls, the host must supply this parameter.
Important! The SIP stack does not support telephone URI fully but it allows telephone numbers to be used as username or hostname.
The following is an example of the INVITE message with the "cic=" parameter highlighted.
INVITE sip:+022536183361088@66.116.123.10 SIP/2.0
From: <sip:6187851270@216.138.56.76>;tag=fdf55690-d88a384c-13c4-348ce5-46943ed9-348ce5
To: <sip:+022536183361088@66.116.123.10>;cic=+1-0008
Call-ID: 591b57d3-29373-22811-cd4572bd-22483-52549@216.138.56.76
CSeq: 5101 INVITE
Via: SIP/2.0/UDP 216.138.56.76:5060;branch=z9hG4bK-348ce5-cd466144-dfe1fb7
User-Agent: Nortel DMS-10UA/v2.1.001
Accept: application/sdp
P-Asserted-Identity: <sip:6187851270@216.138.56.76;user=phone>
Privacy: none
Remote-Party-ID: <sip:6187851270@216.138.56.76;user=phone>; party=calling; privacy=off
Max-Forwards: 70
Supported: 100rel,replaces
Allow: INVITE, ACK, OPTIONS, CANCEL, BYE, REFER, PRACK
Contact: <sip:6187851270@216.138.56.76>
Content-Type: application/SDP
Content-Length: 167
v=0
o=- 162175548 463391812 IN IP4 216.138.56.252
s=SIP Call
c=IN IP4 216.138.56.252
t=0 0
m=audio 20008 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=ptime:20
a=sendrecv
API and TLVs
Messages
• PPL Event Indication (0x0043)
• PPL Event Request (0x0044)
• Route Control (0x00E8)
• Outseize Control (0x002C)
• Request for Service with Data (0x002D)
TLVs
• SIP To Parameter (0x2945)
• SIP Message Information Mask TLV (0x027F)
Call Flows
The following call flow shows a SIP call between two CSPs.
This feature allows the host to instruct the SIP stack to insert parameters in the "To" header of the outbound INVITE request. By default, the SIP stack does not add this parameter.
The CSP acts as the User Agent Server (UAS) reporting to the host the parameter, in the inbound INVITE message, within the Request for Service message or PPL Event Indication message for subsequent data. This parameter is reported using the new TLV - SIP To Parameter (0x2945).
Configuring and Querying with API
This feature is disabled by default. To enable it, set bit 22 of the data part in the SIP Message Information Mask TLV (0x027F) and send it within the VoIP Protocol Configure (0x00EE) message.
Configuring with CSA
Refer to Configuring SIP in the Converged Services Administrator User’s Guide to configure with SwitchKit CSA.