SIP Profile - Advanced Settings
- 1 Web GUI Page
- 2 Maximum Objects
- 3 Related Topics and Dependencies
- 4 Field Descriptions
- 4.1 Outbound Modem Triggers Re-INVITE
- 4.2 INFO for Spirou/ITX
- 4.3 Outgoing Fully Qualified Domain Name (FQDN)
- 4.4 Incoming Reason Header Cause Code
- 4.5 Allow 180 after 183
- 4.6 Acceptable Inbound Call Type
- 4.7 Secure SIP (SIPS)
- 4.8 SIP-T Pass On
- 4.9 Hold/UnHold
- 4.10 Hold/UnHold Propagation
- 4.11 Retry After Support
- 4.12 Clear Channel Override
- 4.13 Enforce User=phone
- 4.14 Enforce sendrecv in SDP
- 4.15 Phone Context
- 4.16 Phone Context String
- 4.17 Allow NOTIFY w/o Subscription
- 4.18 183 Periodic Retransmission
- 4.19 Star Digit Mapping
- 4.20 Hex Digit Mapping
- 4.21 Route by Prefix
- 4.22 Use Ext GW transport when unspecified.
- 4.23 Call Answer Timeout
- 4.24 T38UDPFEC in SDP Response
- 4.25 IP Traffic Management Response Message
- 4.26 200OK PRACK/UPDATE Race Condition Prevention Delay
- 4.27 Append (+) for Headers
- 4.28 Remove (+) for Headers
- 4.29 R-URI Header Tags
- 5
The SIP Profile Advanced Settings object is an extension of the SIP Profile object. When communicating with an external gateway there are various attributes/features that need to be associated with that particular gateway. The SIP Advanced Settings object is created under the SIP Profile object and adds more attributes/features to the existing SIP Profile object. Once configured, the SIP Profile created can be added to the SIP Signaling object, the External SIP Gateways object and External ENUM Server Sets object. The SIP Profiles configured will all be selectable from a drop down menu in each of the objects described above. In addition to the fields in the SIP Profile and SIP Advanced Setting object, there are also multiple additional objects that can be configured under the SIP Profile (SGP). These additional objects add additional features/attributes. Refer to the information below for information on configuring each individual field.
Web GUI Page
Dialogic > Profiles > SIP Profiles > SIP Profile > New SIP Advanced Settings
Maximum Objects
One SIP Advanced Settings object per SIP Profile object.
Related Topics and Dependencies
The SIP Advanced Settings object is a extension of the SIP Profile object. The SIP Advanced Settings object adds attributes/features to the already created SIP Profile.
Field Descriptions
Outbound Modem Triggers Re-INVITE
Disabled (Default) - Feature is disabled.
Enabled - The IMG 2020 will send a re-INVITE to the far-end when it detects modem traffic. The IMG 2020 switches the RTP into Modem Bypass mode over G.711. The IMG 2020 will then use the bypass codec type specified in the associated Bearer Profile (u-law or a-law). Incoming Re-INVITE's during modem calls are accepted automatically.
INFO for Spirou/ITX
The ITX/TXA messages are used in a Spirou (Signalisation Pour l'Interconnexion des Réseaux Ouverts/Signaling for the Interconnection of Open Networks) network for audio services that are paid for by either a flat rate calculation or time based calculation. The IMG 2020 supports sending both the ITX and TXA messages. The INFO for Spirou/ITX field enables or disables the sending of these messages. Refer to SPIROU/ITX in SIP INFO topic for more information.
Disabled (Default) - Support for the Spirou Variant is disabled.
Enabled - When enabled there are two scenarios. SS7 to SIP and SIP to SS7. See below.
SS7 to SIP - The IMG 2020 will accept the ITX message from the SS7 ISUP leg and interwork it into a SIP INFO Message on the SIP leg.
SIP to SS7 - The IMG 2020 will accept the SIP INFO message (RFC 2976 - The SIP INFO Method) from SIP leg and generate an ITX message onto the SS7 ISUP leg.
Outgoing Fully Qualified Domain Name (FQDN)
The Fully Qualified Domain Name is a domain name which specifies an exact location of a piece of equipment within a Domain Name System. (Ex. myhost.example.com). The IMG 2020 allows user to input a FQDN in a number of different objects. The FQDN is entered in place of the IP address. If the Outgoing Fully Qualified Domain Name field is enabled, the IMG 2020 will include the FQDN in its outgoing requests and response messages. The feature is disabled by default and can be modified to send out the FQDN in place of IP addresses for the local SIP Signaling port, the local VoIP Module Port, or both. See below.
Disabled (Default) - Feature is disabled. Only IP addresses are sent with outgoing requests and responses.
Signaling Only - The Fully Qualified Domain Name assigned to the local SIP Signaling port in the SIP Signaling object is inserted in the outgoing SIP messages. See SIP FQDN Support topic.
SDP c=line Only - The Fully Qualified Domain Name assigned in the VoIP Resource object is inserted in the outgoing SIP messages and responses.
Both - The Fully Qualified Domain Name assigned to both the VoIP Resource and SIP Signaling objects are inserted in the outgoing SIP messages.
User Domain - The Fully Qualified Domain Name assigned to the User Domain. The outgoing SIP INVITE message To: and From: headers to contain the FQDN in SIP IP address.
CenturyLink User Domain - Avaya Special.
Incoming Reason Header Cause Code
The Reason Header describes through the use of cause codes why a SIP request or response was issued. The Reason Header is issued in the BYE, CANCEL, 4xx, 5xx, and 6xx requests/responses. The Reason Header field provides the ability to propagate cause code information from SIP leg to TDM leg and/or TDM leg to SIP leg without having to configure SIP-T. The SIP Reason Header will provide additional information on why a call was disconnected. The cause codes implemented are based on ITU-T Recommendation Q.850. The interworking of cause code values are based on RFC 3326.
Disabled (Default) - The IMG 2020 will interwork of the release cause codes based on RFC 3398 ISUP to SIP Mapping.
Enabled - The IMG 2020 will propagate the cause value from the first Reason Header with a valid cause value based on ITU-T Recommendation Q.850.
For more information refer to SIP Reason Header.
Allow 180 after 183
In a normal call flow the 183 Session Progress message indicates whether the calling user agent should provide alerting or not. Once the 183 has been sent then a 180 Ringing message is sent dependent on the specific call flow. The Allow 180 after 183 field can be configured either to allow or suppress the 180 Ringing message. See below.
Enabled (Default) - The IMG 2020 will send a 180 Ringing message after sending a 183 Session Progress message if the specific call flow requires.
Disabled - The IMG 2020 will not send a 180 Ringing message if a 183 Session Progress with SDP has already been sent to the remote SIP side.
Acceptable Inbound Call Type
The Acceptable Inbound Call Type field is for inbound calls only and is applicable if an external gateway communicating with IMG 2020 is configured to use TLS. The field is used to specify whether non-TLS inbound calls will be accepted or rejected by the IMG 2020 from this gateway. (i.e. UDP or TCP call attempts) The Acceptable Inbound Call Type field enforces the use of TLS as a preference or a requirement for a specific SIP profile assigned to an external gateway. See below.
Make encrypted calls-accept all calls (Default) - If a non-encrypted call is received from an external gateway, the IMG 2020 server port will accept the call.
Make and accept only encrypted calls - If a non-encrypted call is received from an external gateway, the IMG 2020 server port will not accept the call.
Secure SIP (SIPS)
SIP provides a secure URI called SIPS URI. If an external gateway and the IMG 2020 are configured to use TLS security, then this field is used to select the URI scheme sips or sip. If TLS is not configured on the IMG 2020 then the Enable SIPS field will be ignored. Refer to the Configure TLS topic for information on configuring TLS functionality. If TLS is configured on IMG 2020 then the selections below are valid. See example below.
Enabled (Default) - When set to true the SIP URI scheme is formatted as follows:
sips:alice@atlanta.com;transport=tcp
Disabled - When set to false the SIP URI scheme is formatted as shown below:
sip:alice@atlanta.com;transport=tcp
SIP-T Pass On
When SIP-T is enabled on the IMG 2020, it is enabled globally. If however there is an external gateway that SIP-T is either not supported on or not enabled, the IMG 2020 can disable SIP-T to that gateway. In the SIP-T Pass On field there is a drop down menu where you can select yes or no.
Enabled - If Yes is selected, SIP-T will be enabled and any ISUP messaging will be sent between SIP and SS7.
Disabled - If No is selected, SIP-T will be disabled and no SIP-T messaging will be sent between SIP and SS7.
If no is selected and the external gateway sends the IMG 2020 SIP-T messaging, the IMG 2020 will not transfer the SIP-T ISUP information. The IMG 2020 will operate as if SIP-T were not enabled and pass only the SIP messaging.
Hold/UnHold
Use this field to configure the IMG 2020 to On Hold/Resume (Hold/UnHold) while in early media as well as in connected state.
Accept (Default) - IMG 2020 will accept the Hold/UnHold request.
Reject - IMG 2020 will reject the Hold/UnHold request with SIP 488 "Not Acceptable Here"
Hold/UnHold Propagation
Use this field to configure the IMG 2020 to either propagate or not propagate a On Hold/Resume (Hold/UnHold) request to the outbound SIP. The Hold/UnHold is supported in early media (SIP UPDATE) as well as in connected state (SIP UPDATE or SIP RE-INVITE). See below.
The Call Flows below display a SIP to SIP call. The Hold/UnHold Propagation feature supports SIP to SS7 and SS7 to SIP as well.
Enabled (Default) - When the Hold/UnHold Propagation field is set toenabledthen the SIP UPDATE or SIP INVITE that contains the Hold message will be propagated to the remote leg of the call.
Disabled - When the Hold/UnHold Propagation field is set todisabledthen the SIP UPDATE or SIP INVITE that contains the Hold message WILL NOT be propagated to the remote leg of the call.
Retry After Support
The IMG 2020 supports sending and receiving the Retry Header in the event there is SIP congestion. When the Retry after support field is set to enable, the IMG 2020 would determine the level of SIP congestion. If it is determined that SIP congestion levels are acceptable, the call will go through. If however congestion levels are high, the IMG 2020 will send a 503 Service Unavailable along with a Retry Header indicating time to wait before re-sending INVITE back to IMG 2020. Refer to SIP Retry-After Header - Transmit and SIP Retry-After Header - Receive for more information.
Enabled (Default) - The IMG 2020 will respond with a Retry-After Header in its response if the Channel Group is congested.
Disabled - The IMG 2020 will not send a Retry-After Header in its response if Channel Group is congested.
Clear Channel Override
The IMG 2020 supports the Clear Channel Codec as described in RFC 4040.
Disabled (Default) - Clear Channel Override is disabled. The Outgoing Codec will not be forced to Clear Channel even if the incoming parameters dictate the correct conditions. See Clear Channel Codec Support for more information.
Enabled - If the Bearer Capability value of the incoming call matches a certain set of requirements and the Clear Channel Override field in the SIP SGP Profile pane on the outgoing side is set to enable then the IMG 2020 will force the outgoing Codec to be clear channel. See Clear Channel Codec for more information.
When Enabled, if a Clear Channel codec is present in the IP profile, the configured payload type is used. If no Clear Channel Codec is configured, the dynamic payload type 125 is used in the SDP of the outgoing SIP INVITE.
Enforce User=phone
The IMG2020 enforces the user=phone in R-URI, "to" header, "from" header and P-Asserted-Identity header.
Disabled (Default) - IMG2020 does not include the user=phone.
Enabled - IMG2020 enforces the user=phone.
Enforce sendrecv in SDP
Enforces “sendrecv” attribute to always be present in SDP for all SIP offer/answer messages.
Disabled (Default) - As per RFC4566, if none of the attributes "sendonly", "recvonly", "inactive" and "sendrecv" is present, IMG2020 will assume and use the default value
Enabled - When the default value is used, IMG2020 will add the "sendrecv" attribute in the outgoing SDP even if not necessary as per RFC4566.
Phone Context
The Phone-Context Parameter (RFC 3966) is supported on the IMG 2020 for outgoing INVITE requests only. Select from drop down menu one of the following choices. See SIP Phone Context Parameter for more information.
Disabled (Default) - Phone Context support is by default disabled.
Include in To: Header - Include the Phone Context Parameter in the To: Header only.
Include in From Header - Include the Phone Context Parameter in the From: Header only.
Include in both To: and From: Headers - Include the Phone Context Parameter in both the To: and From: Headers.
Phone Context String
If Phone Context Support field above is set to Disable then the Phone Context String field cannot be modified. To be able to modify the Phone Context String field, change the Phone Context Support field to one of the choices other than Disabled. Once accomplished, click in the Phone Context String field and enter the Phone Context String which can be one of two formats. The two formats are either by digit string or by domain name. Max number of characters is 64. Below are a few examples:
Digit String = 1508862
Domain Name = hyannis.dialogic.com
Allow NOTIFY w/o Subscription
Choose from a drop down menu the following selections:
Disallow (Default) - Do not allow the IMG 2020 to accept a NOTIFY message without a subscription.
Allow - Allow the IMG 2020 to accept a NOTIFY message without a Subscription. The Notify message will be accepted without a subscription only if the parameters Content Type = application/simple-message-summary and Event = message summary are in the SIP NOTIFY message. Select Allow when configuring the Message Waiting Indicator feature.
183 Periodic Retransmission
In response to a SIP INVITE message, a 183 Session Progress message is first received on the B Leg. It is interworked and transmitted out the A leg. If the Call Answer Timeout value in the field below is set to a large amount of time, the IMG 2020 will keep retransmitting the interworked 183 Session Progress messages. Typically one 183 Session Progress message every minute. The 183 Periodic Transmission field can either enable or disable the retransmission of these 183 Session Progress messages out the A Leg. Refer to the Call Answer Timeout and 183 Periodic Retransmission functionality topic for more information.
Enabled (Default) - If 183 Session Progress message is interworked from the B Leg to the A leg the IMG 2020 will retransmit the 183 Session Progress message out the A Leg as long as the call has not been answered (200 OK received).
Disabled - If 183 Session Progress message is interworked from the B Leg to the A leg the IMG 2020 will NOT retransmit the 183 Session Progress message out the A Leg as long as the call has not been answered (200 OK received). However, the IMG 2020 still sends out the retransmitted 183 Session Progress messages interworked from the B leg.
Star Digit Mapping
This will allow the ability to handle star () as digit number. For example, this mapping of the star digit () is required for some JT-ISUP use cases.
Mapped to 0x0E (Default) - The digit is mapped to digit 0x0E.
Mapped to 0x0B - The star digit (*) from SIP is mapped to digit 0x0B.
To receive and send digits A to F, the Support Digit A to F field in the must me set to True.
Hex Digit Mapping
This will allow the ability to select how A-F digits will be displayed in SIP headers.
Lower Case (Default) - The digits are displayed in lower case (abcdef).
Upper Case - The digits are displayed in upper case (ABCDEF).
Route by Prefix
This will allow the user to associate a Prefix with an outgoing Channel Group.
Disabled (Default) - Route by Prefix is disabled.
Enabled - Route by Prefix is enabled.
Enabled - Keep Prefix - Route by Prefix is enabled and the Prefix is relayed to the outgoing leg. This is applicable for SIP-SIP call only.
Use Ext GW transport when unspecified.
The transport parameter in a SIP url, when unspecified, defaults to UDP. In some case scenario, it may cause the SIP signaling to switch from TCP to UDP.
Disabled (Default) - When unspecified, the transport defaults to UDP.
Enabled - When the transport is unspecified, the Transport Type value in the External Gateway configuration is used.
Call Answer Timeout
After a 183 Call Session Progress message is received, a Call Answer Timeout timer starts. If this timer expires, the call is cancelled. During a SIP Early Media call, the Call Answer Timeout may need to be extended to accept the early media. The Call Answer Timeout field allows a user the ability to modify the Timeout period. The default value is 3 minutes and can be modified to not expire for up to 60 minutes. For more information on the functionality of the Call Answer Timeout field, refer to the Call Answer Timeout and 183 Periodic Retransmission functionality topic.
T38UDPFEC in SDP Response
Disabled (Default) - For T.38 SDP offer, the IMG will respond with attribute a=T38FaxUdpEC:t38UDPRedundancy.
Enabled - For T.38 SDP offer containing attribute a=T38FaxUdpEC:t38UDPFEC, the IMG will respond with attribute a=T38FaxUdpEC:t38UDPFEC.
IP Traffic Management Response Message
This field allows a user the ability to select the SIP response message when IP Traffic Management rejects the call.
503 Service Unavailable (Default) - The server is currently unable to handle the request due to a temporary overloading or maintenance.
500 Server Internal Error - The server encountered an unexpected condition which prevented it from fulfilling the request.
403 Forbidden - The server understood the request, but is refusing to fulfill it. Authorization will not help, and the request SHOULD NOT be repeated.
200OK PRACK/UPDATE Race Condition Prevention Delay
This field allows a user the ability to introduce a delay to prevent a race condition between the 200 (OK) for the INVITE and the 200 (OK) for the PRACK/UPDATE. This condition is sometimes encountered when communicating with some Voice over LTE (VoLTE) implementations.
The minimum value is 0x100msec = 0sec. The maximum value is 20x100msec = 2sec. If the user selects between 0-20, this would be 100msec increment. When the delay is set to 0sec, the feature is disabled. There is no delay added, which is the default behavior.
Append (+) for Headers
Use the Append () for Headers field to add the prefix + to any outgoing INVITE requests if the incoming INVITE does not have +. Click on one or more selections within the Append () for Headers field. The chosen selections (highlighted in blue) will have the prefix + appended to the outgoing INVITE. To highlight more than one choice, hold down the <Ctrl> key while clicking the selection.
Remove (+) for Headers
Use the Remove () for Headers field to remove the + prefix from an incoming message. The outgoing INVITE request will not include the + prefix. This feature can also be used in the case where the incoming side is not SIP. Click on one or more choices within the Remove () for Headers field. The chosen selections (highlighted in blue) will have the prefix + removed from the outgoing INVITE. To highlight more than one choice, hold down the <Ctrl> key while clicking the selection.
R-URI Header Tags
Click on the selection within the R-URI Header Tags field. The tag selected (highlighted in blue) will be added into the R-URI of the outgoing INVITE in the sip_uri_enc method. To highlight more than one selection, hold down the <Ctrl> key while clicking the selection. Selections are described below.
None (Default) - No tags will be added to outgoing INVITE.
CIC (Carrier Identification Code)and DAI (Dial Around Indicator) - The CIC parameter is a three or four digit code used in routing tables to identify the network that serves the remote user when a call is routed over many different networks. The DAI parameter will be displayed immediately after the CIC code. See SIP CIC and DAI Codes for more information.
RN (Routing Number) - The RN tag is used to convey the location routing number. Refer to the Local Number Portability (LNP) topic for more information.
NPDI (Number Portability DIP Indicator) - The NPDI tag is used to indicate whether an LNP query has been performed. Refer to the LNP Routing topic for more information.
ISUB/ISUB-Encoding - The ISDN calling party Subaddress parameters convey address information of each device in the ISDN network. For more information on ISUB Encoding, refer to the ISUB Encoding topic.
tty-ind - custom parameter indicating Baudot tone detection in Re-INVITE