Sets the order of
precedence, the matching criteria and the association to an operator policy for
subscribers meeting the match criteria.
Product
MME
SAEGW
SaMOG
S-GW
Mode
Exec > Global
Configuration > LTE Policy Configuration > LTE Subscriber Map
Configuration
configure > lte-policy > subscriber-map
subscriber_map_name
Entering the above
command sequence results in the following prompt:
[local]host_name(subscriber-map)#
Syntax
Syntax Description
For MME:
precedence number match-criteria { all | imei-tac group group_name | imsi mcc mcc_num mnc mnc_num [ msin first start_range last end_range ] | service-plmnid plmnid } operator-policy-name policy_name
For SaMOG:
precedence number match-criteria { all | domain domain_name | imei-tac group group_name | service-plmnid plmid [ ssid ssid ] | ssid ssid | imsi mcc mcc_num mnc mnc_num [ msin first start_range last end_range ] [ service-plmnid plmn_id ] [ ssid ssid ] } operator-policy-name policy_name
For SAEGW and
S-GW:
precedence number match-criteria { all | imei-tac group group_name | imsi mcc mcc_num mnc mnc_num [ msin first start_range last end_range ] | service-plmnid plmnid } operator-policy-name policy_name
For all:
no precedence number
no
Removes the selected
precedence number definition from the subscriber map. number must be an integer value from 1 to 1024.
number
Specifies the order
of precedence for the subscriber map. 1 (the lowest number) takes the highest
precedence.
number must be
an integer value from 1 to 1024.
match-criteria
Specifies that the
keyword following this keyword is the criteria to be used to match a UE.
all
Specifies that all
UEs are to be associated with the operator policy.
imei-tac group
group_name
MME only; releases
18.6 and higher.
Identifies a
previously configured IMEI-TAC group (with
imei-tac-group command LTE-Policy configuration
mode) to associate with this precedence definition. IMEI-TAC groups comprise up
to 500 individual IMEI-TACs and/or up to 20 ranges of IMEI-TAC values. The
IMEI-TAC group contents are used as the selection criteria for the MME to
select/re-select an operator policy based on the UE's unique international
mobile equipment identity - type allocation code (IMEI-TAC).
group_name
must be a string of up to 64 alphanumeric characters.
Beginning with
releases 19.4 and higher, it is possible to configure greater level of
granularity for the IMEI-TAC matching criteria by optionally including, either
singly or in pairs, as part of the command:
-
mcc + mnc
-
imsi
-
service-plmnid
So with release
19.4 the behavior of the syntax has modified slightly so that if
imei-tac-group is the selected matching criteria,
then the command syntax would be similar to:
precedence precedence_value match-criteria imei-tac group group_name [ imsi mcc mcc mnc mnc | msin { first start_msin_value last end_msin_value } ] [ service-plmnid plmn_id] operator-policy policy_name
imsi mcc mcc_num mnc mnc_num [ msin first start_range last end_range | service-plmnid id ]
Specifies that UEs
with criteria matching the International Mobile Subscriber Identifier (IMSI)
information (MCC and MNC) are to be associated with a specified operator
policy.
mcc mcc_num: Specifies the mobile country code (MCC)
portion of the IMSI identifier as an integer value between 100 and 999.
mnc mnc_num: Specifies the mobile network code (MNC)
portion of the IMSI identifier as a 2- or 3-digit integer value between 00 and
999.
msin first start_range last end_range: Optionally specifies a range of Mobile
Subscriber Identification Numbers that further narrows the match criteria for
the IMSI match configuration.
start_range
and
end_range
must each be an integer value of 10 digits.
service-plmnid
plmn_id:
Optionally specifies a local service PLMN ID number used further narrow the
IMSI-based operator policy selection.
plmn_id must
be an integer value of five digits minimum and six digits maximum (the
combination of the MCC and MNC).
service-plmnidplmn_id
Specifies a local
service PLMN ID number used for PLMN ID-based operator policy selection.
id must be an
integer value of five digits minimum and six digits maximum (the combination of
the MCC and MNC).
ssid
id
Specifies a local
SSID used for SSID-based operator policy selection to support the SaMOG Local
Break Out (LBO) feature. The operator policy and associated call control
profile are selected based on the SSID received in the Called-Station-Id
attribute in Access-Request.
id must be an alphanumeric string of 1 through 32
characters.
The SaMOG LBO
feature is license dependant. Contact your Cisco account representative for
more information.
operator-policy-name policy_name
Sets the operator
policy with which the matching criteria is associated. policy_name must be an existing operator policy
expressed as an alphanumeric string of 1 through 64 characters. Operator
policies are configured in the Operator Policy Configuration Mode. For more
information about operator policies, refer to the
Operator
Policy Configuration Mode Commands chapter.
Usage Guidelines
The operator
policy provides mechanisms to fine tune the behavior of subsets of subscribers
above and beyond the behaviors described in the user profile. It is also used
to control the behavior or visiting subscribers in roaming scenarios, enforce
roaming agreements, and provide a measure of local protection against foreign
subscribers.
Examples
The following
command associates the operator policy named
op_pol1 with
UEs associated with an IMSI MCC of
111, an MNC
of
222, and a
service PLMN ID of
123456:
precedence 100 match-criteria imsi mcc 111 mnc 222 service-plmnid 123456 operator-policy-name op_pol1
The following
command gives the match-criteria configuration a precedence of
155 and
instructs the MME to select and apply the
nokia1
operator policy for UEs with IMEI-TAC that matches one of the following
IMEI-TAC:
35850000 or
01124500
precedence 155 match-criteria imei-tac value 35850000 01124500 operator-policy-name nokia1
The following
command identifies this as having the highest precedence and sets the matching
criteria for the operator policy selection to based on IMEI-TAC + MCC-MNC of UE
+ Serving PLMNID:
precedence 1 match-criteria imei-tac-group myGroup imsi mcc 123 mnc 234 service-plmnid 56789 operator-policy-name BESTpol