1. ACLI Reference Guide
  2. ACLI Configuration Elements A-M
  3. codec-policy

codec-policy

The codec-policy configuration element allows you to configure codec policies, sets of rules that specify the manipulations to be performed on SDP offers.

Parameters

name
Enter the unique name for the codec policy. This is the value you will use to refer to this codec policy when you apply it to realms or session agents. This is a required parameter.
allow-codecs
Enter the list of media format types (codecs) to allow for this codec policy. In your entries, you can use the asterisk (*) as a wildcard, the force attribute, or the no attribute so that the allow list you enter directly reflect your configuration needs. The text:no value strips "m=text" occurrence in the outbound INVITE and enables T.140 to Baudot transcoding. The codecs that you enter here must have corresponding media profile configurations. This field accepts conditional codec policy syntax.
add-codecs-on-egress
Enter the codecs to be appended to an offer. Excluding keywords add and delete when a list is already configured replaces the entire list. This field accepts conditional codec policy syntax.
  • [add | delete] <name> [name>...]

    Note:

    Only codecs that can be transcoded may be specified. See your version's Release Notes for the list of applicable codecs.
order-codecs
Enter the order in which you want codecs to appear in the outgoing SDP offer. You can use the asterisk (*) as a wildcard in different positions of the order to directly reflect your configuration needs. The codecs that you enter here must have corresponding media profile configurations. This field accepts conditional codec policy syntax.
force-ptime
Enable or disable a forced ptime being used.
  • Default: disabled
  • enabled | disabled
packetization-time
Enter a preferred ptime when the force-ptime parameter is enabled.
  • Default: 20
  • Values: 10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100
dtmf-in-audio
Select how the Oracle Communications Session Border Controller should support the conversion of signaling messages or RFC 2833 to DTMF Audio tones in the realm where this transcoding policy is active.
  • Default: disabled
  • Values:
    • disabled—Does not support DTMF audio tones as transcoded in this realm.
    • preferred—Supports DTMF audio tones as transcoded in this realm.
    • dual—Supports both transcoded DTMF audio tones and signaling-based DTMF indications if possible.
tone-detection
Enables FAX tone detection.
  • fax-cng—Causes the system to start its FAX transcoding based on the detection of CNG or CED tone.
  • fax-v21—Causes the system to start its FAX transcoding based on the receipt of V21 messages.
tone-detect-renegotiate-timer
Specifies the time after which the system sends a re-Invite if it does not receive a re-Invite from the endpoint. The system resets this timer whenever it receives a re-Invite from the endpoint.
  • Default: 500
  • Values: 50 - 32000
reverse-fax-tone-detection-reinvite
Allows you to force the SBC to send a ReInvite that includes T.38 in the SDP out a realm that does not have tone detection enabled.
  • disabled—Does not force the system to send ReInvites out a different realm. (Default)
  • enabled—Allows the system to send ReInvites out a different realm during applicable scenarios.
fax-single-m-line
Set this parameter to the preferred FAX media type for Re-INVITEs to endstations that do not support multiple m-lines. The SBC issues Re-INVITEs using the configured media type only. Should the negotiation fail, the SBC issues another Re-INVITE that offers the other media type.
  • disabled—The single m-line function is disabled. (Default)
  • image-first—Sends Re-INVITE with m=image as the only m-line in the SDP.
  • audio-first—Sends Re-INVITE with m=audio as the only m-line in the SDP.
evrc-tty-baudot-transcode
Enables transcoding of EVRC TTY TDD to BAUDOT in EVRC-G.711
  • Default: disabled
  • Values: enabled | disabled
secure-dtmf-cancellation
Removes all Dual-Tone Multi-Frequency (DTMF) information that the SBC processes within the codec-policy from ingress. It also removes the residual signal energy (i.e. the leftover signaling from the media stream) at the beginning and ending of each DTMF digit so that an important piece of data is not detectable within the egress stream. But this option does not remove DTMF bleed unless transcoding is enabled for the call.
  • Default: disabled
  • Values: enabled | disabled

Path

codec-policy is an element of the media-manager path. The full path from the topmost ACLI prompt is: configure terminal, and then media-manager, and then codec-policy.