4.335 ent-rtx
Use this command to enter an exception route entry. An exception route is associated with an entry in the Routing table. When the Origin-Based MTP Routing feature is enabled and turned on, the least cost route available for an MSU to be routed to a Destination Point Code over a specified linkset is used.
Up to 6 routes can be defined to a single entry in the Routing table. Up to 8000 routesets can be defined for an STP. This total must include at least one normal route (not an exception route). The remaining 7999 routesets can include any combination of normal and exception routes.
Note:
A routeset is a collection of routes to a destination. Each routeset can have up to 6 routes, with 16 links on each route. An exception routeset is a collection of up to 6 exception routes that have the same DPC, exception class, and criteria.Parameters
- 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.
- dpci (mandatory)
- 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).
- dpcn (mandatory)
- 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:npcfmiti
flexible point code option. A group code must be specified when the ITUDUPPDC 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).
- dpcn24 (mandatory)
- 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).
- dpcn16 (mandatory)
- 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).
- lsn (mandatory)
- Linkset Name. The name of the linkset that is associated with the specified exception route.
- cic (optional)
- Starting Circuit Identification Code. This parameter is used alone or together with the ecic parameter as exception routing criteria for the specified exception route.
- ecic (optional)
- Ending Circuit Identification Code. This parameter, together with the cic parameter, defines the CIC range that is used as exception routing criteria for the specified exception route.
- force (optional)
- The force=yes parameter must be specified when the ilsn parameter value is the same as the lsn parameter value.
- ilsn (optional)
- Incoming Link Set Name. The name of the originating linkset. This value is used as part of the exception routing criteria for the specified exception route.
- 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).
- Synonym:
- opca
- 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.
- 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).
- 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:npcfmit
flexible point code option. A group code must be specified when the ITUDUPPDC 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).
- 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).
Example
ent-rtx:dpca=1-1-1:opca=2-3-3:lsn=lset1:rc=30
ent-rtx:dpca=1-3-1:ilsn=lset2:lsn=lset3:rc=20
ent-rtx:dpca=2-100-1:si=5:lsn=lset5:rc=50
Dependencies
Only one of the opc, ilsn, cic, or si parameters can be specified for a exception route entry.
For an ANSI origination point code that is defined using asterisks (nnn-*-*), the value of the network identifier subfield (nnn) must be greater than 5.
If the ecic parameter is specified, the cic parameter must also 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 enabled and turned on before this command can be entered.
The point code specified by the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter must already exist in the Route table.
The value specified for the dpc parameter cannot already be used as an adjacent point code (APC).
The linkset name, as defined by the ilsn or lsn parameter, must exist.
An exception route entry cannot already exist with the same input parameter values, other than the relative cost.
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.
A maximum of 6 exception routes can be associated with the specified DPC and criteria.
A maximum total of 8000 exception routes and normal routes can be defined for the EAGLE. At least one route must be a normal (not exception) route. The remaining routes (up to 7999) can be all normal routes, all exception routes, or any combination of normal and exception routes.
The network domain of the adjacent point code in the linkset or of the routes in the specified routeset must be the same as the network domain of the specified destination point code or its alias.
The adjacent or secondary point code type and group code of the linkset or linksets in the specified routeset must match the point code type and group code of the destination point code.
The specified CIC/ECIC range must not overlap an existing range.
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.
If the ilsn and lsn parameters 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 opcn parameter must be in the same ITU-N group as the dpcn parameter.
The Group Code of the APCN in the ilsn parameter must be the same as the Group Code of the dpcn parameter.
ANSI network routing and cluster point codes as OPC exception route criteria are not allowed for ITU destinations.
ITU point codes as OPC exception route criteria are not allowed for ANSI Network and Cluster destination.
If the lsn parameter is specified, then the rc parameter must be specified.
If a proxy destination is used, then this command cannot be entered.
The value specified for the destination point code must be a full point code and not a cluster or network point code.
The destination point code specified by the dpc parameter must have routes provisioned.
The Nested Cluster Routing feature must be turned on before an exception route can be assigned to cluster members.
The STPOPTS table is corrupt or cannot be found.
The value specified for the opc/opca/opci/opcn/opcn24/opcn16 parameter 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
ent-rtx:dpci=2-100-1:si=5:lsn=lset5:rc=50
stdcfg2b 06-05-19 18:20:11 EST EAGLE 35.0.0
ENT-RTX: MASP A - COMPLTD
Related Topics