This object creates a Crankback Profile containing a table of call release codes used by by the
to attempt to reroute (or "crankback") a call when a matching code is returned by Egress Signaling. Release codes may be added or removed from this table. Removing a release code from the table causes the
software to return that release code to Ingress Signaling rather than attempt to reroute the call.
You can configure up to 20 Crankback Profiles (including default profile). As profiles are created, they are assigned indexes 2, 3, 4, and so on by the
(index 1 is reserved for default profile). Index assignments are viewable using the
show command.
Use the crankback index number to assign a particular Crankback Profile to a particular SIP, or H.323 trunk group for ingress signaling.
This object influences rerouting policy for SIP 3xx Redirection processing if the IP Profile is configured to use the Crankback Profile. For example, when a SIP 3xx Redirect is initiated and a SIP INVITE message is issued, if a disconnect release code is returned in the SIP response, the Crankback Profile is examined for a matching code. If a matching code is found and at least one more SIP redirect destination is present, a SIP INVITE is issued to that destination.
This scenario is repeated up to ten times, after which additional SIP redirect destinations are disregarded as if not present. However, only four Contact headers in a redirect are accepted and processed. If more than four Contact headers are sent, they are ignored.
If a matching code is found but no additional SIP redirect destination is present, the SIP redirect is terminated with that code. If no matching code is found in the Crankback Profile, then the SIP redirect is terminated with that (unmatched) code.
Command Syntax
| Code Block |
|---|
|
% set profiles callRouting crankbackProfile <profile_name>
attemptRecordGeneration <disabled | enabled>
lateCrankback <disabled | enabled>
reason <reason code, 1-255>
location <location type>
useLocationValue <disabled | enabled> |
Command Parameters
The Crankback Profile Parameters are as shown below:
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Command Parameters |
|---|
|
Parameter | Length/Range | Description |
|---|
crankbackProfile
| 1-23 | The name of the Crankback Profile. | attemptRecordGeneration
| N/A | Enable this flag to log ATTEMPT record in accounting file after each crankback. disabled (default)enabled
| lateCrankback
| N/A | Enable flag to allow crankback after an ALERTING, PROCEEDING, or equivalent backwards call message is received from egress network. disabled (default)enabled
| reason
| 1-255 | Call termination reason code value, plus associated location
(see Refer to Call Termination Reason Codes page for call termination reason codes list). <reason_code>locationgwLinkFailure – Allows the GW-GW signaling link (TCP connection) failure to initiate call crankback. To crankback for GW-GW link failures only, set useLocationValue to enabled, reason code to 3, and Location value to gwLinkFailure.internationalNet – internationalNet – International network.natReserved6 – – Reserved
natReserved12 – – Reserved
netBeyondInterPoint – – Network beyond interworking point (BI).
privateLocal – – Private network serving the local user (LPN).
privateRemote – – Private network serving the remote user (RPN).
publicLocal – – Public network serving the local user (LN).
publicRemote – – Public network serving the remote user (RLN).
transitNet – – Transit network (TN)
user
useLocationValue – Enable flag to use Location table values for this reason code while cranking back on the next route.disabled (default)enabled
|
|
Command Example
| Code Block |
|---|
|
% set profiles callRouting crankbackProfile CB_CUSTOM attemptRecordGeneration enabled lateCrankback enabled reason 10 location publicLocal
% set profiles callRouting crankbackProfile CB_CUSTOM reason 11 location internationalNet
% commit
% show profiles callRouting crankbackProfile CB_CUSTOM
lateCrankback enabled;
attemptRecordGeneration enabled;
reason 10 {
location publicLocal;
}
reason 11 {
location internationalNet;
} |
| Info |
|---|
| title | Notes on Using Crankback for DNS |
|---|
|
- dnsCrankback needs to be enabled on the egress sipTrunkGroup.
- The crankbackProfile assigned to the egress sipTrunkGroup is used for DNS crankback.
- The SBC maps the received SIP response from the egress call leg using the sipToCpcCauseMapProfile from the egress sipTrunkGroup. The CPC cause is then looked up in the egress sipTrunkGroup's crankbackProfile.
- If a match is found, the SBC attempts a new target.
- If a match is not found, SBC skips the DNS crankback and proceeds with the normal crankback at CC level using the ingress sipTrunkGroup's crankback profile
|