4.64 chg-gsmopts

Use this command to enter GSM (Global System for Mobile Telecommunications) system options in the database. This command updates the GSMOPTS Table.

Parameters

Note:

See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.

Note:

The options for the on, off, maplyrrtgon, and maplyrrtgoff parameters are described in the Notes section.
ccnc (optional)
E214 country code and network code.
Range:
2-8 digits
Default:
No change to the current value
crptt (optional)
Circular Route Prevention Translation Type.
Range:
0 - 255, none
System Default:
none
defmapvr (optional)
Default MAP version.
Range:
1 - 3
Default:
No change to the current value
System Default:
1
defmcc (optional)
E212 default mobile country code.
Range:
3 digits, none

Valid digits are 0-9, a-f, A-F

none —Deletes the current value for the defmcc parameter

Default:
No change to the current value
System Default:
none
defmnc (optional)
E212 default mobile network code.
Range:
1-4 digits, none

Valid digits are 0-9, a-f, A-F.

none —Deletes the current value for the defmnc parameter

Default:
No change to the current value
System Default:
none
dfltrn (optional)
Default routing number. The digits to use as the routing number portion of the msrndig parameter when an SRI is processed by the SRI Query for Prepaid feature, an RTDB match is found for an own-network subscriber, and Service Portability is not applied.
Range:
1-15 digits, none
Default:
No change to the current value
System Default:
none
eirdfltimsilkup (optional)
Equipment Identity Register (EIR) default IMSI lookup status. This parameter specifies the order of the IMEI table lookup for default IMSI screening. This parameter is analogous to the P1 parameter in the IMSIPFX CSL list but is used only when there is no matching IMSI prefix in the IMSIPFX CSL.
Range:
both
Perform lookup on Individual IMEI table first & if not found then lookup Range IMEI table
individual
Perform lookup on Individual IMEI table only
none
Don't perform any lookup. Just return the default IMEI status.
range
Perform lookup on Range IMEI table only
Default:
No change to the current value.
System Default:
range
eirdfltimsiresp (optional)

Equipment Identity Register (EIR) default IMSI response. This parameter specifies the default IMEI status for default IMSI screening. This parameter is analogous to the P2 parameter in the IMSIPFX CSL list but is used only when there is no matching IMSI prefix in the IMSIPFX CSL.

Range:
blacklist
The IMEI is "invalid". Registration should not be allowed for this handset
graylist
The IMEI is "questionable."
unknown
The IMEI is not in the White, Gray, or Black list. Registration should not be allowed for this handset.+
whitelist
The IMEI is "valid". Registration should be allowed for the handset.
Default:
No change to the current value.
System Default:
whitelist
eirgrsp (optional)
Equipment Identity Register (EIR) Global Response status.
Range:
off
EIR Global Response is not used
whitelst
The IMEI is “valid”. Registration should be allowed for the handset.
graylst
The IMEI is “questionable.” Registration should be allowed, but the event is logged in the EIR log and a special measurement peg is incremented.
blklst
The IMEI is “invalid”. Registration should not be allowed for this handset.
unknown
The IMEI is not in the White, Gray, or Black list. Registration should not be allowed for this handset.
Default:
No change to the current value
System Default:
off
eirimsichk (optional)
Equipment Identity Register (EIR) IMSI Check status. This parameter is not valid for IMEI ranges.
Range:
on
off
Default:
No change to the current value
System Default:
off
eirrsptype (optional)
Equipment Identity Register (EIR) Response Type.
Range:
type1
type2
type3
Table 4-6 contains information to help select the value for this parameter.

Table 4-6 EIR Response Type Values

Presence in List EIR Response Type
White Gray Black Type 1 Type 2 Type 3
X     white list white list white list
X X   gray list gray list gray list
X X X black list black list black list
X   X black list black list black list
  X   gray list gray list unknown
  X X black list black list unknown
    X black list black list unknown
      white list* unknown* unknown*

*Indicates no match was found for the IMEI in an incoming message within the database.

Default:
No change to the current value
System Default:
type1
gflexmaplayerrtg (optional)
G-Flex MAP layer routing. The message parameter used in the database lookup performed during G-Flex MAP layer routing.

The gflexmaplayerrtg parameter applies G-Flex MLR to the following MAP operations:

  • updateLocation
  • sendParameters
  • sendAuthenticationInfo
  • updateGPRSLocation
  • AnyTimeInterrogation

Use the maplyrrtgon and maplyrrtgoff parameters to apply G-Flex MLR to additional MAP operations.

Range:
imsi
use the IMSI parameter for database lookup
none
MLR is not performed
msisdn
use the MSISDN parameter for database lookup
all
use the IMSI or MSISDN parameter for database lookup based on the operation code of the message
Default:
No change to the current value
System Default:
none
gsm2is41 (optional)
GSM to IS41 migration prefix.
Range:
1-15 digits, none

Valid digits are 0-9, a-f, A-F

none —Deletes the current value of the gsm2is41 parameter.

Default:
No change to the current value
System Default:
none
is412gsm (optional)
IS41 to GSM migration prefix.
Range:
1-15 digits, none

Valid digits are 0-9, a-f, A-F

none —Deletes the current value of the is412gsm parameter.

Default:
No change to the current value
System Default:
none
maplyrrtgoff (optional)

MAP Layer Routing Off. This parameter turns off G-Flex MLR for a comma-separated list of MAP operations. Up to 10 operations can be specified in the list.

Range:
regss, actss, dactss, intss, authfailrpt, rstdata, procunstrqt, rdyforsm, purgmobss, sriloc, all

all —Turns off G-Flex MLR for all MAP operations supported by the maplyrrtgoff parameter.

Note:

If the all MAP operation is specified, then no other MAP operations can be specified in the same command. 
Default:
No change to the current value
maplyrrtgon (optional)
MAP Layer Routing On. This parameter turns on G-Flex MLR for a comma-separated list of MAP operations. Up to 10 operations can be specified in the list. 
Range:
regss, actss, dactss, intss, authfailrpt, rstdata, procunstrqt, rdyforsm, purgmobss, sriloc, all
all —Turns on G-Flex MLR for all MAP operations supported by the maplyrrtgon  parameter.

Note:

If the all MAP operation is specified, then no other MAP operations can be specified in the same command.
Default:
No change to the current value
mccmnc (optional)
E212 mobile country code and mobile network code.
Range:
4-7 digits, none

Valid digits are 0-9, a-f, A-F.

none —Deletes the current mccmnc and ccnc parameter combination entry.

Default:
No change to current value
migrpfx (optional)
Migration prefix. This parameter specifies whether the database routing number (RN) or the GSM to IS-41 Migration prefix is used as the source for the prefix in the SRI Ack response message for a migrated subscriber.
Range:
single
The RN from the RTDB lookup is not used as the prefix in the SRI Ack. If the  gsm2is41 parameter has a value other than none, then that value is used as the prefix in the SRI Ack Response.
multiple
The RN from the database lookup is used as the prefix in the SRI Ack response.
Default:
No change to the current value
System Default:
single
A value of single is the system default value for a new system, or for a system that upgraded to 36.0 without the IGM feature being turned on. If the IGM feature was turned on before upgrade to 36.0, then a value of multiple is hardcoded as the system default value.
msisdntrunc (optional)
MS ISDN truncation digits. The number of digits to delete from the beginning of the National MSISDN (MSISDN without Country Code) before formulating the MSRN parameter of the SRI Ack response.
Range:
0 - 5
Default:
No change to current value
System Default:
0
msrndig (optional)
The routing number to be used as is or concatenated with the MSISDN.
Range:
rn
Routing number
rndn
Routing number prefix and the international DN (dialed/directory number)
ccrndn
Country code, routing number, and national directory number
rnccdn
Routing number, country code and directory number
rnasd
Routing number and additional subscriber data
asdrn
Additional subscriber data and routing number
rnasddn
Routing number, additional subscriber data, and directory number
asdrndn
Additional subscriber data, routing number, and directory number
ccrnasddn
Country code, routing number, additional subscriber data, and directory number
ccasdrndn
Country code, additional subscriber data, routing number and directory number
rnasdccdn
Routing number, additional subscriber data, country code, and directory number
asdrnccdn
Additional subscriber data, routing number, country code, and directory number
rngrn
Routing number and generic routing number
grnrn
Generic routing number and routing number
rngrndn
Routing number, generic routing number, and directory number
grnrndn
Generic routing number, routing number, and directory number
ccrngrndn
Country code, routing number, generic routing number, and directory number
ccgrnrndn
Country code, generic routing number, routing number, and directory number
rngrnccdn
Routing number, generic routing number, country code, and directory number
grnrnccdn
Generic routing number, routing number, country code, and directory number
Default:
No change to the current value
System Default:
rn
msrnlen (optional)
The number of digits in the MAP Routing Info portion of the returned SRI_ACK message.
Range:
1 - 30
Default:
No change to the current value
System Default:
30
msrnnai (optional)
The nature of address indicator value for the MSRN.
Range:
0 - 7
0
Unknown Nature of Address
1
International Number
2
National Significant Number
3
Network Specific Number
4
Subscriber Number
5
Reserved for national use
6
Abbreviated Number
7
Reserved for extension
Default:
No change to current value
msrnnp (optional)
The numbering plan value for the MSRN.

Note:

This parameter is mandatory if the msrnnai parameter is specified.
Range:
0 - 15
Default:
No change to current value
multcc (optional)
Multiple country code.
Range:
1-3 digits

Valid digits are 0-9, a-f, A-F

Default:
No change to current value
nmultcc (optional)
New multiple country code.
Range:
1-3 digits, none

Valid digits are 0-9, a-f, A-F.

none —Deletes the specified multcc value from the multiple country code list.

Default:
No change to current value
off (optional)
This parameter turns off the specified options. Up to 8 comma-separated unique options can be specified.
Range:
eirdfltimsiscrn
eirimsichk
eirimsiscrn
eirlogwl
encdnpsdnnotfound
encdnpsptnone
encodecug
encodenps
srismgttrtg
on (optional)
This parameter turns on the specified options. Up to 8 comma-separated unique options can be specified.
Range:
eirdfltimsiscrn
eirimsichk
eirimsiscrn
eirlogwl
encdnpsdnnotfound
encdnpsptnone
encodecug
encodenps
srismgttrtg
serverpfx (optional)
Server SRI prefix.
Range:
1-4 digits, none

Valid digits are 0-9, a-f, A-F

none —No Server SRI prefix is provisioned

Default:
No change to current value
System Default:
none
sporttype (optional)
Service Portability type. This parameter specifies whether Service Portability applies to SRI Query for Prepaid messages for own-network subscribers.

Note:

If Service Portability is performed, then the Service Portability prefix (RTDB ‘GRN’entity id) is applied.

Note:

The S-Port feature must be turned on before any change to the parameter will impact the G-Port SRI Query for Prepaid feature.
Range:
gsm
Apply Service Portability prefix for own-network GSM subscribers
is41
Apply Service Portability prefix for own-network IS41 subscribers
all
Apply Service Portability prefix for all own-network (IS41 and GSM) subscribers
none
Service Portability is not performed for this feature
Default:
No change to the current value
System Default:
none
srfaddr (optional)
Entity address of the MNP_SRF node.
Range:
1-15 digits, none

Valid digits are 0-9, a-f, A-F

none —Deletes the current value for the srfaddr parameter.

Default:
No change to current value
System Default:
none
srfnai (optional)
The nature of address indicator value of the MNP_SRF.
Range:
0 - 127
Default:
No change to current value
srfnp (optional)
The numbering plan value of the MNP_SRF.
Range:
0 - 15
Default:
No change to current value
sridn (optional)
The Send Routing Information Dialed Number location.
Range:
tcap
sccp
Default:
No change to current value
System Default:
tcap
sridnnotfound (optional)
The processing used when G-Port encounters an RTDB query result that indicates that the specified directory number is not known.
Range:
gtt
GTT is performed on the message for routing to an HLR
srinack
an SRI negative acknowledgement is generated and returned to the calling party
Default:
No change to the current value
System Default:
gtt
srirdctent (optional)
This indicates whether existing SRI REDIRECT feature (SP) or Intra Network Number Portability feature (GRN) is to be used.
Range:
grn
Vendor type of GRN should be considered to be matched against Vendor type of CGPA GTA.
sp
Vendor type of SP should be considered to be matched against Vendor type of CGPA GTA.
Default:
No change to the current value
System Default:
sp
ownnetworksetname (optional)
This indicates the GTTSet (of Set Type CDGTA) to be used to screen and determine if the GT belongs to own network or not.
Range:
ayyyyyyyy, none
Valid characters are 1 alphabetic character followed by up to 8 alphanumeric characters.
Default:
No change to the current value
System Default:
none

Example

chg-gsmopts:msisdntrunc=1:srfaddr=123456789abcdef:srfnai=0:srfnp=0

chg-gsmopts:msrnnai=1:msrnnp=1:msrndig=ccrndn:defmapvr=2

chg-gsmopts:sridn=sccp

chg-gsmopts:is412gsm=1234:gsm2is41=1234

chg-gsmopts:serverpfx=1000

chg-gsmopts:multcc=011

chg-gsmopts:multcc=011:nmultcc=11

chg-gsmopts:ccnc=33322123:mccmnc=21434

chg-gsmopts:eirimsichk=on:eirrsptype=type2:eirgrsp=blklst

chg-gsmopts:migrpfx=multiple

chg-gsmopts:sridnnotfound=srinack

chg-gsmopts:defmcc=214:defmnc=34

chg-gsmopts:msrndig=rnasd

chg-gsmopts:on=eirimsichk,eirimsiscrn,eirlogwl,eirdfltimsiscrn:eirrsptype=type2:

eirgrsp=blklst

chg-gsmopts:on=encodecug,encodenps,srismgrnrtg:off=eirimsichk,eirimsiscrn,eirlogwl,

eirdfltimsiscrn:crptt=50

chg-gsmopts:on=encdnpsptnone,encdnpsdnnotfound

chg-gsmopts:maplyrrtgon=regss,actss,sriloc:maplyrrtgoff=dactss,rstdata

chg-gsmopts:eirdfltimsilkup=range

chg-gsmopts:eirdfltimsiresp=whitelist

chg-gsmopts:srirdctent=grn

chg-gsmopts:ownnetworksetname=cdgta1

Dependencies

At least one parameter must be specified.

The G-Flex feature must be turned on before the defmnc, ccnc, or mccmnc parameter can be specified.

The G-Port or IGM feature must be enabled before the srfaddr, msrndig, msrnnai, sridn,  msisdntrunc, migrpfx, gsm2is41, or serverpfx parameter can be specified and before a value of  encodecug, encodenps, srismgttrtg, encdnpsptnone, or encdnpsdnnotfound can be specified for the on or off parameter.

An is412gsm parameter value must exist in the database before the serverpfx parameter can be specified.

The serverpfx=none parameter must be specified before the is412gsm=none parameter can be specified.

The EIR feature must be turned on before the eirgrsp, eirrstype, eirimsichk, eirdfltimsilkup, or eirdfltimsiresp parameters can be specified and before the eirimsichk, eirimsiscrn, eirlogwl or eirdfltimsiscrn options can be specified for the on or off parameter.

The ccnc and mccmnc parameter values must be specified together in the command.

A maximum of 10 ccnc records can exist in the database.

The value specified for the ccnc parameter cannot already exist in the database unless the mccmnc=none parameter is specified.

The srfaddr, srfnai, and srfnp parameters must be specified together in the command.

The msrnnai and msrnnp parameters must be specified together in the command.

The value specified for the ccnc parameter must already exist in the database if the mccmnc=none parameter is specified.

A maximum of 10 entries can be defined in the multiple country code list (in addition to the STP options defcc value).

A multiple country code cannot be entered when the STP options defcc value is none. A defcc value must first be defined before the first multiple country code can be entered. See the chg-stpopts command.

The value specified for the nmultcc parameter cannot already exist in the multiple country code list.

If the multcc and nmultcc parameters are specified to change the multcc value to the nmultcc value, then the multcc value must already exist in the multiple country code list.

The specified multcc and nmultcc values cannot already be defined as the STP options defcc parameter value.

The STP Options table is corrupt or cannot be found.

The IGM feature must be enabled before the is412gsm, gsm2is41, or migrpfx parameter can be specified.

The G-Port, IGM, MO SMS ASD, MO SMS B-Party Routing, MO SMS GRN, MO SMS IS41-to-GSM Migration, MO-based GSM SMS NP, or Prepaid SMS Intercept Ph1 feature must be enabled, or the G-Flex, EIR, or V-Flex feature must be turned on before this command can be entered.

The G-Port or IGM feature must be enabled or the V-Flex feature must be turned on before the  multcc and nmultcc parameters can be specified.

The G-Flex MAP Layer Routing feature must be enabled and turned on before the gflexmaplayerrtg, maplyrrtgon, or maplyrrtgoff  parameter can be specified.

The G-Flex or G-Port feature must be turned on or the MT-Based GSM SMS NP or IGM feature must be enabled before the defm or cc parameter can be specified.

If the MT-Based GSM SMS NP feature is turned on, then the defmcc=none parameter cannot be specified.

The nmultcc and multcc parameters must be specified together in the command.

If the multcc parameter is specified to enter a new value in the multiple country list, then the specified value cannot already exist in the list.

The IGM or MO SMS IS41-to-GSM Migration feature must be enabled before the is412gsm parameter can be specified.

The G-Port feature must be enabled before the sridnnotfound parameter can be specified.

The G-Port feature must be turned on before the migrpfx=multiple  parameter can be specified.

The EGLEOPTS table is corrupt or cannot be found.

The G-Port, IGM, MO SMS ASD, MO SMS B-Party Routing, MO SMS GRN, MO-based GSM SMS NP, or Prepaid SMS Intercept Ph1 feature must be enabled before the defmapvr parameter can be specified. 

The G-Port SRI Query for Prepaid feature must be enabled before the dfltrn parameter can be specified.

The S-Port and G-Port SRI Query for Prepaid features must be enabled before the sporttype parameter can be specified.

The G-Flex feature must be turned on or the G-Port or IGM feature must be enabled before the ccnc and mccmnc parameters can be specified.

The G-Flex feature must be turned on or the G-Port or IGM feature must be enabled before the ccnc and mccmnc parameters can be specified.

The MNP Circular Route Prevention feature must be turned on before the crptt parameter can be specified.

The eirimsichk parameter and the on or off parameter cannot be specified together in the command.

The same value cannot be specified for the on and off parameters.

The same MAP operation cannot be specified by the maplyrrtgon and maplyrrtgoff parameters in the same command.

If the all MAP operation is specified for the maplyrrtgon or maplyrrtgoff parameter, then no other operation can be specified for these parameters in the same command.

If the maplyrrtgon=all parameter is specified, then the  maplyrrtgoff  parameter cannot be specified in the same command.

If the maplyrrtgoff=all parameter is specified, then the  maplyrrtgon parameter cannot be specified in the same command.

The GSM MAP SRI Redirect feature must be enabled before the srirdctent parameter can be set to grn or sp.

Notes

The sridn parameter can be used with the G-Port feature only or with the G-Port feature and the MNP Circular Route Prevention feature. Refer to G-Port User's Guide for more information.

If the IGM feature was turned on prior to upgrade to Release 36.0, then the migration prefix is hard-coded to a value of multiple. After upgrade, if the chg-gsmopts:migrpfx=single command is used to change the migration prefix to single, then the G-Port feature must be turned on before the migration prefix can be changed back to multiple (chg-gsmopts:migrpfx=multiple).

In 39.2.4, the gflexmaplayerrtg values changed from off/on to none/imsi/msisdn/all. The value off was changed to none. The value on was changed to imsi. The message processing did not change, just the text description that is displayed to the user. The numeric values did not change, so no upgrade is necessary.

SRIRDCTENT is a system-wide option that can be set to use either the Intra Network Number Portability feature or the GSM MAP SRI Redirect feature.

on/off options

  • eirimsichk —Specifies the use of the Equipment Identity Register (EIR) IMSI Check status. This option is not valid for IMEI ranges. This option has a default of OFF.
  • encodecug —Specifies whether the Closed User Group (CUG) Checkinfo from the SRI message is included in the SRI Ack message. This option has a default of OFF. 
  • enodenps — Specifies whether the Number Portability Status Indicator (NPSI) is included in SRI Ack messages when the portability type (PT) has a value of 0, 1, 2 or 36. This option has a default of ON.
  • srismgttrtg —Specifies whether the SRI_SM routing feature is on. This option has a default of OFF.
  • encdnpsptnone —Specifies whether the NPSI is included in SRI Ack messages when the PT has a value of none (255). This option has a default of OFF.
  • encdnpsdnnotfound —Specifies whether the NPSI is included in SRI Ack messages when the DN is not found. This option has a default of OFF.
  • eirimsiscrn ---- Specifies the use of Equipment Identity Register (EIR) IMSI screening status. This option specifies whether the IMSI Screening shall be done before the IMEI check. This option has a default of OFF.
  • eirlogwl ---- Specifies the use of Equipment Identity Register (EIR) white list logging status. This option specifies whether the white list logging for EIR shall be on. This option has a default of OFF.
  • eirdfltimsiscrn ---- Specifies the use of Equipment Identity Register (EIR) default IMSI screening status. This option specifies whether the default IMSI screening shall be on. This option has a default of OFF.

MAP Operations Supported by the maplyrrtgon and maplyrrtgoff Parameters

The maplyrrtgon and maplrrtgoff parameters are used to turn G-Flex MLR on and off, respectively, for the following MAP operations:

  • regss : registerSS —Register Supplementary Service
  • actss : activateSS —Activate Supplementary Service
  • dactss : deactivateSS —Deactivate Supplementary Service 
  • intss : interrogateSS —Interrogate Supplementary Service 
  • authfailrpt : authenticationFailureReport —Authentication Failure Report 
  • rstdata : restoreData —Restore Data 
  • procunstrqt : processUnstructuredSS-Request —Process Unstructured SS Request 
  • rdyforsm : readyForSM —Ready For Short Message 
  • purgmobss : purgeMS —Purge Mobile Subscriber 
  • sriloc : sendRoutingInfoForLCS —Send Routing Information for Location Service 

Output

chg-gsmopts:msrnnai=1:msrnnp=1:msrndig=ccrngrndn:defmapvr=2

    tekelecstp 09-05-05 12:28:07 EST  EAGLE 41.1.0
    CHG-GSMOPTS: MASP A – COMPLTD 
;
chg-gsmopts:srirdctent=grn

    tekelecstp 14-05-30 16:39:41 EST  EAGLE 46.1.0
    CHG-GSMOPTS: MASP A - COMPLTD
;