You are here: CSP Developer’s Guide: Internet Protocol > 5 Session-Initiation Protocol (SIP) Software > SIP Display Name Parameter in From Header

SIP Display Name Parameter in From Header

Overview

This feature allows access to a display name parameter in the From Header field in SIP methods. The display name in the From Header field will be reported to the Host for incoming request method and can be configured for specific value for an outgoing request method.

Pertinent Specification

RFC 2543/3261

Description

Display Name Write Access

The Display name parameter write access is within the context of the SIP From Header field.

The SIP stack allows the host to fill the Display name parameter using the NPDI TLV SIP From Display Name (0x2928) in the Route Control (0x00E8) or Outseize Control messages (0x002C). The functionality works for data up to 250 bytes (including the null). If the TLV (0x2928) is sent with data greater than 250 bytes then the message is nacked with a status of 0x1304 (Invalid data).

Example:

Parameters supplied in the form of TLVs by the user only applied to FROM header field

Displayname(0x2928):Robert

Username (0x291E): bob

Hostname (0x2920): biloxi.example.net

The final Header will look as follows:

From: Robert<sip:bob@biloxi.example.net>;tag=40972175214

Display name parameters read access

The reporting of the Display name parameter is within the context of the SIP From Header field. The Display name parameter is reported as a null terminated string using the TLV, SIP Display Name (0x2928) in the Request for Service (0x002D) message.

This functionality works for data up to 250 bytes (including the null). If the received display name is greater than 250 bytes then the TLV is not reported.

API Messages Used

The following messages are used by this feature. Refer to the API Reference for the formats.

• Route Control (0x00E8) message

• Outseize Control (0x002C) message

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.
A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
Network Protocol Data Intelligence. Also called “Interworking,” it is a software product that operates within Excel’s Call Control (Layer 4) and Services (Layer 5) call processing layers. NPDI is meant to enhance Excel’s call processing product offering by allowing call processing layers (specifically Layers 4 and 5) to perform advanced analysis, generation, and conversion of Network Signaling (NS) Layer 3 information.
Tag-Length-Value block. A standardized block that allows data to inserted in a standard way into API messages.
Outgoing call setup during real-time call processing on a specific channel.