4.305 ent-gttact
Use this command to enter a Global Title Translations (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 actions performed 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 (mandatory)
- Action. The action 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 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
- sfapp
- route message to SFAPP card
- atcaperr (optional)
-
ANSI TCAP Error Cause. The reason for discarding the message containing the ANSI TCAP portion that is 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)
-
This parameter signifies the number of previous 30-second windows from which the unused capacity can be carried over to the current window.
- cdgtmodid (optional)
- Called party global title modification identifier. The GTMOD ID to be associated with the called party of a GTT Action entry.
- cggtmodid (optional)
- Calling party global title modification identifier. The GTMOD ID to be associated with the calling party of a GTT Action entry.
- cgpc (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:
- cgpca
- 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 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).
- cgpcn (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).
- cgpcn24 (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).
- cgpcn16 (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).
- cgpcogmsg (optional)
- The data that is 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 the
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.
- Default:
- fallback
- failactid (optional)
- Fail Action ID. The default action that is performed to route
the message when the VLR Validation fails on Stateful App.
- Range:
- ayyyyyyyy
1 leading alphabetic character followed by 8 alphanumeric characters
The failactid 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 discarded.
- Default:
- fallback
- itcaperr (optional)
- ITU TCAP Error Cause. The reason for discarding the message containing the ITU TCAP portion that is 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 must be matched between the SCCP parameter and MAP parameter.
- off (optional)
-
Disables or turns off the specified feature options. This parameter specifies 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 duplicated copy of MSU.
- scfaddr (optional)
- GSM SCFAddressparameter must be specified when sfapp action needs to be performed.
- sprm (optional)
-
SCCP Parameter. This parameter is used to determine 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.
- srvcerr (optional)
- The action to be taken when the Service triggered by GTT Action Service fails. The MSU can be processed by either applying the results of the pre-Service GTT, or continue with the specific Service error.
- threshold (optional)
-
If the number of MSUs serviced by the SFTHROT action exceeds this value, MSUs are discarded.
- tprm (optional)
-
TCAP Parameter. This parameter is used to determine whether the MAP digits, NP, and NON (if NP and NON are present) will be picked up from SMRPDA or SMRPOA and used for comparison.
Example
Provisioning GTT Action entry with action type duplicate:ent-gttact:actid=dup1:act=dup:pc=1-1-1:ssn=10:ri=ssn:mapset=20
ent-gttact:actid=actudts:act=udts:udtserr=10
ent-gttact:actid=actdisc:act=disc
ent-gttact:actid=actfwd:act=fwd:pc=2-2-2:ssn=2:ri=ssn:mapset=10
ent-gttact:act=dup:actid=actdup2:pca=1-1-1:ssn=15:ri=gt:
cdgtmodid=set1:cggtmodid=set5:loopset=loop1:cgpca=2-2-2:cgpcogmsg=provcgpc
ent-gttact:actid=actfwd2:act=fwd:pc=2-2-2:ssn=2:
ri=ssn:defactid=actdisc:on=useicmsg
ent-gttact:act=dup:actid=actdup3:pc=1-1-1:ri=gt:mrnset=dflt:cgpc=2-2-2
ent-gttact:act=fwd:actid=actfwd3:pc=1-1-1:ri=gt:mrnset=dflt:cgpcogmsg=dflt
ent-gttact:act=fwd:actid=actfwd4:pc=1-1-1:
ri=gt:mrnset=dflt:defactid=fallback
ent-gttact:actid=acttcap:act=tcaperr:atcaperr=5
ent-gttact:act=fwd:actid=actfwd5:pcn16=1-14-0:ri=gt:mrnset=dflt:cgpcogmsg=remove
ent-gttact:actid=actsrvc:act=srvc:srvcname=gflex:snp=e164:snai=sub:srvcerr=gtt
ent-gttact:actid=actsflog:act=sflog
ent-gttact:actid=sfthrot1:act=sfthrot:bursts=1:threshold=2500
ent-gttact:actid=scpval1:act=scpval:valtype=sccptotcap:sprm=cdpa:tprm=smrpda:
ndgt=15:on=uimreqd:defactid=actdisc
ent-gttact:actid=scpval1:act=scpval:valtype=ir21totcap
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:hlraddr=usecdpa:failactid=actdisc
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:hlraddr=tcapparm:tt=10
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:hlraddr=fwdact:fwdgtt=actsfapp
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:atirescgmodid=set1
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=1912:psirescgmodid=set5
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:on=handlresp
Dependencies
A value of disc, udts, tcaperr, scpval, or sfapp 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 cannot contain more than 2000 entries.
The GTT Action table is corrupt or cannot be found.
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 ri=ssn parameter is specified, then the ssn parameter must be specified.
If the value of the cgpcogmsg=provcgpc parameter is specified, then the cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameter must be specified.
The sprm and tprm parameters must be specified when act is set to scpval.
If the hlraddr=tcapparm parameter is specified, then the tt parameter must be specified.
If the hlraddr=fwdact parameter is specified, then the fwdgtt 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 and 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, the specified PC must already exist in the specified MRN set.
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.
The point code specified for the pc/pci/pcn/pcn24/pcn16 parameter must be a full point code.
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, ssn, ri, mrnset, mapset, loopset, cgpcogmsg, cdgtmodid, or cggtmodid 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/sfapp 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 if action type is srvc.
The threshold or bursts parameter can only be specified when act=sfthrot is specified.
The tprm, sprm, and ndgt parameters can only be specified if action type is scpval/sfapp.
The scfaddr, hlraddr, tt, failactid and fwdgtt parameters can only be specified if action type is sfapp.
A value of none or fallback cannot be specified for the actid parameter.
The GTT Action entry specified by the actid parameter cannot already exist in the database.
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/pca/pci/pcn/pcn24/pcn16 parameter must already exist as a destination in the Route 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 SCCP Application entity set (Remote Point Code/MAP Table).
The SS-APPL table is corrupt or cannot be found.
The Route table is corrupt or cannot be found.
The STP Self-identity table is corrupt or cannot be found.
The MRN table is corrupt or cannot be found.
If the value specified for the pc/pca/pci/pcn/pcn24/pcn16 parameter is the STP’s true point code, then the ri=ssn parameter must be specified.
The value specified for the loopset parameter must already exist in the database.
The SCCP Loop Detection feature must be enabled before the loopset parameter can be specified.
The Loopset table is corrupt or cannot be found.
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 value specified for the pc/pca/pci/pcn/pcn24/pcn16 parameter must be a point code that is already associated with a valid route.
The AMGTT feature must be enabled before the cggtmodid parameter can be specified.
The value specified for the cdgtmodid and cggtmodid parameters must already exist in the GTMOD table.
A value of none cannot be specified for the cdgtmodid or cggtmodid parameter.
A value of disc, utds, or tcaperr must be specified for the defactid/failactid parameter.
The GTT Action ID specified by the defactid or failactid parameter must already exist.
The values specified for the pc/pca/pci/pcn/pcn24/pcn16 and cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameters must have the same domain.
The loopset=none parameter cannot be specified.
The defactid=none or failactid=none parameter cannot be specified.
The same value cannot be specified for the on and off parameters.
The snp, snai, and srvcname parameters must be specified when act is set to srvc.
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.
When the service specified is GFLEX, SNAI must be specified as subscriber, national or international.
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.
When service is specified as GPORT or SMSMR, the SNP must be specified as E164.
The GTT Action - FORWARD/DISCARD/DUPLICATE feature must be enabled before the act=srvc parameter can be specified.
The GTT destination must exist in the DSTN table.
More than 32 SFTHROT GTT Actions are not permitted.
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 EGTT feature must be on before the SCPVAL GTT Action can be entered.
A value of none cannot be specified for the atirescgmodid and psirescgmodid 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 —Specifies whether the ATI/PSI response will be sent to SFAPP card or not.
GTI, TT and NPDS must be provisioned in GTMOD table to associate gtmodid with ATIRESCGMODID or PSIRESCGMODID.
Output
ent-gttact:actid=disc1:act=disc
tekelecstp 10-02-04 18:29:41 EST EAGLE 42.0.0
ent-gttact:actid=disc1:act=disc
Command entered at terminal #4.
GTT Action table is (1 of 2000) 1% full
ENT-GTTACT: MASP A - COMPLTD
;
ent-gttact:actid=sfthrot1:act=sfthrot
tekelecstp 15-05-27 15:43:58 EST Eagle 46.3.0
ent-gttact:actid=sfthrot1:act=sfthrot
Command entered at terminal #4.
GTT Action table is (1 of 2000) 1% full
ENT-GTTACT: MASP A - COMPLTD
;
ent-gttact:actid=sflog1:act=sflog
tekelecstp 15-05-27 15:43:58 EST Eagle 46.3.0
ent-gttact:actid=sflog1:act=sflog
Command entered at terminal #4.
GTT Action table is (1 of 2000) 1% full
ENT-GTTACT: MASP A - COMPLTD
;
ent-gttact:actid=scpval1:act=scpval:sprm=cdpa:tprm=smrpda:ndgt=15:on=uimreqd:defactid=actdisc
tekelecstp 15-05-29 10:25:11 EST Eagle 46.3.0
ent-gttact:actid=scpval1:act=scpval:sprm=cdpa:tprm=smrpda:ndgt=15:
on=uimreqd:defactid=actdisc
Command entered at terminal #4.
GTT Action table is (10 of 2000) 1% full
ENT-GTTACT: MASP A - COMPLTD
;
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:hlraddr=usecdpa
tekelecstp 17-11-22 10:01:01 EST EAGLE 46.5.1.5.0-73.2.0
ent-gttact:actid=sfapp10:act=sfapp:scfaddr=19:hlraddr=usecdpa
Command entered at terminal #17.
;
Command Accepted - Processing
tekelecstp 17-11-22 10:01:01 EST EAGLE 46.5.1.5.0-73.2.0
GTT-ACT table is (9 of 2000) 1% full.
;
tekelecstp 17-11-22 10:01:02 EST EAGLE 46.5.1.5.0-73.2.0
ENT-GTTACT: MASP B - COMPLTD
;
Command Executed
ent-gttact:actid=sfapp13:act=sfapp:scfaddr=16:failactid=fallback
tekelecstp 17-11-22 10:07:39 EST EAGLE 46.5.1.5.0-73.2.0
7406.1083 SYSTEM INFO REPT COND: system alive
tekelecstp 17-11-22 10:07:47 EST EAGLE 46.5.1.5.0-73.2.0
ent-gttact:actid=sfapp13:act=sfapp:scfaddr=16:failactid=fallback
Command entered at terminal #17.
;
Command Accepted - Processing
tekelecstp 17-11-22 10:07:47 EST EAGLE 46.5.1.5.0-73.2.0
GTT-ACT table is (10 of 2000) 1% full.
;
tekelecstp 17-11-22 10:07:47 EST EAGLE 46.5.1.5.0-73.2.0
ENT-GTTACT: MASP B - COMPLTD
;
Command Executed
ent-gttact:actid=sfapp3:scfaddr=6762:act=sfapp:atirescgmodid=set1
tekelecstp 18-05-07 10:13:26 EST EAGLE 46.7.0.0.0-74.5.0
ent-gttact:actid=sfapp3:scfaddr=6762:act=sfapp:atirescgmodid=set1
Command entered at terminal #4.
GTT-ACT table is (3 of 2000) 1% full.
ENT-GTTACT: MASP A - COMPLTD
;
Related Topics