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