Filter
Top Products
178 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
IP-Specific Operations
Table 10 lists the SIP header fields that have field-specific parameter IDs, all of which are
deprecated. The table also indicates the size defines that correspond to each parameter ID, each of
which is equated to 255. Note that some of these parameters provide access to specific portions of
the corresponding header field, such as only the URI or only the display string.
Note that there is no advantage to using the field-specific parameters that identify complete fields
when setting SIP headers. Parameters that access only a part of the corresponding header field (i.e.,
just the URI or just the display string) may provide some convenience but should be used with
caution because all of these parameter IDs are being deprecated.
When a SIP message is received, the associated parm block contained in the event metadata
contains an element that uses the header-specific parameter ID for each corresponding header field
that is present in the message, regardless of whether the same field is registered to be received
using the generic IPSET_SIP_MSGINFO / IPPARM_SIP_HDR parameter
Table 10. Field-Specific Parameters (Deprecated) for SIP Header Access
Header Field Name Set ID and Parameter ID Maximum Data Length Define †
Call-ID †† IPSET_SIP_MSGINFO
• IPPARM_CALLID_HDR
IP_CALLID_HDR_MAXLEN
Contact display string IPSET_SIP_MSGINFO
• IPPARM_CONTACT_DISPLAY
IP_CONTACT_DISPLAY_MAXLEN
Contact URI IPSET_SIP_MSGINFO
• IPPARM_CONTACT_URI
IP_CONTACT_URI_MAXLEN
Diversion URI IPSET_SIP_MSGINFO
• IPPARM_DIVERSION_URI
IP_DIVERSION_MAXLEN
Event IPSET_SIP_MSGINFO
• IPPARM_EVENT_HDR
IP_EVENT_HDR_MAXLN
Expires IPSET_SIP_MSGINFO
• IPPARM_EXPIRES_HDR
IP_EXPIRES_HDR_MAXLEN
From display string IPSET_SIP_MSGINFO
• IPPARM_FROM_DISPLAY
IP_FROM_DISPLAY_MAXLEN
From (complete header
field, with display string,
URI, and parameters)
IPSET_SIP_MSGINFO
•IPPARM_FROM
IP_FROM_MAXLEN
Referred-By IPSET_SIP_MSGINFO
• IPPARM_REFERRED_BY
IP_REFERRED_BY_MAXLEN
Replaces (parameter in
Refer-To header field for
attended call transfers)
IPSET_SIP_MSGINFO
• IPPARM_REPLACES
IP_REPLACES_MAXLEN
Request-URI IPSET_SIP_MSGINFO
• IPPARM_REQUEST_URI
IP_REQURI_MAXLEN
† The value for each listed parameter ID is a character array with the maximum size of the array (including the NULL) equal to
the corresponding maximum length define.
†† Directly setting the Call-ID header field using this parameter overrides any Call-ID value that is set using the
IPSET_CALLINFO / IPPARM_CALLID parameter.