dlt-gta

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.

Range:: ayyyyyyyy
1 leading alphabetic and up to 8 following alphanumeric characters.

acn (optional)

Application context name. The ITU TCAP ACN field in the incoming MSU.

Range:

0 - 255, *, none

This parameter supports up to 7 subfields separated by a dash (e.g., 1-202-33-104-54-26-007).

* —any valid value in the ITU TCAP ACN field in the incoming MSU

none —there is no value in the ITU TCAP ACN field in the incoming MSU

cdssn (optional)

Starting CdPA subsystem number.

Range:: 0 - 255

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

Range:

s-, 0-255

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

prefix—s

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 (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).

Range:

s-, 0-16383, aa-zz

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

prefix—s-

nnnnn—0-16383

gc—aa-zz

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

cgpcn24 (optional)

24-bit ITU national CgPA point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).

Range:

000-255

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

msa—000–255

ssa—000–255

sp—000–255

cgpcn16 (optional)

16-bit ITU national CgPA point code with subfields unit number-sub number area-main number area (un-sna-mna).

Range:: 000-127; Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).; un---000---127; sna---000---15; mna---000---31

cgssn (optional)

Starting CgPA subsystem number.

Range:: 0 - 255

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.

dpc/dpca/dpci/dpcn/dpcn24/dpcn16 (optional): 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).

Range:

s-, 0-255

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

prefix—s

zone—0-7

area—000-255

id—0-7

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

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

Range:

s-, 0-16383, aa-zz

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

prefix—s-

nnnnn—0-16383

gc—aa-zz

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

dpcn24 (optional)

24-bit ITU national destination point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).

Range:

000-255

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

msa—000–255

ssa—000–255

sp—000–255

dpcn16 (optional)

16-bit ITU national destination point code with subfields unit number-sub number area-main number area (un-sna-mna).

Range:: 000-127; Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).; un---000---127; sna---000---15; mna---000---31

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.

ecdssn (optional)

Ending CdPA subsystem number.

Range:: 0 - 255

ecgssn (optional)

Ending CgPA subsystem number.

Range:: 0 - 255

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

family (optional)

This parameter specifies the ANSI TCAP family field in the incoming MSU.

Range:

0 - 255, *, none

* —any valid value in the ANSI TCAP family field in the incoming MSU

none —there is no value in the ANSI TCAP family field in the incoming MSU

gta (optional)

Global title address. The beginning 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.

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

Range:

s-, 0-255

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

prefix—s

zone—0-7

area—000-255

id—0-7

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

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

Range:

s-, 0-16383, aa-zz

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

prefix—s-

nnnnn—0-16383

gc—aa-zz

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

opcn24 (optional)

24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).

Range:

000-255

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

msa—000–255

ssa—000–255

sp—000–255

opcn16 (optional)

16-bit ITU national originating point code with subfields unit number-sub number area-main number area (un-sna-mna).

Range:: 000-127; Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).; un---000---127; sna---000---15; mna---000---31

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

saddr (optional)

Start Address (Similar to GTA). This parameter specifies the beginning 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

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 Aborted

If 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 
;

Related Topics