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.
Range:
0 - 16383
class (optional)
Exception routing class. This parameter displays all exception route sets provisioned for the specified class.
Range:
opc
ilsn
cic
si
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).
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 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).
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
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.
Range:
0 - 16383
ilsn (optional)
Incoming Link Set Name. The parameter value 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.

lsn (optional)
Link Set Name. The linkset 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-

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).
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 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).
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
si (optional)
Service Indicator. This parameter is used as part of the exception routing criteria for the specified exception route.
Range:
3 - 15

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 

;