4.497 rtrv-gttact
Use this command to display entries from the Global Title Translations (GTT) Action table.
Parameters
Note:
Definitions for the feature options specified by the on and off parameters are located in the Notes section.- act (optional)
- 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 the original message to the 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.
- 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).
- defactid (optional)
- Default Action ID. The Action ID associated with the Forward/SCPVAL/SFTHROT action.
- 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.
- loopset (optional)
- SCCP loopset name. This parameter retrieves action entries that are associated with the specified loopset.
- 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 in the form of
network
indicator-network cluster-network cluster member (ni-nc-ncm). The value "none"
indicates that the Origin Point Code (OPC) field in the message will be used in
place of CGPC.
- 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).
- 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).
- 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).
- 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.
- snai (optional)
- The service nature of address indicator.
- Range:
-
- ccrndn
- Country code, routing number, and national directory number
- intl
- International number
- Natl
- National significant number
- rnidn
- Routing number prefix and international dialed/directory number
- rnndn
- Routing number prefix and national dialed/directory number
- rnsdn
- Routing number prefix and subscriber dialed/directory number
- Sub
- Subscriber number
- sprm (optional)
-
SCCP Parameter. This parameter is used to decide whether the SCCP GTA, NP, and NAI (if GTI=4 and NP/NAI are present) will be picked up from CDPA or CGPA for comparison.
- srvcerr (optional)
- The action to be taken when the Service triggered by the GTT Action Service fails. The MSU can be processed by either applying the results of the pre-Service GTT, or continuing with the specific Service error processing.
- tprm (optional)
-
TCAP Parameter. This parameter is used to decide whether the MAP digits, NP, and NON (if NP and NON are present) will be picked up from SMRPDA or SMRPOA for comparison.
Example
rtrv-gttact:actid=disc1
rtrv-gttact:cggtmodid=idda1
rtrv-gttact:cggtmodid=cggt1:cdgtmodid=cdgt2
rtrv-gttact:defactid=fallback
rtrv-gttact:pcn16=1-14-0
rtrv-gttact:act=srvc
rtrv-gttact:srvcname=gflex
rtrv-gttact:tprm=smrpda
rtrv-gttact:hlraddr=usecdpa:failactid=sfapp8
rtrv-gttact:hlraddr=fwdact
rtrv-gttact:hlraddr=tcapparm
rtrv-gttact:atirescgmodid=set1
rtrv-gttact:psirescgmodid=set5
rtrv-gttact:valtype=sccptotcap
Dependencies
The GTT Action table is corrupt or cannot be found.
The specified GTT Action entry must already exist in the database.
If the Flexible GTT Load Sharing feature is not enabled, then the mapset parameter cannot be specified.
The value specified for the pc/pca/pci/pcn/pcn24/pcn16 and cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameters must be a full point code and must have a valid value within the range for each subfield.
The Flexible GTT Load Sharing feature must be enabled before the mrnset parameter can be specified.
The mapset and mrnset parameters cannot be specified together in the command.
A value of none or fallback cannot be specified for the actid parameter.
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.
A value of dup or fwd must be specified for the act parameter before the pc, ssn, ri, mrnset, mapset, loopset, cgpc, cgpcogmsg, cggtmodid or cdgtmodid parameters can be specified.
A value of dup, fwd, scpval, or sfthrot must be specified for the act parameter before a value of useicmsg can be specified for the on or off parameter.
The act=fwd/scpval/sfthrot parameter must be specified before the defactid parameter can be specified.
The pc, ssn, ri, mrnset, mapset, loopset, cgpc, cgpcogmsg, defactid, tprm, and sprm parameters cannot be specified in the same command as the atcaperr, itcaperr, or udtserr parameters.
Values of useicmsg and uimreqd cannot be specified for the on or off parameters in the same command.
If the actid parameter is specified, then the ri, pc, ssn, mrnset, mapset, loopset, on, off, atcaperr, itcaperr, udtserr, act, cgpc, cgpcogmsg, defactid, cggtmodid, cdgtmodid, snp snai, srvcerr, srvcname, sprm, and tprm parameters cannot be specified.
The act=tcaperr parameter must be specified before the atcaperr or itcaperr parameter can be specified.
The act=udts parameter must be specified before the udtserr parameter can be specified.
The udtserr and srvcerr parameters cannot be specified in the same command.
The atcaperr and itcaperr parameters cannot be specified in the same command.
The pc, ri, ssn, mrnset, mapset, loopset, cdgtmodid, defactid, cgpc, cgpcogmsg, and cggtmodid parameters cannot be specified in the same command with the atcaperr, itcaperr, and udtserr parameters.
The srvcname, snp, snai and srvcerr parameters can only be specified when act is set to srvc.The sprm and tprm parameters can be specified only when act is set to scpval.
The scfaddr, hlraddr, tt, failactid and fwdgtt parameters can only be specified if action type is sfapp.
The point code specified for the pc/pci/pcn/pcn24/pcn16 and cgpc/cgpci/cgpcn/cgpcn24/cgpcn16 parameters must be a full point code.
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.
The value specified for the cdgtmodid or cggtmodid parameter must already exist in the GTMOD table.
The GTMOD table is corrupt or cannot be found.
The defactid=none or failactid=none parameter cannot be specified.
The value specified for the pc/pca/pci/pcn/pcn24/pcn16 and cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameters must have the same domain.
The same value cannot be specified for the on and off parameters.
The specified MAP set must already exist in the MAP table.
The specified MRN set must already exist in the MRN 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.
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 the SFAPP card or not.
Output
rtrv-gttact:on=refcnt
tekelecstp 15-05-29 18:21:01 EST EAGLE 46.3.0
ACTID ACTION ATCAPERR ITCAPERR UDTSERR UIMREQD REFCNT
------------------------------------------------------------
act2 disc --- --- --- off 0
none1 disc --- --- --- off 0
ACTID ACTION PCA RI SSN MRNSET MAPSET REFCNT
---------------------------------------------------------------------------
actdup1 dup 001-001-001 gt --- DFLT ----- 2
CDGTMODID = --------- CGGTMODID = ---------
LOOPSET = None
USEICMSG = off CGPCOGMSG = dflt CGPCA = ---
actfwd1 fwd 001-001-001 gt --- DFLT ----- 2
CDGTMODID = --------- CGGTMODID = ---------
LOOPSET = None DEFACTID = Fallback
USEICMSG = off CGPCOGMSG = dflt CGPCA = ---
ACTID ACTION PCI RI SSN MRNSET MAPSET REFCNT
---------------------------------------------------------------------------
ACTID ACTION PCN RI SSN MRNSET MAPSET REFCNT
---------------------------------------------------------------------------
ACTID ACTION PCN24 RI SSN MRNSET MAPSET REFCNT
---------------------------------------------------------------------------
ACTID ACTION VALTYPE NDGT UIMREQD USEICMSG DEFACTID REFCNT
---------------------------------------------------------------------------
scpval1 scpval ir21totcap ALL off off DISCARD 0
scpval2 scpval sccptotcap 15 off off DISCARD 0
TPRM = smrpda SPRM = cdpa
GTT-ACT table is (2 of 2000) 1% full.
;
rtrv-gttact:cggtmodid=set1
tekelecstp 10-02-04 18:21:01 EST EAGLE 42.0.0
ACTID ACTION PCI RI SSN MRNSET MAPSET
---------------------------------------------------------------------
actdup2 DUP 002-002-002 GT --- 2000 -----
CDGTMODID = set2 CGGTMODID = set1
ACTID ACTION PCN24 RI SSN MRNSET MAPSET
---------------------------------------------------------------------------
actdup6 DUP 111-222-333 SSN 100 ---- 3000
CDGTMODID = id9 CGGTMODID = set1
GTT Action table is (8 of 2000) 1% full
;
rtrv-gttact:pcn16=1-2-3
tekelecstp 13-07-02 15:04:36 EST 45.0.0-64.69.0
rtrv-gttact:pcn16=1-2-3
Command entered at terminal #4.
ACTID ACTION PCN16 RI SSN MRNSET MAPSET
-----------------------------------------------------------------------
actfwd5 fwd 001-02-03 gt --- DFLT -----
CDGTMODID = --------- CGGTMODID = ---------
DEFACTID = Fallback
USEICMSG = off CGPCOGMSG = dflt CGPCN16 = ---
GTT-ACT table is (1 of 2000) 1% full.
;
rtrv-gttact:srvcname=smsmr:act=srvc
eagle1 13-10-27 18:10:25 EST EAGLE 46.0.0
ACTID ACTION SRVCNAME SRVCERR SNP SNAI
----------------------------------------------------------------
actsrvc1 srvc GFLEX SRVC E212 SUB
actsrvc4 srvc GPORT SRVC E164 INTL
actsrvc5 srvc GPORT GTT E164 RNNDN
actsrvc6 srvc SMSMR SRVC E164 INTL
actsrvc7 srvc SMSMR GTT E164 RNNDN
;
rtrv-gttact:act=scpval
tekelecstp 15-05-29 18:21:01 EST EAGLE 46.9.0
ACTID ACTION VALTYPE NDGT UIMREQD USEICMSG DEFACTID
---------------------------------------------------------------------
scpval1 scpval ir21totcap ALL off off DISCARD
scpval2 scpval sccptotcap 15 off off DISCARD
TPRM = smrpda SPRM = cdpa
GTT-ACT table is (2 of 2000) 1% full.
;
rtrv-gttact:act=sfthrot
tekelecstp 15-05-29 18:21:01 EST EAGLE 46.3.0
ACTID ACTION THRESHOLD BURSTS DEFACTID
---------------------------------------------------------
act1 sfthrot 1 0 disc1
act2 sfthrot 1 2 disc2
act3 sfthrot 1 1 disc3
act4 sfthrot 20 0 disc4
GTT-ACT table is (4 of 2000) 1% full.
;
rtrv-gttact:hlraddr=usecdpa
tekelecstp 17-11-22 14:55:02 EST EAGLE 46.5.1.5.0-73.2.0
rtrv-gttact:hlraddr=usecdpa
Command entered at terminal #17.
;
Command Accepted - Processing
tekelecstp 17-11-22 14:55:02 EST EAGLE 46.5.1.5.0-73.2.0
ACTID ACTION DEFACTID USEICMSG NDGT UIMREQD
----------------------------------------------------------------
sfapp1 sfapp FALLBACK off ALL off
SCFADDR = 18 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp8 sfapp FALLBACK off ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp9 sfapp FALLBACK off ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp10 sfapp FALLBACK off ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp13 sfapp FALLBACK off ALL off
SCFADDR = 16 FAILACTID = DISCARD
HLRADDR = USECDPA
GTT-ACT table is (11 of 2000) 1% full.
;
Command Executed
rtrv-gttact:failactid=fallback
tekelecstp 17-11-22 14:56:30 EST EAGLE 46.5.1.5.0-73.2.0
rtrv-gttact:failactid=fallback
Command entered at terminal #17.
;
Command Accepted - Processing
tekelecstp 17-11-22 14:56:30 EST EAGLE 46.5.1.5.0-73.2.0
ACTID ACTION DEFACTID USEICMSG NDGT UIMREQD
----------------------------------------------------------------
sfapp1 sfapp FALLBACK off ALL off
SCFADDR = 18 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp8 sfapp FALLBACK off ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp9 sfapp FALLBACK off ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp10 sfapp FALLBACK off ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
sfapp13 sfapp FALLBACK off ALL off
SCFADDR = 16 FAILACTID = DISCARD
HLRADDR = USECDPA
GTT-ACT table is (11 of 2000) 1% full.
;
Command Executed
rtrv-gttact:atirescgmodid=set1
tekelecstp 18-05-07 10:48:35 EST EAGLE 46.7.0.0.0-74.5.0
rtrv-gttact:atirescgmodid=set1
Command entered at terminal #4.
ACTID ACTION DEFACTID NDGT UIMREQD
----------------------------------------------------------------
sfapp10 sfapp FALLBACK ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
ATIRESCGMODID = set1 PSIRESCGMODID = ---------
HANDLRESP = ON
GTT-ACT table is (3 of 2000) 1% full.
;
rtrv-gttact:psirescgmodid=set5
tekelecstp 18-05-07 10:48:35 EST EAGLE 46.7.0.0.0-74.5.0
rtrv-gttact:atirescgmodid=set5
Command entered at terminal #4.
ACTID ACTION DEFACTID NDGT UIMREQD
----------------------------------------------------------------
sfapp10 sfapp FALLBACK ALL off
SCFADDR = 19 FAILACTID = DISCARD
HLRADDR = USECDPA
ATIRESCGMODID = --------- PSIRESCGMODID = set5
HANDLRESP = ON
GTT-ACT table is (3 of 2000) 1% full.
;
rtrv-gttact:valtype=ir21totcap
tklc1131001 20-01-29 02:18:02 HST EAGLE 46.9
ACTID ACTION VALTYPE NDGT UIMREQD USEICMSG DEFACTID
---------------------------------------------------------------------
scpval1 scpval ir21totcap ALL off off DISCARD
GTT-ACT table is (2 of 2000) 1% full.
;
Related Topics