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