Академический Документы
Профессиональный Документы
Культура Документы
DN9821507
Issue 3-0
Nokia Siemens Networks is continually striving to reduce the adverse environmental effects of
its products and services. We would like to encourage you as our customers and users to join
us in working towards a cleaner, safer environment. Please recycle product packaging and
follow the recommendations for power use and proper disposal of our products and their components.
If you should have questions regarding our Environmental Policy or any of the environmental
services we offer, please contact us at Nokia Siemens Networks for any additional information.
CA - Attribute-Directed Routing
The information in this document is subject to change without notice and describes only the
product defined in the introduction of this documentation. This documentation is intended for the
use of Nokia Siemens Networks customers only for the purposes of the agreement under which
the document is submitted, and no part of it may be used, reproduced, modified or transmitted
in any form or means without the prior written permission of Nokia Siemens Networks. The
documentation has been prepared to be used by professional and properly trained personnel,
and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes
customer comments as part of the process of continuous development and improvement of the
documentation.
The information or statements given in this documentation concerning the suitability, capacity,
or performance of the mentioned hardware or software products are given "as is" and all liability
arising in connection with such hardware or software products shall be defined conclusively and
finally in a separate agreement between Nokia Siemens Networks and the customer. However,
Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions
contained in the document are adequate and free of material errors and omissions. Nokia
Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which
may not be covered by the document.
Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO
EVENT WILL Nokia Siemens Networks BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED
TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY
OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION
IN IT.
This documentation and the product it describes are considered protected by copyrights and
other intellectual property rights according to the applicable laws.
The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark
of Nokia Corporation. Siemens is a registered trademark of Siemens AG.
Other product names mentioned in this document may be trademarks of their respective
owners, and they are mentioned for identification purposes only.
Copyright Nokia Siemens Networks 2012/1/28. All rights reserved
Id:0900d805802f1171
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
Table of Contents
This document has 21 pages.
Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CA - ATTRIBUTE-DIRECTED ROUTING COMMANDS . . . . . . . . . . . . . 6
CA - ATTRIBUTE-DIRECTED ROUTING COMMANDS . . . . . . . . . . . . . 7
CAV CREATE OR MODIFY PRIMARY ATTRIBUTES . . . . . . . . . . . . . . 8
CAW CREATE OR MODIFY COMBINED ATTRIBUTES . . . . . . . . . . . 15
CAX DELETE PRIMARY OR COMBINED ATTRIBUTES . . . . . . . . . . . 18
CAY INTERROGATE PRIMARY OR COMBINED ATTRIBUTES . . . . . 19
DN9821507
Issue 3-0
Id:0900d805802f1171
CA - Attribute-Directed Routing
Id:0900d805802f1171
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
Summary of changes
Summary of changes
Changes between document issues are cumulative. Therefore, the latest document
issue contains all changes made to previous issues.
Changes made between issues 3 and 2
CAV
CAY
DN9821507
Issue 3-0
Id:0900d805802e0faa
CA - Attribute-Directed Routing
CA - ATTRIBUTE-DIRECTED ROUTING
COMMANDS
You can use the commands in this command group to create, modify, delete and interrogate primary and combined attributes.
The command group menu:
Menu of the
command group:
.....
.....
.....
.....
.....
.....
DISPLAY MENU
CREATE OR MODIFY PRIMARY ATTRIBUTES
CREATE OR MODIFY COMBINED ATTRIBUTES
DELETE PRIMARY OR COMBINED ATTRIBUTES
INTERROGATE PRIMARY OR COMBINED ATTRIBUTES
RETURN TO MAIN LEVEL
Id:0900d8058026eedb
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
CA - ATTRIBUTE-DIRECTED ROUTING
COMMANDS
The commands in this command group are:
DN9821507
Issue 3-0
CAV
CAW
CAX
CAY
Id:0900d805803c259b
CA - Attribute-Directed Routing
Parameters
command mode: attribute name, attribute index, attribute contents type: new attribute
name, negation control, equivalence control, action control, working mode, test switch,
comparison operator: token bank size, passing control, amount (bound rate), time unit
(bound rate): beginning date, beginning time, beginning day of week, ending date,
ending time, ending day of week, day class, duration;
Syntax
CAV:
<command mode>:
Id:0900d805803a3685
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
command mode
Indicates whether the command is used to create or to modify primary attributes:
C
attribute name
ATTN
The first character in the name cannot be a numeral. The maximum length is 12 characters.
There can be more than one attribute with the same name.
If you do not give the name, the MML program will generate a name like P00124. The
numbers refer to the index where the attribute was created.
If the command mode is M (modify), you can give either the name or the index of the
attribute, but not both. If the name is used, it must be unique.
attribute index
ATTR
The index distinguishes the attribute from other attributes. Therefore, the number must
be unique.
attribute contents type
AC
RBTF
Use this parameter when you want to modify the name of the primary attribute.
The first character of the name cannot be a numeral. The maximum length is 12 characters.
There can be more than one attribute with the same name.
negation control
NEG =ON
NEG=OFF
The negation control switches the result of the match operation to the opposite.
equivalence control
DN9821507
Issue 3-0
EQ =T
EQ=F
EQ=E
Id:0900d805803a3685
CA - Attribute-Directed Routing
The equivalence control sets a constant value for the attribute condition. When the
equivalence control is turned off, the attribute condition is always checked in the match
operation.
action control
ACT =STOP
ACT=SKIP
The action control is carried out only if the match result is negative, in other words, if the
call set-up would otherwise be interrupted. In this case, the action control defines the
route selection to be used.
working mode
WMD =O
WMD=M
measurement mode
In the operating mode, the attribute evaluation result is put into effect as normal,
whereas in the measurement mode, the user only gets the normal statistical reports of
what would have happened. No call clearing is carried out in the measurement mode
due to attributes. The traffic counters are updated normally in both modes.
test switch
TEST =OFF
TEST=ON
This function is useful if a new attribute does not seem to work as desired.
comparison operator
CMP =SH
When the comparison operator is used, the evaluating process assumes that the
compared data chunks are of the same type.
token bank size <option>
TB
The token bank size determines the maximum amount of call passing tokens. Give the
value as a non-zero integer. The default value is 40. The minimum size is 1, the
maximum varies.
passing control <option>
PASS =ALL
PASS=NONE
PASS=OFF
amount <option>
BRA
amount
The amount of calls is the first component of the bound rate. The amount is a non-zero
integer. The default value is 10.
You cannot give the amount if parameter PASS has value ALL or NONE.
10
Id:0900d805803a3685
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
The time unit is the second component of the bound rate. The time unit is a non-zero
integer. The default time unit is one second.
You cannot give the time unit if parameter PASS has value ALL or NONE.
beginning date <option>
BDAT
Give the date with hyphens, in the form year-month-day (for example 1999-10-16).
Each element can be forced to have a special value '*', which means that the element
value matches repetitively. When some element has value '*', the elements (units) that
are its multiples must also have value '*'. For example, if day gets value '*', month and
year must also have value '*'. When '*' is given for an element in BDAT, the corresponding element in EDAT must be similarly marked as '*'.
The beginning date must be an earlier date than that given as the ending date. However,
the beginning date can be the same as the ending date, if you define the beginning and
ending time.
beginning time <option>
BTIM
Give the time with hyphens, in the form hour-minute-second (for example 12-00-00).
Any element can be forced to have a special value '*', which means that the element
value matches repetitively. When some element has value '*', the elements (units) that
are its multiples must also have value '*'. For example, if minute gets value '*', then hour,
day, month and year must also have value '*'. Second cannot have value '*'. If parameter
beginning day of week (BDW), ending day of week (EDW) or day class (DAY) is given,
special values '*' cannot be used in any element.
When '*' is given for an element in BTIM, the corresponding element in ETIM must be
similarly marked as '*'.
The beginning time must be an earlier time than that given as the ending time, if the
beginning date and the ending date are the same.
beginning day of week <option>
BDW
The day is one of the following: mon, tue, wed, thu, fri, sat or sun.
The parameter cannot be given if the beginning date (BDAT) is used.
If beginning day of week is used, special values '*' cannot be used in beginning time or
in ending time.
ending date <option>
EDAT
Give the date with hyphens, in the form year-month-day (for example 1999-10-16).
Each element can be forced to have a special value '*', which means that the element
value matches repetitively. When some element has value '*', the elements (units) that
are its multiples must also have value '*'. For example, if day gets value '*', month and
year must also have value '*'. An EDAT element must be marked as '*', if the correspond-
DN9821507
Issue 3-0
Id:0900d805803a3685
11
CA - Attribute-Directed Routing
ing BDAT element has been marked as '*'. However, if '*' is used for an EDAT element
when parameter BDAT has not been given, the corresponding element in BDAT
receives the same value (*) automatically.
The ending date must be a later date than that given as the beginning date. However,
the ending date can be the same as the beginning date, if you define the beginning and
ending time.
ending time <option>
ETIM
Give the time with hyphens, in the form hour-minute-second (for example 12-00-00).
Each element can be forced to have a special value '*', which means that the element
value matches repetitively. When some element has value '*', the elements (units) that
are its multiples must also have value '*'. For example, if minute gets value '*', then hour,
day, month and year must also have value '*'. Second cannot have value '*'. If parameter beginning day of week (BDW), ending day of week (EDW) or day class (DAY) is
given, special values '*' cannot be used in any element.
An ETIM element must be marked as '*', if a corresponding BTIM element has been
marked as '*'. However, if '*' is used for an ETIM element when parameter BTIM has not
been given, the corresponding element in BTIM receives the same value (*) automatically.
The ending time must be a later time than that given as the beginning time, if the beginning date and the ending date are the same.
ending day of week <option>
EDW
that day of the week when the rate-based traffic filtering ends
The day is one of the following: mon, tue, wed, thu, fri, sat or sun.
The parameter cannot be given if the ending date (EDAT) is used.
If ending day of week is used, special values '*' cannot be used in beginning time or in
ending time.
day class <option>
DAY
day class
If the day class is used, special values '*' cannot be used in beginning time or in ending
time. The time cannot be 00-00-00 either. Parameters beginning date, beginning day of
week, ending date, ending day of week and duration cannot be used when DAY is used.
duration <option>
DUR
Parameters ending date, ending time, ending day of week and day class cannot be used
if DUR is used.
If special value '*' is used for any element in BTIM, the duration must be shorter than the
periodically repetitive filtering time achieved with value(s) '*'. For example, if BTIM is *00-00, the periodically repetitive filtering time is one hour and thus duration (DUR) must
be less than 3600 seconds (= 1 hour).
Examples
12
1. Create a primary attribute for rate-based traffic filtering without giving a name. Use
the first available index with default parameter options. The filtering is repetitive
every year on December 24th between 7.00 - 12.00.
Id:0900d805803a3685
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
CAV:C:AC=RBTF:::BDAT=*-12-24,BTIM=07-00-00,EDAT=*-1224,ETIM=12-00-00;
2. Create a primary attribute named RBTF1 for rate-based traffic filtering to the first
available index. The filtering is repetitive every day, excluding 7.00 - 12.00 on
December 24th.
CAV:C:ATTN=RBTF1,AC=RBTF:NEG=ON::BDAT=*-12-24,BTIM=07-0000,EDAT=*-12-24,ETIM=12-00-00;
3. Create a primary attribute for rate-based traffic filtering, named RBTF3, to index 23.
All calls are gapped on December 6th 1997 between 17.00 - 22.00.
CAV:C:ATTN=RBTF3,ATTR=23,AC=RBTF::PASS=NONE:BDAT=1997-1206,BTIM=17-00-00,EDAT=1997-12-06,ETIM=22-00-00;
4. Change rate-based traffic filtering primary attribute named RBTF3 in index 23 to
RBTF4. All calls are gapped on December 6th 1997 between 17.00 - 22.00.
CAV:M:ATTR=23,AC=RBTF:NATTN=RBTF4;
Execution printouts
Semantic error
messages
Combination of duration and special value '*' in BTIM has been used incorrectly.
/*** BOUND RATE TOO HIGH ***/
The bound rate is too high with the values given for the components.
/*** MORE THAN ONE ATTRIBUTE EXISTS WITH THE SAME NAME ***/
/*** USE ATTRIBUTE INDEX INSTEAD ***/
An attempt has been made to modify an attribute by using the name of the attribute, but
the given name is not unique. The attribute must be identified by giving the index number
instead.
/*** COMBINED ATTRIBUTE CANNOT BE MODIFIED WITH V-COMMAND ***/
The command W must be used for modifying combined attributes.
/* NOTICE: NAME ALREADY EXISTS */
DN9821507
Issue 3-0
Id:0900d805803a3685
13
CA - Attribute-Directed Routing
This notice is received when the command is used for creating a primary attribute and
the given name is already in use, but there can be multiple attributes with the same
name.
The system may also output a general MML semantic error message.
Execution error
messages
14
If an error occurs, the system outputs a general MML execution error message.
Id:0900d805803a3685
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
Parameters
command mode: attribute name, attribute index: new attribute name, negation control,
equivalence control, action control, test switch: logical expression;
Syntax
CAW:
<command mode>:
]...:
<logical expression>;
Parameter explanations
command mode
The parameter indicates whether the command is used to create or to modify combined
attributes:
C
attribute name
ATTN
The first character in the name cannot be a numeral. The maximum length is 12 characters.
There can be more than one attribute with the same name.
If you do not give the name, the MML program will generate a name like P00124. The
numbers refer to the index where the attribute was created.
If the command mode is M (modify), you can give either the name or the index of the
attribute, but not both. If the name is used, it must be unique.
attribute index
ATTR
The index distinguishes the attribute from other attributes. Therefore, the number must
be unique.
DN9821507
Issue 3-0
Id:0900d8058031868e
15
CA - Attribute-Directed Routing
Use this parameter when you want to modify the name of the combined attribute.
The first character of the name cannot be a numeral. The maximum length is 12 characters.
There can be more than one attribute with the same name.
negation control
NEG =ON
NEG=OFF
The negation control switches the result of the match operation to the opposite.
equivalence control
EQ =T
EQ=F
EQ=E
The equivalence control sets a constant value for the attribute condition. When equivalence control is turned off, the attribute condition is always checked in the match operation.
action control
ACT =STOP
ACT=SKIP
The action control is carried out only if the match result is negative, in other words, if the
call set-up would otherwise be interrupted. In this case, the action control defines the
route selection to be used.
test switch
TEST =OFF
TEST=ON
This function is useful if a new attribute does not seem to work as desired.
logical expression
The logical expression is given in infix order, using brackets, if necessary. The expression is evaluated according to normal precedence rules.
The logical operators are given in a brief form, with one character, by using their usual
counterparts in mathematical expressions:
+
OR
AND
The index is used to identify the attribute, not the name. The maximum length for logical
expression is 110 characters.
Examples
16
Id:0900d8058031868e
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
Semantic error
messages
DN9821507
Issue 3-0
If an error occurs, the system outputs a general MML execution error message.
Id:0900d8058031868e
17
CA - Attribute-Directed Routing
Parameters
Syntax
Parameter explanations
CAX:
attribute name
ATTN
attribute index
ATTR
Examples
Additional information
Execution printouts
Semantic error
messages
/*** MORE THAN ONE ATTRIBUTE EXISTS WITH THE SAME NAME ***/
/*** USE ATTRIBUTE INDEX INSTEAD ***/
An attempt has been made to delete an attribute by identifying the name of the attribute,
but there is more than one attribute with same name. The attribute must be identified by
giving the index number instead.
The system may also output a general MML semantic error message.
Execution error
messages
18
If an error occurs, the system outputs a general MML execution error message.
Id:0900d805802b9857
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
Parameters
Syntax
CAY:
inquiry mode
P
both (all information about combined attributes and only names and
indexes of primary attributes)
attribute index
ATTR
Examples
CAY:P;
2. Interrogate all combined attributes and display the contents of the primary attributes
in question.
CAY:C;
3. Interrogate all combined attributes.
CAY:B;
4. Interrogate all attributes.
CAY;
Execution printouts
ATTN
RBTF1
ATTN
PRIM10
DN9821507
Issue 3-0
ATTR
2
ATTR
10
EQ
ACT
E
SKIP
BRA
10
BTIM
07-00-00
ETIM
12-00-00
WMD
O
AC
RBTF
TB
EQ
ACT
E
SKIP
BRA
WMD
O
NEQ
OFF
TEST
OFF
BRU
1
BDW
EDW
-
CMP
SH
PASS
OFF
TEST
OFF
BRU
CMP
SH
PASS
Id:0900d805802e172c
DUR
-
DAY
-
19
40
BDAT
EDAT
-
ATTN
PRIM12
ATTN
P00015
ATTR
12
ATTR
15
CA - Attribute-Directed Routing
10
BTIM
07-00-00
ETIM
07-00-00
AC
NEQ
RBTF
ON
TB
40
BDAT
****-12-24
EDAT
****-12-24
EQ
ACT
E
SKIP
BRA
10
BTIM
07-00-00
ETIM
12-00-00
WMD
O
AC
RBTF
TB
40
BDAT
EDAT
-
EQ
ACT
E
STOP
BRA
10
BTIM
07-00-00
ETIM
07-00-00
WMD
O
NEG
ON
1
BDW
FRI
EDW
MON
OFF
TEST
OFF
BRU
1
BDW
EDW
-
CMP
SH
PASS
OFF
TEST
OFF
BRU
1
BDW
FRI
EDW
MON
CMP
SH
PASS
OFF
DUR
-
DUR
-
DUR
-
DAY
-
DAY
-
DAY
-
ATTR
4
NEQ
EQ
ACT
TEST
OFF
E
SKIP
OFF
LOGICAL EXPRESSION
(10+12)*15
ATTN
PRIM10
ATTR
10
AC
RBTF
TB
40
BDAT
EDAT
-
ATTN
PRIM12
20
ATTR
12
NEQ
OFF
AC
NEQ
RBTF
ON
TB
40
BDAT
****-12-24
EDAT
****-12-24
EQ
ACT
E
SKIP
BRA
10
BTIM
07-00-00
ETIM
07-00-00
WMD
O
EQ
ACT
E
SKIP
BRA
10
BTIM
07-00-00
ETIM
12-00-00
WMD
O
Id:0900d805802e172c
TEST
OFF
BRU
1
BDW
FRI
EDW
MON
CMP
SH
PASS
OFF
TEST
OFF
BRU
1
BDW
EDW
-
CMP
SH
PASS
OFF
DUR
-
DUR
-
DAY
-
DAY
-
DN9821507
Issue 3-0
CA - Attribute-Directed Routing
ATTN
P00015
ATTR
15
AC
NEQ
RBTF
ON
TB
40
BDAT
1995-12-12
EDAT
-
EQ
ACT
E
STOP
BRA
10
BTIM
07-00-00
ETIM
-
WMD
O
TEST
OFF
BRU
1
BDW
EDW
-
CMP
SH
PASS
OFF
DUR
3600
DAY
-
ATTR
4
ATTN
PRIM10
PRIM12
P00015
ATTR
10
12
15
ATTR
2
4
10
12
15
TYPE
PRI
COM
PRI
PRI
PRI
Semantic error
messages
If an error occurs, the system outputs a general MML semantic error message.
Execution error
messages
If an error occurs, the system outputs a general MML execution error message.
DN9821507
Issue 3-0
Id:0900d805802e172c
21