ip-outbound-manipulation

This command configures the Outbound Manipulations table, which lets you define IP-to-IP Outbound Manipulation rules. An Outbound Manipulation rule defines a manipulation action for the SIP Request-URI user part (source or destination) or calling name of outbound SIP dialog requests.

Syntax

(config-voip)# sbc manipulation ip-outbound-manipulation <Index>
(ip-outbound-manipulation-<Index>)#

Command

Description

Index

Defines the table row index.

calling-name-pattern

Defines the prefix of the calling name (caller ID). The calling name appears in the SIP From header.

dest-tags

Assigns a prefix tag to denote destination URI user names corresponding to the tag configured in the associated Dial Plan.

dst-host

Defines the destination SIP URI host name - full name, typically located in the Request-URI and To headers.

dst-ip-group-name

Defines the IP Group to where the INVITE is to be sent.

dst-user-name-pattern

Defines the prefix of the destination SIP URI user name, typically located in the Request-URI and To headers.

is-additional-manipulation {disable|yes}

Determines whether additional manipulation is done for the table entry rule listed directly above it.

leave-from-right

Defines the number of digits to keep from the right of the manipulated item.

manipulated-uri {destination|source}

Defines the element in the SIP message that you want manipulated.

manipulation-name

Defines a descriptive name, which is used when associating the row in other tables.

message-condition-name

Assigns a Message Condition rule as a matching characteristic. Message Condition rules define required SIP message formats.

prefix-to-add

Defines the number or string to add in the front of the manipulated item.

privacy-restriction-mode {dont-change-privacy|remove-restriction|restrict|transparent}

Defines user privacy handling (i.e., restricting source user identity in outgoing SIP dialogs).

re-route-ip-group-name

Defines the IP Group that initiated (sent) the SIP redirect response (e.g., 3xx) or REFER message.

remove-from-left

Defines the number of digits to remove from the left of the manipulated item prefix.

remove-from-right

Defines the number of digits to remove from the right of the manipulated item prefix.

request-type {all|invite|invite-and-register|invite-and-subscribe|register|subscribe}

Defines the SIP request type to which the manipulation rule is applied.

routing-policy-name

Assigns a Routing Policy to the rule.

src-host

Defines the source SIP URI host name - full name, typically in the From header.

src-ip-group-name

Defines the IP Group from where the INVITE is received.

src-tags

Assigns a prefix tag to denote source URI user names corresponding to the tag configured in the associated Dial Plan.

src-user-name-pattern

Defines the prefix of the source SIP URI user name, typically used in the SIP From header.

suffix-to-add

Defines the number or string to add at the end of the manipulated item.

trigger {3xx|3xx-or-refer|any|initial-only|refer}

Defines the reason (i.e., trigger) for the re-routing of the SIP request.

Command Mode

Privileged User

Example

This example configures an Outbound Manipulation rule that removes two digits from the right of the destination URI if the calling name prefix is "WEI":

(config-voip)# sbc manipulation ip-outbound-manipulation 0
(ip-outbound-manipulation-0)# manipulation-name ITSP-OOUTMAN
(ip-outbound-manipulation-0)# calling-name-pattern WEI
(ip-outbound-manipulation-0)# manipulated-uri destination
(ip-outbound-manipulation-0)# remove-from-right 2
(ip-outbound-manipulation-0)# activate