4.210 dlt-gta
Use this command to delete the GTA (global title address) information applicable to a global title selector combination.
This command deletes the routing of SCCP messages for specified global title addresses from designated destinations and their subsystem numbers.
Note:
If the EGTT feature is turned on, then the GTT Selector (ent/chg/dlt/rtrvgttsel
), GTT Set
(ent/dlt/rtrv-gttset
), and GTA
(ent/chg/dlt/rtrvgta
) commands replace the Translation Type
(ent/dlt/rtrv-tt
) and Global Title Translation
(ent/chg/dlt/rtrv-gtt
) commands. It is not recommended to
run
ent/dlt/rtrv-tt & ent/chg/dlt/rtrv-gtt
commands
as it may cause the advance GTA fields of GTT entry to be reset to the default
values.
Parameters
- gttsn (mandatory)
- GTT set name. A GTT set is an entity to which global title addresses and selectors are assigned.
- cgpc (optional)
- ANSI CgPA point code with subfields
network
indicator-network cluster-network cluster member (ni-nc-ncm).
- Synonym:
- cgpa
- Range:
- 0-255, *
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
The asterisk (*) value is not valid for the ni subfield.
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.When
chg-sid:pctype=ansi
is specified, ni-*-* 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 (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 (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
- cgpcn24 (optional)
- 24-bit ITU national CgPA point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
- cgpcn16 (optional)
- 16-bit ITU national CgPA point code with subfields unit number-sub number area-main number area (un-sna-mna).
- dpc (optional)
- ANSI destination point code with subfields
network
indicator-network cluster-network cluster member (ni-nc-ncm).
- Synonym:
- dpca
- Range:
- 0-255, *
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
The asterisk (*) value is not valid for the ni subfield.
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.When
chg-sid:pctype=ansi
is specified, ni-*-* is valid if ni =006–255.The point code 000-000-000 is not a valid point code.
- dpci (optional)
- ITU international destination point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).
- dpcn (optional)
- ITU destination 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 (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
- dpcn24 (optional)
- 24-bit ITU national destination point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
- dpcn16 (optional)
- 16-bit ITU national destination point code with subfields unit number-sub number area-main number area (un-sna-mna).
- eaddr (optional)
- End Address (Similar to EGTA). This parameter
specifies the end of a range of MAP digits
(IMEI/IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).
- Range:
- 1 - 21
digits
If the Hex Digit Support for GTT feature is not enabled, the range is 1 - 21 decimal digits; valid digits are 0-9
If the Hex Digit Support for GTT feature is enabled and on, the range is 1 - 21 hexadecimal digits; valid digits are 0-9, a-f, A-F
- Default:
- Same as the specified SADDR value.
- egta (optional)
- End global title address. This parameter specifies
the end of a range of global title digits.
- Range:
- 1 - 21 digits
If the Hex Digit Support for GTT feature is not enabled and on, the range is 1 - 21 decimal digits; valid digits are 0-9
If the Hex Digit Support for GTT feature is enabled and on, the range is 1 - 21 hexadecimal digits; valid digits are 0-9, a-f, A-F
- Default:
- Same as the specified gta value
- opc (optional)
- ANSI originating point code with subfields
network
indicator-network cluster-network cluster member (ni-nc-ncm).
- Synonym:
- opca
- Range:
- 0-255, *
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
The asterisk (*) value is not valid for the ni subfield.
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.When
chg-sid:pctype=ansi
is specified, ni-*-* is valid if ni =006–255.The point code 000-000-000 is not a valid point code.
- opci (optional)
- ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).
- opcn (optional)
- ITU national originating 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 (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
- opcn24 (optional)
- 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
- opcn16 (optional)
- 16-bit ITU national originating point code with subfields unit number-sub number area-main number area (un-sna-mna).
- opcodetag (optional)
- The ITU TCAP opcodetag field in the incoming MSU.
- Range:
- none, local, global, any
none —there is no value in the ITU TCAP opcodetag field in the incoming MSU
local—The opcodetag is local in the ITU TCAP opcodetag field in the incoming MSU
global —The opcodetag is global in the ITU TCAP opcodetag field in the incoming MSU
any— any valid value in the ITU TCAP opcodetag field in the incoming MSU
- Default:
- any
- pkgtype (optional)
- Package type. The ANSI TCAP and ITU TCAP package
type.
- Range:
-
- ansiuni
- ANSI unidirectional
- qwp
- Query with Permission
- qwop
- Query without Permission
- cwp
- Conversation with Permission
- cwop
- Conversation without Permission
- any
- Wildcard value
- bgn
- Begin
- cnt
- Continue
- ansiabort
- ANSI abort
- end
- End
- ituabort
- ITU abort
- ituuni
- ITU unidirectional
- resp
- Response
- ANSI TCAP PKGTYPE—
- ansiuni, qwp, qwop, resp, cwp, cwop, ansiabort, any
- ITU TCAP PKGTYPE—
- bgn, ituabort, ituuni, any, end, cnt
Example
dlt-gta:gttsn=setcdgta:gta=123456789012345678901:egta=223456789012345678901
dlt-gta:gttsn=t800:gta=919461:egta=919468
dlt-gta:gttsn=setcggta:gta=323456789012345678901:egta=423456789012345678901
dlt-gta:gttsn=setcgpc:cgpca=001-001-001
dlt-gta:gttsn=setopc:opca=002-001-001
dlt-gta:gttsn=setcgssn:cgssn=100:ecgssn=200
The following example specifies hexadecimal digits for the GTA and EGTA.dlt-gta:gttsn=set1:gta=abcd:egta=abce
The following examples specify the GTA translations when the FLOBR feature is on.dlt-gta:gttsn=setcdssn:cdssn=100:ecdssn=150
dlt-gta:gttsn=setdpc:dpci=1-101-1
dlt-gta:gttsn=gtt1:cgpcn16=45-1-0
dlt-gta:gttsn=setimsi:saddr=3234567890:eaddr=4234567890
Dependencies
The gttsn parameter must be specified, cannot have a value of none, and must match an existing gttsn.
The length of the specified gta/saddr parameter must match the number of digits provisioned for the specified GTT set when the VGTT feature is turned off. If the VGTT feature is turned on, then up to 10 GTA/SADDR lengths can exist per GTT set. If the Support for 16 GTT Lengths in VGTT feature is turned on, then up to 16 GTA/SADDR lengths can exist per GTT set.
The specified gta/egta or saddr/eaddr range must exist for the specified GTT set in the STP active database. While an exact match is not required, you cannot specify an overlap with another range. If the range overlaps, an error is generated that displays a list of overlapped global title addresses. An example follows that shows what happens when the user attempts to enter a global title address range (such as 8005550000 to 8005559999) that overlaps an existing range. The overlapping links must match. If they do not, the error message displays the list of overlapped global title addresses:
The following GTA ranges overlap the input GTA range START GTA END GTA 8005550000 8005551999 8005552000 8005553999 8005554000 8005555999 DLT-GTA: MASP A - Command AbortedIf the egta/eaddr parameter is specified, the gta/saddr and egta/eaddr value must be the same length and the egta/eaddr value must be greater than the gta/saddr value.
The GTT table cannot be full in case a delete command causes a split requiring more entries to be added.
The cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16, opc/opca/opci/opcn/opcn24/opcn16, cgssn, gta, cdssn, opcode/acn/pkgtype, opcode/family/pkgtype, dpc/dpca/dpci/dpcn/dpcn24/dpcn16 or saddr parameter must be specified.
The cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16, opc/opca/opci/opcn/opcn24/opcn16 and dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameters must have a valid value within the range for each subfield.
If specified, the ecgssn/ecdssn parameter must be greater than the cgssn/cdssn parameter.
The Origin-based SCCP Routing feature must be enabled when specifying the cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16, opc/opca/opci/opcn/opcn24/opcn16, or (e)cgssn parameters.
The gta parameter must be specified if the GTTSN set type has a value of cdgta or cggta, and cannot be specified for other set types.
The cgpc/cgpca/cgpci/cgpcn/cgpcn24/cgpcn16 parameter must be specified if the GTTSN set type has a value of cgpc, and cannot be specified for other set types.
The opc/opca/opci/opcn/opcn24/opcn16 parameter must be specified if the GTTSN set type has a value of opc, and cannot be specified for other set types.
The cgssn parameter must be specified if the GTTSN set type has a value of cgssn, and cannot be specified for other set types.
If the specified GTT Set is an ANSI set, then the cgpc/cgpca, opc/opca, and dpc/dpca parameters must be valid ANSI point codes. If the specified GTT Set is an ITU set, then the cgpci/cgpcn/cgpcn24/cgpcn16, opci/opcn/opcn24/opcn16, and dpci/dpcn/dpcn24/dpcn16 parameters must be valid ITU point codes.
The range specified by the cgssn/ecgssn and cdssn/ecdssn parameters must exist for the specified GTT set.
The translation entry associated with the specified point code (dpc/dpca/dpci/dpcn/dpcn24/dpcn16, pc/pca/pci/pcn/pcn24/pcn16, or opc/opca/opci/opcn/opcn24/opcn16 or opcode value must already exist.
The range specified by the cgssn/ecgssn and cdssn/ecdssn parameters cannot overlap an existing range for the specified GTT set.
The cgpc, cgssn, gta, opc, cdssn, opcode and saddr parameters cannot be specified together in the command.
If the cgssn and cdssn parameters are both specified in the same command (in any order), then only the value for the last of the two parameters specified is used during processing.
The Hex Digit Support for GTT feature must be enabled and on before hexadecimal digits can be specified for the gta/saddr or egta/eaddr parameters.
If the specified GTT set has a set type of opcode (see the ent-gttset
command), then the opcode/acn/pkgtype or
opcode/family/pkgtype parameters must be
specified. These parameters cannot be specified for GTT sets with other set types.
If the specified GTT set has a set type of cdssn (see the ent-gttset
command), then the cdssn parameter must be
specified. The cdssn parameter cannot be
specified for GTT sets with other set types.
The value specified for the gttsn parameter must match the name of an existing GTT Set.
A TOBR quantity feature must be turned on before the opcode, pkgtype, acn, family, saddr, eaddr or defmapvr parameter can be specified.
The opcode, pkgtype, and family parameters must be specified together for ANSI TCAP translations. The opcode, pkgtype, and acn parameters must be specified together for ITU TCAP translations.
If the cgssn parameter is specified, then the ecdssn parameter cannot be specified. If the cdssn parameter is specified, then the ecgssn parameter cannot be specified.
If the family parameter is specified, then the pkgtype parameter must have a value of ansiuni, qwp, qwop, resp, cwp, cwop, ansiabort, or any.
If the acn parameter is specified, then the pkgtype parameter must have a value of bgn, ituabort, ituuni, any, end, or cnt.
If the opcodetag is specified by opcodetag parameter, then the pkgtype, opcode and acn must be specified.
E3701 Cmd Rej: PkgType, Opcode and ACN must be specified.
If the pkgtype=ituabort parameter is specified, then a value of none must be specified for the acn. opcode and opcodetag parameters.
If the pkgtype=ansiabort parameter is specified, then a value of none must be specified for the family and opcode parameters.
E5144 Cmd Rej: PKGTYPE abort requires ACN/FAMILY/OPCODE/OPTAG value none
The GTT Action Set table is corrupt or cannot be found.
If the GTT set specified by the gttsn parameter has a set type of dpc (see the ent-gttset
command),
then the dpc/dpca/dpci/dpcn/dpcn24/dpcn16
parameter must be specified. If the set type has a value other than dpc, then the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter cannot be specified.
The FLOBR feature must be turned on before the cdssn, ecdssn, or dpc parameter can be specified.
If the translation entry is referenced in GTT Action Path table, then the entry cannot be deleted.
The specified GTT set must have a set type of opcode (see the ent-gttset
command)
before the opcode/acn/pkgtype or opcode/family/pkgtype parameters can be specified. The
specified GTT set must have a set type of cdssn, cgssn,
cdgta/cgta, opc, or cgpc before
the cdssn, cgssn, gta, opc, or cgpc parameter, respectively, can be specified.
The acn and family parameters cannot be specified together in the command.
If the opc or dpc parameter is specified, then the (e)gta, (e)cgssn, (e)cdssn, and opcode parameters cannot be specified.
SADDR parameter must be specified if GTT set specified by gttsn parameter is of MBR type (IMEI/IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).
If the saddr parameter is specified, then the ecgssn/ecdssn parameters cannot be specified.
Notes
If a GTT is being deleted or changed and the point code (DPC or RTE) is not found in the route table (unless the point code is the STP’s true point code), the following message is displayed in the terminal scroll area:
NOTICE: No DPC and/or RTE found for GTT being deleted or changed.
The above situation may occur for the following reasons:
A database was upgraded from a release prior to EAGLE Release 27.1 or IP7 Secure Gateway Release 3.0 when GTT entries were not linked to the route table and the deletion of the DPC was permitted. The GTT referenced a DPC/RTE that was deleted, and the enforce reference counts between the GTT and route tables were not updated.
- A serious problem occurred in which the reference count rules were not enforced and a DPC and/or RTE were deleted while being referenced by a GTT entry. This indicates a software error; notify the Customer Care Center.
The error message E2478 was deleted in release 41.0 for PR 137896.
The error message E5099 was deleted in release 42.0 for PR 137290.
Output
The following example specifies GTA translations when the FLOBR feature is on. dlt-gta:gttsn=setcdssn:cdssn=100
rlghncxa03w 10-03-10 09:04:21 EST EAGLE 42.0.0
DLT-GTA: MASP A - CMPLTD
;