4.71 chg-gttact
Use this command to change a Global Title Translation (GTT) Action entry. A GTT Action entry consists of an Action ID, an action, and action specific data. The action specified in the entry determines the process that is performed on the MSU during translation.
Parameters
Note:
Definitions for the feature options specified by the on and off parameters are located in the Notes section.- act (optional)
- Action. The GTT Action that is applied to the
message.
- Range:
-
- disc
- discard message with no return error
- dup
- route a copy of the message to a specified duplicate node
- fwd
- route the original message to a specified forward node instead of the destination indicated by the GTT/ DB data
- scpval
- perform the SCCP MAP validation on MO/MT-FSM messages
- sflog
- send a copy of original message to SFLOG card
- sfthrot
- discard message if threshold is exceeded
- srvc
- apply service (GPORT/GFLEX/SMSMR) on the message
- tcaperr
- discard message that has a specified TCAP error
- udts
- discard message and send UDTS/XUDTS
- atcaperr (optional)
-
ANSI TCAP error cause. The reason for discarding a message that contains the ANSI TCAP portion associated with the tcaperr GTT Action.
- atirescgmodid (optional)
-
Calling party global title modification identifier for ATI. The GTMOD ID to be associated with the calling party of a SFAPP GTT Action entry.
- bursts (optional)
- The number of previous 30 second windows from where the unused capacity can be carried over to the current window.
- cgpc (optional)
- ANSI CgPA point code with subfields
network
indicator-network cluster-network cluster member (ni-nc-ncm). The
prefix
subfield indicates a private point code
(prefix-ni-nc-ncm).
- Range:
- p-, 000-255
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix—p-
When
chg-sid:pctype=ansi
is specified, ni = 000 is not valid.When
chg-sid:pctype=ansi
is specified, nc = 000 is not valid if ni = 001-005.When
chg-sid:pctype=ansi
is specified, nc = 000 is valid if ni = 006-255.The point code 000-000-000 is not a valid point code.
- cgpci (optional)
- ITU international CgPA point code with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
- cgpcn (optional)
-
ITU national CgPA point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the
chg-stpopts:npcfmti
flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc, m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
- cgpcn16 (optional)
- 16-bit ITU national CgPA point code with subfields unit number-sub number area-main number area (un-sna-mna). The prefix subfield indicates a private point code (prefix-un-sna-mna).
- cgpcn24 (optional)
- 24-bit ITU national CgPA point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix subfield indicates a private point code (prefix-msa-ssa-sp).
- cgpcogmsg (optional)
- The data used as the Calling Party Point Code in the outgoing message.
- defactid (optional)
- Default Action ID. The default action that
is performed when the
fwd GTT Action fails to route the
MSU or when
sfthrot or
scpval GTT Action fails.
- Range:
- ayyyyyyyy
1 leading alphabetic character followed by 8 alphanumeric characters
The defactid parameter can take one of the following values:
- GTT Action ID with a GTT Action of disc, udts, or tcaperr (see the act parameter). This value must already be defined in the GTT Action table.
- fallback —The MSU is routed using routing data in the translated MSU when action is fwd. When action is set to scpval/sfthrot, the MSU is discarded.
- itcaperr (optional)
-
ITU TCAP error cause. The reason for discarding the message that contains the ITU TCAP portion associated with the tcaperr GTT Action.
- ndgt (optional)
- Number of digits to be matched. This parameter is used to specify the number of digits that needs to be matched between the SCCP and MAP parameters.
- off (optional)
-
Disables or turns off the specified feature options. A comma-separated list of feature options that are requested to be turned off. Up to 8 feature options can be specified in the list.
- on (optional)
-
Enables or turns on the specified feature options. A comma-separated list of feature options that are requested to be turned on. Up to 8 feature options can be specified in the list.
- pc (optional)
- ANSI point code with subfields
network
indicator-network cluster-network cluster member (ni-nc-ncm). The
prefix
subfield indicates a private point code
(prefix-ni-nc-ncm).
- Synonym:
- pca
- Range:
- p-, 000-255
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix—p-
When
chg-sid:pctype=ansi
is specified, ni = 000 is not valid.When
chg-sid:pctype=ansi
is specified, nc = 000 is not valid if ni = 001-005.When
chg-sid:pctype=ansi
is specified, nc = 000 is valid if ni = 006-255.The point code 000-000-000 is not a valid point code.
- pci (optional)
-
ITU international destination point code with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
- pcn (optional)
-
ITU national point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the
chg-stpopts:npcfmti
flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc, m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
- pcn24 (optional)
-
24-bit ITU national point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix subfield indicates a private point code (prefix-msa-ssa-sp).
- pcn16 (optional)
- 16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). The prefix subfield indicates a private point code (prefix-un-sna-mna).
- psirescgmodid (optional)
-
Calling party global title modification identifier for PSI. The GTMOD ID to be associated with the calling party of a SFAPP GTT Action entry.
- ri (optional)
- Routing indicator. The routing indicator in the SCCP called party address of the MSU being processed.
- sprm (optional)
-
SCCP Parameter. This parameter is used to decide whether the SCCP GTA, NP and NAI (if GTI=4 and NP/NAI is present) will be picked up from CDPA or CGPA and used for comparison.
- ssn (optional)
-
Subsystem number. The value used for the SSN in the SCCP called party address of the MSU.
- threshold (optional)
- Throttling threshold. The MSU is discarded if the number of MSUs serviced by the SFTHROT action exceeds this value in a 30 second period.
Example
chg-gttact:actid=dup1:act=dup:ssn=40
Changing the Action Id of the already provisioned GTT Action entry:chg-gttact:actid=dup1:act=dup:nactid=dup2
chg-gttact:actid=disc1:act=tcaperr:atcaperr=10
chg-gttact:actid=actfwd1:act=fwd:pc=2-2-2:ri=gt:defactid=none
chg-gttact:act=dup:actid=dup2:cdgtmodid=set1:cggtmodid=none
chg-gttact:act=dup:actid=dup5:cggtmodid=set4
chg-gttact:actid=actfwd2:act=fwd:pc=2-2-2:ri=gt:defactid=fallback:on=useicmsg
chg-gttact:actid=actfwd3:act=fwd:pc=2-2-2:ri=gt:cgpcogmsg=opcicmsg
chg-gttact:actid=actdup3:act=dup:pc=2-2-2:ri=gt:cgpc=1-1-1:cgpcogmsg=provcgpc
chg-gttact:act=fwd:actid=actfwd5:pcn16=1-14-0:ri=gt:mrnset=dflt:cgpcogmsg=remove
chg-gttact:actid=gflex1:act=GPORT
chg-gttact:actid=actsrvc1:snp=e164:snai=rnndn:srvcerr=gtt
chg-gttact:actid=actsfthrot:threshold=2000:bursts=1
chg-gttact:actid=sflog1:nactid=sflogid1
chg-gttact:actid=scpval1:act=scpval:sprm=cgpa:ndgt=20
chg-gttact:actid=sfapp8:failactid=fallback
chg-gttact:actid=sfapp8:hlraddr=tcapparm:tt=26
chg-gttact:actid=sfapp9:hlraddr=usecdpa
chg-gttact:actid=sfapp10:act=sfapp:atirescgmodid=set1
chg-gttact:actid=sfapp10:psirescgmodid=set5
chg-gttact:actid=sfapp10:on=handlresp
Dependencies
A value of dup or fwd must be specified for the act parameter before the pc/pca/pci/pcn/pcn24/pcn16, cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16, cgpcogmsg, cdgtmodid, cggtmodid, ssn, ri, mrnset, mapset, or loopset parameter can be specified and before a value of useicmsg can be specified for the on or off parameter.
The act=tcaperr parameter must be specified before the atcaperr and itcaperr parameters can be specified.
The act=udts parameter must be specified before the udtserr parameter can be specified.
The act=fwd/sfthrot/scpval parameter must be specified before the defactid parameter can be specified.
The Service Numbering Plan (snp), Service Nature of Address Indicator (snai), Service Name (srvcname) and Service Error Cause (srvcerr) parameters can only be specified when act is set to srvc.
The srvc/sflog/sfthrot/scpval GTT Action cannot be changed to any other GTT Action (Duplicate/forward/TCAP Error/Discard/UDTS Error) and vice versa.
The parameters threshold and bursts can only be specified when action is set to sfthrot.
The sfthrot GTT Action cannot be changed to any other GTT Action (Duplicate/Forward/TCAP Error/Discard/UDTS Error/SRVC/SCPVAL) and vice versa.
The scpval GTT Action cannot be changed to any other GTT Action (Duplicate/Forward/TCAP Error/Discard/UDTS Error/SRVC/SFTHROT) and vice versa.
The sflog GTT Action cannot be changed to any other GTT Action (Duplicate/Forward/TCAP Error/Discard/UDTS Error/SRVC/SFTHROT/SCPVAL) and vice versa.
The SCCP Parameter (sprm), TCAP Parameter (tprm) can only be specified when act is set to scpval and valtype is set to sccptotcap.
The Number of digits to match (ndgt) parameters can only be specified when act is set to scpval.
A value of disc, udts, tcaperr or scpval must be specified for the act parameter before a value of uimreqd can be specified for the on or off parameter.
The GTT Action table is corrupt or cannot be found.
The GTT Action entry specified by the actid parameter must already exist in the database.
The value specified for the nactid parameter cannot already exist in the database.
A value of none or fallback cannot be specified for the actid or nactid parameter.
If a value of dup or fwd is specified for the act parameter then the pc/pca/pci/pcn/pcn24/pcn16 parameter must be specified.
If the cgpcogmsg=provcgpc parameter is specified, then the cgpc/cgpca/cgpci/cgpcn/cgpcn24/pcn16 parameter must be specified.
The GTT Action - DISCARD feature must be enabled before a value of disc, udts, or tcaperr can be specified for the act parameter.
The GTT Action - DUPLICATE feature must be enabled before the act=dup parameter can be specified.
The specified PC/SSN must already exist in the specified MAP set.
If the ri=ssn parameter is specified, then the mrnset parameter cannot be specified.
The Flexible GTT Load Sharing feature must be enabled before the mrnset parameter can be specified.
If the ri=gt parameter is specified, then the mapset parameter cannot be specified.
The Flexible GTT Load Sharing feature must be enabled before the mapset parameter can be specified.
The specified MAP set must already exist in the database.
The specified MRN set must already exist in the MRN table.
If the Flexible GTT Load Sharing feature is enabled, then the specified PC must already exist in the specified MRN set.
The point code specified for the pc/pca/pci/pcn/pcn24/pcn16 parameter must be a full point code.
The value specified for the pc/pca/pci/pcn/pcn24/pcn16 parameter must already exist as a destination in the Route table.
If the value specified for the pc/pca/pci/pcn/pcn24/pcn16 parameter is the STP true point code, then the value specified for the ssn parameter must already exist in the SS-APPL table.
The value specified for the pc parameter cannot be associated with a proxy point code.
The MAP table is corrupt or cannot be found.
If the pc/pca/pci/pcn/pcn24/pcn16, ri=ssn and ssn parameters are specified, then the PC/SSN must be populated in the Remote Point Code and MAP tables.
The point code specified for the pc/pca/pci/pcn/pcn24/pcn16 and cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameters must be within the range specified by the parameter definition.
A value of disc, utds, or tcaperr must be specified for the defactid parameter.
The Route table is corrupt or cannot be found.
The STP Self-identity table is corrupt or cannot be found.
The SS-APPL table is corrupt or cannot be found.
The MRN table is corrupt or cannot be found.
The ri=ssn and the ssn=none parameters cannot be specified together in the command.
The SCCP Loop Detection feature must be enabled before the loopset parameter can be specified.
The value specified for the loopset parameter must already exist in the database.
The Loopset table is corrupt or cannot be found.
Failure while reading the GTT Action Set Table.
The GTT Action - FORWARD feature must be enabled before the act=fwd parameter can be specified.
The GTMOD table is corrupt or cannot be found.
The point code specified by the pc/pca/pci/pcn/pcn24/pcn16 parameter must be associated with a valid route.
If the value specified for the pc/pca/pci/pcn/pcn24/pcn16 parameter is the STP true point code, then the ri=ssn parameter must be specified.
The values specified for the cdgtmodid and cggtmodid parameters must already exist in the GTMOD table.
The AMGTT or AMGTT CgPA Upgrade feature must be turned on before the cggtmodid parameter can be specified.
The GTT Action ID specified by the defactid parameter must already exist.
The pc/pca/pci/pcn/pcn24/pcn16 and cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameters must have the same domain.
One of the optional parameters must be specified.
The value specified by the act parameter cannot be changed until the associated Action ID is referenced by an Action Set or by any forward/scpval/sfthrot/sflog action. The value can only be changed from disc/udts/tcaperr to disc/udts/tcaperr.
The defactid=none parameter cannot be specified.
The same value(s) cannot be specified for the on and off parameters.
The GFLEX feature must be activated if the GFLEX service is entered with the SRVCNAME parameter.
The GPORT feature must be activated if the GPORT service is entered with the SRVCNAME parameter.
The Portability Check for Mobile Originated SMS feature/PPSMS feature must be turned ON, or the MO SMS ASD/MO SMS B-Party Routing/MO SMS GRN/MO SMS IS41-to-GSM Migration/MO-based GSM SMS NP/MO-based IS41 SMS NP feature must be ENABLED before the SMSMR Service is entered with SRVCNAME parameter.
If the value specified for the SRVCNAME parameter is GFLEX, then the snai=sub, natl or intl parameter must be specified.
If the value specified for the SRVCNAME parameter is GPORT/SMSMR, then the snai= rnidn, rnndn, rnsdn or ccrndn parameter must be specified.
If the value specified for the SRVCNAME parameter is GPORT/SMSMR, then the snp=e164 parameter must be specified.
If the value specified for the SRVCNAME parameter is GFLEX, then the snp=e164, e212 or e214 parameter must be specified.
The GTT destination must exist in the DSTN table.
A value of fwd, dup or scpval must be specified for the act parameter before a value of useicmsg can be specified for the on or off parameter.
The value specified for the atirescgmodid and psirescgmodid parameters must already exist in the GTMOD table.
AMGTT feature must be enabled, if atirescgmodid or psirescgmodid is specified.
Notes
on/off options
- uimreqd —UIM required. Specifies whether a UIM should be generated.
- useicmsg —Use Incoming Message. Specifies whether to apply GTT Action data to the message as the message was received (OFF) or after any EPAP or GTT translation/modification data has been applied (ON).
- handlresp — Handle response message. Specifies whether to apply GTT Action data to the message as the message is a response message to an Eagle-generated ATI or PSI.
GTT Actions srvc, scpval, sflog and sfthrot cannot be changed to any other GTT Action (Duplicate/Forward/TCAP Error/Discard/UDTS Error/srvc/scpval/sflog/sfthrot) and vice versa. A srvc GTT Action representing one service can be changed to another service.
GTI, TT and NPDS must be provisioned in GTMOD table to associate gtmodid with ATIRESCGMODID or PSIRESCGMODID.
Output
chg-gttact:actid=dup1:ssn=40
tekelecstp 10-02-04 18:29:41 EST EAGLE 42.0.0
chg-gttact:actid=dup1:ssn=40
Command entered at terminal #4
GTT Action table is (2 of 2000) 1% full
CHG-GTTACT: MASP A - COMPLTD
;
chg-gttact:actid=gflex1:act=GPORT
tekelecstp 13-12-07 13:41:11 EST EAGLE 46.0.0
chg-gttact:actid=gflex1:act=GPORT
Command entered at terminal #1
GTT Action table is (5 of 2000) 1% full
CHG-GTTACT: MASP A - COMPLTD
;
chg-gttact:actid=sfthrot1:threshold=2000:bursts=1
tekelecstp 15-05-27 15:43:59 EST Eagle 46.3.0
chg-gttact:actid=sfthrot1:threshold=2000:bursts=1
Command entered at terminal #1
GTT Action table is (5 of 2000) 1% full
CHG-GTTACT: MASP A - COMPLTD
;
chg-gttact:actid=scpval1:act=scpval:sprm=cgpa:ndgt=20
tekelecstp 15-05-28 10:27:42 EST EAGLE 46.3.0
chg-gttact:actid=scpval1:act=scpval:sprm=cgpa:ndgt=20
Command entered at terminal #1
GTT Action table is (20 of 2000) 1% full
CHG-GTTACT: MASP A - COMPLTD
;
chg-gttact:actid=sfapp3:act=sfapp:atirescgmodid=set5
tekelecstp 18-05-07 10:13:26 EST EAGLE 46.7.0.0.0-74.5.0
chg-gttact:actid=sfapp3:act=sfapp:atirescgmodid=set5
Command entered at terminal #4.
GTT-ACT table is (3 of 2000) 1% full.
CHG-GTTACT: MASP A - COMPLTD
;
Related Topics