chg-rtx

4.114 chg-rtx

Use this command to change an exception route entry in the Routing table.

Parameters

At least one of the following optional parameters must be specified: opc, ilsn, si, or cic.

dpc (mandatory)

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-

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 (mandatory): Destination point code.

dpci (mandatory)

Destination Point Code. ITU international 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 (mandatory)

Destination Point Code. 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 ITUPUPPC 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 (mandatory)

Destination Point Code. 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 (mandatory)

Destination Point Code. 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 (mandatory)

The name of the linkset associated with the specified exception route.

Range:: ayyyyyyyyy
1 alphabetic character followed by up to 9 alphanumeric characters.

cic (optional)

Starting Circuit Identification Code. This parameter is used alone or with the ecic parameter as exception routing criteria for the specified exception route.

Range:: 1 - 16383

ecic (optional)

Ending Circuit Identification Code. This parameter and the cic parameter define the CIC range that is used as exception routing criteria for the specified exception route.

Range:: 0 - 16383

force (optional)

This parameter must be specified when the ilsn parameter value is the same as the nlsn parameter value.

Range:: yes

ilsn (optional)

The name of the incoming/originating linkset. This parameter is used as part of the exception routing criteria for the specified exception route.

Range:: ayyyyyyyyy
1 alphabetic character followed by up to 9 alphanumeric characters

nlsn (optional)

The new linkset name that replaces the linkset name associated with the specified exception route.

Range:: ayyyyyyyyy
1 alphabetic character followed by up to 9 alphanumeric characters

opc (optional)

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

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.

opc/opca/opci/opcn/opcn24/opcn16 (optional): Originating Point Code

opci (optional)

ITU international 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.

opcn (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 ITUPUPPC 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

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

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

rc (optional)

The relative cost associated with the specified exception route.

Range:: 0 - 99

si (optional)

Service indicator. This parameter is used as part of the exception routing criteria for the specified exception route.

Range:: 3 - 15

Example

This example changes the relative cost of an existing exception route.

chg-rtx:dpca=1-1-1:opca=2-3-3:lsn=lset1:rc=30

This example changes the linkset associated with the exception route.

chg-rtx:dpca=1-2-1:si=3:lsn=lset2:nlsn=lset3

This example changes the linkset and relative cost of the exception route.

chg-rtx:dpca=1-3-1:ilsn=lset2:lsn=lset3:nlsn=lset4:rc=20

chg-rtx:dpci=2-100-1:ilsn=lset2:lsn=lset4:rc=10

chg-rtx:dpci=2-100-1:si=5:lsn=lset5:rc=50

chg-rtx:dpcn16=121-10-15:si=5:lsn=lset5:rc=50

Dependencies

Only one of the opc, ilsn, cic, or si parameters can be specified for an exception route entry.

If the ecic parameter is specified, the cic parameter must be specified.

The ecic parameter value cannot be less than the cic parameter value.

The opc/opca/opci/opcn/opcn24/opcn16 parameter value cannot be the same as the dpc parameter value.

The Origin-Based MTP Routing feature must be turned on before this command can be entered.

The specified combination of exception route parameter conditions must already exist.

The linkset name, as defined by the ilsn, lsn, or nlsn parameter, must exist.

The 6-Way Loadsharing on Routesets feature must be turned on before more than 2 routes can be provisioned with the same relative cost for a given exception route criteria.

The network domain of the adjacent point code in the linkset or in the routes in the specified routeset must be the same as the network domain of the specified destination point code or its alias.

The APC/SAPC type and group code in the linkset specified by the lsn parameter must match the value specified by the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter.

The Linkset table is corrupt or cannot be found.

The Route table is corrupt or cannot be found.

The Route Exception table is corrupt or cannot be found.

The nlsn parameter value cannot be the same as the lsn parameter value.

Either the nlsn parameter, the rc parameter, or both parameters must be specified.

The value specified for the destination point code must be a full point code and not a cluster or network point code.

The point code specified by the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter must exist in the destination table.

If the ilsn and lsn parameter have the same value, or if the value specified for the opc/opca/opci/opcn/opcn24/opcn16 parameter is the same as the APC of the linkset specified by the lsn parameter, then the force=yes parameter must be specified.

The route cost specified by the rc parameter must differ from the existing route cost for the linkset specified by the lsn parameter.

The route associated with the linkset specified by the lsn parameter must already exist in the specified exception route.

The route associated with the linkset specified by the nlsn parameter cannot already exist in the specified exception route.

The value specified for the opc/opca/opci/opcn/opc24/opcn16 parameters cannot be the same as the adjacent point code of the linkset specified by the lsn parameter.

The J7 Support feature must be enabled before the dpcn16/opcn16 parameter can be specified.

Output

chg-rtx:dpca=1-1-1:opc=2-3-3:lsn=lset1:rc=30


    stdcfg2b 06-05-19 18:20:11 EST  EAGLE  35.0.0
    CHG-RTX: MASP A - COMPLTD

Related Topics