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.
actid (mandatory)

GTT Action ID. The Action ID associated with the GTT Action entry.

Range:
ayyyyyyyy

1 leading alphabetic character and up to 8 following alphanumeric characters

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.

Range:
0 - 255
Default:
No change to the current value
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.

Range:
ayyyyyyyy

1 leading alphabetic character followed by up to 8 alphanumeric characters

Default:
None
bursts (optional)
The number of previous 30 second windows from where the unused capacity can be carried over to the current window.
Range:
0 - 2
Default:
0
cdgtmodid (optional)
Called party global title modification identifier.
Range:
ayyyyyyyy

1 alphabetic followed by up to 8 alphanumeric characters

none —removes the association between the GTT Action entry and the CdPGT modification identifier

Default:
No change to the current value
cggtmodid (optional)
Calling party global title modification identifier.
Range:
ayyyyyyyy

1 alphabetic character followed by up to 8 alphanumeric characters

none —removes the association between the GTT Action entry and the CgPGT modification identifier

Default:
No change to the current value
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).
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 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).
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

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).

Range:
s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

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).
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un---000---127
sna ---000---15
mna---000---31
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).
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

cgpcogmsg (optional)
The data used as the Calling Party Point Code in the outgoing message.
Range:
dflt
Default. The standard Global Title Translation process supplies the CgPA PC.
cgpcicmsg
CgPA PC data from the incoming MSU 
opcicmsg
OPC data from the incoming MSU
provcgpc
provisioned CGPC/CGPCA/CGPCI/CGPCN/CGPCN24/CGPCN16 data in the GTT Action
remove
CGPC will be removed from outgoing MSU
Default:
No change to the current value
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.

Range:
0 - 255
Default:
No change to the current value
loopset (optional)
SCCP loopset name. This parameter associates a GTT Action with a loopset.
Range:
ayyyyyyy

One leading alphabetic character and up to 7 following alphanumeric characters.

none —disassociates the GTT Action from all loopsets

Default:
No change to the current value
mapset (optional)
MAP Set ID. The Mated Application Set ID.
Range:
1 - 36000, dflt

dflt —Default MAP set

Default:
No change to the current value
mrnset (optional)
MRN Set ID. The Mated Relay Node Set ID.
Range:
1 - 3000, dflt, none

dflt —Default MRN Set ID

none —The GTT Action does not participate in any loadsharing.

Default:
No change to the current value
nactid (optional)
New GTT Action ID.
Range:
ayyyyyyyy

1 leading alphabetic character and up to 8 following alphanumeric characters

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.
Range:
1-21, all
all - All the digits present in the SCCP and MAP parameters are matched.
Default:
all
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.

Range:
uimreqd
useicmsg
handlresp
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.

Range:
uimreqd
useicmsg
handlresp
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).

Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

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).

Range:
s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

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).

Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

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).
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un---000---127
sna ---000---15
mna---000---31
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.

Range:
ayyyyyyyy

1 leading alphabetic character followed by up to 8 alphanumeric characters

Default:
None
ri (optional)
Routing indicator. The routing indicator in the SCCP called party address of the MSU being processed.
Range:
gt
route by the global title digits
ssn
route by the subsystem number
snai (optional)
The service nature of address indicator.
Range:
Sub -- Subscriber number
Natl -- National significant number
intl -- International 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
ccrndn -- Country code, routing number, and national directory number
snp (optional)
The service numbering plan.
Range:
e164 ---- E.164 numbering plan
e212 ---- E.212 numbering plan
e214 ---- E.214 numbering plan
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.

Range:
CDPA --- SCCP CDPA GTA, NP and NAI (if GTI=4 and NP/NAI is present) is used for comparison.
CGPA --- SCCP CGPA GTA, NP and NAI (if GTI=4 and NP/NAI is present) is used for comparison.
Default:
CDPA
srvcerr (optional)
The action to be performed when the Service triggered by GTT Action Services fails. The MSU can be processed by either applying the results of the pre-Service GTT, or continue with the specific Service error.
Range:
SRVC --- Continue with specific service error
GTT --- Apply the result of pre-GTT service
Default:
SRVC
srvcname (optional)
Service to be applied on the MSU when act is set to srvc.
Range:
GFLEX, GPORT, SMSMR
ssn (optional)

Subsystem number. The value used for the SSN in the SCCP called party address of the MSU.

Range:
2 - 255, none

none —an SSN is not used

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.
Range:
1-42949676295
Default:
1
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 and used for comparison.
Range:
SMRPDA --- MAP digits, NP and NON (if NP and NON are present) from SMRPDA are used for comparison
SMRPOA --- MAP digits, NP and NON (if NP and NON are present) from SMRPOA are used for comparison
Default:
SMRPDA
udtserr (optional)
UDTS error cause. The reason associated with the UDTS GTT Action for discarding the message.
Range:
0 - 255
Default:
No change to the current value

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
;