Configure Reason and Cause Mapping for SIP-SIP Calls

To configure reason-cause mapping for SIP-SIP calls, you must set up the ACLI local-response-map configuration with appropriate entries to generate the SIP response and the Q.850 cause code value used for particular error scenarios. If you want to add a Reason header, you must enable that capability in the global SIP configuration.

In the following procedure use the method parameter and the register-response-expires parameter to enable a SIP registration response mapping feature that allows you to configure the system to remap a SIP failure response to a 200 OK. The failure response can come from another network device or the system can generate the response locally. You might want the system to perform such mapping when a non-malicious endpoint continually attempts registration, but stops when the system sends a 200 OK. The failure response mapping does not register the client with the system, which leaves neither a registration cache entry nor a CAM ACL for the entry.

For the 200 OK it generates, the system removes any Reason or Retry-After header in the 200 OK and sets the expires time. By default, the expires time is the Retry-After time (if there is one in the response) or the expires value in the Register request (if there is no Retry-After expires time). You can also set this value using the register-response-expires parameter, but the value you set should never exceed the Register request’s expires time.

1. Access the entries configuration element.

   ORACLE# configure terminal
   ORACLE(configure)# session-router
   ORACLE(session-router)# local-response-map
   ORACLE(local-response-map)# local-response-map-entries
   ORACLE(local-response-map-entries)#

2. (Optional) Type ? to see the entire menu for the local response map entries configuration.
3. local-error—Set the local error that triggers the use of this local response map. No default.

   Note:

   The Enterprise and Service Provider systems both display the full list, but some items do not apply to both systems. Such items are noted.
   • invalid-message
   • cpu-overload
   • media-released
   • media-not-allocated
   • enum-void-route
   • monthly-minutes-exceed
   • next-hop-sa-oos
   • recv-sa-exc-constraints
   • recv-sip-int-exc-constraints
   • next-hop-sa-exc-constraints
   • next-hop-sip-int-exc-constraints
   • realm-bw-exc-poly-serv-reject
   • no-steering-pool-ports-available
   • allow-anonymous-rejection
   • sdp-address-mismatch
   • request-method-throttled
   • reg-cache-full
   • per-user-cac-exc-sessions
   • per-user-cac-exc-sessions
   • recv-conditional-cac-reject
   • ldap-unavailable
   • allowed-elements-profile-rejection
   • recording-required
   • hss-lir-timeout—Service Provider only.
   • hss-lir-failure—Service Provider only.
   • licensed-session-capacity-reached
   • fraud-protection-reject-call—Enterprise only.
   • transcoding-licensed-session-capacity-reached—Service Provider only.
   • dsp-resource-limit-reached—Service Provider only.
   • rx-rar-loss-of-bearer—Service Provider only.
   • rx-rar-release-of-bearer—Service Provider only.
   • rx-rar-out-of-credit—Service Provider only.
   • rx-rar-failed-resources-allocation—Service Provider only.
   • rx-asr-bearer-released—Service Provider only.
   • rx-asr-insufficient-server-resources—Service Provider only.
   • rx-asr-insufficient-bearer-resources—Service Provider only.
   • rx-asr-ps-to-cs-handover—Service Provider only.
   • rx-asr-sponsored-data-connectivity-disallowed—Service Provider only.
4. sip-status—Set the SIP response code to use. No default value. Range: 100-699.
5. sip-reason—Set the SIP reason string you want to use for this mapping. No default value. If the value contains spaces between the characters, you must surround the entry with quotation marks.
6. q850-cause—Set the Q.850 cause. No default value.
7. q850-reason—Set the Q.850 reason string that you want to use for this mapping. No default value. If your value has spaces between characters, then your entry must be surrounded by quotation marks.
8. method—Enter the name of the received SIP failure response message you want to map to a 200 OK.
   No default. Leave the parameter empty to turn off the SIP registration response mapping feature.
9. register-response-expires—Enter the time you want to use for the expires time you identified in the method parameter.
   The maximum is 999999999. By default, the expires time is the Retry-After time (if there is one in the response) or the expires value in the Register request (if there is no Retry-After expires time). Any value you configure in this parameter (when not using the defaults) should never exceed the Register request’s expires time.
10. (Optional) Repeat this process to create the number of local response map entries that you need.
11. Save and activate the configuration for changes to take effect.