The Following modules must be loaded before this module:

This modules requires the internal IMS library.

This is the name of the Diameter realm of the Diameter server (typically a PCRF).

Default value is 'ims.smilecoms.com'.

...
modparam("ims_qos", "rx_dest_realm", "ims.smilecoms.com")
...

FQDN of the Diameter server (typically a PCRF) to communicate with. If not set then realm routing is used. If you use this, the routing defined in your diameter xml configuration file (CDP) will be ignored and as a result you will lose the benefits of load balancing and failover.

Default value is ''.

...
modparam("ims_qos", "rx_forced_peer", "pcrf.ims.smilecoms.com")
...

This is the expiry length in seconds of the initiated Diameter sessions.

Default value is 7200.

...
modparam("ims_qos", "rx_auth_expiry", 14400)
...

This is a flag to determine whether or slow CDP responses should be reported in the log file. 1 is enabled and 0 is disabled.

Default value is 1.

...
modparam("ims_qos", "cdp_event_latency", 1)
...

This time in milliseconds is the limit we should report a CDP response as slow. i.e. if a CDP response exceeds this limit it will be reported in the log file. This is only relevant is cdp_event_latency is enabled (set to 0).

Default value is 500.

...
modparam("ims_qos", "cdp_event_threshold", 500)
...

This time log level at which we should report slow CDP responses. 0 is ERROR, 1 is WARN, 2 is INFO and 3 is DEBUG. This is only relevant is cdp_event_latency is enabled (set to 0)

Default value is 0.

...
modparam("ims_qos", "cdp_event_latency_log", 1)
...

This is a flag that specifies whether or not to authorize video flows. 1 means video flows will be authorized over Rx and 0 means video flows will not be authorized over Rx

Default value is 1.

...
modparam("ims_qos", "authorize_video_flow", 0)
...

This is a threshold on the size of the cdp event list. Once the queue exceeds this length a warning is logged. 0 disables this feature

Default value is 0.

...
modparam("ims_qos", "cdp_event_list_size_threshold", 10)
...

This parameters defines the default bandwidth for Audio, if no "b=AS"-Parameter is found in the SDP.

Default value is 64 (64 kBit)

...
modparam("ims_qos", "audio_default_bandwidth", 32)
...

This parameters defines the default bandwidth for Video, if no "b=AS"-Parameter is found in the SDP.

Default value is 128 (128 kBit)

...
modparam("ims_qos", "video_default_bandwidth", 256)
...

This sets the default Reason, when a call is terminated in early stage due to QoS-failure.

Default value is "QoS released", an call in early stage would be released with "488 QoS released".

...
modparam("ims_qos", "early_qosrelease_reason", "Sorry - QoS failed")
...

These headers are added to the BYE-Message, when an confirmed call is terminated due to a QoS failure.

Default value is "", no Extra-Headers

The headers must end with CRLF.

...
modparam("ims_qos", "confirmed_qosrelease_headers", "X-Reason: QoS failed\r\n")
...

The flow-description AVP is typically populated using IP:port information present in the SDP. Certain (buggy) UEs can change ports midway during calls which causes the flow-description to no longer match the traffic. This parameter allows the flow-description AVP to use to the any keyword instead of certain IP:port combinations in the SDP. The parameter is a regex that if set adds an extra filter for all IPs that do not match the regex with the any keyword in the flow-description AVP

Default value is "", no extra filters added

...
modparam("ims_qos", "regex_sdp_ip_prefix_to_maintain_in_fd", "10.21.0.1")
...

If set then active dialogs associated with an Rx session are torn down in the Rx session fails

Default value is 1, dialogs are torn down

...
modparam("ims_qos", "terminate_dialog_on_rx_failure", 0)
...

If set then contacts associated with signalling Rx sessions are deleted if the Rx session fails

Default value is 1, contacts are deleted

...
modparam("ims_qos", "delete_contact_on_rx_failure", 0)
...

If set then a flow description is added for media flows - next available odd port is used as the default for RTCP traffic

Default value is 0, RTCP flow description not added

...
modparam("ims_qos", "include_rtcp_fd", 1)
...

Perform a AAR on Diameter RX interface to subscribe to signalling status. This purpose of this is tell a Diameter server (typically a PCRF) to inform the requesting Diameter client on changes to the status of signalling bearer for the same framed IP address. For more details see 3GGP TS 29.214.

Meaning of the parameters is as follows:

Return codes:

This function can be used from REQUEST_ROUTE.

p.s. this is executed asynchronously. See example on how to retrieve return value

...
if(Rx_AAR_Register("REG_AAR_REPLY","location")==0){
    exit;
}
...
route[REG_AAR_REPLY]
{
    switch ($avp(s:aar_return_code)) {
        case 1:
            xlog("L_DBG", "Diameter: AAR success on subscription to signalling\n");
            break;
        default:
            xlog("L_ERR", "Diameter: AAR failed on subscription to signalling\n");
            t_reply("403", "Can't register to QoS for signalling");
            exit;
    }
...

Perform a AAR on Diameter RX interface to request resource authorisation from a Diameter server (typically a PCRF). For more details see 3GGP TS 29.214.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE or ONREPLY_ROUTE.

p.s. this is executed asynchronously. See example on how to retrieve return value

...
if(Rx_AAR("ORIG_SESSION_AAR_REPLY","orig","",-1)==0){
    exit;
}
...
route[ORIGN_SESSION_AAR_REPLY]
{
    if ($avp(s:aar_return_code) != 1) {
        xlog("L_ERR", "IMS: AAR failed Orig\n");
        dlg_terminate("all", "Sorry no QoS available");
    } else {
        xlog("L_DBG", "Diameter: Orig AAR success on media authorization\n");
    } 
}
...

The number of timeouts on sending a AAR. i.e. no response to AAR.

The average response time in milliseconds for AAR-AAA transaction.