Page 1 of 3

QRU

-MANAGE IP BASED ROUTE IDENTIFIER LIST

Function
Use this command to configure, delete or modify identifier parameters of IP-based route network.

Parameters
action mode : ip_based_route identifier , ip_based_route_name : ip_based_route_bandwidth :
committed_bandwidth : committed_signal_bandwidth : committed_dcn_bandwidth : ifc_option , ifc_ratio :
mux_enable , local_mux_port , remote_mux_port , max_packets , mux_dscp ;
Syntax
QRU:<action mode>:<ip_based_route_id>,<ip_based_route_name>:
[ip_based_route_bandwidth]:[committed_bandwidth]:
[committed_signal_bandwidth]:[committed_dcn_bandwidth]:
[ifc_option],[ifc_ratio]:
[mux_enable],[local_mux_port],[remote_mux_port],
[max_packets],[mux_dscp];

Parameter explanations
action mode
This parameter identifies action mode of network identifier list for IP-based route. There are three action modes.
ADD
DEL
MOD

Add a new IP-based route network into list. For this action mode, IP-based route name is obligatory, but IP-based route id is not.
Delete an existing IP-based route network from list. For this action mode, either IP-based route name or IP-based route id or both
should be specified.
Modify an existing IP-based route network. For this action mode, IP-based route id is obligatory, but IP-based route name is not.

ip_based_route_id
An identifier number of IP-based route network. The available range is from 1 to 4095 in decimal. This parameter value is unique in whole
identifier list. This parameter is obligatory when the action mode is MOD.
ip_based_route_name
The identifier name of IP-based route network. The name can contain the following characters: letters A-Z, a-z, numbers 0-9, dot (.), and
hyphen (-). The maximum length of name is 16 characters. The name is given in quotation marks. This parameter is obligatory when the
action mode is ADD.
ip_based_route_bandwidth
The bandwidth of the IP-based route. The allowed value range is 0Kbps - 1000Mbps, with an increment of 1Kbps. The default value is
0Kbps.
It is a L2 layer bandwidth that is used for IFC. Bandwidth shaping is made based on this parameter.
When the action mode is ADD and Connection Admission Control (CAC) is requested, this parameter is obligatory. This also means that
if any of committed_bandwidth,committed_signal_bandwidth, or committed_dcn_bandwidth is specified in ADD mode,
ip_based_route_bandwidth cannot be skipped.
committed_bandwidth
The committed bandwidth of IP-based route network. This parameter is used for CAC, which means CAC is configured based on this
parameter. The allowed value range is 0Kbps - 1000Mbps, with an increment of 1Kbps. The default value is 0Kbps.
committed_signal_bandwidth
The committed signal bandwidth of IP-based route network. This parameter is excluded from CAC and IFC. The allowed value range is 0kbps
- 50Mbps, with an increment of 1 Kbps. The default value is 0Kbps.
committed_dcn_bandwidth
The committed dcn bandwidth of IP-based route network. This parameter is excluded from CAC and IFC. The allowed value range is 0Kbps 1Mbps, with an increment of 1Kbps. The default value is 0Kbps.
ifc_option
This parameter specifies whether there is internal flow control for the IP-based route. The parameter can have value ON or OFF. The default
value is OFF.
When the action mode is MOD, this parameter cannot be modified.
ifc_ratio
This parameter defines the ratio of Iur_user_traffic_bandwidth to total_user_traffic_bandwidth. The allowed value range is 0 - 100, with an
increment of 1. The default value is 20. This parameter is valid only when the ifc_option parameter is ON.
mux_enable
IP multiplexing option. This parameter defines whether the license based FP small packet multiplexing feature is enabled. The feature can
only be enabled on NPGE(P).
The valid values are ON and OFF, and the default value is OFF.
local_mux_port

http://127.0.0.1:43231/NED/NED?service=printview&library=a25003a0000c0800476p... 8/25/2014

Page 2 of 3

This parameter indicates the local ports for demultiplexing. The value is an integer within the range from 49152 to 65535. The default value
is 65535.
remote_mux_port
This parameter indicates the remote ports for demultiplexing. The value is an integer within the range from 49152 to 65535. The default
value is 65535.
max_packets
This parameter indicates the maximum number of packets that will be multiplexed. The value is an integer within the range from 5 to 30. The
default value is 30.
mux_dscp
This parameter defines the DSCP value of the multiplexed connection. It indicates that only the FP traffic with the specified DSCP value can
be multiplexed. The value is an integer within the range from 0 to 63. The default value is 46.
Parameters mux_enable, local_mux_port, remote_mux_port, max_packets, and mux_dscp are valid in the ADD and
MOD action mode.

Examples
1.

Add a new identifier of IP-based route network into list.

QRU:ADD:2,"CMCC-1":20000:20000:3000:300:ON,80;

2.

Modify the IP multiplexing related values of IP-based route ROUTE2.

QRU:MOD:2,"ROUTE2":1000000:1000000:50000:1000:OFF:ON,50001,50002;

3.

Modify identifier name fto "CMCC-5".

QRU:MOD:2,"CMCC-5";

4.

Modify the committed bandwidth of IP-based route.

QRU:MOD:2,"CMCC-5":20000:10000:3000:300:ON,80;

5.

Modify the IP-based route ifc ratio.

QRU:MOD:2,"CMCC-5":::::ON,75;

6.

Delete the existing identifier of "CMCC-5".

QRU:DEL:,"CMCC-5";

Additional information
The identifier list of IP-based route network can be interrogated using the command QRL. The maximum count of identifier in list is 4095 items.

Execution printouts
The following abbreviations are used in the execution printouts:
SEQ
ID
NAME
ROUTE BW
COMMITTED BW
COMMITTED SIG BW
COMMITTED DCN BW
IFC
RATIO

Sequence number of IP-based route. It shows the IP-based routes in an ascending order.
Identifier ID of IP-based route network.
Identifier name of IP-based route network.
Route bandwidth of IP-based route network.
Committed bandwidth.
Committed signaling bandwidth.
Committed data communication network bandwidth.
Internal Flow Control for User Plane Traffic.
Ratio of lur user traffic bandwidth to total user traffic bandwidth. It's only valid when IFC is on.

The execution printout of command example 1 is as follows:

CONFIGURED IP BASED ROUTE
ROUTE BW

COMMITTED
BW
SEQ ID
NAME
(KBPS)
(KBPS)
---- ---- --------------- ---------- --------1
2 CMCC-1
20000
20000
COMMAND EXECUTED

COMMITTED
SIG BW
(KBPS)
--------3000

COMMITTED
DCN BW
(KBPS)
IFC
--------- --300 ON

RATIO
----80

The execution printout of command example 2 is as follows:

CONFIGURED IP BASED ROUTE
ROUTE BW

COMMITTED COMMITTED COMMITTED

BW
SIG BW
DCN BW
SEQ ID
NAME
(kbps)
(kbps)
(kbps)
(kbps)
MUX
LOCAL MUX REMOTE MUX MAX
ENABLE
PORT
PORT
PACKETS
---- ---- ---------------- --------- --------- --------- --------1
2 ROUTE2
1000000
1000000
50000
1000
ON
50001
50002
30
COMMAND EXECUTED
The execution printout of command example 3 is as follows:

IFC RATIO
DSCP
--OFF
46

----N/A

CONFIGURED IP BASED ROUTE

ROUTE BW
SEQ

ID

NAME

(KBPS)

COMMITTED COMMITTED COMMITTED

BW
SIG BW
DCN BW
(KBPS)
(KBPS)
(KBPS)
IFC

RATIO

http://127.0.0.1:43231/NED/NED?service=printview&library=a25003a0000c0800476p... 8/25/2014

Page 3 of 3

---- ---- --------------- ---------- --------- --------- --------- --1

2 CMCC-5
20000
20000
3000
300 ON
COMMAND EXECUTED

----80

The execution printout of command example 4 is as follows:

CONFIGURED IP BASED ROUTE
ROUTE BW

COMMITTED
BW
SEQ ID
NAME
(KBPS)
(KBPS)
---- ---- --------------- ---------- --------1 2
CMCC-5
20000
10000
COMMAND EXECUTED
The execution printout of command example 5 is as follows:

COMMITTED COMMITTED
SIG BW
DCN BW
(KBPS)
(KBPS)
IFC RATIO
--------- --------- --- ----3000
300
ON
80

ROUTE BW

COMMITTED COMMITTED COMMITTED

BW
SIG BW
DCN BW
SEQ ID
NAME
(KBPS)
(KBPS)
(KBPS)
(KBPS)
IFC RATIO
---- ---- --------------- ---------- --------- --------- --------- --- ----1 2
CMCC-5
20000
10000
3000
300
ON
75
COMMAND EXECUTED
The execution printout of command example 6 is as follows:
DELETED IP BASED ROUTE
ROUTE BW

COMMITTED
BW
SEQ ID
NAME
(KBPS)
(KBPS)
---- ---- --------------- ---------- --------1
2 CMCC-5
20000
10000
COMMAND EXECUTED

COMMITTED
SIG BW
(KBPS)
--------3000

COMMITTED
DCN BW
(KBPS)
IFC
--------- --300
ON

RATIO
----75

Semantic error messages

/*** INVALID IP BASED ROUTE NAME ***/
You have given an incorrect identifier name. Give the route name again so that it meets the requirements specified in Parameter explanation.
/***

IP BASED ROUTE ID IS ILLEGAL ***/

You have given an incorrect IP-based route id. Give the id as a decimal in the range of 1 to 4095.
/***

IP BASED ROUTE NAME IS MISSING ***/

You have not given the parameter IP based route name. Give the route name again so that it meets the requirements specified in
Parameter explanation.
/***

TOO MANY CHARACTERS ***/

You have given an IP-based route network name that is longer than 16 characters.
/*** NUMBER TOO BIG ***/
The value you have given for ip_based_route_bandwidth, committed_bandwidth, committed_signal_bandwidth, or
committed_dcn_bandwidth is too large. Check the allowed value range in the Parameter explanation.
The system may also output a general MML semantic error message.

Execution error messages

/*** SEARCH KEY NOT FOUND ***/
You have given an IP-based route id or name that refers to a non-existing IP-based route network.
/*** IFC METHOD CAN NOT BE MODIFIED ***/
You have tried to modify the IFC method. The IFC method can not be modified after it has been created in IP-based route.
/*** PARAMETER SET IS IN USE ***/
You have tried to delete an IP-based route which is bound to an interface. Check the IP-based route network configuration with QRB and
remove it by QRA.
You may also have tried to create an IP-based route which has a same ID or Name of an existing IP-based route. Check the information by
QRL and change the ID or NAME.
/*** INVALID PARAMETER ***/
You have given a wrong combination of parameters.
Note that when you give bandwidth related parameters, make sure ip_based_route_bandwidth equals to or is larger than
committed_bandwidth, and committed_bandwidth is larger than the sum of committed_signal_bandwidth and
committed_dcn_bandwidth.
/*** IPMUX CAN NOT SET ENABLE WHEN LICENCE IS OFF ***/
You have tried to set the value of IP multiplexing option to ON while the license for feature RAN1886 is not turned on. Turn on the license and
give the command again.
If an error occurs, the system may also outputs a general MML execution error message.

DN0173161

Id: 0900d80580a29403

2013 Nokia Siemens Networks

http://127.0.0.1:43231/NED/NED?service=printview&library=a25003a0000c0800476p... 8/25/2014