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.- 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.
- 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.
- 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.
- 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.
- eirrsptype (optional)
- Equipment Identity Register (EIR) Response Type.
- Range:
-
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.
- 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.
- 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
- 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.
- 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.
- 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.
- msrnnp (optional)
- The numbering plan value for the MSRN.
Note:
This parameter is mandatory if the msrnnai parameter is specified.
- off (optional)
- This parameter turns off the specified options. Up to 8 comma-separated unique options can be specified.
- on (optional)
- This parameter turns on the specified options. Up to 8 comma-separated unique options can be specified.
- 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.
- sridnnotfound (optional)
- The processing used when G-Port encounters an RTDB query result that indicates that the specified directory number is not known.
- srirdctent (optional)
- This indicates whether existing SRI REDIRECT feature (SP) or Intra Network Number Portability feature (GRN) is to be used.
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
;
Related Topics