4.552 rtrv-rtx
Use this command to retrieve one or more exception route entries. Because all parameters are optional, the retrieve examines the entire Route table to find all entries that match the specified parameters. Entries with CIC-ECIC range values that fall in the range specified by the cic and ecic parameters are displayed.
Parameters
- 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.
- class (optional)
- Exception routing class. This parameter displays all exception route sets provisioned for the specified class.
- 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 values *, **, and *** are not valid for the ni subfield.
If ** or *** is specified for the nc subfield, either *, **, or *** must be specified for the ncm 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)
- 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).
- dpcn (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 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 (-).
An asterisk (*) can be specified for the node (nnnnn or every member of a flexible point code) or for the group code (gc) only when group codes are present in the point codes.
An asterisk (*) can be specified either for the node or for the group code, but not both.
prefix—s-, p-, ps-
nnnnn—0-16383, *
gc—aa-zz, *
m1-m2-m3-m4—0-14 for each member; values must sum to 14; or *-*-*-* when the point code includes a group code.
- 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).
- 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).
- 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.
- ilsn (optional)
- Incoming Link Set Name. The parameter 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).
- 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 values *, **, and *** are not valid for the ni subfield.
If ** or *** is specified for the nc subfield, either *, **, or *** must be specified for the ncm 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 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: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 (-).
An asterisk (*) can be specified for the node (nnnnn or every member of a flexible point code) or for the group code (gc) only when group codes are present in the point codes.
An asterisk (*) can be specified either for the node or for the group code, but not both.
prefix—s-, p-, ps-
nnnnn—0-16383, *
gc—aa-zz, *
m1-m2-m3-m4—0-14 for each member; values must sum to 14; or *-*-*-* when the point code includes a group code.
- 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
rtrv-rtx:dpca=1-1-1
rtrv-rtx:opca=6-*-*
rtrv-rtx:ilsn=lset4
rtrv-rtx:si=5
rtrv-rtx:cic=0:ecic=16383
rtrv-rtx:dpcn16=121-10-25
Dependencies
Only one of the opc, ilsn, cic, si, or class parameters can be specified.
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 Origin-Based MTP Routing feature must be enabled and turned on before this command can be entered.
The linkset name, as defined by the ilsn or lsn parameter, must exist.
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 value specified for the destination point code must be a full point code and not a cluster or network point code.
Notes
** can be used in the network cluster member (ncm) subfield of dpc/dpca and opc/opca parameters to retrieve all point codes residing in (members of) a given network cluster (ni-nc).
** can be used in the network cluster (nc) subfield of dpc/dpca and opc/opca parameters to retrieve all point codes residing in (members of) a given network (ni).
*** can be used in the network cluster member (ncm) subfield of dpc/dpca/opc/opca parameters to retrieve all point codes residing in (members of) a given network cluster (ni-nc), and the network cluster address (if any).
*** can be used in the network cluster (nc) subfield of dpc/dpca and opc/opca parameters to retrieve all point codes residing in (members of) a given network (ni), and the network address (if any).
* is allowed only for retrieves (for example, rtrv-rtx:dpcn=*-aa
or rtrv-rtx:opcn=*-xy
) on ITU-N DPCs and ITU-N OPCs if the ITUDUPPC feature is on. ** and *** are not allowed for ITU-N DPCs and OPCs (for example, dpcn=**-xy is rejected). The node and group code cannot both be * (dpcn=*-* is rejected).
Output
This example retrieves all provisioned exception routes:
rtrv-rtx
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCA RTX-CRITERIA LSN RC APC
200-002-001 OPCA
001-001-001 lsn11 15 001-002-003
001-002-001 lsn10 99 001-002-002
CIC - ECIC
0 9 lsn10 1 001-002-002
10 16383 lsn10 2 001-002-002
SI
3 lsn12 1 001-002-004
9 lsn12 21 001-002-004
11 lsn12 9 001-002-004
DPCI RTX-CRITERIA LSN RC APC
s-2-029-6 OPCI
3-030-0 lsn27 28 s-2-020-6
CIC - ECIC
34 44 lsn27 6 s-2-020-6
45 55 lsn27 16 s-2-020-6
SI
3 lsn27 7 s-2-020-6
15 lsn27 14 s-2-020-6
DPCN RTX-CRITERIA LSN RC APC
s-08379-aa OPCN
s-08278-aa lsn62 8 s-12693-aa
CIC - ECIC
99 100 lsn62 9 s-12693-aa
999 1989 lsn62 99 s-12693-aa
SI
4 lsn56 29 s-08279-aa
14 lsn56 44 s-08279-aa
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves all exception routes provisioned for a specific DPC:
rtrv-rtx:dpcn=s-08379-aa
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCN RTX-CRITERIA LSN RC APC
s-08379-aa OPCN
s-08278-aa lsn62 8 s-12693-aa
CIC - ECIC
99 100 lsn62 9 s-12693-aa
999 1989 lsn62 99 s-12693-aa
SI
4 lsn56 29 s-08279-aa
14 lsn56 44 s-08279-aa
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves all provisioned exception routes for a specific exception criteria:
rtrv-rtx:dpcn=s-08379-aa:opcn=s-08278-aa
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCN RTX-CRITERIA LSN RC APC
s-08379-aa OPCN
s-08278-aa lsn62 8 s-12693-aa
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves all provisioned exception routes for a specific exception criteria:
rtrv-rtx:dpci=s-2-029-6:cic=45:ecic=55
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCI RTX-CRITERIA LSN RC APC
s-2-029-6 CIC - ECIC
45 55 lsn27 16 s-2-020-6
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves exception routes for a specific class:
rtrv-rtx:opc=1-1-1
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCA RTX-CRITERIA LSN RC APC
200-002-001 OPCA
001-001-001 lsn11 15 001-002-003
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves exception routes for a specific linkset:
rtrv-rtx:lsn=lsn27
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCI RTX-CRITERIA LSN RC APC
s-2-029-6 OPCI
3-030-0 lsn27 28 s-2-020-6
CIC - ECIC
34 44 lsn27 6 s-2-020-6
45 55 lsn27 16 s-2-020-6
SI
3 lsn27 7 s-2-020-6
15 lsn27 14 s-2-020-6
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves exception routes for the network cluster members of an OPC:
rtrv-rtx:opc=40-**-*
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCA RTX-CRITERIA LSN RC APC
002-002-003 OPCA
040-001-001 bd1 10 002-002-002
040-001-002 bd1 15 002-002-002
040-001-* bd1 5 002-002-002
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 190
EXCEPTION DPC(s): 21
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 217
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves exception routes for all cluster member plus itself of an OPC:
rtrv-rtx:opc=40-***-*
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCA RTX-CRITERIA LSN RC APC
002-002-003 OPCA
040-001-001 bd1 10 002-002-002
040-001-002 bd1 15 002-002-002
040-*-* bd1 0 002-002-002
040-001-* bd1 5 002-002-002
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 190
EXCEPTION DPC(s): 21
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 217
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves route exceptions by criteria class:
rtrv-rtx:class=cic
eagle10115 08-12-09 10:00:37 EST EAGLE 40.1.0
DPCA RTX-CRITERIA LSN RC APC
200-002-001 CIC - ECIC
0 9 lsn10 1 001-002-002
10 16383 lsn10 2 001-002-002
DPCI RTX-CRITERIA LSN RC APC
s-2-029-6 CIC - ECIC
34 44 lsn27 6 s-2-020-6
45 55 lsn27 16 s-2-020-6
DPCN RTX-CRITERIA LSN RC APC
s-08379-aa CIC - ECIC
99 100 lsn62 9 s-12693-aa
999 1989 lsn62 99 s-12693-aa
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
This example retrieves exception routes for a specific class:
rtrv-rtx:opcn16=121-10-15
eagle10115 08-12-13 10:00:37 EST EAGLE 45.1.0
DPCN16 RTX-CRITERIA LSN RC APC
200-002-001 OPCN16
121-010-015 lsn11 15 001-002-003
DESTINATION ENTRIES ALLOCATED: 2000
FULL DPC(s): 188
EXCEPTION DPC(s): 17
NETWORK DPC(s): 2
CLUSTER DPC(s): 4
TOTAL DPC(s): 211
CAPACITY (% FULL): 11%
ALIASES ALLOCATED: 12000
ALIASES USED: 216
CAPACITY (% FULL): 2%
X-LIST ENTRIES ALLOCATED: 500
;
Related Topics