dlt-rte

Use this command to remove either a single route or all routes from the system database.

Parameters

Note:

See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.

The dpc/dpca/dpci/dpcn/dpcn24/dpcn16 or cic parameter must be specified. If the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter is specified, then action is taken upon the historic routes of the destination entity only.

all (optional)

This parameter removes all destinations from the system database.

Range:

yes

Default:

no

dpc (optional)

ANSI destination 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:

dpca

Range:

p-, 000-255, *

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

prefix—p-

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.

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

dpc/dpca/dpci/dpcn/dpcn24/dpcn16 (optional): Destination point code.

dpci (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.

dpcn (optional)

ITU national 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, 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

dpcn24 (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

dpcn16 (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

lsn (optional)

The name of the linkset associated with the route.

Note:

This parameter must be specified when the all parameter is not specified, and cannot be specified when the all=yes parameter is specified.

Range:: ayyyyyyyyy
1 alphabetic character followed by 9 alphanumeric characters
Default:: No linkset name is specified

Example

Delete route to DPC 1-1-1 using linkset HQ435326:

dlt-rte:dpc=1-1-1:lsn=hq435326

Delete all routes to DPC 2-2-2:

dlt-rte:dpc=2-2-2:all=yes

Delete route to DPCN 3-15-15-15-sp using link E1M2ITUN:

dlt-rte:dpcn=3-15-15-15-sp:lsn=e1m2itun

Delete route for DPCN24 10-100-14 using linkset WE123624:

dlt-rte:dpcn24=10-100-14:lsn=we123624:rc=10

Delete route to private point code DPC p-1-1-1 using linkset HQ 325426:

dlt-rte:dpc=p-1-1-1:lsn=hq325426

Delete all routes to private point code DPC p-21-*-*:

dlt-rte:dpc=p-21-*-*:all=yes

Delete route to spare point code DPCI s-1-100-1 using linkset WE123624:

dlt-rte:dpci=s-1-100-1:lsn=we123624

Delete route to spare point code DPCN16 121-10-15 using linkset WE123624:

dlt-rte:dpcn16=121-10-15:lsn=we123624

Dependencies

The dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter must exist in the Destination Point Code table.

The value of the lsn parameter must exist in the Linkset table.

If the all=yes parameter is specified, then the lsn parameter cannot be specified.

At least one optional parameter must be specified.

The destination point code of a route must be a full point code (ni-nc-ncm) or a cluster point code (ni-nc-*).

If the specified destination address is a full point code address (ni-nc-ncm) and is a member of a provisioned cluster (ni-nc-*), then whether the ordered routes can be deleted is determined by the destination address’s nested cluster allowed indicator. This value is set with the ncai parameter of the ent/chg-dstn commands:

If the ncai=no parameter is specified, then the ordered route cannot be deleted.
If the ncai=yes parameter is specified, then the destination address is a member of a provisioned nested cluster where the ordered routes of the provisioned members can be deleted. Deletion of the ordered routes of a provisioned member results in the provisioned member assuming the attributes of its cluster

If the specified destination address is a network cluster address (ni-nc-*), then the method used to delete the specified ordered route attributes is determined by the setting of the destination address’s nested cluster allowed indicator. This value is set with the ncai parameter of the ent/chg-dstn commands.

If the ncai=no parameter is specified, then the specified ordered route is deleted for each signaling point code having the same network identifier (ni) and network cluster (nc) codes.
If the ncai=yes parameter is specified, then the specified destination is a nested cluster where deletion of the cluster route will not delete the ordered route of the provisioned member.

If the dpcn parameter is specified, the format of the point code(s) must match the format you assigned with the chg-stpopts:npcfmti parameter.

The last route for the specified destination point code being removed cannot be referenced by a mated application, or a concerned signaling point code. If any of the destinations referencing the specified routset exist in the MAP table, then the last route of the routeset cannot be deleted.

If any of the destinations referencing the routset is used by the redirect function, then the last route of the routeset cannot be deleted.

The last route to a destination point code that exists in the MRN table cannot be deleted until the point code is deleted from the MRN table. If any of the destinations referencing the specified routset exists in the MRN table, then the last route of the routeset cannot be deleted.

The last route to a destination point code that still exists in the Concerned Secondary Point Code (CSPC) table cannot be deleted until the point code is deleted from the CSPC table. If any of the destinations referencing the routset exist in the CSPC table, then the last route of the routeset cannot be deleted.

If the destination point codes associated with the routeset are referenced by GTT, then the last route cannot be deleted. If the last route to a destination point code is referenced by a GTT, then the route cannot be deleted until one of the following actions is performed:

Delete the GTT using the route’s destination.
Change the route used by the GTT to a route using a different destination.
Add another route using the same destination.

The NRT feature must be turned on before the dpc/dpca parameter can be specified.

When using network routing, if the destination point code has a value of * in the nc field, the ncm field must also be * (for example, dpc=21-*-*).

If the routeset does not contain routes, then the all=yes parameter cannot be specified.

If the destination point code is specified, then the linkset must exist in the historic routeset.

The Route table is corrupt or cannot be found.

The Linkset table is corrupt or cannot be found.

The Redirect table is corrupt or cannot be found.

The last route to a destination that contains exception routes cannot be deleted. If any of the destinations referencing the specified routset contains exception routes, then the last route of the routeset cannot be deleted.

If a cluster point code is provisioned with ncai=no, and any cluster member has an associated exception route, then the routeset cannot be deleted using the all=yes parameter.

The Route Exception table is corrupt or cannot be found.

The value of the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter cannot exist in the Application Filter table.

The last route to a destination point code that still exists in the Prepaid SMS Options (PPSOPTS) table cannot be deleted until the point code is deleted from the PPSOPTS table. If any of the destinations referencing the routset exist in the PPSOPTS table, then the last route of the routeset cannot be deleted.

If multiple routes are assigned to a point code, then the route that uses the proxy linkset must be the final route that is deleted.

The network type of the linkset and routeset must match.

The last route to a destination point code that exists in the PCT table cannot be deleted until the Filter Point Code or the Real Point Code is deleted from the table.

The Prepaid SMS Options Table must be available.

Notes

In this command, only ITU-international and ITU national point codes support the spare point code subtype prefix (s-) and the private and spare point code subtype prefix (ps-). All of the point code types support the private (internal) point code subtype prefix (p-).

Output

dlt-rte:dpc=1-1-1:lsn=ls01


    rlghncxa03w 04-01-07 11:43:04 EST  EAGLE 31.3.0
    DLT-RTE: MASP A - COMPLTD 
;

This example shows the output when the GTT feature is turned on:

dlt-rte:dpc=2-2-2:all=yes


    rlghncxa03w 10-03-06 11:43:04 EST  EAGLE 42.0.0
    WARNING - ROUTE MAY BE REFERENCED BY MAP OR CSPC.
    DLT-RTE: MASP A - COMPLTD 
;

4.244 dlt-rte