100rel inbound

To configure the 100rel interworking parameters for inbound SIP adjacencies on signaling border elements (SBEs), use the 100rel inbound command in the adjacency SIP configuration mode.

100rel inbound {strip | support}

 
Syntax Description

inbound

Sets the inbound SIP 100rel parameters.

strip

Strips 100rel from the Supported and Require headers in the incoming INVITE request.

support

Sends reliable provisional responses for all the requests that include a “Supported: 100rel” header, even when the request does not include a “Require: 100rel” header and responses are received as unreliable provisional responses.

 
Command Default

100rel interworking is disabled.

 
Command Modes

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to enable the 100rel strip option for the incoming INVITE request for inbound SIP adjacency:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc test
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip adj1
Router(config-sbc-sbe-adj-sip)# 100rel inbound strip
Router(config-sbc-sbe-adj-sip)#
 

The following example shows how to enable 100rel support option to send reliable provisional responses for all the incoming SIP INVITE requests that contains “Supported:100rel” header:

Router(config-sbc-sbe-adj-sip)# 100rel inbound support
Router(config-sbc-sbe-adj-sip)#
 

 

100rel outbound

To configure the 100rel interworking parameters for outbound SIP adjacencies on signaling border elements (SBEs), use the 100rel outbound command in the adjacency SIP configuration mode.

100rel outbound {require-add | support-add}

 
Syntax Description

outbound

Sets the outbound SIP 100rel parameters.

require-add

Adds 100rel Require header in the outgoing INVITE request.

support-add

Adds 100rel Support header in the outgoing INVITE request.

 
Command Default

100rel interworking is disabled.

 
Command Modes

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to enable 100rel Require header option in the outgoing INVITE request:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc test
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip adj1
Router(config-sbc-sbe-adj-sip)# 100rel outbound require-add
Router(config-sbc-sbe-adj-sip)#
 

The following example shows how to enable 100rel Support header option in the outgoing INVITE request:

Router(config-sbc-sbe-adj-sip)# 100rel outbound support-add
Router(config-sbc-sbe-adj-sip)#

account (session border controller)

To define a SIP or H.323 adjacency account on an SBE, use the account command in the appropriate configuration mode. To remove this definition, use the no form of this command.

account account-name

no account account-name

 
Syntax Description

account-name

Specifies the SBE account name.

The account-name can have a maximum of 32 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No account name is associated with the adjacency.

 
Command Modes

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the H.323 adjacency h323ToIsp42 to account isp42:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323 SipToIsp42
Router(config-sbc-sbe-adj-h323)# account isp42
 

The following example shows how to configure the SIP adjacency SipToIsp42 to account isp42:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip SipToIsp42
Router(config-sbc-sbe-adj-sip)# account isp42
 

 

action (body)

To set the action to take on a body type in a SIP body profile for a non-SDP message body, use the action (body) command in SBE configuration mode. To restore the default behavior of action nopass, use the no action command.

action [ pass | nopass | strip | reject]

no action [ pass | nopass | strip | reject]

 
Syntax Description

pass

Instructs the SBC to pass through the body type of the non-SDP message body.

nopass

Uses the handling parameter in the message to determine whether to strip the body or reject the entire message with error code 415 (Unsupported media type).

strip

Strips the body and passes the rest of the message.

reject

Rejects the entire message with an error code.

 
Command Default

The command default is action nopass.

 
Command Modes

SBE SIP Body Element configuration (config-sbc-sbe-sip-body-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 2.6

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The action (body) command is used in conjunction with the sip body-profile {profle_name} and body {body_name} commands to complete the configuration.

After creating a body profile with the sip body-profile {profile_name} command, you can associate the body profile at the following levels and configuration modes:

  • At the SIP signaling entity level (ingress or egress), under SBE mode, using the sip default body-profile [[inbound|outbound] {profle_name}] command. The body profile is associated for the entire signlaing instance (that is all messages, either ingress or egress, passing through the SBC).
  • SIP adjacency level, under SIP adjacency mode, using the body-profile [[inbound|outbound] {profle_name}] command. The body profile is associated to an adjacency.
  • At SIP method profile level, under method profile mode, using the body-profile {profle_name} command. The body profile is associated to a method profile.

SBC uses a body profile that you create and associate to filter non-SDP bodies from incoming and outgoing SIP messages, based on the Content-Type header field. A body profile allows a message containing a specific non-SDP body to be either passed (without altering the message), stripped of the body (and pass the rest of the message), or be rejected.

Examples

The following example creates a body profile named bodyprofile1, associates the body profile at the SIP signaling level for all inbound calls passing through the SBC, describes the body type that is to act on messages with the "application/ISUP" content-type header, and instructs SBC to strip that particular message body and pass the rest of the message.

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip body-profile bodyprofile1
Router(config-sbc-sbe)# sip default body-profile inbound bodyprofile1
Router(config-sbc-sbe-sip-body)# body application/ISUP
Router(config-sbc-sbe-sip-body-ele)# action strip
Router(config-sbc-sbe-sip-body-ele)#

 
Related Commands

Command
Description

sip default body-profile

Associates a body profile at the SIP signaling level under the SBE mode.

body-profile

Associates a body profile to a method profile under the method profile mode.

body-profile (sip adj)

Associates a body profile at the SIP adjacency level, to an adjacency, under SIP adjacency mode.

sip body-profile

Creates a body profile used to filter non-SDP bodies from incoming and outgoing SIP messages.

body

Names a body type or content header type for a non-SDP message body that is part of the body profile.

action (body editor)

To set an action to be taken on a body type in a SIP body editor for a non-SDP message body, use the action command in the signaling border element (SBE) SIP body element configuration mode. To remove the action, use the no form of this command.

action [ pass | nopass | strip | reject]

no action

 
Syntax Description

pass

Instructs the session border controller (SBC) to pass through the body type of the non-SDP message body.

nopass

Uses the handling parameter in the message to determine whether to strip the body or reject the entire message with the error code 415, which is unsupported media type.

strip

Strips the body and passes the rest of the message.

reject

Rejects the entire message.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE SIP body element configuration (config-sbc-sbe-mep-bdy-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The action (body) command is used in conjunction with the sip body-editor {editor-name} and body {word} commands to complete the configuration.

The SBC uses a body editor that you have created and associated, to filter the non-SDP bodies from the incoming and outgoing SIP messages, based on the Content Type header field. A body editor allows a message containing a specific non-SDP body to be passed (without altering the message), stripped off the body (and pass the rest of the message), or rejected.

Examples

The following example shows how to create a body editor named bodyeditor1, describe the body type, that is to act on the messages with the application/ISUP Content Type header , and instruct the SBC to strip that particular message body and pass the rest of the message:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip body-editor bodyeditor1
Router(config-sbc-sbe-mep-bdy)# body application/ISUP
Router(config-sbc-sbe-mep-bdy-ele)# action strip
Router(config-sbc-sbe-mep-bdy-ele)#
 

 
Related Commands

Command
Description

body

Names a body type or content header type for a non-SDP message body that is a part of a body editor.

body-editor

Associates a body editor at a SIP adjacency level to an adjacency in the SIP adjacency mode.

sip body-editor

Creates a body editor to filter the non-SDP bodies from the incoming and outgoing SIP messages.

action (CAC)

To configure the action to perform after this entry in an admission control table, use the action command in CAC table entry configuration mode.

action { cac-complete | next-table goto-table-name }

no action { cac-complete | next-table goto-table-name }

 
Syntax Description

cac-complete

Indicates an event matches, this CAC policy is complete.

next-table

Specifies the name of the next cac table.

goto-table-name

Table name identifying the next CAC table to process (or cac-complete, if processing should stop).

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the next table to process for the entry in the new admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete

 
Related Commands

Command
Description

action (NA-)

Configures the action to perform after an entry in an admission control table.

action (RTG-SRC)

Configures the action to take if a routing entry is chosen.

action drop-msg

To add an action of dropping the message to a SIP message profile, use the action drop-msg command in SIP header-profile configuration mode. To remove the method from the profile, use the no form of this command.

action drop-msg

no action drop-msg

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

No default behavior or values are available.

 
Command Modes

SIP header configuration (config-sbc-sbe-sip-hdr)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows action of dropping the message to a SIP message profile to the header profile Myprofile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip header-profile Myprofile
Router(config-sbc-sbe-sip-hdr)# action drop-msg

 
Related Commands

Command
Description

sip header-profile

Configures a header profile.

action (header-editor)

To configure an action that is to be taken on an element type in a header editor or parameter editor, use the action command in the appropriate configuration mode. To remove an action from the element type, use the no form of this command.

action {add-first-header| add-header | replace-name | replace-value} { value word }

action {as-editor | drop-msg | pass | strip}

action reject [ status-code code-number ]

no action

 
Syntax Description

add-first-header

Adds the first occurrence of a header (no action occurs if a header already exists).

add-header

Adds a header irrespective of whether or not a header already exists.

as-editor

Default editor action (whitelist or blacklist).

drop-msg

Drops the message.

pass

Passes on the header.

reject

Rejects a request if this header is present, specifically for INVITE headers.

replace-name

Replaces the header name.

replace-value

Replaces the header content (value).

strip

Unconditionally strips the matched body, header, or parameter element.

value

Specifies the string used in conjunction with the action.

word

String used in the action. It can be upto 256 characters.

status-code

Specifies the SIP status code for the response.

code-number

SIP status-code number that can range from 300 to 699. By default, it is 488.

 
Command Default

By default, the code-number is 488.

 
Command Modes

SBE Header Editor Header configuration (config-sbc-sbe-mep-hdr-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, you must remove the existing configuration first.

Examples

The following example shows how to set the as-editor action for the To header element type in the headerprof1 parameter editor:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip header-editor headerprof1
Router(config-sbc-sbe-mep-hdr)# header To
Router(config-sbc-sbe-mep-hdr-ele)# action as-editor

 
Related Commands

Command
Description

header

Configures a header element in a header editor.

parameter-editor

Configures a parameter element in a parameter editor.

sip header-editor

Configures a header editor.

action (method-editor)

To configure an action to be taken on a method editor, use the action command in the signaling border element (SBE) method editor element configuration mode. To deconfigure an action, use the no form of this command.

action {as-editor | pass | reject}

no action

 
Syntax Description

as-editor

Passes the method for the whitelist method editor, and rejects for the blacklist method editor.

pass

Passes the method.

reject

Rejects the method.

 
Command Default

The default is the as-editor keyword.

 
Command Modes

SBE method editor element configuration (config-sbc-sbe-mep-mth-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows the reject action:

Router# configure terminal
Router(config)# sbc mysbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip method-editor editor1
Router(config-sbc-sbe-mep-mth)# description mysbc editor1
Router(config-sbc-sbe-mep-mth)# blacklist
Router(config-sbc-sbe-mep-mth)# method test
Router(config-sbc-sbe-mep-mth-ele)# action reject
Router(config-sbc-sbe-mep-mth-ele)# end
 

 
Related Commands

Command
Description

header

Configures a header element in a header editor.

parameter-editor

Configures a parameter element in a parameter editor.

action (method profile)

To configure the action to take on a method profile, use the action command in the SBE method profile element configuration mode. To remove the action on a method profile, use the no form of this command.

action {as-profile | pass | reject}

no action

 
Syntax Description

as-profile

Drops the method. This is the default

pass

Passes the method.

reject

Rejects the method.

 
Command Default

The default is as-profile.

 
Command Modes

SBE method profile element configuration (config-sbc-sbe-sip-mth-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows the action to drop the method:

Router# configure terminal
Router(config)# sbc mysbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip method-profile profile1
Router(config-sbc-sbe-sip-mth)# description mysbc profile1
Router(config-sbc-sbe-sip-mth)# blacklist
Router(config-sbc-sbe-sip-mth)# pass-body
Router(config-sbc-sbe-sip-mth)# method test
Router(config-sbc-sbe-sip-mth-ele)# action as-profile
Router(config-sbc-sbe-sip-mth-ele)# end
 

 
Related Commands

Command
Description

header

Configures a header element in a header profile.

parameter-profile

Configures a parameter element in a parameter profile.

action (NA-)

To configure the action of an entry in the number analysis table with entries of the table matching a source number (prefix or whole number), a dialed number (prefix or whole number) or the source adjacency or account, use the action (NA-) command in the Number analysis table configuration mode. To deconfigure the action, use the no form of this command.

action { next-table goto-table-name | accept | reject }

no action

 
Syntax Description

next-table goto-table-name

Specifies the next number analysis table to process, if the event matches this entry.

accept

Configures the call to be accepted if it matches the entry in the table.

reject

Configures the call to be rejected if it matches the entry in the table.

 
Command Default

No default behavior or values are available.

 
Command Modes

Number analysis table configuration (config-sbc-sbe-rtgpolicy-natable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 2.6

This command was updated to support source number analysis.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the call to be accepted if it matches the entry in the new number analysis table MyNaTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# na-number-table MyNaTable
Router(config-sbc-sbe-rtgpolicy-natable)# entry 1
Router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept
 

The following example shows how to configure the call to be accepted if it matches the start of the entry in the new number analysis table MyNaTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# na-dst-prefix-table MyNaTable
Router(config-sbc-sbe-rtgpolicy-natable)# entry 1
Router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept
 

The following example shows how to configure the call to be accepted if it matches the source adjacency entry in the new number analysis table MyNaTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# na-src-adjacency-table MyNaTable
Router(config-sbc-sbe-rtgpolicy-natable)# entry 1
Router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept
 

The following example shows how to configure the call to be accepted if it matches the source account entry in the new number analysis table MyNaTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# na-src-account-table MyNaTable
Router(config-sbc-sbe-rtgpolicy-natable)# entry 1
Router(config-sbc-sbe-rtgpolicy-natable-entry)# action accept

 
Related Commands

Command
Description

action (CAC)

Configures the action to perform after an entry in an admission control table.

action (RTG-SRC)

Configures the action to take if a routing entry is chosen.

action (parameter)

To configure the action to take on an element type in a parameter, use the action command in the appropriate configuration mode. To remove an action from the element type, use the no form of this command.

action {add-not-present | add-or-replace | strip}

no action {add-not-present | add-or-replace | strip}

 
Syntax Description

add-not-present

Adds the parameter if it is not present.

add-or-replace

Adds the parameter if it is not present or replace the parameter if it is present.

strip

Strips out the parameter if it is present.

 
Command Default

The default parameter action is strip .

The default header action is strip .

 
Command Modes

SBE header profile header configuration (config-sbc-sbe-sip-hdr-ele)

SBE parameter profile parameter configuration (config-sbc-sbe-sip-prm-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Examples

The following example shows how to set the action for parameter element type user in parameter profile paramprof1 to add-not-present:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip parameter-profile paramprof1
Router(config-sbc-sbe-sip-prm)# parameter user

Router(config-sbc-sbe-sip-prm-ele)# action add-not-present value phone

The following example shows how to set the action for header element type To in parameter profile headerprof1 to as-profile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip header-profile headerprof1
Router(config-sbc-sbe-sip-hdr)# header To

Router(config-sbc-sbe-sip-hdr-ele)# action as-profile

 
Related Commands

 

Command
Description

header

Configures a header element in a header profile.

parameter

Configures a parameter element in a parameter profile.

action (parameter editor)

To configure an action to be taken on an element type in a parameter editor, use the action command in the SIP Parameter Editor Element configuration mode. To remove an action from an element type, use the no form of this command.

action {add-not-present | add-or-replace} {value} { word | private-ip-address | public-ip-address}

action strip

no action

 
Syntax Description

add-not-present

Adds the parameter if it is not present.

add-or-replace

Adds the parameter if it is not present, or replaces the parameter if it is present.

value

Specifies the value of the parameter to be added or replaced.

word

Description of the action. Length can be a maximum of 30 characters.

private-ip-address

Specifies the value of the parameter as the private IP address.

public-ip-address

Specifies the value of the parameter as the public IP address.

strip

Strips out the parameter if it is present.

 
Command Default

By default, strip is used.

 
Command Modes

SIP Parameter Editor Element configuration (config-sbc-sbe-mep-prm-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to set the add-not-present action for the parameter element type user in the paramedit1 parameter editor:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip parameter-editor paramedit1
Router(config-sbc-sbe-mep-prm)# parameter user
Router(config-sbc-sbe-mep-prm-ele)# action add-not-present value phone

 
Related Commands

 

Command
Description

parameter

Configures a parameter element in a parameter editor.

sip parameter-editor

Configures a parameter editor.

action (RTG-)

To configure the action to take if a routing entry is chosen, use the action command in the RTG routing table configuration mode. To delete the action, use the no form of this command.

action { next-table goto-table-name | complete | reject }

no action

 
Syntax Description

next-table goto-table-name

Specifies the next routing table to process if the event matches the entry.

complete

Completes the action.

reject

Rejects the indicated action.

 
Command Default

No default behavior or values are available.

 
Command Modes

RTG routing table configuration (config-sbc-sbe-rtgpolicy-rtgtable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# rtg-src-address-table MyRtgTable
Router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 1471
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject
 

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# rtg-src-adjacency-table MyRtgTable
Router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-adjacency 1471
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject
 

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# rtg-src-account-table MyRtgTable
Router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-account 1471
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action reject
 

The following example shows how to configure the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# rtg-round-robin-table MyRtgTable
Router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 1471
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action complete
 

The following example configures the match-value of an entry in the new routing table MyRtgTable and if any calls match this criterion, they are rejected.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# rtg-dst-address-table MyRtgTable
Router(config-sbc-sbe-rtgpolicy-rtgtable)# entry 1
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# match-address 1471
Router(config-sbc-sbe-rtgpolicy-rtgtable-entry)# action complete

 
Related Commands

Command
Description

action (NA-)

Configures the action of an entry in the number analysis table with entries of the table matching a dialed number (prefix or whole number) or the source adjacency or account.

action (CAC)

Configures the action to perform after an entry in an admission control table.

action (SDP)

To configure an SDP policy table action, use the action command in sdp match table configuration mode. To return to the default, use the no form of this command.

action {whitelist | blacklist}

no action

 
Syntax Description

 

whitelist

Allow the defined set of attributes and block the rest.

blacklist

Block the defined set of attributes and allow the rest. This is the default.

 
Command Default

The default action is blacklist.

 
Command Modes

SDP match table configuration (config-sbc-sbe-sdp-match-tbl)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows action of dropping the message to a SIP message profile to the header profile Myprofile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sdp-match-table 1
Router(config-sbc-sbe-sdp-match-tbl)# action blacklist

 
Related Commands

Command
Description

sdp-match-table

Creates an SDP match table.

match-string

Configures an SDP attribute matching string.

sdp-policy-table

Configures an SDP policy table.

action (SIP)

To configure the action to take on an element type in a header or parameter profile, use the action command in the appropriate configuration mode. To remove an action from the element type, use the no form of this command.

action {add-first-header| add-header | as-profile | drop-msg | pass | replace-name | replace-value | strip}

no action {add-first-header| add-header | as-profile | drop-msg | pass | replace-name | replace-value | strip}

 
Syntax Description

add-first-header

Adds the first occurrence of a header (no action if a header exists).

add-header

Adds a header whether on not one already exists.

as-profile

Default profile action (whitelist or blacklist).

drop-msg

Drops the message.

pass

Pass on the header.

replace-name

Replace the header name.

replace-value

Replace the header content (value).

strip

Unconditionally strips the matched body, header, or parameter element.

 
Command Default

The default body action is strip .

The default parameter action is strip .

The default header action is strip .

 
Command Modes

SBE header profile header configuration (config-sbc-sbe-sip-hdr-ele)

SBE parameter profile parameter configuration (config-sbc-sbe-sip-prm-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Examples

The following example shows how to set the action for parameter element type user in parameter profile paramprof1 to add-not-present:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip parameter-profile paramprof1
Router(config-sbc-sbe-sip-prm)# parameter user

Router(config-sbc-sbe-sip-prm-ele)# action add-not-present value phone

The following example shows how to set the action for header element type To in parameter profile headerprof1 to as-profile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip header-profile headerprof1
Router(config-sbc-sbe-sip-hdr)# header To

Router(config-sbc-sbe-sip-hdr-ele)# action as-profile

 
Related Commands

Command
Description

header

Configures a header element in a header profile.

parameter-profile

Configures a parameter element in a parameter profile.

activate (billing)

To activate billing once it is configured, use the activate command in SBE billing configuration mode.

activate

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

By default, billing is not activated.

 
Command Modes

SBE billing configuration (config-sbc-sbe-billing)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

You can activate billing only after the RADIUS configuration has been activated.

Examples

The following example shows how to activate the billing functionality after configuration is committed:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# billing

Router(config-sbc-sbe-billing)# activate

 
Related Commands

Command
Description

billing

Configures billing.

ldr-check

Configures the time of day (local time) to run the Long Duration Check (LDR).

local-address ipv4

Configures the local IPv4 address that appears in the CDR.

method packetcable-em

Enables the packet-cable billing method.

packetcable-em transport radius

Configures a packet-cable billing instance.

show sbc sbe billing remote

Displays the local and billing configurations.

activate (enum)

To activate ENUM client, use the activate command in ENUM configuration mode. To deactivate ENUM client, use the no form of this command.

activate

no activate

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

No default behavior or values are available.

 
Command Modes

ENUM configuration (config-sbc-sbe-enum)

 
Command History

Release
Modification

Cisco IOS XE Release 3.1S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to activate ENUM client:

Router# configure terminal
Router(config)# sbc MySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# enum 1
Router(config-sbc-sbe-enum)# activate
 

 
Related Commands

Command
Description

activate (enum)

Activates ENUM client.

dial-plan-suffix

Configures the dial plan suffix used for the ENUM query.

div-address

Enters the diverted-by address mode to set the priority of the header or headers from which to derive a diverted-by address (inbound only).

dst-address

Enters the destination address mode to set the priority of the header or headers from which to derive a called party address (inbound only).

entry (enum)

Configures the ENUM client entry name and enter the ENUM entry configuration mode.

enum

Configures the ENUM client ID number and enter the ENUM configuration mode.

header-prio header-name

Configures the priority of a header that is used to derive a source, destination, or diverted-by address.

max-recursive-depth

Configures the maximum number of recursive ENUM look-ups for non-terminal Resource Records (RR).

max-responses

Configures the maximum number of ENUM records returned to the routing module.

req-timeout

Configures the ENUM request timeout period.

src-address

Enters the source address mode to set the priority of the header or headers from which to derive a calling party address (inbound only).

server ipv4

Configures the IPv4 address of a DNS server for ENUM client and optionally associate the DNS server to a VRF.

show sbc sbe call-policy-set

Displays configuration and status information about call policy sets.

show sbc sbe enum

Displays the configuration information about an ENUM client.

show sbc sbe enum entry

Displays the contents of an ENUM client entry.

activate (radius)

To activate the RADIUS client, use the activate command in the appropriate configuration mode. To disable this command, use the no form of this command.

activate

no activate

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

Default is the no form of the command.

 
Command Modes

Server accounting (config-sbc-sbe-acc)

Server authentication (config-sbc-sbe-auth)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to activate the RADIUS client .

Router# configure terminal
Router(config)# sbc uut105-1
Router(config-sbc)# sbe
Router(config-sbc-sbe)# radius accounting SBC1-account-1
Router(config-sbc-sbe-acc)# activate
 

 
Related Commands

 

retry-interval

Sets the retry interval to connect to the RADIUS server.

retry-limit

Sets the retry interval to the RADIUS server.

concurrent-requests

Sets the maximum number of concurrent requests to the RADIUS server.

activate (session border controller)

To start the Session Border Controller (SBC) service when all signaling border element (SBE) or data border element (DBE) address configuration have been successfully committed, use the activate command in the appropriate configuration mode. To deactivate the SBE service of the SBC, use the no form of this command.

activate

no activate

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

Default is the no form of the command.

 
Command Modes

DBE configuration (config-sbc-dbe)

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.1

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 2.4

SBE support added for unified SBC.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

The command is not completed even when the CLI returns; there is an asynchronous process (activation or deactivation) going on and the new instruction is not actioned until the last one completes.

Examples

The following example shows how to activate the DBE on the service mySbc:

Router# configur
Router(config)# sbc mySbc dbe

Router (config-sbc-dbe)# activate

The following example shows how to activate the SBE on the service mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# activate

 
Related Commands

Command
Description

deact-mode

Indicates how to implement the deactivation of an SBE.

cac-policy-set global

To activate the global call admission control (CAC) policy set within an signaling border element (SBE) entity, use the cac-policy-set global command in the SBE configuration mode.

cac-policy-set global policy-set-id

 
Syntax Description

policy-set-id

Integer identifying the policy set that should be made global. Range is from 1 to 2147483647.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was replaced by the cac-policy-set global command.

 
Usage Guidelines

The active CAC policy set cannot be modified.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to activate policy set 1 on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# cac-policy-set global 1

 
Related Commands

Command
Description

cac-policy-set

Creates a new CAC policy set, copies an existing complete policy set, swaps the references of a complete policy set to another policy set, or sets the averaging period for rate calculations in a CAC policy set.

show sbc sbe cac-policy-set

Lists detailed information pertaining to a CAC policy table.

call-policy-set default

To activate a default policy set within a signaling border element (SBE) entity, use the call-policy-set default command in the SBE configuration mode. To deactivate a default policy set, use the no form of this command.

call-policy-set default policy-set-id

no call-policy-set default

 
Syntax Description

policy-set-id

Number that identifies the default call policy set. The range is from 1 to 2147483647.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was replaced by the call-policy-set default command.

 
Usage Guidelines

If another policy set was previously active, it is made inactive by executing this command. The SBE is created with no active routing policy set; an active routing policy set must be explicitly configured using this command.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to set policy set 1 as the default on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# call-policy-set default 20

 
Related Commands

Command
Description

call-policy-set

Creates a policy set on the session border controller (SBC).

first-inbound-na-table

Configures the name of the first inbound policy table to be processed when performing the number analysis stage of a policy.

first-outbound-na-table

Configures the name of the first outbound policy table to be processed when performing the number analysis stage of a policy.

show sbc sbe call-policy-set

Lists the details of the policy sets configured on the SBC.

show sbc sbe call-policy-set default

Lists the summary of the default policy set configured on the SBC.

active-script-set

To activate a script set, use the active-script-set command in the SBE configuration mode. To change the active script set to the inactive state, use the no form of this command. Only one script set can be active on the SBC at any given point in time. When you use the no form of this command, script-based editing is temporarily disabled.

active-script-set script-set-number

no active-script-set

 
Syntax Description

script-set-number

Script set number. This is the number that you set when you run the script-set lua command.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 3.4S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

At any particular point of time, only one script can be in the active state on the SBC. When you run the active-script-set command for a particular script set, the script set that was previously active automatically goes to the inactive state. The editors in an inactive script set are not applied to SIP messages. You can switch an inactive script set to the active state by running the active script-set command on it. To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run this command.

Examples

In the following example, the active-script-set command is used to activate the script set with the number 10:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# script-set 10 lua
Router(config-sbc-sbe-script-set)# script mySBCScript
Router(config-sbc-sbe-scrpset-script)# load-order 2
Router(config-sbc-sbe-scrpset-script)# type wrapped edit-point both
Router(config-sbc-sbe-scrpset-script)# filename bootflash:mySBCScript.lua
Router(config-sbc-sbe-scrpset-script)# exit
Router(config-sbc-sbe-script-set)# complete
Router(config-sbc-sbe-script-set)# exit
Router(config-sbc-sbe)# active-script-set 10

 
Related Commands

Command
Description

clear sbc sbe script-set-stats

Clears the stored statistics related to a script set.

complete

Completes a CAC policy set, call policy set, or script set after committing the full set.

editor

Specifies the order in which a particular editor must be applied.

editor-list

Specifies the stage at which the editors must be applied.

editor type

Configures an editor type to be applied on a SIP adjacency.

filename

Specifies the path and name of the script file written using the Lua programming language.

load-order

Specifies the load order of a script in a script set.

script

Configures a script written using the Lua programming language.

show sbc sbe editors

Displays a list of all the editors registered on the SBC.

show sbc sbe script-set

Displays a summary of the details pertaining to all the configured script sets or the details of a specified script set.

script-set lua

Configures a script set composed of scripts written using the Lua programming language.

sip header-editor

Configures a header editor.

sip method-editor

Configures a method editor.

sip option-editor

Configures an option editor.

sip parameter-editor

Configures a parameter editor.

test sbc message sip filename script-set editors

Tests the message editing functionality of the SBC.

test script-set

Tests the working of a script set.

type

Specifies the type of a script written using the Lua programming language.

address ipv4 (session border controller)

To configure the address of the RADIUS server, use the address command in the Server accounting configuration mode. To deconfigure the active accounting server address, use the no form of this command.

address ipv4 A.B.C.D.

no address ipv4 A.B.C.D.

 
Syntax Description

A.B.C.D.

IP address of the RADIUS server.

 
Command Default

No default behavior or values are available.

 
Command Modes

Server accounting (config-sbc-sbe-acc-ser)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

Any number of accounting servers can be specified. Call Detail Reports are sent to the accounting server with the highest priority upon call termination.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following command configures accounting servers castor and pollux on mySbc for Remote Authentication Dial-In User Service (RADIUS) client instance radius1:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# radius accounting radius1
(config-sbc-sbe-acc)# server castor
(config-sbc-sbe-acc-ser)# address ipv4 10.0.0.1
(config-sbc-sbe-acc-ser)# exit
(config-sbc-sbe-acc)# server pollux
(config-sbc-sbe-acc-ser)# address pollux
(config-sbc-sbe-acc-ser)# exit

 

address (session border controller)

To configure either an IP address or a host name to act as a redundant peer, use the address command in adjacency Session Initiation Protocol (SIP) peer configuration mode. To deconfigure an IP address or a host name, use the no form of this command.

address address

no address address

 
Syntax Description

address

The IP address or host name of a peer.

 
Command Default

No default behavior or values are available.

 
Command Modes

Adjacency SIP peer configuration (config-sbc-sbe-adj-sip-peer)

 
Command History

Release
Modification

Cisco IOS XE Release 3.1S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section that follows shows the hierarchy of the modes required to run the command.

Examples

The following example shows how the address command is used to configure an IP address or a host name to act as a redundant peer on a SIP adjacency:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip SipToIsp42
Router(config-sbe-adj-sip)# redundant peer 1
Router(config-sbe-adj-sip-peer)# address sbc1
 

 
Related Commands

 

Command
Description

network

Configures either an IPv4 or IPv6 network in a redundant peer.

port

Configures a port for redundant peer.

priority

Configures a redundant peer’s priority.

redundant peer

Configures an alternative signaling peer for an adjacency.

adjacency

To configure an adjacency for an Session Border Controller (SBC) service, use the adjacency command in SBE configuration mode. To deconfigure the adjacency, use the no form of this command.

adjacency { sip | h323 } adjacency-name

no adjacency { sip | h323 } adjacency-name

 
Syntax Description

sip

Enters the mode of an SBE SIP adjacency, often called adjacency sip mode, to configure a destination SIP adjacency.

h323

Enters the mode of an SBE H.323 adjacency, often called adjacency h323, to configure a destination H.323 adjacency.

adjacency-name

Specifies the name of the SBE SIP or H.323 adjacency.

The adjacency-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section below shows the hierarchy of modes required to run the command.

Examples

The following example shows how the adjacency command configures a SIP adjacency named sipGW, and enters into adjacency sip mode.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip sipGW
Router(config-sbc-sbe-adj-sip)#
 
The following example shows how the adjacency command configures an H.323 adjacency named H323ToIsp42, and enters into adjacency h323 mode.
 
Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323 H323ToIsp42
Router(config-sbc-sbe-adj-h323)#

 

adjacency h248

To configure an H.248 Border Access Controller (BAC) access adjacency and core adjacency, use the adjacency h248 command in the H248 BAC configuration mode. To unconfigure an H.248 BAC access adjacency and core adjacency, use the no form of this command.

adjacency h248 {access access-adjacency name}

adjacency h248 {core core-adjacency name}

no adjacency h248 {access access-adjacency name} | {core core-adjacency name}

 
Syntax Description

h248

Specifies an adjacency for an H.248 BAC.

access

Specifies an access adjacency.

access-adjacency name

Name of the access adjacency.

The access-adjacency name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

core

Specifies a core adjacency.

core-adjacency name

Name of the core adjacency.

The core-adjacency name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

None

 
Command Modes

H248 BAC configuration (config-h248-bac)

 
Command History

Release
Modification

Cisco IOS XE Release 3.7

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

When you configure an access adjacency, the adjacency h248 command enters the access adjacency submode.

When you configure a core adjacency, the adjacency h248 command enters the core adjacency submode.

Examples

The following example shows how the adjacency h248 command is used to configure an H.248 BAC access adjacency:

Router# configure terminal
Router(config)# sbc h248 bac
Router(config-h248-bac)# adjacency h248 access iad_80_123

 

The following example shows how the adjacency h248 command is used to configure an H.248 BAC core adjacency:

Router# configure terminal
Router(config)# sbc h248 bac
Router(config-h248-bac)# adjacency h248 core core_spec2

 
Related Commands

Command
Description

core-adj

Binds an H.248 BAC core djacency with its corresponding H.248 BAC access adjacency.

adjacency timeout

To configure the adjacency retry timeout interval, use the adjacency timeout command in the appropriate configuration mode. To return to the default value, use the no form of this command.

adjacency timeout value

no adjacency timeout value

 
Syntax Description

value

Specifies the timeout period in milliseconds. Valid values are from 10000 to 30000. The default value is 30 seconds.

 
Command Default

The default value is 30 seconds.

 
Command Modes

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

H.323 configuration (config-sbc-sbe-h323)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how the adjacency timeout command configures adjacency retry timeout in adjacency H.323 configuration mode:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323 h323ToIsp42
Router(config-sbc-sbe-adj-h323)# adjacency timeout 10000
 

The following example shows how the adjacency timeout command configures adjacency retry timeout in H.323 configuration mode.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# h323
Router(config-sbc-sbe-h323)# adjacency timeout 10000
 

 

admin-domain

To configure an administrative domain, use the admin-domain command in the Signaling border element (SBE) configuration mode. To deconfigure an administrative domain, use the no form of this command.

admin-domain name

no admin-domain name

 
Syntax Description

name

The name of an administrative domain.

The name field can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration mode (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

The command enables the user to enter into the administrative domain mode. The policy set that is to be used for an administrative domain is defined in the administrative domain mode. A user can specify only one CAC policy set to be used for the administrative domain. A user can also define separate call policy sets for inbound number analysis, routing policy, and outbound number analysis. If the policies are not specified, the default call policy set is used.

The policy sets must be in a complete state before they can be assigned to an administrative domain. A default call policy set must be configured before the administrative domain mode can be entered.

Examples

The following example shows how to configure an administrative domain in the SBE configuration mode:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set default 25 priority 1
Router(config-sbc-sbe)# admin-domain ADMINDOMAIN
Router(config-sbc-sbe-ad)# description This is the description of the admin-domain 1
Router(config-sbc-sbe-ad)# call-policy-set inbound-na 2 priority 1
Router(config-sbc-sbe-ad)# call-policy-set outbound-na 3 priority 1
Router(config-sbc-sbe-ad)# call-policy-set rtg 2 priority 1
Router(config-sbc-sbe-ad)# cac-policy-set 2
Router(config-sbc-sbe-ad)# exit
 
 

 
Related Commands

Command
Description

cac-policy-set (admin-domain)

Configures the call admission control (CAC) policy set for an administrative domain.

call-policy-set (admin-domain)

Configures the inbound and outbound number analysis and routing policy set for an administrative domain.

show sbc sbe admin-domain

Lists the administrative domains on the Session Border Controller (SBC) and per adjacency.

 

 

admin-domain (adjacency)

To associate an administrative domain to an adjacency, use the admin-domain command in the Session Initiation Protocol (SIP) adjacency and an H.323 adjacency configuration mode. To remove the association of an administrative domain from an adjacency, use the no form of this command.

admin-domain name

no admin-domain name

 
Syntax Description

name

Specifies the name of an administrative domain.

The name field can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

SIP adjacency mode (config-sbc-sbe-adj-sip)

H.323 adjacency mode (config-sbc-sbe-adj-h323)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

In the SIP and H.323 adjacency modes, the user can configure up to two optional administrative domains on an adjacency. A separate admin-domain command is configured for every administrative domain. An administrative domain can be configured for both the SIP adjacency and the H323 adjacency. However, the H.323 adjacency must be unattached in order to be able to add, delete, or modify the administrative domain.

Examples

The following example shows how to assign the administrative domain to a SIP adjacency:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip SIPP
Router(config-sbc-sbe-adj-sip)# admin-domain ADMINDOMAIN
Router(config-sbc-sbe-adj-sip)#

 
Related Commands

Command
Description

cac-policy-set (admin-domain)

Configures the call admission control (CAC) policy set for an administrative domain.

call-policy-set (admin-domain)

Configures the inbound and outbound number analysis and routing policy set for an administrative domain.

show sbc sbe admin-domain

Lists the administrative domains on the Session Border Controller (SBC) and per adjacency.

 

 

alias (session border controller)

To configure the endpoint alias of an H.323 adjacency, use the alias command in adjacency H.323 configuration mode. To remove this configuration, use the no form of this command.

alias alias-name

no alias

 
Syntax Description

alias-name

Specifies the alias of the H.323 adjacency endpoint.

The alias-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the H.323 adjacency h323ToIsp42 endpoint alias to end1:

 
Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323 h323ToIsp42
Router(config-sbc-sbe-adj-h323)# alias end1

 
Related Commands

Command
Description

attach-controller

Configures a DBE to attach to a controller.

allow diff-med-sig-vpn

To allow media and signaling to use different VPN IDs in a call leg, use the allow diff-med-sig-vpn command in the session border controller (SBC) configuration mode. To allow media and signaling to use the same VPN ID in a call leg, use the no form of this command.

allow diff-med-sig-vpn

no allow diff-med-sig-vpn

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

No default values are available.

 
Command Modes

SBC configuration (config-sbc)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5.0S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

Ensure that the SBC is deactivated before running the allow diff-med-sig-vpn command.

If the SBC is active and you run the allow diff-med-sig-vpn command, the system issues a warning message, asking you to first deactivate the SBC. You can reactivate the SBC using the activate command.

Use the show run command to display the output of the allow diff-med-sig-vpn command.

Examples

The following example shows how the allow diff-med-sig-vpn command allows media and signaling to use different VPN IDs in a call leg:

Router# configure terminal
Router(config)# sbc test
Router(config-sbc)# no activate
Router(config-sbc)# allow diff-med-sig-vpn
Router(config-sbc)# activate
Router(config-sbc)# exit

allow private info

To configure an H.323 adjacency to allow private information on messages sent out by the adjacency, use the allow private info command in the adjacencyH.323 configuration mode. To disallow private information on messages sent out by the adjacency, use the no form of this command.

allow private info

no allow private info

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

By default, the H.323 adjacency does not send private information.

 
Command Modes

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Please note that if you configure the H.323 adjacency to allow private information, then it will allow private information on messages even if the CAC policy is configured to apply privacy service or the user requests privacy service.

Examples

The following example shows how the allow private info command is used to configure an H.323 adjacency to allow private information on messages sent by the adjacency.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323ToIsp422
Router(config-sbc-sbe-adj-h323)# allow private info

 
Related Commands

Command
Description

privacy restrict outbound

Configures an H.323 adjacency to apply privacy restriction on outbound messages if the user requests it.

associate dspfarm profile

To associate the session border controller (SBC) with a digital signal processor (DSP) farm profile, use the associate dspfarm profile command in the SBC and SBC-DBE configuration modes. To remove the association with a DSP farm profile, use the no form of this command.

associate dspfarm profile { profile-number | all }

no associate dspfarm profile { profile-number | all }

 
Syntax Description

profile-number

The DSP farm profile number the SBC is to associate with.

all

The SBC picks one of the DSP farm profiles associated with the SBC for its transcoding session.

 
Command Default

No default behavior or values.

 
Command Modes

SBC and SBC-DBE configuration (config-sbc-dbe)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section that follows shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to associate the SBC with a DSP farm profile using the associate dspfarm profile command in the SBC-DBE mode:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc mySBC dbe
Router(config-sbc-dbe)# associate dspfarm profile 1

attach-controllers (session border controller)

To configure a DBE to attach to an H.248 controller, use the attach-controllers command in VDBE configuration mode. To detach the DBE from its controller, use the no form of this command.

attach-controllers

no attach-controllers

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

The default is that no controllers are attached.

 
Command Modes

VDBE configuration mode (config-sbc-dbe-vdbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.1

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The attachment and detachment of the DBE from its controller does not always complete immediately. To view the current attachment status, use the show sbc dbe controllers command.

Examples

In a configuration where the DBE has been created and controllers have been configured, the following example shows how to attach the DBE to a controller in VDBE configuration mode:

Router# configure terminal
Router(config)# sbc mySbc dbe
Router(config-sbc-dbe)# vdbe
Router(config-sbc-dbe-vdbe)# attach-controllers

 
Related Commands

 

Command
Description

vdbe

Configures a virtual data border element (vDBE) and enters the VDBE configuration mode.

show sbc dbe controllers

Lists the media gateway controllers configured on each vDBE and its controller address.

attach (H.248 BAC)

To set the Border Access Controller (BAC) adjacency state to Attached, use the attach command in the H248 BAC adjacency configuration mode. To set the BAC adjacency state to Detached, use the no form of this command.

attach

no attach

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

None

 
Command Modes

H248 BAC adjacency configuration (config-h248-bac-adj)

 
Command History

Release
Modification

Cisco IOS XE Release 3.7

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Examples

The following example shows how the attach command is used to set the BAC adjacency state:

Router# configure terminal
Router(config)# sbc h248 bac
Router(config-h248-bac)# adjacency h248 access iad_80_123
Router(config-h248-bac-adj)# attach

attach (Rf billing)

To attach an origin realm or an origin host to a Rf billing on an Element (SBE), use the attach command in the SBC SBE billing Rf configuration mode. To detach an origin realm or an origin host to a Rf billing on an SBE, use the no form of this command.

attach

no attach

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

None.

 
Command Modes

SBC SBE billing Rf configuration (config-sbc-sbe-billing-rf)

 
Command History

Release
Modification

Cisco IOS XE Release 3.7S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Examples

The following example shows how to attach the an origin realm to an Rf billing on an SBE:

Router> enable
Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# billing
Router(config-sbc-sbe-billing)# rf 0
Router(config-sbc-sbe-billing-rf)# origin-realm mySBC
Router(config-sbc-sbe-billing-rf)# attach

attach (session border controller)

To attach an adjacency to an account on an SBE, use the attach command in the appropriate configuration mode. To detach the adjacency from an account on an SBE, use the no form of this command.

attach

no attach force [abort | normal]

 
Syntax Description

force

Executes a forced detach.

abort

Tears down calls without signaling an end.

normal

Tears down calls gracefully.

 
Command Default

Default is the no form of the command.

 
Command Modes

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

You can only modify adjacencies when the adjacency is detached. Before modifying an adjacency, you can detach the adjacency first with the no attach command. The adjacency stays in the going down state when a call is active or when the ping enable feature is running. During this state, existing calls are not torn down and new calls are not accepted. The adjacency does not go to detached state until all calls have ended. An adjacency cannot be attached until the adjacency is in detached state.

If you wish to override the option to wait till active calls on the adjacency end, the adjacency can be detached immediately using the following commands:

  • no attach force abort—Executes a forced detach, tearing down calls without signaling their end.
  • no attach force normal—Executes a forced detach, tearing down calls gracefully.

To check the state of the adjacency, you can use the show sbc sbe adjacencies command.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to attach the H.323 adjacency to h323ToIsp42:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323 h323ToIsp42
Router(config-sbc-sbe-adj-h323)# attach

audit (H.248 BAC)

To force the Border Access Controller (BAC) to send an audit to an H.248 terminal device, ignoring the audit initiated by the H.248 terminal device, use the audit force command in the H248 BAC adjacency configuration mode. To auto audit (default), which means the BAC will not send an audit to an H.248 terminal device if the audit initiated by the H.248 terminal device is received within the audit interval, use the no form of this command.

To change the audit interval in the BAC, use the audit interval command in the H248 BAC adjacency configuration mode. To return to the default value, use the no form of this command.

audit force

audit interval idle time

no audit {force | interval idle time }

 
Syntax Description

force

Forces the H.248 BAC to send an audit to the terminal devices. Default is auto audit.

interval

Specifies the audit interval.

idle time

Audit time interval, in seconds. The range is from 0 to 3600. The default value is 60.

 
Command Default

The default is the no form of the command.

 
Command Modes

H248 BAC adjacency configuration (config-h248-bac-adj)

 
Command History

Release
Modification

Cisco IOS XE Release 3.7

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command can be configured only in the access adjacency submode and not in the core adjacency submode.

Examples

The following example shows how the audit force command forces the BAC to send an audit to the H.248 terminal devices:

Router# configure terminal
Router(config)# sbc h248 bac
Router(config-h248-bac)# adjacency h248 access iad_80_123
Router(config-h248-bac-adj)# audit force

 

The following example shows how the audit interval command is used to change the audit interval in the BAC:

Router# configure terminal
Router(config)# sbc h248 bac
Router(config-h248-bac)# adjacency h248 access iad_80_123
Router(config-h248-bac-adj)# audit interval 300

authentication mode (session border controller)

To configure the authentication mode for a SIP adjacency, use the authentication mode command in the adjacency SIP configuration mode. To deconfigure the authentication mode, use the no form of this command.

authentication mode { local | remote }

no authentication mode { local | remote }

 
Syntax Description

local

Configures the SIP adjacency for local authentication.

remote

Configures the SIP adjacency for remote authentication.

 
Command Default

No default behavior or values are available.

 
Command Modes

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how the authentication mode command is used to configure the SIP adjacency for local authentication:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip SipToIsp42
Router(config-sbe-adj-sip)# authentication mode local

 
Related Commands

Command
Description

authentication nonce timeout

Configures the authentication nonce timeout for a SIP adjacency.

authentication (session border controller)

To configure the H.323 adjacency authentication, use the authentication command in the adjacency H.323 configuration mode. To deconfigure the H.323 adjacency authentication mode, use the no form of this command.

authentication auth-type

no authentication

 
Syntax Description

auth-type

The authentication type; currently this can only be endpoint.

 
Command Default

Default is the no form of the command.

 
Command Modes

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command causes the SBC to authenticate itself with a Gatekeeper. The gatekeeper is responsible for performing the endpoint authentication.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following command sets H.323 adjacency "h323ToIsp42" to use endpoint authentication.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# isp42 adjacency h323 h323ToIsp42
Router(config-sbc-sbe-adj-h323)# authentication endpoint
Router(config-sbc-sbe-adj-h323)# exit
 
 
 

 

bandwidth-fields mandatory

To set the bandwidth description of Session Description Protocol (SDP) as mandatory, use the bandwidth-fields mandatory command in Virtual Data Border Element (VDBE) configuration mode. To set the bandwidth description as optional, use the no form of this command.

bandwidth-fields mandatory

no bandwidth-fields

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

The default behaviour is that the bandwidth description of SDP is optional.

 
Command Modes

VDBE configuration (config-sbc-dbe-vdbe)

 
Command History

Release
Modification

Cisco IOS XE Release 3.1S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in a user group that is associated with a task group that includes the proper task IDs. To use this command, you must be in the correct configuration mode and submode. The Examples section that follows shows the hierarchy of the modes and submodes required to run the command.

Examples

The following example shows how to set the bandwidth description of the SDP as mandatory in the VDBE configuration mode:

Router# configure terminal
Router# sbc sbc dbe
Router(config-sbc-dbe)# vdbe global
Router(config-sbc-dbe-vdbe)# bandwidth-fields mandatory

 
Related Commands

Command
Description

vdbe

Enters VDBE configuration mode.

bandwidth (session border controller)

To configure the maximum and minimum bandwidth limits for media calls, use the bandwidth command in codec definition mode mode. To return the bandwidth to the default value, use the no form of this command.

bandwidth bandwidth-value [ min bandwidth-value ]

no bandwidth bandwidth-value [ min bandwidth-value ]

 
Syntax Description

bandwidth

Specifies the maximum bandwidth in bits per second (bps) for media calls. Decimal points are allowed.

min bandwidth-value

(Optional) Specifies the minimum bandwidth in bits per second (bps) for media calls. Decimal points are allowed.

 
Command Default

The default minimum bandwidth is 128 kbps.

 
Command Modes

Codec definition mode (config-sbc-sbe-codec-def)

 
Command History

Release
Modification

Cisco IOS XE Release 3.1S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

This command configures the bandwidth for the analog-to-digital codec (enCOder/DECoder) hardware. The codec name must be one of the system codecs that SBC can recognize. To see a list of the system codecs, use the show sbc sbc sbe codecs command.

The minimum bandwidth setting is for use with the media police degrade command. It specifies the minimum acceptable bandwidth for the video codec. If the available bandwidth is smaller than the configured min bandwidth-value , the call is rejected under the degrade policy. The minimum bandwidth setting applies only to the unidirectional bandwidth of the media stream, and does not include the packet overhead.

The bandwidth min command specifies the unidirectional, minimum bandwidth limit bandwidth and does not include packet overhead.

Examples

The following example shows how to configure the maximum bandwidth limit to 400,000 bps for media calls:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# codec system H263 id 34
Router(config-sbc-sbe-codec-def)# bandwidth 400000
 

The following example shows how to configure the minimum bandwidth limit to 328,000 bps, specifically for video type media calls:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router (config-sbc-sbe)# codec custom h263-c id 96
Router (config-sbc-sbe-codec-def)# type variable
Router (config-sbc-sbe-codec-def)# media video
Router (config-sbc-sbe-codec-def)# bandwidth min 328000
 

 
Related Commands

Command
Description

bandwidth

Configures the maximum and minimum bandwidth limits for media calls.

caller-bandwidth-field

Configures SBC to convert a specific bandwidth line format into another bandwidth line format in an outbound Session Description Protocol (SDP) sent to the caller.

callee-bandwidth-field

Configures the SBC to convert a specific bandwidth line format into another bandwidth line format in an outbound Session Description Protocol (SDP) sent to the callee

max-bandwidth-per-scope

Configures the maximum limit for the bandwidth in bps, Kbps, Mbps or Gbps for an entry in an admission control table.

batch-size

To configure the batching or grouping of RADIUS messages sent to a RADIUS server, use the batch command in the packetcable-em configuration mode. To disable the batch, use the no form of this command.

batch-size number

no batch-size

 
Syntax Description

 

number

Specifies the batch size in bytes. The range is 0 through 4096.

 
Command Default

0

 
Command Modes

Packet-cable em configuration (config-sbc-sbe-billing-packetcable-em)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

A value of 0 indicates no batching. A platform may choose to set a non-zero default value (this may increase performance.)

Examples

The following example shows how to configure the maximum size of a batch of CDRs:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# billing
(config-sbc-sbe-billing)# packetcable-em 4 transport radius test
(config-sbc-sbe-billing-packetcable-em)# batch-size 256

 
Related Commands

 

Command
Description

activate (radius)

Activates the billing functionality after configuration is committed.

attach

activate the billing for a RADIUS client

batch-size

Configures the batching or grouping of RADIUS messages sent to a RADIUS server.

batch-time

Configures the maximum number of milliseconds for which any record is held in the batch before the batch is sent

deact-mode

Configures the deactivate mode for the billing method.

ldr-check

Configures the time of day (local time) to run the Long Duration Check (LDR).

local-address ipv4

Configures the local IPv4 address that appears in the CDR.

local-address ipv4 (packet-cable)

Configures the local address of the packet-cable billing instance.

method packetcable-em

Enables the packet-cable billing method.

packetcable-em transport radius

Configures a packet-cable billing instance.

show sbc sbe billing remote

Displays the local and billing configurations.

 

 

batch-time

To configure the maximum number of milliseconds for which any record is held before the batch is sent, use the batch-time command in the packetcable-em configuration mode. To disable the waiting period, use the no form of this command.

batch-time number

no batch-time

 
Syntax Description

 

number

Specifies the batch time in milliseconds. The range is 1 through 3600000.

 
Command Default

1000 milliseconds

 
Command Modes

Packet-cable em configuration (config-sbc-sbe-billing-packetcable-em)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the maximum number of milliseconds for which any record is held before the batch is sent:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# billing
(config-sbc-sbe-billing)# packetcable-em 4 transport radius test
(config-sbc-sbe-billing-packetcable-em)# batch-size 256
(config-sbc-sbe-billing-packetcable-em)# batch-time 22

 
Related Commands

 

Command
Description

activate (radius)

Activates the billing functionality after configuration is committed.

attach

activate the billing for a RADIUS client

batch-size

Configures the batching or grouping of RADIUS messages sent to a RADIUS server.

batch-time

Configures the maximum number of milliseconds for which any record is held in the batch before the batch is sent

deact-mode

Configures the deactivate mode for the billing method.

ldr-check

Configures the time of day (local time) to run the Long Duration Check (LDR).

local-address ipv4

Configures the local IPv4 address that appears in the CDR.

local-address ipv4 (packet-cable)

Configures the local address of the packet-cable billing instance.

method packetcable-em

Enables the packet-cable billing method.

packetcable-em transport radius

Configures a packet-cable billing instance.

show sbc sbe billing remote

Displays the local and billing configurations.

bgp additional-paths select

To have the system calculate a second BGP bestpath, use the bgp additional-paths select command in address family configuration mode. To remove this mechanism for calculating a second bestpath, use the no form of the command.

bgp additional-paths select { best-external [ backup ] | backup }

no bgp additional-paths select

 
Syntax Description

best-external

(Optional) Calculates a second bestpath from among those received from external neighbors. Configure this keyword on a PE or RR. This keyword enables the BGP Best External feature on an RR.

backup

(Optional) Calculates a second bestpath as a backup path.

 
Command Default

This command is disabled by default.

 
Command Modes

Address family configuration (config-router-af)

 
Command History

Release
Modification

Cisco IOS XE Release 3.4S

This command was introduced.

 
Usage Guidelines

The BGP Diverse Path feature can be enabled on a route reflector to calculate a bestpath and an additional path per address family.

Computation of a diverse path per address family is triggered by any of the following commands:

  • bgp additional-paths install
  • bgp additional-paths select
  • maximum-paths ebgp
  • maximum-paths ibgp

The bgp additional-paths install command will install the type of path that is specified in the bgp additional-paths select command Either the best-external keyword or the backup keyword is required; both keywords can be specified. If both keywords ( best-external and backup ) are specified, the system will install a backup path.

Examples

In the following example, the system computes a second best path from among those received from external neighbors:

router bgp 1
neighbor 10.1.1.1 remote-as 1
address-family ipv4 unicast
neighbor 10.1.1.1 activate
maximum-paths ibgp 4
bgp bestpath igp-metric ignore
bgp additional-paths select best-external
bgp additional-paths install
neighbor 10.1.1.1 advertise diverse-path backup

 
Related Commands

Command
Description

bgp additional-paths install

Enables BGP to calculate a backup path for a given address and to install it into the RIB and CEF.

bgp bestpath igp-metric ignore

Specifies that the system ignore the IGP metric during best path selection.

maximum-paths ebgp

Configures multipath load sharing for eBGP and iBGP routes.

maximum-paths ibgp

Controls the maximum number of parallel iBGP routes that can be installed in a routing table.

bgp bestpath igp-metric ignore

To have the system ignore the Interior Gateway Protocol (IGP) metric during BGP best path selection, use the bgp bestpath igp-metric ignore command in address family configuration mode. To remove the instruction to ignore the IGP metric, use the no form of this command.

bgp bestpath igp-metric ignore

no bgp bestpath igp-metric ignore

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

This command is disabled by default.

 
Command Modes

Address family configuration (config-router-af)

 
Command History

Release
Modification

Cisco IOS XE Release 3.4S

This command was introduced.

 
Usage Guidelines

The IGP metric is a configurable metric for EIGRP, IS-IS, or OSPF that is related to distance. The bgp bestpath igp-metric ignore command can be used independently, or in conjunction with the BGP Diverse Path feature. This command does not enable the BGP Diverse Path feature.

Similarly, enabling the BGP Diverse Path feature does not necessarily require that the IGP metric be ignored. If you enable the BGP Diverse Path feature and the RR and its shadow RR are not co-located, this command must be configured on the RR, shadow RR, and PE routers.

This command is supported in the following address families:

  • ipv4 unicast
  • vpnv4 unicast
  • ipv6 unicast
  • vpnv6 unicast
  • ipv4+label
  • ipv6+label

NoteThis command is not supported per VRF; if you use it per VRF, it is at your own risk. This command is not supported per VRF; if you use it per VRF, it is at your own risk.


This command applies per VRF as follows (which is consistent with the BGP PIC/Best External feature):

  • When configured under address-family vpnv4 or vpnv6, it applies to all VRFs, but it will be nvgened only under vpnv4/vpnv6 global.
  • When configured under a particular VRF, it applies only to that VRF and will be nvgened only for that VRF.
  • When configured under vpnv4 or vpnv6 global, this command can be disabled for a particular VRF by specifying no bgp bestpath igp-metric ignore . The no form will be nvgened under that VRF, while under vpnv4 or vpnv6 bgp bestpath igp-metric ignore is nvgened and the command applies to all other VRFs.

Examples

In the following example, the IGP metric is ignored during calculation of the BGP best path:

router bgp 1
neighbor 10.1.1.1 remote-as 1
address-family ipv4 unicast
neighbor 10.1.1.1 activate
maximum-paths ibgp 4
bgp bestpath igp-metric ignore
bgp additional-paths select backup
bgp additional-paths install
neighbor 10.1.1.1 advertise diverse-path backup

 
Related Commands

Command
Description

bgp additional-paths select

Specifies that the system compute a second BGP bestpath.

bgp consistency-checker

To enable the BGP Consistency Checker feature, use the bgp consistency-checker command in router configuration mode. To disable the BGP Consistency Checker feature, use the no form of this command.

bgp consistency-checker { error-message | auto-repair } [ interval minutes ]

no bgp consistency-checker

 
Syntax Description

error-message

Specifies that when an inconsistency is found, the system will only generate a syslog message.

auto-repair

Specifies that when an inconsistency is found, the system will generate a syslog message and take action based on the type of inconsistency found.

interval minutes

(Optional) Specifies the interval at which the BGP consistency checker process occurs.

  • The range is 5 to 1440 minutes. The default is 1440 minutes (one day).

 
Command Default

No BGP consistency check is performed.

 
Command Modes

Router configuration (config-router)

 
Command History

Release
Modification

15.1(2)S

This command was introduced.

Cisco IOS XE 3.3S

This command was integrated into Cisco IOS XE 3.3S.

 
Usage Guidelines

A BGP route inconsistency with a peer occurs when an update or a withdraw is not sent to a peer, and black-hole routing can result. The BGP consistency checker feature is a low-priority process created to address this issue. This feature performs nexthop-label, RIB-out, and aggregation consistency checks. When BGP consistency checker is enabled, it is performed for all address families. Once the process identifies such an inconsistency:

  • If the error-message keyword is specified, the system will report the inconsistency with a syslog message, and will also perform forceful aggregation reevaluation in the case of an aggregation inconsistency.
  • If the auto-repair keyword is specified, the system will report the inconsistency with a syslog message and also take appropriate action, such as a route refresh request or an aggregation reevaluation, depending on the type of inconsistency.

Examples

In the following example, BGP consistency checker is enabled. If a BGP route inconsistency is found, the system will send a syslog message and take appropriate action.

Router(config)# router bgp 65000
Router(config-router)# bgp consistency-checker auto-repair

 
Related Commands

Command
Description

show ip bgp vpnv4 all inconsistency nexthop-label

Displays routes that have nexthop-label inconsistency found by BGP consistency checker.

bgp refresh max-eor-time

To cause the router to generate a Route-Refresh End-of-RIB (EOR) message if it was not able to generate one due to route flapping, use the bgp refresh max-eor-time command in router configuration mode. To disable the timer, use the no form of this command.

bgp refresh max-eor-time seconds

no bgp refresh max-eor-time

 
Syntax Description

seconds

Number of seconds after which, if the router was unable to generate a Route-Refresh EOR message due to route flapping, the router generates a Route-Refresh EOR message.

  • Valid values are from 600 to 3600, or 0.
  • The default is 0, meaning the command is disabled.

 
Command Default

0 seconds

 
Command Modes

Router configuration (config-router)

 
Command History

Release
Modification

Cisco IOS XE Release 3.4S

This command was introduced.

 
Usage Guidelines

The BGP Enhanced Route Refresh feature is enabled by default. The bgp refresh max-eor-time command is not needed under normal circumstances. You might configure the bgp refresh max-eor-time command in the event of continuous route flapping, when the router is unable to generate a Route-Refresh EOR message, in which case a Route-Refresh EOR is generated after the timer expires.

Examples

In the following example, if no Route-Refresh EOR message is received after 800 seconds, stale routes will be removed from the BGP table. If no Route-Refresh EOR message is generated after 800 seconds, one is generated.

router bgp 65000
bgp refresh stalepath-time 800
bgp refresh max-eor-time 800

 
Related Commands

Command
Description

bgp refresh stalepath-time

Causes the router to remove stale routes from the BGP table even if the router does not receive a Route-Refresh EOR message.

bgp refresh stalepath-time

To cause the router to remove stale routes from the BGP table even if the router does not receive a Route-Refresh EOR message, use the bgp refresh stalepath-time command in router configuration mode. To disable the timer, use the no form of this command.

bgp refresh stalepath-time seconds

no bgp refresh stalepath-time

 
Syntax Description

seconds

Number of seconds the router waits to receive a Route-Refresh End-of-RIB (EOR) message, and then removes the stale paths from BGP table if the router hasn’t received an EOR message.

  • Valid values are 600 to 3600, or 0.
  • The default is 0, meaning the command is disabled.

 
Command Default

0 seconds

 
Command Modes

Router configuration (config-router)

 
Command History

Release
Modification

Cisco IOS XE Release 3.4S

This command was introduced.

 
Usage Guidelines

The BGP Enhanced Route Refresh feature is enabled by default. The bgp refresh stalepath-time command is not needed under normal circumstances. You might configure the bgp refresh stalepath-time command in the event of continuous route flapping, when the router does not receive a Route-Refresh EOR after an Adj-RIB-Out, in which case the router removes the stale routes from the BGP table after the timer expires. The stale path timer is started when the router receives a Route-Refresh SOR.

Examples

In the following example, if no Route-Refresh EOR message is received after 800 seconds, stale routes will be removed from the BGP table. If no Route-Refresh EOR message is generated after 800 seconds, one is generated.

router bgp 65000
bgp refresh stalepath-time 800
bgp refresh max-eor-time 800

 
Related Commands

Command
Description

bgp refresh max-eor-time

Causes the router to generate a Route-Refresh EOR message if it was not able to generate one due to route churn.

billing

To configure billing, use the billing command in SBE configuration mode. Use the no form of this command to remove all the billing configuration.

billing

no billing

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

There is only one billing per SBC.

Examples

The following example shows how to enter the billing mode for mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# billing
Router(config-sbc-sbe-billng)#
 

 
Related Commands

 

Command
Description

activate (radius)

Activates the billing functionality after configuration is committed.

ldr-check

Configures the time of day (local time) to run the Long Duration Check (LDR).

local-address ipv4

Configures the local IPv4 address that appears in the CDR.

method packetcable-em

Enables the packet-cable billing method.

packetcable-em transport radius

Configures a packet-cable billing instance.

show sbc sbe billing remote

Displays the local and billing configurations.

 

 

billing (CAC)

To configure billing, use the billing command in the CAC table entry configuration mode. To unconfigure the billing configuration, use the no form of this command.

billing { filter { disable | enable } | methods { packetcable-em | xml }}

no billing { filter | methods { packetcable-em | xml }}

 
Syntax Description

filter

Specifies whether the billing filter scheme is enabled or disabled.

disable

Disables the billing filter.

enable

Enables the billing filter.

methods

Specifies the billing methods that are allowed for calls relating to different adjacencies.

packetcable-em

Configures the PacketCable billing method for billing.

xml

Configures the XML billing method for billing.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

There is only one billing per SBC.

Examples

The following example shows how to enter the billing mode for mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table 1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# billing filter enable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# billing methods xml
 
 

 
Related Commands

 

Command
Description

cac-policy-set

Creates a new CAC policy set, copies an existing complete policy set, swaps the references of a complete policy set to another policy set, or sets the averaging period for rate calculations in a CAC policy set.

cac-table

Configures admission control tables.

table-type

Configures a CAC table type that enables the priority of the call to be used as a criterion in CAC policy.

 

 

blacklist

To enter the mode for configuring the event limits of a given source, use the blacklist command in the SBE configuration mode. To return the event limits to the default values, use the no form of this command.

[ no ] blacklist [ critical ] global [address-default | { ipv4 { addr } | ipv6 { addr }} [ tcp { tcp-port } | udp { udp-port } | default-port-limit] ]

[ no ] blacklist [ critical ] vpn { vpn-name } [ address-default [ address-family { ipv4 | ipv6 }] | address-family { ipv4 | ipv6 } | ipv4 addr [ tcp { tcp-port } | udp { udp-port } | default-port-limit ] | ipv6 addr [ tcp { tcp-port } | udp { udp-port } | default-port-limit ] ]

 
Syntax Description

global

(Required) Allows blacklisting limits or critical blacklisting limits to be configured for the global VPN. Sets limits for total traffic from global VPN.

This keyword is required when the command is used on the global VPN. Either global or vpn name must be specified for the blacklist.

critical

Configures critical blacklisting limits for the global VPN or a specific VPN.

vpn {vpn_name}

(Required) Enters the mode for configuring the event limits or critical event limits for the given VPN. Sets limits for total traffic from the named VPN.

vpn_name is the VPN name. Either global or vpn name must be specified for the blacklist.

address-default

(Optional) Enters the mode for configuring the default event limits for the source addresses in the given VPN. Sets default traffic limits to apply to each IP address within the global VPN, except where overridden by the ipv4 or ipv6 command option.

address-family

(Optional) Enters the mode for configuring the default event limits for the IPv4 or IPv6 address family in the given VPN.

ipv4 addr

(Optional) Enters the mode for configuring the default event limits for the IPv4 address in the given VPN. Sets traffic limits for total traffic from this IP address within the global VPN.

addr is the IPv4 address.

ipv6 addr

(Optional) Enters the mode for configuring the default event limits for the IPv6 address in the given VPN. Sets traffic limits for total traffic from this IP address within the global VPN.

addr is the IPv6 address.

tcp tcp-port

(Optional) Sets traffic limit for traffic from this IP address and TCP port within the global VPN.

udp udp-port

(Optional) Sets traffic limit for traffic from this IP address and UDP port within the global VPN.

default-port-limit

(Optional) Sets traffic limits to apply to each port within the IP address in the global VPN, except where overridden by either the tcp or udp command option.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 2.4.2

The critical keyword and options were added.

Cisco IOS XE Release 2.6

The ipv6 keyword was added.

Cisco IOS XE Release 3.1S

The ipv6 keyword was added under address-family . The ipv6 addr and options were also added.

 
Usage Guidelines

For IPv4, either “global” or “vpn_name” must be specified for the blacklist. However, if a vpn_name is entered, a VPN token is required.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how the vpn keyword and the VPN token of 800 are used to enter the mode for configuring the event limits for the VPN test:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# blacklist vpn 800
Router(config-sbc-sbe-blacklist)#

 

The following example shows how to enter the mode for configuring the default event limits for all addresses:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# blacklist global address-default

 

The following example shows how to enter the mode for configuring blacklisting to apply to all addresses:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# blacklist global
Router(config-sbc-sbe-blacklist)#

 

The following example shows how to enter the mode for applying blacklisting options to a single IPv4 IP address:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# blacklist global ipv4 1.1.1.1
Router(config-sbc-sbe-blacklist)#
 

The following example shows how to enter the mode for applying blacklisting options to a single IPv6 IP address:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# blacklist global ipv6 2001::10:0:0:1
Router(config-sbc-sbe-blacklist)#
 

The following example shows how to enter the mode for applying blacklisting options to an IPv6 address family in a VPN:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# blacklist vpn Mgmt-intf address-family ipv6

Router(config-sbc-sbe-blacklist)#

 
Related Commands

Command
Description

address-default

Enters the mode for configuring the default event limits for the source addresses in a given VPN.

clear sbc sbe blacklist

Clears the blacklist for the specified SBC service.

global

Enters the mode for configuring blacklisting to apply to all addresses.

ipv4 (blacklist)

Enters the mode for applying blacklisting options to a single IPv4 IP address.

ipv6 (blacklist)

Enters the mode for applying blacklisting options to a single IPv6 IP address.

vpn

Enter the mode for configuring the event limits for a given VPN.

reason

Enters a mode for configuring a limit to a specific event type on the source.

show sbc sbe blacklist configured-limits

Lists the explicitly configured limits, showing only the sources configured.

show sbc sbe blacklist current-blacklisting

Lists the limits causing sources to be blacklisted.

tcp

Enters the mode for configuring blacklisting for TCP protocol only.

timeout

Defines the length of time that packets from the source are blocked, should the limit be exceeded.

trigger-period

Defines the period over which events are considered.

default-port-limit

Enters a mode for configuring the default even limits for the ports of a given address.

trigger-size

Defines the number of the specified events from the specified source that are allowed before the blacklisting is triggered, and blocks all packets from the source.

udp

Enters the mode for configuring blacklisting for UDP protocol only.

vpn

Enters the mode for configuring the event limits for a given VPN.

blacklist (profile)

To set a profile to be blacklisted, use the blacklist command in the appropriate profile configuration mode. To remove blacklist from this profile, use the no form of this command.

blacklist

no blacklist

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

No default behavior or values are available.

 
Command Modes

SIP Method Profile configuration (config-sbc-sbe-mep-mth)

SIP Option Profile configuration (config-sbc-sbe-mep-opt)

SIP Header Profile configuration (config-sbc-sbe-mep-hdr)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to blacklist an option profile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip option-profile option1
Router(config-sbc-sbe-mep-opt)# blacklist
 

The following example shows how to blacklist a method profile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip method-profile Method1
Router(config-sbc-sbe-mep-mth)# blacklist
 

The following example shows how to blacklist a header profile:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip header-profile header1
Router(config-sbc-sbe-mep-hdr)# blacklist

 
Related Commands

Command
Description

sip header-profile

Configures a header profile.

sip method-profile

Configures a method profile.

sip option-profile

Configures an option profile.

blacklist (sip-opt)

To set profile to be blacklisted, use the blacklist command in SIP option mode. Use the no form of this command to remove blacklist from this profile.

blacklist

no blacklist

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

The global default is used.

 
Command Modes

SIP option (sip-opt)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command:

Examples

The following example shows how to add an option to the profile.

Router# configure terminal
Router(config)# sbc sanity
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip option-profile optpr1
Router(config-sbc-sbe-sip-opt)# blacklist

 

blended-codec-list

To add a blended codec list, use the blended-codec-list command in SBC SBE CAC policy CAC table entry configuration mode. To remove a blended codec list, use the no form of this command.

blended-codec-list blended-codec-li st

no blended-codec-list blended-codec-li st

 
Syntax Description

blended-codec-list

Case-sensitive, unique name for a blended codec list. The maximum length is 63 characters.

 
Defaults

No blended codec list exists.

 
Command Modes

SBC SBE CAC policy CAC table entry configuration mode (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.11S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Examples

The following example shows how to configure a blended codec list:

Router> enable
Router# configure terminal
Router(config)# sbc 123
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table test
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# cac-table test
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit adjacency
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# blended-codec-list codec-a

 
Related Commands

Command
Description

blended-transcode

Enables the Blended Transcoding feature.

 

 

blended-transcode

To enable the Blended Transcoding feature, use the blended-transcode command in the SBC SBE CAC policy CAC table entry configuration mode. To disable the Blended Transcode feature, use the no form of this command.

blended-transcode

no blended-transcode

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The Blended Transcode feature is disabled.

 
Command Modes

SBC SBE CAC policy CAC table entry configuration mode (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.11S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Examples

The following example shows how to enable the Blended Transcode feature:

Router> enable
Router# configure terminal
Router(config)# sbc 123
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table test
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# cac-table test
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit adjacency
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# blended-transcode

 
Related Commands

Command
Description

blended-codec-list

Configures a blended codec list.

body-editor

To associate a body editor to a SIP adjacency to cause the body editor to act on the incoming and outgoing SIP messages, use the body-editor command in the Adjacency SIP configuration mode. To remove a body editor, use the no form of this command.

body-editor [inbound | outbound] {editor-name}

no body-editor [inbound | outbound] {editor-name}

 
Syntax Description

inbound

Associates a body editor to act on the inbound messages on a SIP adjacency.

Note When the message is passed, the body editor should be applied in the inbound and outbound directions on the respective adjacencies on which the message is routed.

outbound

Associates a body editor to act on the outbound messages on a SIP adjacency.

Note When the message is passed, the body editor should be applied in the inbound and outbound directions on the respective adjacencies on which the message is routed.

editor-name

Text string that describes a body editor name.

The editor-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to associate two body editors, inbound editor2 and outbound editor1, at a SIP adjacency level for the adj-1 adjacency:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip adj-1
Router(config-sbc-sbe-adj-sip)# body-editor inbound editor2
Router(config-sbc-sbe-adj-sip)# body-editor outbound editor1
 

 
Related Commands

Command
Description

action

Sets the action to be taken on a body type in a SIP body editor for a non-SDP message body.

sip body-editor

Configures a body editor.

body-editor (method)

To add a body editor to act on a method, use the body-editor command in the signaling border element (SBE) SIP method element configuration mode. To remove a body editor, use the no form of this command.

body-editor editor-name

no body-editor

 
Syntax Description

editor-name

Specifies the name of the body editor.

The following guidelines apply:

The editor-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE SIP method element configuration (config-sbc-sbe-mep-mth-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how the body-editor command adds a body editor to act on a method:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip SIPP
Router(config-sbc-sbe-adj-sip)# sip method-editor MethodEditor1
Router(config-sbc-sbe-mep-mth)# method Method2
Router(config-sbc-sbe-mep-mth-ele)# body-editor bodyEditor1

 
Related Commands

Command
Description

sip body-editor

Configures a body editor.

sip method-editor

Configures a method editor.

body-profile

To associate a body profile to a method profile to cause the body profile to act on incoming and outgoing SIP messages, use the body-profile command in SBE method profile element configuration mode. To remove the body profile, use the no body-profile command.

body-profile {profile_name}

no body-profile {profile_name}

 
Syntax Description

profile_name

Text string that describes a body profile name.

The following guidelines apply:

The profile_name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE method profile element configuration mode (config-sbc-sbe-sip-mth-ele)

 
Command History

Release
Modification

Cisco IOS XE Release 2.6

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

After creating a body profile with the sip body-profile {profile_name} command, you can associate the body profile at the following additional levels and configuration modes:

  • At the SIP signaling entity level (ingress or egress), under SBE mode, using the sip default body-profile [[inbound|outbound] {profle_name}] command. The body profile is associated for the entire signlaing instance (that is all messages, either ingress or egress, passing through the SBC).
  • SIP adjacency level, under SIP adjacency mode, using the body-profile [[inbound|outbound] {profle_name}] command. The body profile is associated to an adjacency.

SBC uses a body profile that you create and associate to filter non-SDP bodies from incoming and outgoing SIP messages, based on the Content-Type header field. A body profile allows a message containing a specific non-SDP body to be either passed (without altering the message), stripped of the body (and pass the rest of the message), or be rejected.

Examples

The following example describes how to associate body profile, bodyprofile1, to a method profile:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip method-profile profile1
Router(config-sbc-sbe-sip-mth)# description mysbc profile1
Router(config-sbc-sbe-sip-mth)# method test
Router(config-sbc-sbe-sip-mth-ele)# body-profile bodyprofile1
Router(config-sbc-sbe-sip-mth-ele)#
 

 
Related Commands

Command
Description

sip default body-profile

Associates a body profile at the SIP signaling level under the SBE mode.

body-profile (sip adj)

Associates a body profile at the SIP adjacency level, to an adjacency, under SIP adjacency mode.

sip body-profile

Creates a body profile used to filter non-SDP bodies from incoming and outgoing SIP messages.

body

Names the body type or content header type for a non-SDP message body that is part of the body profile.

action

Sets the action to be taken on a body type in a SIP body profile for a non-SDP message body

sip method-profile

Configures a method profile in the mode of an SBE entity

body-profile (sip adj)

To associate a body profile to a SIP adjacency to cause the body profile to act on incoming and outgoing SIP messages, use the body-profile (sip adj) command in adjacency SIP configuration mode. To remove the body profile, use the no body-profile (sip adj) command.

body-profile [inbound | outbound] {profile_name}

no body-profile [inbound | outbound] {profile_name}

 
Syntax Description

inbound

Associates the body profile to act on inbound messages on the SIP adjacency.

Note When the message is ‘passed,’ the body profile should be applied both in the inbound and outbound direction on the respective adjacencies on which the message is routed.

outbound

Associates the body profile to act on outbound messages on the SIP adjacency.

Note When the message is ‘passed,’ the body profile should be applied both in the inbound and outbound direction on the respective adjacencies on which the message is routed.

profile_name

The profile_name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 2.6

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

After creating a body profile with the sip body-profile {profile_name} command, you can associate the body profile at the following additional levels and configuration modes:

  • At the SIP signaling entity level (ingress or egress), under SBE mode, using the sip default body-profile [[inbound|outbound] {profle_name}] command. The body profile is associated for the entire signlaing instance (that is all messages, either ingress or egress, passing through the SBC).
  • At SIP method profile level, under method profile mode, using the body-profile {profle_name} command. The body profile is associated to a method profile.

SBC uses a body profile that you create and associate to filter non-SDP bodies from incoming and outgoing SIP messages, based on the Content-Type header field. A body profile allows a message containing a specific non-SDP body to be either passed (without altering the message), stripped of the body (and pass the rest of the message), or be rejected.

Examples

The following example describes how to associate two body profiles, inbound profile2 and outbound profile1, at the SIP adjacency level for adjacency adj-1:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip adj-1
Router((config-sbc-sbe-adj-sip))# body-profile inbound profile2
Router((config-sbc-sbe-adj-sip))# body-profile outbound profile1
 

 
Related Commands

Command
Description

sip default body-profile

Associates a body profile at the SIP signaling level under the SBE mode.

body-profile

Associates a body profile to a method profile under the method profile mode.

sip body-profile

Creates a body profile used to filter non-SDP bodies from incoming and outgoing SIP messages.

body

Names the body type or content header type for a non-SDP message body that is part of the body profile.

action

Sets the action to be taken on a body type in a SIP body profile for a non-SDP message body

body

To name the body type or content header type for a non-SDP message body that is part of the body profile, use the body command in SBE SIP Body configuration mode. To remove the body type or content header type, use the no body command.

body {WORD}

no body {WORD}

 
Syntax Description

WORD

Specifies the body type or content header type. This is a string of maximum 64 characters.

The body name must be in the form of <media-type>/<media-sub-type>, for example, application/ISUP. The body name field is case-insensitive. For more information, see Usage Guidelines.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE SIP Body configuration (config-sbc-sbe-sip-body)

 
Command History

Release
Modification

Cisco IOS XE Release 2.6

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command describes the body type or content header type for SBC to act on messages with the specified body type or content header type.

The body command is used in conjunction with the sip body-profile command that is used to create the body profile.

The body name must be in the form of <media-type>/<media-sub-type>, for example, application/ISUP. The body name field is case-insensitive.

Asterisk (*) is used to match all non-SDP body types. Note that * is also interpreted as a string by the CLI, and is just a token used to indicate wild-card match.

The following Content-Type descriptions are not allowed: application/sdp and multipart/mixed

Only one body element with such a wildcard can co-exist with other bodies per body profile. The wildcard body is applied if there is no other matching body in that profile. The body name is matched using regular ‘string compare.’ Note that there is no provision to match body names using any regular expression matching techniques.

Examples

The following example does the following: creates a body profile named bodyprofile1; describes the body type, that is to act on messages with Content-Type header “application/ISUP”; and instructs SBC to strip that particular message body and pass the rest of the message:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip body-profile bodyprofile1
Router(config-sbc-sbe-sip-body)# body application/ISUP
Router(config-sbc-sbe-sip-body-ele)# action strip
Router(config-sbc-sbe-sip-body-ele)#

 
Related Commands

Command
Description

sip default body-profile

Associates a body profile at the SIP signaling level under the SBE mode.

body-profile

Associates a body profile to a method profile under the method profile mode.

body-profile (sip adj)

Associates a body profile at the SIP adjacency level, to an adjacency, under SIP adjacency mode.

sip body-profile

Creates a body profile used to filter non-SDP bodies from incoming and outgoing SIP messages.

action

Sets the action to be taken on a body type in a SIP body profile for a non-SDP message body.

body (editor)

To name a body type or content header type for a non-SDP message body that is a part of the body editor, use the body command in the signaling border element (SBE) session initiation protocol (SIP) body configuration mode. To remove a body type or content header type, use the no form of this command.

body word

no body word

 
Syntax Description

word

The word field can have a maximum of 64 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

The body name must be in the form <media-type>/<media-sub-type>, for example, application/ISUP. The body name field is case-insensitive.

 
Command Default

No default behavior or values are available.

 
Command Modes

SIP Body Editor configuration (config-sbc-sbe-mep-bdy)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command describes the body type or content header type for the SBC to act on messages of the specified body type or content header type.

The body command is used in conjunction with the sip body-editor command that is used to create the body editor.

The body name must be in the form <media-type>/<media-sub-type>, for example, application/ISUP. The body name field is case-insensitive.

Asterisk (*) is used to match all the non-SDP body types. Note that * is also interpreted as a string by the CLI, and is a token used to indicate wildcard match.

Examples

The following example shows how to create a body editor named bodyeditor1 and describe the body type as application/ISUP:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip body-editor bodyeditor1
Router(config-sbc-sbe-mep-bdy)# body application/ISUP
 

 
Related Commands

Command
Description

sip body-editor

Creates a body editor to filter the non-SDP message bodies from the incoming and outgoing SIP messages.

branch bandwidth-field

To configure the SBC such that it converts a specific bandwidth line format into another bandwidth line format in the outbound Session Description Protocol (SDP) sent to a caller or a callee, use the branch bandwidth-field command in the CAC table entry configuration mode. To unconfigure the conversion of the bandwidth line format, use the no form of this command.

branch bandwidth-field {as-to-tias | tias-to-as}

no branch bandwidth-field {as-to-tias | tias-to-as}

 
Syntax Description

as-to-tias

Configures the SBC to convert the b=AS line format into the b=TIAS line format for a specific SDP media descriptor in an outbound offer. Here, AS refers to Application Specific maximum. Similarly, TIAS refers to Transport Independent Application Specific maximum.

tias-to-as

Configures the SBC to convert the b=TIAS line format into the b=AS line format for a given SDP media descriptor in an outbound offer.

 
Command Default

The default is that the format of bandwidth lines is not converted.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The SBC applies the outgoing bandwidth line format that you configure. If the offerer-side adjacency is configured to apply a specific style of bandwidth line format in the SDP, this command causes the SBC to convert the answer to the specified format before it is sent back to the offerer. If there are multiple bandwidth lines, only the first line is converted into the specified bandwidth line and the remaining lines are ignored.


Note As mentioned earlier, the default is that the bandwidth line is not converted from one format to another. However, if the callee is configured to convert the bandwidth, and the message is converted, the response that is sent back to the caller is converted back even if this command is not configured for the caller.


Examples

The following example shows how to configure the SBC such that it converts an AS bandwidth line format into a TIAS bandwidth line format in the outbound SDP sent to a caller or a callee:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc test
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table 1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch bandwidth-field as-to-tias
 

 
Related Commands

Command
Description

callee-bandwidth-field

Configures the SBC such that it converts a specific bandwidth line format into another bandwidth line format in an outbound SDP sent to a callee.

caller-bandwidth-field

Configures the SBC such that it converts a specific bandwidth line format into another bandwidth line format in an outbound SDP sent to a caller.

branch codec

To configure the codec options for a caller or a callee, use the branch codec command in the CAC table entry configuration mode. To unconfigure the codec options, use the no form of this command.

branch codec {convert | profile profile-name }

no caller codec {convert | profile }

 
Syntax Description

convert

Enables the codec variant conversion.

profile profile-name

Specifies the codec variant profile name.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

By default, codec variant conversion is disabled, and no codec variant profile is specified.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the codec options for a caller using the branch codec command:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table Transrate
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch codec convert
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch codec profile profile-1

 

 
Related Commands

Command
Description

callee codec

Configures the codec options for a callee.

caller codec

Configures the codec options for a caller.

branch codec-list

To specify the codecs that the caller or the callee of a call can use, use the branch codec-list command in the CAC table entry configuration mode. To delete a codec list, use the no form of this command.

branch codec-list list-name

no branch codec-list list-name

 
Syntax Description

list-name

Name of the codec list.

The list-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to enter a mode to create the test codec list:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch codec-list test

 
Related Commands

Command
Description

callee-codec-list

Specifies the codecs that the callee of a call can use.

caller-codec-list

Specifies the codecs that the caller of a call can use.

branch hold-setting

To specify the caller hold settings or the callee hold settings, use the branch hold-setting command in the CAC table entry configuration mode. To remove the caller hold settings or the callee hold settings, use the no form of this command.

branch hold-setting {hold-c0 | hold-c0-inactive | hold-c0-sendonly | hold-sendonly | standard}

no branch hold-setting {hold-c0 | hold-c0-inactive | hold-c0-sendonly | hold-sendonly | standard}

 
Syntax Description

hold-c0

Branch supports and requires c=0.0.0.0.

hold-c0-inactive

Branch supports and requires c=0.0.0.0 and a=inactive.

hold-c0-sendonly

Branch supports and requires c=0.0.0.0 and a=sendonly.

hold-sendonly

Branch supports and requires a=sendonly.

standard

Branch supports and requires c=0.0.0.0 and an a= line.

 
Command Default

The default setting is standard .

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to use the branch hold-setting command:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value fairchild
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch hold-setting hold-sendonly
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete
Router(config-sbc-sbe-cacpolicy-cactable-entry)# complete

 
Related Commands

 
Command
Description

callee-hold-setting

Specifies the callee hold settings.

caller-hold-setting

Specifies the caller hold settings.

branch inband-dtmf-mode

To configure the dual-tone multifrequency (DTMF) in-band mode for the caller side or the callee side, use the branch inband-dtmf-mode command in the CAC table entry configuration mode. To unconfigure the DTMF in-band mode, use the no form of this command.

branch inband-dtmf-mode { always | inherit | maybe | never }

no branch inband-dtmf-mode

 
Syntax Description

always

Specifies that the in-band DTMF tones are always used by the endpoint.

inherit

Specifies that the in-band DTMF mode for the endpoint is not affected by the CAC entry.

maybe

Specifies that the in-band DTMF tones are used by the endpoint unless signaling indicates that an alternative format is in use for the DTMF.

never

Specifies that the endpoint never uses the in-band DTMF mode.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the DTMF in-band mode for the caller side using the caller inband-dtmf-mode command in the CAC table entry configuration mode so that the endpoint never uses the inband DTMF mode:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table InbandDTMF
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch inband-dtmf-mode never

 
Related Commands

Command
Description

callee inband-dtmf-mode

Configures the DTMF in-band mode for the callee side.

caller inband-dtmf-mode

Configures the DTMF in-band mode for the caller side.

branch inbound-policy

To configure a caller inbound SDP policy table or a callee inbound SDP policy table, use the branch inbound-policy command in the CAC table entry configuration mode. To unconfigure an inbound SDP policy table, use the no form of this command.

branch inbound-policy sdp-policy-table-name

no branch inbound-policy sdp-policy-table-name

 
Syntax Description

sdp-policy-table-name

Name of the SDP policy table.

The sdp-policy-table-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to use the branch inbound-policy command to configure an inbound SDP policy table:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch inbound-policy test

 
Related Commands

Command
Description

callee-outbound-policy

Configures a callee outbound SDP policy table.

caller-outbound-policy

Configures a caller outbound SDP policy table.

branch media bypass

To enable or disable the Multiple SBC Media Bypass feature on the caller side or the callee side, use the branch media bypass command in the CAC table entry configuration mode. To unconfigure the Multiple SBC Media Bypass feature, use the no form of this command.

branch media bypass { enable | disable }

no branch media bypass

 
Syntax Description

enable

Enables the Multiple SBC Media Bypass feature on the caller side or the callee side.

disable

Disables the Multiple SBC Media Bypass feature on the caller side or the callee side.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to use the branch media bypass command to enable the Multiple SBC Media Bypass feature:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table table1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch media bypass enable

 
Related Commands

Command
Description

codec

Adds a codec to a codec list.

codec-list

Creates a codec list.

codec-list description

Provides a description of a codec list.

show sbc sbe codec-list

Displays information about codec lists.

branch media-caps

To configure a codec list used to announce media capabilities on behalf of a SIP caller or SIP callee in a SIP-to-H.323 or H.323-to-SIP interworking call, use the branch media-caps command in the CAC table entry configuration mode. To unconfigure the codec list, use the no form of this command.

branch media-caps media-caps-list-name

no branch media-caps media-caps-list-name

 
Syntax Description

media-caps-list-name

Name of media capabilities list.

The media-caps-list-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command configures a codec list and assigns the list to a CAC table. After a codec list is assigned, it must not be deleted before it is removed from the CAC table. A codec list must exist before it can be assigned to an entry in a CAC table.

Examples

The following example shows how to configure the caller-media-caps-list codec list and assign the list to the cac-tbl-1 CAC table in entry 1:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# codec list caller-media-caps-list
Router(config-sbc-sbe-codec-list)# codec t38
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table cac-tbl-1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch media-caps media-caps-list
 
 

 
Related Commands

Command
Description

callee-media-caps

Configures a codec list that is used to announce media capabilities on behalf of a SIP callee in a SIP-to-H.323 or H.323-to-SIP interworking call.

caller-media-caps

Configures a codec list that is used to announce media capabilities on behalf of a SIP caller in a SIP-to-H.323 or H.323-to-SIP interworking call.

branch media-description disabled

To configure how the SBC handles disabled media descriptions for a caller or a callee, use the branch media-description disabled command in the CAC table entry configuration mode. To unconfigure how the SBC handles disabled media descriptions for a caller or a callee, use the no form of this command.

branch media-description disabled {strip {answer | offer {all | new}} | {pad offer}}

no branch media-description disabled {strip {answer | offer {all | new}} |{pad offer}}

 
Syntax Description

strip

Strips the disabled media description lines.

pad

Pads with dummy disabled media description lines.

answer

Strips the disabled media description lines from answers.

offer

Strips the disabled media description lines from offers when this keyword is used with the strip keyword. Pads offers with dummy disabled media description lines when used with pad.

all

Strips all the disabled media descriptions from offers.

new

Strips new disabled media descriptions from offers.

 
Command Default

By default, the pad setting is configured.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the removal of disabled media streams from new forwarded offers:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch media-description disabled strip offer new
 

The following example shows how to configure the removal of disabled media streams from forwarded offers, regardless of whether it is known to the recipient of the offer:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch media-description disabled strip offer all
 

The following example shows how to configure the removal of disabled media streams from forwarded answers:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch media-description disabled strip answer
 

The following example shows how to configure the SBC so that it does not pad forwarded offers with disabled media streams:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# no branch media-description disabled pad offer

 
Related Commands

Command
Description

callee media-description disabled

Configures how the SBC handles disabled media descriptions for a callee.

caller media-description disabled

Configures how the SBC handles disabled media descriptions for a caller.

branch media-type

To configure the media address type settings for a caller or a callee, use the branch media-type command in the CAC table entry configuration mode. To unconfigure the media address type settings for a caller, use the no form of this command.

branch media-type { ipv4 | ipv6 | inherit | both }

no branch media-type { ipv4 | ipv6 | inherit | both }

 
Syntax Description

ipv4

Specifies that only IPv4 media addresses are supported.

ipv6

Specifies that only IPv6 media addresses are supported.

inherit

Specifies that the supported media IP address type from earlier CAC policy entries must be inherited. This is the default setting.

both

Specifies that both IPv4 and IPv6 media addresses are supported.

 
Command Default

The default is that the supported media IP address type from earlier CAC policy entries must be inherited.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to use the branch media-type command to specify that only IPv4 media addresses are supported:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch media-type ipv4
Router(config-sbc-sbe-cacpolicy-cactable-entry)#

 
Related Commands

Command
Description

callee media-type

Configures the media address type settings for a callee.

caller media-type

Configures the media address type settings for a caller.

branch outbound-policy

To configure an outbound Session Description Protocol (SDP) policy table for a caller or a callee, use the branch outbound-policy command in the CAC table entry configuration mode. To unconfigure an outbound SDP policy table, use the no form of this command.

branch outbound-policy table-name

no branch outbound-policy table-name

 
Syntax Description

table-name

Name of the SDP policy table.

The table-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure an outbound SDP policy table for a caller:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch outbound-policy test

 
Related Commands

Command
Description

callee-inbound-policy

Configures a callee inbound SDP policy table.

caller-inbound-policy

Configures a caller inbound SDP policy table.

branch port-range-tag

To configure the port range tag for a caller or a callee that is used when selecting a media address and port, use the branch port-range-tag command in the CAC table entry configuration mode. To unconfigure the port range tag, use the no form of this command.

branch port-range-tag { adjacency-name | none | string tag-string }

no branch port-range-tag

 
Syntax Description

adjacency-name

Source adjacency name that is used as a port range tag.

none

Prompts the SBC to not use a port range tag for calls matching the CAC entry, and removes any previously found strings.

string tag-string

Specifies the explicit port range tag string.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to use the branch port-range-tag command to configure a port range tag:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table table1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch port-range-tag adj1

 
Related Commands

Command
Description

callee port-range-tag

Configures the port range tag for a callee.

caller port-range-tag

Configures the port range tag for a caller.

branch privacy edit-privacy-request

To edit and update privacy indications provided by a user, use the branch privacy edit-privacy-request command in the CAC table configuration mode. To remove the indications, use the no form of this command.

branch privacy edit-privacy-request { pass | strip | insert | replace | sip { strip { all | critical | header | id | none | session | token word | user } | insert { critical | header | id | none | session | token word | user }}}

no branch privacy edit-privacy-request { pass | strip | insert | replace | sip { strip { all | critical | header | id | none | session | token word | user } | insert { critical | header | id | none | session | token word | user }}}

 
Syntax Description

insert

Inserts privacy restrictions, depending on the type of message:

  • SIP message—Inserts Privacy:header;session;user;id;critical if the header is not already present.
  • H323 message—Changes the presentation indicator from Allowed to Restricted.

pass

Passes on the privacy header or presentation indicators.

replace

Replaces privacy restrictions, depending on the type of message:

  • SIP message—Replaces Privacy:header;session;user;id;critical except when none has been requested.
  • H323 message—Sets the presentation indicator to Restricted.

strip

Removes all the privacy restrictions, depending on the type of message:

  • SIP message—Removes the Privacy header.
  • H323 message—Sets the presentation indicator to Allowed.

sip

Specifies the following SIP settings. These settings allow greater control and overide all generic actions:

  • insert —Inserts privacy tokens into the Privacy header.
  • strip —Removes privacy tokens from the Privacy header.

critical

Specifies the call must be discontinued if privacy cannot be achieved in the Privacy header.

header

Obscures all the header information that is related to the user, from the Privacy header.

id

Adds or removes the ID headers from the Privacy header.

none

Specifies that privacy must not be applied to the call.

session

Specifies the media privacy for the session in the Privacy header. No media bypass is performed.

token

Specifies the nonstandard user-defined privacy token in the Privacy header.

word

User-defined privacy token.

user

Removes all nonessential header information that is related to the user, from the Privacy header.

 
Command Default

The default setting is pass .

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure an entry to remove all the privacy restrictions from the SIP and H323 adjacencies in the MyCacTable admission control table:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefix
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch-privacy edit-privacy-request strip

 
Related Commands

Command
Description

callee-privacy edit-privacy-request

Edits and updates privacy indications provided by a user, from the callee side.

caller-privacy edit-privacy-request

Edits and updates privacy indications provided by a user, from the caller side.

branch privacy privacy-service

To apply privacy settings according to RFC3323, RFC3325, and the H.323 presentation restriction settings in the admission control table, use the branch privacy privacy-service command in the CAC table configuration mode. To unconfigure the privacy settings, use the no form of this command.

branch privacy privacy-service { adj-trust-boundary | always | never }

no branch privacy privacy-service

 
Syntax Description

adj-trust-boundary

Specifies the adjacency privacy trust level to determine whether the privacy service is required.

always

Specifies that the privacy service must be provided indefinitely if requested by the user.

never

Specifies that the privacy service must not be provided even if requested by the user.

 
Command Default

The default privacy setting value is adj-trust-boundary .

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure an entry to provide privacy service indefinitely in the MyCacTable admission control table:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefix
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch privacy privacy-service always

 
Related Commands

Command
Description

callee privacy privacy-service

Applies privacy settings according to RFC3323, RFC3325, and H.323 presentation restriction settings, on the callee side.

caller privacy privacy-service

Applies privacy settings according to RFC3323, RFC3325, and H.323 presentation restriction settings, on the caller side.

branch ptime

To configure the packetization time on the caller side or the callee side, use the branch ptime command in the CAC table configuration mode. To unconfigure the packetization time setting, use the no form of this command.

branch ptime packetization-time

no branch ptime packetization-time

 
Syntax Description

packetization-time

Packetization time, in milliseconds. The range is from 0 to 100. The default is 0.

 
Command Default

The default packetization time is 0 milliseconds. This value indicates that transrating must not be performed.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the packetization time to 30 milliseconds by using the branch ptime command:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table Transrate
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch ptime 30
 

 
Related Commands

Command
Description

callee ptime

Configures the packetization time on the callee side.

caller ptime

Configures the packetization time on the caller side.

branch secure-media

To apply the granular-level Secure Media feature on the caller side or the callee side, use the branch secure-media command in the CAC table entry configuration mode. To remove the granular-level Secure Media feature, use the no form of this command.

branch secure-media

no branch secure-media

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

By default, the granular-level (Unsignaled) Secure Media feature is disabled.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

We recommend that you use the granular-level Secure Media feature instead of enabling Secure Media globally. The granular-level feature enables you to specify the calls and adjacencies at the location where you want to use secure media.

Examples

The following example shows an Unsignaled Secure Media configuration where the two SIP adjacencies for both legs of the call are configured for security trusted-unencrypted, and both the caller and the callee sides are configured for secure media in a CAC table entry:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip client
Router(config-sbc-sbe-adj-sip)# security trusted-unencrypted
Router(config-sbc-sbe-adj-sip)# exit
Router(config-sbc-sbe)# adjacency sip server
Router(config-sbc-sbe-adj-sip)# security trusted-unencrypted
Router(config-sbc-sbe-adj-sip)# exit
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-table testSecure
Router(config-sbc-sbe-cacpolicy)# cac-table testSecure
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch secure-media
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy)# exit
Router(config-sbc-sbe)# cac-policy-set global 1
Router(config-sbc-sbe)# end

 
Related Commands

Command
Description

callee secure-media

Configures the granular-level Secure Media feature on the callee side.

caller secure-media

Configures the granular-level Secure Media feature on the caller side.

branch sig-qos-profile

To configure the Quality of Service (QoS) profile to be used for signaling packets sent to the original caller or callee, use the branch sig-qos-profile command in the CAC table entry configuration mode. To unconfigure the QoS profile, use the no form of this command.

caller-sig-qos-profile profile-name

no caller-sig-qos-profile profile-name

 
Syntax Description

profile-name

Name of the QoS profile. The default string is reserved.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command can be run only at the per-call scope. The CAC policy will not be activated if this command is configured in any other scope.

Packet marking will not be applied until the CAC decision process is run. This means that some initial signaling packets sent to the caller, for example, the SIP 100 provisional response, will not receive any particular Differentiated Services Codepoint (DSCP) marking.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following command shows how to configure calls from the acme account to use the voice QoS profile enterprise for signaling packets sent from the SBC to the original caller or callee:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch-sig-qos-profile enterprise

 
Related Commands

Command
Description

callee-sig-qos-profile

Configures the QoS profile to be used for the signaling packets sent to the original callee.

caller-sig-qos-profile

Configures the QoS profile to be used for the signaling packets sent to the original caller.

branch tel-event payload type

To configure the payload type to be used for the caller or the callee in H.323-SIP interworking calls, use the branch tel-event payload-type command in the CAC entry configuration mode. To unconfigure the payload type setting, use the no form of this command.

branch tel-event payload type payload-type

no branch tel-event payload type

 
Syntax Description

payload-type

See RFC 2833 for detailed information about the values of payload-type . The range is from 96 to 127. The default is 101.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC entry configuration (config-sbc-cac-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The branch tel-event payload type command enables support for dual tone multifrequency (DTMF) H.323-SIP interworking. The telephone-event payload type configured by this command is used by the SBC only in situations where the payload type information is not provided by the other side in an H.323-SIP interworking call.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to use the branch tel-event payload-type command to set the payload type to 101:

Router(config)# sbc sbc1
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-cac-pol)# cac-table CAC-POLICY-TBL1
Router(config-sbc-cac-entry)# branch tel-event payload-type 101

 
Related Commands

Command
Description

callee tel-event payload-type

Configures the payload type to be used for the callee in H.323-SIP interworking calls.

caller tel-event payload-type

Configures the payload type to be used for the caller in H.323-SIP interworking calls.

branch video-qos-profile

To configure the QoS profile to be used for the media packets sent to the original caller or original callee, use the branch video-qos-profile command in the CAC table configuration mode. To remove this configuration, use the no form of this command.

branch video-qos-profile profile-name

no branch video-qos-profile profile-name

 
Syntax Description

profile-name

Name of the QoS profile.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command. The branch video-qos-profile command can be executed only in the per-call scope. The CAC policy is not activated if this command is configured in any other scope.

Examples

The following example shows how to configure calls from the acme account to use the video QoS profile enterprise for the packets sent from the SBC to the original caller:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch video-qos-profile enterprise

 
Related Commands

Command
Description

callee-video-qos-profile

Configures the QoS profile to be used for the media packets sent to the original callee.

caller-video-qos-profile

Configures the QoS profile to be used for the packets sent to the original caller.

branch voice-qos-profile

To configure the QoS profile to be used for the media packets sent to the original caller or the original callee, use the branch voice-qos-profile command in the CAC table configuration mode. To unconfigure the QoS profile, use the no form of this command.

branch voice-qos-profile profile-name

no branch voice-qos-profile

 
Syntax Description

profile-name

Name of the QoS profile.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 3.5S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command. This command can be run only in the per-call scope. The CAC policy is not activated if this command is configured in any other scope.

Examples

The following example shows how to configure the calls from the acme account to use the voice QoS profile enterprise for the packets sent from the SBC:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# branch voice-qos-profile enterprise

 
Related Commands

Command
Description

calle-voice-qos-profile

Configures the QoS profile to be used for the media packets sent to the original callee.

caller-voice-qos-profile

Configures the QoS profile to be used for the media packets sent to the original caller.

cac-policy-set

To create a new call admission control (CAC) policy set, copy an existing complete policy set, swap the references of a complete policy set to another policy set, or set the averaging period for rate calculations in a CAC policy set, use the cac-policy-set command in the Signaling border element (SBE) configuration mode. To remove a policy set or deconfigure the averaging period, use the no form of this command.

cac-policy-set { policy-set-id | copy { source policy-set-id destination policy-set-id } | swap { source policy-set-id destination policy-set-id } | averaging-period { avg-number avg-period }

no cac-policy-set { policy-set-id | averaging-period { avg-number }}

 
Syntax Description

policy-set-id

An integer chosen by a user to identify the policy set. The range is from 1 to 2147483647.

copy

Copies an existing policy set.

swap

Swaps the existing references of a complete policy set to another policy set.

source

Specifies the existing complete call policy set.

destination

Specifies the destination of the call policy set.

averaging-period

Specifies the averaging period for rate calculations.

avg-number

The averaging period number. It can be 1 or 2.

avg-period

The averaging period used by the CAC in rate calculations, in seconds. It can range from 1 to 3600 seconds. By default, 60 seconds is configured.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified. The copy-and-swap function was added to this command. The averaging period could also be configured for a CAC policy set.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Changes are not permitted to the configuration of a global policy set. Also, a policy set cannot be removed if it is a global policy set.

Examples

The following command creates a policy set 1 on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# exit
 
The following example shows how to copy an existing complete CAC policy set and swap its references to the new policy set:
 
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc MySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set copy source 12 destination 22
Router(config-sbc-sbe)# cac-policy-set 22
Router(config-sbc-sbe-cacpolicy)# no complete
Router(config-sbc-sbe-cacpolicy)# cac-table TAB1
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# $max-call-rate-per-scope 100
Router(config-sbc-sbe)# cac-policy-set 22
Router(config-sbc-sbe-cacpolicy)# complete
Router(config-sbc-sbe-cacpolicy)# exit

Router(config-sbc-sbe)# cac-policy-set swap source 12 destination 22

Router(config-sbc-sbe-cacpolicy)# cac-policy-set global 22
Router(config-sbc-sbe)# end

 

The following example shows how to set the averaging period for rate calculations in a CAC policy set:

 
Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe

Router(config-sbc-sbe)# cac-policy-set averaging-period 1 100

Router(config-sbc-sbe)# cac-policy-set averaging-period 2 175

 
Related Commands

Command
Description

cac-policy-set global

Activates the global CAC policy set within an SBE entity.

show sbc sbe cac-policy-set

Lists detailed information pertaining to a CAC policy table.

cac-policy-set (admin-domain)

To configure the call admission control (CAC) policy set for an administrative domain, use the cac-policy-set command in the Administrative domain configuration mode. To remove a policy set from the administrative domain , use the no form of this command.

cac-policy-set policy-set-id

no cac-policy-set

 
Syntax Description

policy-set-id

The integer, ranging from 1 to 2147483647, that identifies a complete policy set.

 
Command Default

By default, no CAC policy set is configured.

 
Command Modes

Administrative domain configuration (config-sbc-sbe-ad)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

A user can specify only one CAC policy set for an administrative domain.

Examples

The following example shows how to configure the CAC policy set for the administrative domain ADMIN1 using the call-policy-set command in an administrative domain configuration mode:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# admin-domain ADMIN1
Router(config-sbc-sbe-ad)# cac-policy-set 2

 
Related Commands

Command
Description

admin-domain

Configures an administrative domain.

call-policy-set (admin-domain)

Configures the inbound and outbound number analysis and routing policy set for an administrative domain.

show sbc sbe admin-domain

Lists the administrative domains on the Session Border Controller (SBC) and per adjacency.

cac-policy-set global

To activate the global call admission control (CAC) policy set within an signaling border element (SBE) entity, use the cac-policy-set global command in the SBE configuration mode.

cac-policy-set global policy-set-id

 
Syntax Description

policy-set-id

Integer identifying the policy set that should be made global. Range is from 1 to 2147483647.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified. The cac-policy-set global command was renamed as cac-policy-set global .

 
Usage Guidelines

The active CAC policy set cannot be modified.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to activate policy set 1 on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# cac-policy-set global 1

 

Command
Description

cac-policy-set

Creates a new CAC policy set, copies an existing complete policy set, swaps the references of a complete policy set to another policy set, or sets the averaging period for rate calculations in a CAC policy set.

show sbc sbe cac-policy-set

Lists detailed information pertaining to a CAC policy table.

cac-table

To create or configure an admission control table, use the cac-table command in CAC-policy-set configuration mode. To delete the admission control table , use the no form of this command.

cac-table table-name

no cac-table table-name

 
Syntax Description

table-name

Specifies the admission control table.

The table-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC-policy-set configuration (config-sbc-sbe-cacpolicy)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to create the admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)#

 
Related Commands

Command
Description

first-cac-table

Configures the name of the first policy table to process when performing the admission control stage of policy.

first-cac-scope

Configure the scope at which to begin defining limits when performing the admission control stage of policy.

cache-lifetime

To configure the lifetime of any DNS entry, use the cache-lifetime command in the DNS configuration mode. To disable the lifetime, use the no form of this command.

cache-lifetime 0-1879048

no cache-lifetime

 
Syntax Description

0-1879048

Specifies the lifetime of any DNS entry in seconds.

 
Command Default

No default behavior or values are available.

 
Command Modes

DNS configuration (config-sbc-sbe-dns)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the lifetime of any DNS entry,:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip dns
Router(config-sbe-dns)# cache-lifetime 444

 
Related Commands

Command
Description

cache-limit

Configures the maximum number of entries that are permitted in the DNS cache.

sip dns

Enter the SIP DNS configuration mode.

cache-limit

To configure the maximum number of entries that are permitted in the DNS cache, use the cache-limit command in the DNS configuration mode. To set the limit to 100, use the no form of this command.

cache-limit 0-4294967295

no cache-lifetime

 
Syntax Description

0-4294967295

Specifies the maximum number of DNS entries.

 
Command Default

100

 
Command Modes

DNS configuration (config-sbc-sbe-dns)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure limits on DNS entries:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# sip dns
Router(config-sbe-dns)# cache-limit 14

 
Related Commands

Command
Description

cache-lifetime

Configures the lifetime of any DNS entry.

sip dns

Enters the SIP DNS configuration mode.

cache (session border controller)

To enable caching and configure call detail record caching parameters on a local disk, use the cache command in the SBE Billing configuration mode. To disable caching and local cache parameters, use the no form of this command.

cache [ path {WORD} | alarm [critical VAL] [major VAL] [minor VAL] | max-size {0-4194303}]

no cache [ path {WORD} | alarm [critical VAL] [major VAL] [minor VAL] | max-size {0-4194303}]

 
Syntax Description

path

(Required to enable caching) Specifies the local CDR cache file path location.

WORD

(Required to enable caching) Specifies the local drive name, up to a maximum of 255 characters.

alarm

(Optional) Specifies the cache file alarm thresholds.

critical VAL

(Optional) Specifies a critical alarm threshold.

major VAL

(Optional) Specifies a major alarm threshold.

minor VAL

(Optional) Specifies a minor alarm threshold.

max-size

(Optional) Specifies the maximum size of the local call detail record (CDR) cache file in kilobytes.

0-4194303

(Optional) This is the maximum size of the local CDR cache file, from zero to 4194303 kilobytes.

The default is zero. The cache max-size 0 command results in no limit on how big the cache can be.

 
Command Default

The default size of the local CDR cache file is zero.

 
Command Modes

SBE Billing configuration (config-sbc-sbe-billing)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The Cisco ASR 1000 Series Routers have a local disk where records and event messages can be stored on a local cache. Local cache support is a significant advantage because call detail records and event messages (EMs) are not lost when a billing server is unavailable.

Use the cache command configures parameters for storing call detail records and EMs on local disk as part of Cisco Unified Border Element (SP Edition)’s integrated billing system in the unified model.

The cache path command enables caching and the no cache path command disables caching. You can use the other optional keywords to specify alarm thresholds and how large the cache size is in kilobytes.

Examples

The following example configures billing and enables caching of call detailed records and EMs on the designated hard disk:

Router# configure terminal
Router(config)# sbc mysbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# control address aaa ipv4 10.1.1.1
Router(config-sbc-sbe)# radius accounting ACCT-CLIENT-GROUP-1
Router(config-sbc-sbe-acc)# activate
Router(config-sbc-sbe-acc)# server ACCT-SERVER-1
Router(config-sbc-sbe-acc-ser)# address ipv4 20.1.1.1
Router(config-sbc-sbe-acc-ser)# key cisco
Router(config-sbc-sbe-acc)# activate
Router(config-sbc-sbe-acc)# exit
Router(config-sbc-sbe)# billing
Router(config-sbc-sbe-billing)# ldr-check 22 30
Router(config-sbc-sbe-billing)# local-address ipv4 10.20.1.1
Router(config-sbc-sbe-billing)# method packetcable-em
Router(config-sbc-sbe-billing)# cache path harddisk:
Router(config-sbc-sbe-billing)# packetcable-em 3 transport radius test
Router(config-sbc-sbe-billing-packetcable-em)# batch-size 256
Router(config-sbc-sbe-billing-packetcable-em)# batch-time 22
Router(config-sbc-sbe-billing-packetcable-em)# local-address ipv4 10.1.1.1
Router(config-sbc-sbe-billing-packetcable-em)# attach
Router(config-sbc-sbe-billing-packetcable-em)# exit
Router(config-sbc-sbe-billing)# activate

 

The following configuration example shows that the cache file alarm thresholds and maximum size of the local CDR cache file are configured:

cache path disk2:
cache alarm minor 100 major 200 critical 300
cache max-size 1234567

 

The following configuration example shows that caching is enabled on the hard disk:

sbc asr
sbe
! - Local radius IP address
control address aaa ipv4 10.1.1.1
 
! - First radius accounting client group
radius accounting ACCT-CLIENT-GROUP-1
! - First radius server
server ACCT-SERVER-1
address ipv4 20.1.1.1
key cisco
activate
 
! - Billing manager.
billing
local-address ipv4 10.1.1.1
method packetcable-em
cache path harddisk:
! - First billing method.
packetcable-em 0 transport radius ACCT-CLIENT-GROUP-1
local-address ipv4 10.1.1.1
attach
activate
 

 
Related Commands

Command
Description

activate (radius)

Activates the billing functionality after configuration is committed.

billing

Configures billing.

local-address ipv4

Configures the local IPv4 address that appears in the CDR.

packetcable-em method-index transport radius RADIUS-client-name

Configures a packet-cable billing instance.

method packetcable-em

Enables the packet-cable billing method.

show sbc sbe billing remote

Displays the local and billing configurations.

cac-policy-set global

To activate the global call admission control (CAC) policy set within an signaling border element (SBE) entity, use the cac-policy-set global command in the SBE configuration mode. To deactivate the global CAC policy, use the no form of the command.

cac-policy-set global policy-set-id

no cac-policy-set global

 
Syntax Description

policy-set-id

Integer identifying the policy set that should be made global. Range is from 1 to 2147483647.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers. It replaces the cac-policy-set global command.

 
Usage Guidelines

From Release 3.5S onward, an active CAC policy set can be modified.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to activate policy set 1 on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# cac-policy-set global 1

 
Related Commands

Command
Description

cac-policy-set

Creates a new CAC policy set, copies an existing complete policy set, swaps the references of a complete policy set to another policy set, or sets the averaging period for rate calculations in a CAC policy set.

show sbc sbe cac-policy-set

Lists detailed information pertaining to a CAC policy table.

cac-scope

To allow you to choose the scope in which CAC limits are to be applied within each entry in a policy set table, use the cac-scope command in the CAC table entry configuration mode. To unconfigure the scope, use the no form of this command.

cac-scope { list of scope options }

no cac-scope { list of scope options }

 
Syntax Description

list of scope options

The scope options are as follows:

  • account —Events that are from the same account.
  • adjacency —Events that are from the same adjacency.
  • adj-group —Events that are from members of the same adjacency group.
  • call —Scope limits are per single call.
  • category —Events under the same category.
  • dst-account —Events that are sent to the same account.
  • dst-adj-group —Events that are sent to the same adjacency group.
  • dst-adjacency —Events that are sent to the same adjacency.
  • dst-number —Events that have the same destination.
  • global —Scope limits are global.
  • src-account —Events that are from the same account.
  • src-adj-group —Events that are from the same adjacency group.
  • src-adjacency —Events that are from the same adjacency.
  • src-number —Events that have the same source number.
  • sub-category —Limits specified at this scope are applicable to all the events sent to or received from members of the same subscriber category.
  • sub-category-pfx prefix-len —Limits specified in this scope are applicable to all the events sent to or received from members having the same subscriber category prefix.

Note prefix-len is included as part of the cac-scope command, for example, the command is as follows:
cac-scope sub-category-pfx prefix-len


  • subscriber —The limits specified in this scope apply to all the events sent to or received from individual subscribers (a device that is registered with a Registrar server).

 
Command Default

The default setting is global .

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 2.5

The sub-category , sub-category-pfx , and subscriber scope options were added.

Cisco IOS XE Release 3.5S

The account and adjacency scope options were added.

 
Usage Guidelines

The cac-scope command allows you to choose a scope in which CAC limits are to be applied within each entry. This command is available only to the entries defined within a Policy Set table type. You can define more than one cac-scope command within an entry.

Use the table-type command to configure a Policy Set table type.

Some CAC scopes can be combined to create compound scopes. The global scope and call scope cannot be combined.

When policy-set is defined as the table type for a CAC table, you must define cac-scope and cac-scope-prefix-len within the entry, for example:

cac-scope sub-category-pfx prefix-len

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the call event at which limits are applied in the TAB1 CAC policy-set table:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-table TAB1
Router(config-sbc-sbe-cacpolicy)# cac-table TAB1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# max-num-calls 20
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# complete
 

 
Related Commands

Command
Description

cac-table

Configures a Call Admission Control (CAC) table.

table-type

Configures a CAC table type that enables the priority of the call to be used as a criterion in the CAC policy.

calc-moscqe

To specify the percentage of calls that must be used to calculate the MOS-CQE score, use the calc-moscqe command in the adjacency H.323 configuration mode or adjacency SIP configuration mode. To remove this configuration, use the no form of this command.

calc-moscqe call-percentage

no calc-moscqe

 
Syntax Description

call-percentage

Percentage of calls. The range is from 0 to 1000. For example, if you enter 205 as the value of call-percentage , the SBC uses 20.5 percent of the calls for measuring local jitter.

 
Command Default

By default, the value of call-percentage is 0 .

 
Command Modes

Adjacency H.323 configuration (config-sbc-sbe-adj-h323)

Adjacency SIP configuration (config-sbc-sbe-adj-sip)

 
Command History

Release
Modification

Cisco IOS XE Release 3.3S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run this command.

Examples

In the following example, the calc-moscqe command is used to specify that 20.5 percent of the calls must be used to calculate the MOS-CQE score:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency h323 adj1
Router(config-sbc-sbe-adj-h323)# calc-moscqe 205

 
Related Commands

Command
Description

current15minutes

Specifies that QoS statistics must be calculated for 15-minute intervals.

current5minutes

Specifies that QoS statistics must be calculated for 5-minute intervals.

currentday

Specifies that statistics must be calculated for 24-hour intervals.

currenthour

Specifies that QoS statistics must be calculated for 60-minute intervals.

currentindefinite

Specifies that statistics must be calculated indefinitely, starting from the last explicit reset.

g107 bpl

Sets a value for the Packet-Loss Robustness (Bpl) factor.

g107 ie

Sets a value for the Equipment Impairment (Ie) factor.

g107a-factor

Sets a value for the Advantage (A) factor.

local-jitter-ratio

Specifies the percentage of calls that must be used to calculate the local jitter ratio.

show sbc sbe adjacencies

Displays details of the adjacencies configured on the SBE.

show sbc sbe call-stats

Displays the statistics pertaining to all the calls on a the SBE.

snmp-server enable traps sbc

Enables SBC notification types.

statistics

Specifies the QoS statistic for which alert levels must be set.

call-policy-set

To create a new policy set, copy an existing complete policy set, or swap the references of a complete policy set to another policy set, use the call-policy-set command in the Signaling border element (SBE) configuration mode. To delete a policy set , use the no form of this command.

call-policy-set { policy-set-id | copy { source policy-set-id destination policy-set-id } | swap { source policy-set-id destination policy-set-id }}

no call-policy-set policy-set-id

 
Syntax Description

policy-set-id

The integer, ranging from 1 to 2147483647, for a call policy set.

copy

Copies an existing policy set.

swap

Swaps the existing references of a complete policy set to another policy set.

source

Specifies the existing complete call policy set.

destination

Specifies the destination of the call policy set.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified. The copy-and-swap function was added to this command.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to create policy set 1 on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set 1
Router(config-sbc-sbe-rtgpolicy)# exit
Router(config-sbc-sbe)#
 

The following example shows how to copy an existing complete policy set and swap its references to a new policy set:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc MySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# call-policy-set copy source 2 destination 20
Router(config-sbc-sbe)# call-policy-set 20
Router(config-sbc-sbe-rtgpolicy)# no complete

Router(config-sbc-sbe-rtgpolicy)# first-inbound-na-table InTable

Router(config-sbc-sbe-rtgpolicy)# first-outbound-na-table OutTable

Router(config-sbc-sbe-rtgpolicy)# complete
Router(config-sbc-sbe-rtgpolicy)# exit
Router(config-sbc-sbe)# call-policy-set swap source 2 destination 20

 

 
Related Commands

Command
Description

call-policy-set

Creates a new policy set on the session border controller (SBC).

call-policy set default

Configures a default policy set on the SBE entity.

first-call-routing-table

Configures the name of the first policy table to be processed when performing the routing stage of a policy for new call events.

first-inbound-na-table

Configures the name of the first inbound policy table to be processed when performing the number analysis stage of a policy.

first-outbound-na-table

Configures the name of the first outbound policy table to be processed when performing the number analysis stage of a policy.

show sbc sbe call-policy-set

Lists the details of the policy sets configured on the SBC.

show sbc sbe call-policy-set default

Lists the summary of the default policy set configured on the SBC.

call-policy-set (admin-domain)

To configure the inbound and outbound number analysis and routing policy set for an administrative domain, use the call-policy-set command in the Administrative domain configuration mode. To remove a policy set from an administrative domain , use the no form of this command.

call-policy-set { inbound-na policy-set-id | outbound-na policy-set-id | rtg policy-set-id } [ priority priority-id ]

no call-policy-set { inbound-na | outbound-na | rtg }

 
Syntax Description

inbound-na

Specifies a completed inbound number analysis policy.

outbound-na

Specifies a completed outbound number analysis policy.

rtg

Specifies a completed routing policy.

policy-set-id

The integer, ranging from 1 to 2147483647, that identifies a complete policy set.

priority

Specifies the administrative domain priority

priority-id

The priority value, ranging from 1 to 10, with 10 indicating the highest priority. By default, 10 is the priority value given to a policy set.

 
Command Default

If the policy sets are not configured, an administrative domain uses the values defined within the default call policy set.

 
Command Modes

Administrative domain configuration (config-sbc-sbe-ad)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure an inbound and outbound number analysis and routing policy set for the administrative domain ADMIN1, and allocate priority to the policy sets using the call-policy-set command in the Administrative domain configuration mode:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# admin-domain ADMIN1
Router(config-sbc-sbe-ad)# call-policy-set inbound-na 2 priority 10
Router(config-sbc-sbe-ad)# call-policy-set outbound-na 3 priority 10
Router(config-sbc-sbe-ad)# call-policy-set rtg 1 priority 10

 
Related Commands

Command
Description

admin-domain

Configures an administrative domain.

cac-policy-set (admin-domain)

Configures the CAC policy set for an administrative domain.

show sbc sbe admin-domain

Lists the administrative domains on the SBC and per adjacency.

call-policy-set default

To activate a default policy set within an signaling border element (SBE) entity, use the call-policy-set default command in the SBE configuration mode. To deactivate a default policy set, use the no form of this command.

call-policy-set default policy-set-id [ priority priority-value ]

no call-policy-set default

 
Syntax Description

policy-set-id

The integer, ranging from 1 to 2147483647, that identifies a default call policy set.

priority

Specifies the priority for the administrative domains that are not configured.

priority-id

The priority value, ranging from 1 to 10, with 10 indicating the highest priority. By default, 6 is the priority value given to the policy set.

 
Command Default

No default behavior or values are available.

 
Command Modes

SBE configuration (config-sbc-sbe)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified. The call-policy-set default command was renamed as call-policy-set default . The priority keyword and its value were also added.

 
Usage Guidelines

If another policy set was previously active, it is made inactive by executing this command. The SBE is created with no active routing policy set; an active routing policy set must be explicitly configured using this command.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to set policy set 1 as the default on mySbc:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router (config-sbc-sbe)# call-policy-set default 1 priority 9

 

 
Related Commands

Command
Description

call-policy-set

Creates a new policy set on the session border controller (SBC).

first-inbound-na-table

Configures the name of the first inbound policy table to be processed when performing the number analysis stage of a policy.

first-outbound-na-table

Configures the name of the first outbound policy table to be processed when performing the number analysis stage of a policy.

show sbc sbe call-policy-set

Lists the details of the policy sets configured on the SBC.

show sbc sbe call-policy-set default

Lists the summary of the default policy set configured on the SBC.

callee-bandwidth-field

To configure the SBC to convert a specific bandwidth line format into another bandwidth line format in an outbound Session Description Protocol (SDP) sent to the callee, use the callee-bandwidth-field command in CAC table entry configuration mode. To remove the specific style of bandwidth line format, use the no callee-bandwidth-field command.

callee-bandwidth-field [as-to-tias | tias-to-as]

no callee-bandwidth-field [as-to-tias | tias-to-as]

 
Syntax Description

as-to-tias

This option causes the SBC to convert a b=AS line format into a b=TIAS line format, for a given SDP bandwidth modifier in an outbound offer.

AS = Application Specific Maximum

TIAS = Transport Independent Application Specific Maximum has an integer bit-rate value in bits per second.

tias-to-as

This option causes the SBC to convert a b=TIAS line format into a b=AS line format, for a given SDP bandwidth modifier in an outbound offer.

AS = Application Specific Maximum

TIAS = Transport Independent Application Specific Maximum has an integer bit-rate value in bits per second.

 
Command Default

The default is that the bandwidth line is not translated from one format to another.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The SBC follows whichever outgoing bandwidth line format is configured. If the outgoing adjacency is configured to prefer a specific style of bandwidth line, then the preferred format is used, and any b=AS or b=TIAS lines are translated to that format.

If the answerer-side adjacency is configured to prefer a specific style of bandwidth line format in the SDP, this command causes the SBC to convert the offer to the specified format before being sent to the answerer. If there are multiple bandwidth lines, only the first is converted into the specified bandwidth line and the rest are ignored.


NoteThe default is that the bandwidth line is not translated from one format to another. However, if the callee is configured to convert the bandwidth, and the message is converted, then the response back to the caller is converted back even if the caller-bandwidth-field option is not provisioned. The default is that the bandwidth line is not translated from one format to another. However, if the callee is configured to convert the bandwidth, and the message is converted, then the response back to the caller is converted back even if the caller-bandwidth-field option is not provisioned.


Examples

The following example shows the SBC is configured to convert an AS bandwidth line format into a TIAS bandwidth line format in an outbound SDP sent to the callee:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc test
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table 1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-bandwidth-field as-to-tias

 

 
Related Commands

Command
Description

caller-bandwidth-field [as-to-tias | tias-to-as]

Configures the SBC to convert a specific bandwidth line format into another bandwidth line format in an outbound Session Description Protocol (SDP) sent to the caller.

callee-codec-list

To list the codecs which the callee leg of a call is allowed to use, use the callee- codec-list command in the CAC table entry configuration mode. To delete a codec list, use the no form of this command.

callee-codec-list list-name

no callee-codec-list list-name

 
Syntax Description

list-name

Specifies the name of the codec list.

The list-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to enter a mode to create a codec list using the name test:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-codec-list test

 

callee-hold-setting

To configure the callee hold settings that are supported, use the callee-hold-setting command in CAC table entry configuration mode. To deconfigure the callee hold settings, use the no form of this command.

callee-hold-setting {hold-c0 | hold-c0-inactive | hold-c0-sendonly | hold-sendonly | standard}

no callee-hold-setting {hold-c0 | hold-c0-inactive | hold-c0-sendonly | hold-sendonly | standard}

 
Syntax Description

hold-c0

Callee supported; requires c=I 0.0.0.0.

hold-c0-inactive

Callee supported; requires c=I 0.0.0.0 or a=inactive.

hold-c0-sendonly

Callee supported; requires c=0.0.0.0 or a=sendonly

hold-sendonly

Callee supported; requires a=sendonly.

standard

Callee supported; requires c=0.0.0.0 and either a=forward-direction capability.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the callee hold settings:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value fairchild
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-hold-setting hold-sendonly
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete
Router(config-sbc-sbe-cacpolicy-cactable-entry)# complete

 
Related Commands

Command
Description

callee-inbound-policy

Configures a callee inbound SDP policy table.

callee-outbound-policy

Configures a callee outbound SDP policy table.

callee-inbound-policy

To configure a callee inbound SDP policy table, use the callee-inbound-policy command in CAC table entry configuration mode. To, use the no form of this command.

callee-inbound-policy WORD

no callee-inbound-policy WORD

 
Syntax Description

WORD

Specifies the name of the SDP policy table. The maximum size is 30 characters.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to create the admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-inbound-policy test
 

 
Related Commands

Command
Description

callee-hold-setting

Configures the callee hold settings that are supported.

callee-outbound-policy

Configures a callee outbound SDP policy table.

callee-media-caps

To configure a codec list used to announce media capabilities on behalf of a SIP callee in a SIP to H.323 or H.323 to SIP interworking call, use the callee-media-caps command in CAC table entry configuration mode. To remove the codec list, use the no callee-media-caps command.

callee-media-caps {code-list-name}

no callee-media-caps {code-list-name}

 
Syntax Description

code-list-name

This is a string text of a maximum length of 30 characters. Describes the extra codecs that a SIP callee can announce to the H.323 side.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5.1

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command configures a codec list and assigns the list to a CAC table.

Once a codec list has been assigned, it may not be deleted until it is removed from the CAC table entry. A codec list must exist before it can be assigned to an entry in a CAC table.

For a description of “H.323 TCS Codecs,” see the “Codec Handling” chapter in the Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model .

Examples

The following example configures a codec list called “callee-media-caps-list” and assigns that list to the CAC table “cac-tbl-1” in entry 1 to announce that T.38 was added as a callee SIP media capabilities.

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# codec list callee-media-caps-list
Router(config-sbc-sbe-codec-list)# codec t38
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table cac-tbl-1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-media-caps callee-media-caps-list
 
 

 
Related Commands

Command
Description

caller-media-caps

Configures a codec list used to announce media capabilities on behalf of a SIP caller in a SIP to H.323 or H.323 to SIP interworking call.

tcs-extra-caps-list

Configures a codec list used to announce media capabilities on behalf of both the SIP caller and callee in a SIP to H.323 or H.323 to SIP interworking call.

callee-outbound-policy

To configure a callee outbound SDP policy table, use the callee-outbound-policy command in CAC table entry configuration mode. To, use the no form of this command.

callee-outbound-policy WORD

no callee-outbound-policy WORD

 
Syntax Description

WORD

Specifies the name of the SDP policy table. The maximum size is 30 characters.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to create the admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-inbound-policy test

 
Related Commands

Command
Description

callee-hold-setting

Configures the callee hold settings that are supported.

callee-inbound-policy

Configures a callee inbound SDP policy table.

callee-privacy edit-privacy-request

To edit and update privacy indications provided by the user, use the callee-privacy edit-privacy-request command in CAC table configuration mode. To remove the indications, use the no form of this command.

callee-privacy edit-privacy-request { pass | strip | insert | replace | sip { strip { all | critical | header | id | none | session | token word | user } | insert { critical | header | id | none | session | token word | user }}}

no callee-privacy edit-privacy-request { pass | strip | insert | replace | sip { strip { all | critical | header | id | none | session | token word | user } | insert { critical | header | id | none | session | token word | user }}}

 
Syntax Description

insert

Inserts privacy restrictions:

  • SIP —Inserts Privacy:header;session;user;id;critical, if the header is not present already
  • H323—Sets presentation indicator from allowed to restricted.

pass

Passes on the privacy header or presentation indicators.

replace

Replaces privacy restrictions:

  • SIP—Replaces the Privacy:header;session;user;id;critical, except when none has been requested.
  • H323—Sets presentation indicator to restricted.

strip

Removes all privacy restrictions:

  • SIP—Removes Privacy header.
  • H323—Set presentation indicator to allowed.

sip

Specifies the following SIP settings that allows greater control and overrides all generic actions:

  • insert —Inserts Privacy tokens into the Privacy header.
  • strip —Removes privacy tokens from the Privacy header.

critical

Specifies the call to discontinue if privacy cannot be achieved in the SIP Privacy header.

header

Obscures all header information that is related to the user from the SIP Privacy header.

id

Adds or removes the ID headers from the SIP Privacy header.

none

Privacy is not applied to call.

session

Specifies the media privacy for the session in the SIP Privacy header. No media bypass is performed.

token

Specifies the non standard user defined privacy token in the SIP Privacy header.

word

Specifies the user defined privacy token.

user

Removes all non-essential header information that is related to the user from the SIP Privacy header.

 
Command Default

The privacy request editing is set to Pass.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified from callee-privacy to callee-privacy edit-privacy-request . The callee-privacy limited-privacy-service command has been removed.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the entry to remove all privacy restrictions from SIP and H323 adjacencies in the new admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefix
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-privacy edit-privacy-request strip
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 
Related Commands

Command
Description

cac-table

Configures admission control tables.

callee-privacy privacy-service

Applies privacy settings according to RFC3323, RFC3325, and/or setting of H.323 presentation restriction settings.

table-type

Configures a CAC table type that enables the priority of the call to be used as a criterion in CAC policy.

callee-privacy privacy-service

To apply privacy settings according to RFC3323, RFC3325, and/or setting of H.323 presentation restriction settings in the given entry in the admission control table, use the callee-privacy privacy-service command in CAC table configuration mode. To remove the privacy settings, use the no form of this command.

callee-privacy privacy-service { adj-trust-boundary | always | never }

no callee-privacy privacy-service

 
Syntax Description

adj-trust-boundary

Specifies the adjacency privacy trust level to determine if the privacy service is required.

always

Provides privacy service always, if requested by the user.

never

Never provides privacy service even if requested by the user.

 
Command Default

The privacy setting value is set to adj-trust-boundary.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified from callee-privacy to callee-privacy privacy-service . The callee-privacy limited-privacy-service command has been removed.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the entry to provide privacy service always as requested by the user in the new admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefix
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-privacy privacy-service always
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 
Related Commands

Command
Description

cac-table

Configures admission control tables.

callee-privacy edit-privacy-request

Edits and updates privacy indications provided by the user

table-type

Configures a CAC table type that enables the priority of the call to be used as a criterion in CAC policy.

callee-sig-qos-profile

To configure the QoS profile to be used for signaling packets sent to the original callee , use the callee-sig-qos-profile command in the CAC table entry configuration mode. To deconfigure the QoS profile , use the no form of this command.

callee-sig-qos-profile profile-name

no callee-sig-qos-profile profile-name

 
Syntax Description

profile-name

Specifies the name of the QoS profile. The string “default” is reserved.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how the callee-sig-qos-profile command is used to configure the QoS profile named enterprise to be used for signaling packets sent to the original callee:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-sig-qos-profile enterprise

 

callee tel-event payload type

To configure the payload type to be used for the callee in H.323-SIP interworking calls, use the callee tel-event payload-type command in the CAC entry configuration mode. To unconfigure the payload type setting, use the no form of this command.

callee tel-event payload type payload-type

no callee tel-event payload type

 
Syntax Description

payload-type

See RFC 2833 for detailed information about the values of payload-type . The range is from 96 to 127. The default is 101.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC entry configuration (config-sbc-cac-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.1S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers in a release earlier than Release 3.1S.

 
Usage Guidelines

The callee tel-event payload type command enables support for dual tone multifrequency (DTMF) H.323-SIP interworking. The telephone-event payload type configured by this command is used by the SBC only in situations where the payload type information is not provided by the other side in an H.323-SIP interworking call.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to use the callee tel-event payload-type command to set the payload type to 101:

Router(config)# sbc sbc1
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-cac-pol)# cac-table CAC-POLICY-TBL1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee tel-event payload-type 101

 
Related Commands

Command
Description

branch tel-event payload-type

Configures the payload type to be used for the callee or the caller in H.323-SIP interworking calls.

caller tel-event payload-type

Configures the payload type to be used for the caller in H.323-SIP interworking calls.

callee-video-qos-profile

To configure the QoS profile to use for media packets sent to the original callee, use the callee-video-qos-profile command in CAC table entry configuration mode. To return to the default behavior, use the no form of this command.

callee-video-qos-profile profile-name

no callee-video-qos-profile

 
Syntax Description

profile-name

Name of the QoS profile.

The profile -name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.


NoteThe The callee-video-qos-profile can be executed only at the per-call scope. CAC policy does not activate if configured at any other scope.


Examples

The following example shows how to configure calls from the acme account to use the video QoS profile enterprise for packets sent from the SBC to the original callee:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-video-qos-profile enterprise
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 

callee-voice-qos-profile

To configure the QoS profile to use for media packets sent to the original callee, use the callee-voice-qos-profile command in CAC table entry configuration mode. To return to the default behavior, use the no form of this command.

callee-voice-qos-profile profile-name

no callee-voice-qos-profile

 
Syntax Description

profile-name

Name of the QoS profile.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.


NoteThis command can be executed only at the per-call scope. CAC policy does not activate if this command is configured at any other scope. This command can be executed only at the per-call scope. CAC policy does not activate if this command is configured at any other scope.


Examples

The following example shows how to configure calls from the acme account to use the voice QoS profile enterprise for packets sent from the SBC to the original callee.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee-voice-qos-profile enterprise
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit
 

 

callee codec

To configure the codec options for a callee, use the callee codec command in the CAC table entry configuration mode. To deconfigure the codec options, use the no form of this command.

callee codec {convert | profile profile-name }

no callee codec {convert | profile }

 
Syntax Description

convert

Enables or disables the codec variant conversion.

profile

Specifies or removes the codec variant profile.

profile-name

The codec variant profile name.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

By default, codec variant conversion is disabled, and no codec variant profile is specified.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section that follows shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the codec options for a callee using the callee codec command in the CAC table entry mode:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table Transrate
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee codec convert
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee codec profile profile-1

 

callee inband-dtmf-mode

To configure the dual tone multifrequency (DTMF) in-band mode for the callee side, use the callee inband-dtmf-mode command in the CAC table entry configuration mode.To deconfigure the DTMF in-band mode for the callee side, use the no form of this command.

callee inband-dtmf-mode { always | inherit | maybe | never }

no callee inband-dtmf-mode

 
Syntax Description

always

Specifies that the in-band DTMF tones are always used by the endpoint.

inherit

Specifies that the in-band DTMF mode for the endpoint is not affected by the CAC entry.

maybe

Specifies that the in-band DTMF tones are used by the endpoint unless signaling indicates that an alternative format is in use for the DTMF.

never

Specifies that the endpoint never uses in-band DTMF.

 
Command Default

No default behavior or values.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section that follows shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the DTMF in-band mode for the callee side using the callee inband-dtmf-mode command in the CAC table entry configuration mode so that the in-band DTMF tones are always in use by the endpoint:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table InbandDTMF
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee inband-dtmf-mode always

 
Related Commands

Command
Description

caller inband-dtmf-mode

Configures the DTMF in-band mode for the caller side

callee media-description disabled

To configure how Cisco Unified Border Element (SP Edition) handles disabled media descriptions for a callee, use the callee media-description disabled command in the CAC table entry configuration mode.

callee media-description disabled {strip {answer | offer {all | new}} | {pad offer}}

no callee media-description disabled {strip {answer | offer {all | new}} |{pad offer}}

 
Syntax Description

strip

Strips disabled media description lines.

pad

Pads with dummy disabled media description lines.

answer

Strips disabled media description lines from answers.

offer

Strips disabled media description lines from offers when used with strip. Pad offers with dummy disabled media description lines when used with pad.

all

Strips all disabled media descriptions from offers.

new

Strips new disabled media descriptions from offers.

 
Command Default

Pad and do-not-strip are the default behaviors.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to remove disabled media streams in forwarded offers which are new:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee media-description disabled strip offer new
 

The following example shows how to remove all disabled media streams from forwarded offers, whether known to the recipient of the offer or not.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee media-description disabled strip offer all
 

The following example shows how to remove all disabled media streams from forwarded answers.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee media-description disabled strip answer
 

The following example shows how to stop SBC from padding forwarded offers with disabled media streams.

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# no callee media-description disabled pad offer
 

 

callee media-type

To configure the media address type settings for a callee on the Cisco Unified Border Element (SP Edition), use the callee media-type command in the CAC table entry configuration mode. Use the no form of this command to disable the media address type settings for a callee.

callee media-type { ipv4 | ipv6 | inherit | both }

no callee media-type { ipv4 | ipv6 | inherit | both }

 
Syntax Description

ipv4

Only IPv4 media addresses are supported.

ipv6

Only IPv6 media addresses are supported.

inherit

Inherit the supported media IP address type from earlier CAC policy entries (default).

both

Both IPv4 and IPv6 media addresses are supported.

 
Command Default

The default behavior is inherit.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.6

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to remove disabled media streams in forwarded offers which are new:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table mytable
Router(config-sbc-sbe-cacpolicy)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee media-type ipv4
Router(config-sbc-sbe-cacpolicy-cactable-entry)#
 
 

 

callee media bypass

To enable or disable the Multiple SBC Media Bypass feature on the callee side, use the callee media bypass command in the CAC table entry configuration mode. To deconfigure the Multiple SBC Media Bypass feature, use the no form of this command.

callee media bypass { enable | disable }

no callee media bypass

 
Syntax Description

enable

Enables the Multiple SBC Media Bypass feature on the callee side.

disable

Disables the Multiple SBC Media Bypass feature on the callee side.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to enable the Multiple SBC Media Bypass feature on the callee side:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table table1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee media bypass enable

 
Related Commands

Command
Description

cac-table

Configures admission control tables.

caller media bypass

Enables or disables the Multiple SBC Media Bypass feature on the caller side.

table-type

Configures a CAC table type to enable the priority of the call to be used as a criterion in the CAC policy.

callee port-range-tag

To configure the port range tag for a callee that is used when selecting a media address and port, use the callee port-range-tag command in the CAC table entry configuration mode. To deconfigure the port range tag, use the no form of this command.

callee port-range-tag { adj-name | none | string tag-string }

no callee port-range-tag

 
Syntax Description

adj-name

Uses the destination adjacency name as a port-range tag.

none

Prompts the SBC to not use a port range tag for calls matching the CAC entry, and removes any previously found strings.

string tag-string

Specifies the explicit port range tag string.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure a port-range tag:

Router# configure terminal
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table table1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match SIPIMSAccess
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee port-range-tag string GenericCorePortRange

 
Related Commands

Command
Description

media-address-pool

Adds an IPv4 and IPv6 address to the set of addresses that can be used by the DBE as a local media address.

callee ptime

To configure the packetization time on the callee side, use the callee ptime command in the CAC table configuration mode.To deconfigure the packetization time on the callee side, use the no form of this command.

callee ptime 0-100

no callee ptime 0-100

 
Syntax Description

0-100

The packetization time in milliseconds (ms).

 
Command Default

By default, 0 ms is configured. This means that no transrating occurs.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section that follows shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the packetization time on the callee side using the callee ptime command in the CAC table configuration mode:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table Transrate
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# cac-scope call
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee ptime 30
 

 
Related Commands

Command
Description

caller ptime

Configures the packetization time on the caller side.

callee secure-media

To configure granular-level Secure Media on the callee side, use the callee secure-media command in CAC table entry configuration mode. To remove granular-level Secure Media, use the no callee secure-media command.

callee secure-media

no callee secure-media

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

Granular-level (Unsignaled) Secure Media is disabled by default.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.6

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

Restriction—Both caller and callee sides of the call need to be configured. If only one leg of the call has granular secure media configured, then the call will fail.

We recommend you use unsignaled (also called granular-level) Secure Media configuration because, instead of turning on Secure Media globally, you can specify the calls and adjacencies where you want to use Secure Media.

Examples

The following example shows an Unsignaled Secure Media configuration where the two SIP adjacencies for both legs of the call are configured for “security trusted-unencrypted” and both the caller and callee sides are configured for Secure Media in a CAC table entry:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# adjacency sip client
Router(config-sbc-sbe-adj-sip)# security trusted-unencrypted
Router(config-sbc-sbe-adj-sip)# exit
Router(config-sbc-sbe)# adjacency sip server
Router(config-sbc-sbe-adj-sip)# security trusted-unencrypted
Router(config-sbc-sbe-adj-sip)# exit
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-table testSecure
Router(config-sbc-sbe-cacpolicy)# cac-table testSecure
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller secure-media
Router(config-sbc-sbe-cacpolicy-cactable-entry)# callee secure-media
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy)# exit
Router(config-sbc-sbe)# cac-policy-set global 1
Router(config-sbc-sbe)# end

 

The following configuration example shows how to configure Unsignaled Secure Media where an adjacency is untrusted by using the transport srtp allowed command on the untrusted adjacency in a CAC policy table:

...
cac-policy-set 2
first-cac-table 1
cac-table 1
table-type limit all
entry 1
match-value call-update
transport srtp allowed
caller secure-media
callee secure-media
action cac-complete
exit
complete
exit
cac-policy-set global 2

 

The following configuration example shows that SIP adjacencies ‘client’ and ‘server’ are configured as “security trusted-unencrypted” and that CAC table entry 1 is configured for Secure Media on both the caller and callee sides:

...
cac-policy-set 2
first-cac-table 1
cac-table 1
table-type policy-set
entry 1
action cac-complete
caller secure-media
callee secure-media
complete
cac-policy-set global 2
 
adjacency sip client
nat force-off
security trusted-unencrypted
signaling-address ipv4 10.10.100.110
signaling-port 9060
remote-address ipv4 10.10.100.10 255.255.255.255
signaling-peer 10.10.100.10
signaling-peer-port 9060
attach
adjacency sip server
nat force-off
security trusted-unencrypted
signaling-address ipv4 10.10.100.110
signaling-port 9070
remote-address ipv4 10.10.100.10 255.255.255.255
signaling-peer 10.10.100.10
signaling-peer-port 9070
attach

 
Related Commands

Command
Description

caller secure-media

Configures granular-level Secure Media on the caller side.

security

Configures transport-level security (TLS) on a SIP adjacency.

caller-bandwidth-field

To configure the SBC to convert a specific bandwidth line format into another bandwidth line format in an outbound Session Description Protocol (SDP) sent to the caller, use the caller-bandwidth-field command in CAC table entry configuration mode. To remove the specific style of bandwidth line format, use the no caller-bandwidth-field command.

caller-bandwidth-field [as-to-tias | tias-to-as]

no caller-bandwidth-field [as-to-tias | tias-to-as]

 
Syntax Description

as-to-tias

Configures the SBC to convert a b=AS line format into a b=TIAS line format, for a given SDP media descriptor in an outbound offer.

AS —Application Specific Maximum

TIAS—Transport Independent Application Specific Maximum has an integer bit-rate value in bits per second.

tias-to-as

Configures the SBC to convert a b=TIAS line format into a b=AS line format, for a given SDP media descriptor in an outbound offer.

AS—Application Specific Maximum

TIAS—Transport Independent Application Specific Maximum has an integer bit-rate value in bits per second.

 
Command Default

The default is that the bandwidth line is not translated from one format to another.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

The SBC follows whichever outgoing bandwidth line format is configured. If the outgoing adjacency is configured to prefer a specific style of bandwidth line, then the preferred format is used, and any b=AS or b=TIAS lines are translated to that format.

If the offerer-side adjacency is configured to prefer a specific style of bandwidth line format in the SDP, this command causes the SBC to convert the answer to the specified format before being sent back to the offerer. If there are multiple bandwidth lines, only the first is converted into the specified bandwidth line and the rest are ignored.


NoteThe default is that the bandwidth line is not translated from one format to another. However, if the callee is configured to convert the bandwidth, and the message is converted, then the response back to the caller is converted back even if the caller-bandwidth-field option is not provisioned. The default is that the bandwidth line is not translated from one format to another. However, if the callee is configured to convert the bandwidth, and the message is converted, then the response back to the caller is converted back even if the caller-bandwidth-field option is not provisioned.


Examples

The following example shows the SBC is configured to convert an AS bandwidth line format into a TIAS bandwidth line format in an outbound SDP sent to the caller:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc test
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table 1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-bandwidth-field as-to-tias

 
Related Commands

Command
Description

callee-bandwidth-field

Configures the SBC to convert a specific bandwidth line format into another bandwidth line format in an outbound Session Description Protocol (SDP) sent to the callee.

caller-codec-list

To list the codecs which the caller leg of a call is allowed to use, use the caller- codec-list command in the CAC table entry configuration mode. To delete a codec list, use the no form of this command.

caller-codec-list list-name

no caller-codec-list list-name

 
Syntax Description

list-name

Specifies the name of the codec list.

The list-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to enter a mode to create a codec list using the name test:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-codec-list test

 

caller-hold-setting

To configure the caller hold settings that are supported, use the caller-hold-setting command in CAC table entry configuration mode. To cancel caller hold settings, use the no form of this command.

caller-hold-setting {hold-c0 | hold-c0-inactive | hold-c0-sendonly | hold-sendonly | standard}

no caller-hold-setting {hold-c0 | hold-c0-inactive | hold-c0-sendonly | hold-sendonly | standard}

 
Syntax Description

hold-c0

Specifies callee supported; requires c=I 0.0.0.0.

hold-c0-inactive

Specifies callee supported; requires c=I 0.0.0.0 or a=inactive.

hold-c0-sendonly

Specifies callee supported; requires c=0.0.0.0 or a=sendonly

hold-sendonly

Specifies callee supported; requires a=sendonly.

standard

Specifies callee supported; requires c=0.0.0.0 and either a=forward-direction capability.

 
Command Default

The default is standard.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the caller hold settings:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value fairchild
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-hold-setting hold-sendonly
Router(config-sbc-sbe-cacpolicy-cactable-entry)# action cac-complete

Router (config-sbc-sbe-cacpolicy-cactable-entry)# complete

 
Related Commands

Command
Description

caller-outbound-policy

Configures a caller outbound SDP policy table.

caller-inbound-policy

Configures a caller inbound SDP policy table.

caller-inbound-policy

To configure a caller inbound SDP policy table, use the caller-inbound-policy command in CAC table entry configuration mode. To deconfigure a caller inbound SDP policy table, use the no form of this command.

caller-inbound-policy WORD

no caller-inbound-policy WORD

 
Syntax Description

WORD

Specifies the name of the SDP policy table. The maximum size is 30 characters.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure a caller inbound SDP policy table:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1

Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-inbound-policy test

 
Related Commands

Command
Description

caller-hold-setting

Configures the caller hold settings.

caller-outbound-policy

Configure a caller outbound SDP policy table.

codec

Adds a codec to a codec list.

caller-codec-list

Lists the codecs which the caller of a call can use.

caller-media-caps

To configure a codec list used to announce media capabilities on behalf of a SIP caller in a SIP to H.323 or H.323 to SIP interworking call, use the caller-media-caps command in CAC table entry configuration mode. To remove the codec list, use the no caller-media-caps command.

caller-media-caps {code-list-name}

no caller-media-caps {code-list-name}

 
Syntax Description

code-list-name

This is a string text of a maximum length of 30 characters. Describes the extra codecs that a SIP caller can announce to the H.323 side.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.5.1

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command configures a codec list and assigns the list to a CAC table.

Once a codec list has been assigned, it may not be deleted until it is removed from the CAC table entry. A codec list must exist before it can be assigned to an entry in a CAC table.

For a description of “H.323 TCS Codecs,” see the “Codec Handling” chapter in the Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model .

Examples

The following example configures a codec list called “caller-media-caps-list” and assigns that list to the CAC table “cac-tbl-1” in entry 1 to announce that T.38 is added as a caller SIP media capabilities:

Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# codec list caller-media-caps-list
Router(config-sbc-sbe-codec-list)# codec t38
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table cac-tbl-1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-media-caps caller-media-caps-list
 
 

 
Related Commands

Command
Description

callee-media-caps

Configures a codec list used to announce media capabilities on behalf of a SIP callee in a SIP to H.323 or H.323 to SIP interworking call.

tcs-extra-caps-list

Configures a codec list used to announce media capabilities on behalf of both the SIP caller and callee in a SIP to H.323 or H.323 to SIP interworking call.

caller-outbound-policy

To configure a caller outbound SDP policy table, use the caller-outbound-policy command in CAC table entry configuration mode. To deconfigure a caller outbound SDP policy table, use the no form of this command.

caller-outbound-policy table_name

no caller-outbound-policy table_name

 
Syntax Description

WORD

Specifies the name of the SDP policy table. The maximum size is 30 characters.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure a caller outbound SDP Limit table:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope global
Router(config-sbc-sbe-cacpolicy)# first-cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy)# cac-table callhold-dst-settings
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-account
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1

Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-outbound-policy test

Command
Description

caller-hold-setting

Configures the caller hold settings.

caller-inbound-policy

Configures a caller inbound SDP policy table.

caller-privacy edit-privacy-request

To edit and update privacy indications provided by the user, use the caller-privacy edit-privacy-request command in CAC table configuration mode. To remove the indications, use the no form of this command.

caller-privacy edit-privacy-request { pass | strip | insert | replace | sip { strip { all | critical | header | id | none | session | token word | user } | insert { critical | header | id | none | session | token word | user }}}

no caller-privacy edit-privacy-request { pass | strip | insert | replace | sip { strip { all | critical | header | id | none | session | token word | user } | insert { critical | header | id | none | session | token word | user }}}

 
Syntax Description

insert

Inserts privacy restrictions:

  • SIP —Inserts Privacy:header;session;user;id;critical, if the header is not present already
  • H323—Sets presentation indicator from allowed to restricted.

pass

Passes on the privacy header or presentation indicators.

replace

Replaces privacy restrictions:

  • SIP—Replaces the Privacy:header;session;user;id;critical, except when none has been requested.
  • H323—Sets presentation indicator to restricted.

strip

Removes all privacy restrictions:

  • SIP—Removes Privacy header.
  • H323—Set presentation indicator to allowed.

sip

Specifies the following SIP settings that allows greater control and overrides all generic actions:

  • insert —Inserts Privacy tokens into the Privacy header.
  • strip —Removes privacy tokens from the Privacy header.

critical

Specifies the call to discontinue if privacy cannot be achieved in the SIP Privacy header.

header

Obscures all header information that is related to the user from the SIP Privacy header.

id

Adds or removes the ID headers from the SIP Privacy header.

none

Privacy is not applied to call.

session

Specifies the media privacy for the session in the SIP Privacy header. No media bypass is performed.

token

Specifies the non standard user defined privacy token in the SIP Privacy header.

word

Specifies the user defined privacy token.

user

Removes all non-essential header information that is related to the user from the SIP Privacy header.

 
Command Default

The privacy request editing is set to Pass.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified from caller-privacy to caller-privacy edit-privacy-request . The caller-privacy limited-privacy-service command has been removed.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the entry to remove all privacy restrictions from SIP and H323 adjacencies in the new admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefix
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-privacy edit-privacy-request strip
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 
Related Commands

Command
Description

cac-table

Configures admission control tables.

caller-privacy privacy-service

Applies privacy settings according to RFC3323, RFC3325, and/or setting of H.323 presentation restriction settings.

table-type

Configures a CAC table type that enables the priority of the call to be used as a criterion in CAC policy.

caller-privacy privacy-service

To apply privacy settings according to RFC3323, RFC3325, and/or setting of H.323 presentation restriction settings in the given entry in the admission control table, use the caller-privacy privacy-service command in CAC table configuration mode. To remove the privacy settings, use the no form of this command.

caller-privacy privacy-service { adj-trust-boundary | always | never }

no caller-privacy privacy-service

 
Syntax Description

adj-trust-boundary

Specifies the adjacency privacy trust level to determine if the privacy service is required.

always

Provides privacy service always, if requested by the user.

never

Never provides privacy service even if requested by the user.

 
Command Default

The privacy setting value is set to adj-trust-boundary.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

Cisco IOS XE Release 3.2S

This command was modified from caller-privacy to caller-privacy privacy-service . The caller-privacy limited-privacy-service command has been removed.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to configure the entry to provide privacy service always as requested by the user in the new admission control table MyCacTable:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit dst-prefix
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-privacy privacy-service always
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 
Related Commands

Command
Description

cac-table

Configures admission control tables.

caller-privacy edit-privacy-request

Edits and updates privacy indications provided by the user

table-type

Configures a CAC table type that enables the priority of the call to be used as a criterion in CAC policy.

caller-sig-qos-profile

To configure the QoS profile to use for signaling packets sent to the original caller, use the caller-sig-qos-profile command in the CAC table entry configuration mode. To deconfigure the QoS profile , use the no form of this command.

caller-sig-qos-profile profile-name

no caller-sig-qos-profile profile-name

 
Syntax Description

profile-name

Specifies the name of the QoS profile. The string “default” is reserved.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

This command can only be executed at the per-call scope. CAC policy will not activate if this command is configured at any other scope.

Packet marking will not be applied until the CAC decision process is run. This means that some initial signaling packets sent to the caller (for example, the SIP 100 provisional response) will not receive any particular DSCP marking.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following command configures calls from the acme account to use the voice QoS profile enterprise for signaling packets sent from the SBC to the original caller:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-sig-qos-profile enterprise
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 

caller tel-event payload type

To configure the payload type to be used for the caller in H.323-SIP interworking calls, use the caller tel-event payload-type command in the CAC entry configuration mode. To unconfigure the payload type setting, use the no form of this command.

caller tel-event payload type payload-type

no caller tel-event payload type

 
Syntax Description

payload-type

See RFC 2833 for detailed information about the values of payload-type . The range is from 96 to 127. The default is 101.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC entry configuration (config-sbc-cac-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.1S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers in a release earlier than Release 3.1S.

 
Usage Guidelines

The caller tel-event payload type command enables support for dual tone multifrequency (DTMF) H.323-SIP interworking. The telephone-event payload type configured by this command is used by the SBC only in situations where the payload type information is not provided by the other side in an H.323-SIP interworking call.

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.

Examples

The following example shows how to use the caller tel-event payload-type command to set the payload type to 101:

Router(config)# sbc sbc1
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-cac-pol)# cac-table CAC-POLICY-TBL1
Router(config-sbc-sbe-cacpolicy-cactable)# table-type policy-set
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller tel-event payload-type 101

 
Related Commands

Command
Description

branch tel-event payload-type

Configures the payload type to be used for the callee or the caller in H.323-SIP interworking calls.

callee tel-event payload-type

Configures the payload type to be used for the callee in H.323-SIP interworking calls.

caller-video-qos-profile

To configure the QoS profile to use for media packets sent to the original caller, use the caller-video-qos-profile command in CAC table configuration mode. To remove this configuration, use the no form of this command.

caller-video-qos-profile profile-name

no caller-video-qos-profile profile-name

 
Syntax Description

profile-name

Specifies the Qos profile.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.


NoteThe The caller-video-qos-profile command can be executed only at the per-call scope. CAC policy does not activate if this command is configured at any other scope.


Examples

The following example shows how to configure calls from the acme account to use the video QoS profile enterprise for packets sent from the SBC to the original caller:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-video-qos-profile enterprise
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 

caller-voice-qos-profile

To configure the QoS profile to use for media packets sent to the original caller, use the caller-voice-qos-profile command in CAC table configuration mode. To remove this configuration, use the no form of this command.

caller-voice-qos-profile profile-name

no caller-voice-qos-profile

 
Syntax Description

profile-name

Specifies the QoS profile.

The profile-name can have a maximum of 30 characters which can include the underscore character (_) and alphanumeric characters.

Note Except for the underscore character, do not use any special character to specify field names.

 
Command Default

No default behavior or values are available.

 
Command Modes

CAC table configuration (config-sbc-sbe-cacpolicy-cactable)

 
Command History

Release
Modification

Cisco IOS XE Release 2.4

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section shows the hierarchy of modes required to run the command.


NoteThis command can be executed only at the per-call scope. CAC policy does not activate if this command is configured at any other scope. This command can be executed only at the per-call scope. CAC policy does not activate if this command is configured at any other scope.


Examples

The following example shows how to configure calls from the acme account to use the voice QoS profile enterprise for packets sent from the SBC to the original caller:

Router# configure terminal
Router(config)# sbc mySbc
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 1
Router(config-sbc-sbe-cacpolicy)# first-cac-scope call
Router(config-sbc-sbe-cacpolicy)# first-cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# table-type limit src-account
Router(config-sbc-sbe-cacpolicy-cactable)# cac-table MyCacTable
Router(config-sbc-sbe-cacpolicy-cactable)# entry 1
Router(config-sbc-sbe-cacpolicy-cactable-entry)# match-value acme
Router(config-sbc-sbe-cacpolicy-cactable-entry)# caller-voice-qos-profile enterprise
Router(config-sbc-sbe-cacpolicy-cactable-entry)# exit
Router(config-sbc-sbe-cacpolicy-cactable)# exit
Router(config-sbc-sbe-cacpolicy)# exit

 

caller codec

To configure the codec options for a caller, use the caller codec command in the CAC table entry configuration mode. To deconfigure the codec options, use the no form of this command.

caller codec {convert | profile profile-name }

no caller codec {convert | profile }

 
Syntax Description

convert

Enables or disables the codec variant conversion.

profile

Specifies or removes the codec variant profile.

profile-name

The codec variant profile name.

 
Command Default

By default, codec variant conversion is disabled, and no codec variant profile is specified.

 
Command Modes

CAC table entry configuration (config-sbc-sbe-cacpolicy-cactable-entry)

 
Command History

Release
Modification

Cisco IOS XE Release 3.2S

This command was introduced on the Cisco ASR 1000 Series Aggregation Services Routers.

 
Usage Guidelines

To use this command, you must be in the correct configuration mode. The Examples section that follows shows the hierarchy of the modes required to run the command.

Examples

The following example shows how to configure the codec options for a caller using the caller codec command in the CAC table entry mode:

Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# sbc mySBC
Router(config-sbc)# sbe
Router(config-sbc-sbe)# cac-policy-set 2
Router(config-sbc-sbe-cacpolicy)# first-cac-table Transrate
Router(config-sbc-sbe-cacpolicy)# cac-table Transrate