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.

Description

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.

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.
See Programmable Protocol Language.
Outgoing call setup during real-time call processing on a specific channel.
A condition that, when met, drives a state machine from one state to another. A condition that drives a Component out of its current state by invoking an associated primitive.
See Integrated Services Digital Network User Part.
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.
CSA. GUI-based tool used to configure, provision and monitor a Excel platform related to, for example, SIP, H.323, and VDAC Resouce Attributes.