LTE Subscriber Map Configuration Mode Commands

The LTE Subscriber Map Configuration Mode is used to create and manage subscriber maps for applying operator policy templates to individual subscribers and/or groups of subscribers.

Subscriber mappings are ordered lists containing explicit UE matching criteria. The maps are examined for specific UE identity information such as the UE's IMSI. The system uses the first map that matches the criteria to associate an operator policy with the UE.

Subscriber maps can be modified but will only affect future subscribers and not subscribers already attached to UEs.

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)#

Important

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

end

Exits the current configuration mode and returns to the Exec mode.

Product

All

Privilege

Security Administrator, Administrator

Syntax

end

Usage Guidelines

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product

All

Privilege

Security Administrator, Administrator

Syntax

exit

Usage Guidelines

Use this command to return to the parent configuration mode.

precedence

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

Privilege

Administrator

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

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 | imsi mcc  mcc_num mnc  mnc_num [ msin first  start_range last  end_range ] } operator-policy-name  policy_name
For all: 
no precedence  number

no

Removes the selected precedence number definition from the subscriber map.

number

Specifies the order of precedence for the subscriber map. 1 (the lowest number) takes the highest precedence.

In releases prior to 21.8: number must be an integer value from 1 to 1024.

In 21.8 and later releases: number must be an integer value from 1 to 10000.

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

Warning

The use of the range value starting with '0' is inoperable during IMEI retrieval based on operator policy (IMEI-TAC). All attach requests with missing IMEI, selects the "000000" operator policy when configured.

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-plmnid plmn_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