4.539 rtrv-mrn
Use this command to display the Mated Relay Node application relationship information maintained by the EAGLE. This information is used to support the routing of SCCP management SSP/SSA messages.
If the Intermediate GTT Load-Sharing feature is on and the Flexible GTT Load-Sharing feature is enabled, then use this command to retrieve MRN set information.
If the GTT Load Sharing with Alternate Routing Indicator (GTT LS ARI) feature is enabled, then use this command to display Alternate RI Mate information.
Parameters
Note:
See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.Note:
Definitions for the feature options specified by the on parameter are located in the Notes section.- on (optional)
- Enables or turns on the specified options. A comma-separated list of options that are requested to be turned on. Up to 8 options can be specified in the list.
- pc (optional)
- ANSI point code in the form of network indicator-network cluster-network cluster member (ni-nc-ncm).
- Synonym:
- pca
- Range:
- 000-255
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
When
chg-sid:pctype=ansiis specified, ni = 000 is not valid.When
chg-sid:pctype=ansiis specified, nc = 000 is not valid if ni = 001–005.When
chg-sid:pctype=ansiis specified, nc = 000 is valid if ni = 006–255.The point code 000-000-000 is not a valid point code.
- pci (optional)
- ITU international point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).
- pcn (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:npcfmtiflexible 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 (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
Example
rtrv-mrn
rtrv-mrn:pc=1-1-2
rtrv-mrn:pcn=s-1-1-1-123-aa
rtrv-mrn:pci=1-55-1:mrnset=2
rtrv-mrn:pcn=1001:mrnset=dflt:on=refcnt
rtrv-mrn:pcn16=1-2-3:mrnset=dflt
Dependencies
A point code that is specified in the command must already exist in the MRN table.
The mrnset parameter can only be specified when the Flexible GTT Load-Sharing feature is enabled.
If the Flexible GTT Load Sharing feature is ON, then the PC and MRN set must be specified together.
The specified MRN set must already exist in the MRN table.
If the Flexible GTT Load Sharing feature is enabled, then the specified PC must already exist in the specified MRN set.
The Intermediate Global Title Translation Load Sharing (IGTTLS) feature must be turned on before this command can be entered.
Notes
This command can be canceled using the F9 function key or the canc-cmd command. See canc-cmd for more information.
In this command, only ITU-international and ITU national point codes support the spare point code subtype prefix (s-).
If any entries are provisioned in the SCCP-SERV table, then the maximum number of entries shown for the MRN table are reduced by that amount.
When the GTT LS ARI feature is enabled, the Alternate RI Mate, identified by the MAPSET, MAPPC, and MAPSSN fields, is displayed for all MRN Sets. When the GTT LS ARI feature is not enabled, the Alternate RI Mate is not displayed, and the display is unchanged.
on options
refcnt —displays the MRNSET and MRNSET/PC reference counts
Output
The NET column is shown only when an MRN set contains mixed network point code types. Addition of the NET column realigns all remaining columns in the output. The re-alignment is constant even if the NET column is not shown.
rtrv-mrn
spareduppc 08-12-13 11:35:12 EST EAGLE 40.1.0
PC RC
001-001-000 5
001-001-001 10
001-001-002 20
001-001-003 30
001-001-004 40
PC RC
001-002-001 20
001-001-007 25
001-001-008 30
001-003-002 30
PCI RC
s-2-100-1 10
s-2-002-1 10
s-2-002-2 10
PCN RC
s-1-1-1-0123-aa 1
s-1-1-1-0235-aa 2
s-1-1-1-0555-aa 3
MRN table is (15 of 3000) 1% full.
rtrv-mrn:pc=1-1-2
spareduppc 08-12-13 11:35:12 EST EAGLE 40.1.0
PC RC
001-001-000 5
001-001-001 10
001-001-002 20
001-001-003 30
001-001-004 40
MRN table is (15 of 3000) 1% full.
rtrv-mrn:pci=s-2-2-1
spareduppc 08-12-13 11:35:12 EST EAGLE 40.1.0
PCI RC
s-2-100-1 10
s-2-002-1 10
s-2-002-2 10
MRN table is (15 of 3000) 1% full.
rtrv-mrn:pcn=s-1-1-1-123-aa
spareduppc 08-12-13 11:35:12 EST EAGLE 40.1.0
PCN RC
s-1-1-1-0123-aa 1
s-1-1-1-0235-aa 2
s-1-1-1-0555-aa 3
MRN table is (15 of 3000) 1% full.
This example shows output when the Weighted GTT Load Sharing feature is on, and weights are added to an existing MRN set:
rtrv-mrn:pci=s-2-2-2
weighton 08-12-13 11:35:12 EST EAGLE 40.1.0
PCI RC WT %WT THR
s-2-002-1 10 5 17 50
s-2-002-2 10 10 33 50
s-2-100-1 10 15 50 50
MRN table is (15 of 3000) 1% full.
This example shows output when the Flexible Final GTT Load Sharing feature is enabled, and the first new ANSI MRN set is added:
rtrv-mrn
gflexon 08-12-13 11:35:12 EST EAGLE 40.1.0
MRNSET PC RC WT %WT THR
DFLT 001-001-000 5 -- --- ---
001-001-001 10 -- --- ---
001-001-002 20 -- --- ---
001-001-003 30 -- --- ---
001-001-004 40 -- --- ---
MRNSET PC RC WT %WT THR
DFLT 001-002-001 20 -- --- ---
001-001-007 25 -- --- ---
001-001-008 30 -- --- ---
001-003-002 30 -- --- ---
MRNSET PCI RC WT %WT THR
DFLT s-2-100-1 10 15 50 50
s-2-002-1 10 5 17 50
s-2-002-2 10 10 33 50
MRNSET PCN RC WT %WT THR
DFLT s-1-1-1-0123-aa 1 -- --- ---
s-1-1-1-0235-aa 2 -- --- ---
s-1-1-1-0555-aa 3 -- --- ---
MRNSET PC RC WT %WT THR
1 001-003-001 10 -- --- ---
001-003-002 10 -- --- ---
001-003-003 30 -- --- ---
001-003-004 30 -- --- ---
001-003-006 60 -- --- ---
001-003-007 60 -- --- ---
001-003-008 80 -- --- ---
001-003-009 80 -- --- ---
MRN table is (23 of 6000) 1% full.
This example shows output when a mixed ITU network weighted MRN set is used:
rtrv-mrn:pci=1-55-1:mrnset=2
gflexon 08-12-13 11:35:12 EST EAGLE 40.1.0
MRNSET NET PC RC WT %WT THR
2 N s-1-1-1-0235-aa 30 20 20 1
I 1-055-1 30 20 20 1
I s-2-002-1 30 20 20 1
I s-2-002-2 30 20 20 1
N 1-1-1-0444-bb 30 20 20 1
MRN table is (28 of 6000) 1% full.
This example shows output when the Flexible GTT Loadsharing and GTT LS ARI features are enabled, and the Weighted GTT Loadsharing feature is not turned on:
rtrv-mrn
eaglestp 08-12-22 19:03:49 EST EAGLE 40.1.0
MRNSET MAPSET MAPPCN MAPSSN PCN RC
DFLT DFLT 01003 10 01002 10
01001 10
MRNSET MAPSET MAPPC MAPSSN PC RC
1 ----- ----------- --- 001-001-002 10
001-001-001 10
MRNSET MAPSET MAPPCI MAPSSN PCI RC
2 1 1-101-3 10 1-101-2 10
1-101-1 10
MRNSET MAPSET MAPPCI MAPSSN PCI RC
3 2 s-2-202-3 * s-2-202-2 10
s-2-202-1 10
MRNSET MAPSET MAPPCN MAPSSN PCN RC
4 DFLT s-02003 * s-02002 20
s-02001 20
MRNSET MAPSET MAPPCN MAPSSN NET PC RC
5 DFLT 01004 20 I 1-101-1 10
N 01001 10
I s-2-202-1 30
MRN table is (13 of 6000) 1% full.
;
This example shows output when the Flexible GTT Loadsharing and GTT LS ARI features are enabled, and the Weighted GTT LS feature is turned on:
rtrv-mrn
eaglestp 08-12-22 19:04:42 EST EAGLE 40.1.0
MRNSET MAPSET MAPPCN MAPSSN PCN RC WT %WT THR
DFLT DFLT 01003 10 01002 10 5 50 1
01001 10 5 50 1
MRNSET MAPSET MAPPC MAPSSN PC RC WT %WT THR
1 ----- ----------- --- 001-001-002 10 20 67 20
001-001-001 10 10 33 20
MRNSET MAPSET MAPPCI MAPSSN PCI RC WT %WT THR
2 1 1-101-3 10 1-101-2 10 40 57 1
1-101-1 10 30 43 1
MRNSET MAPSET MAPPCI MAPSSN PCI RC WT %WT THR
3 2 s-2-202-3 * s-2-202-2 10 50 50 1
s-2-202-1 10 50 50 1
MRNSET MAPSET MAPPCN MAPSSN PCN RC WT %WT THR
4 DFLT s-02003 * s-02002 20 -- --- ---
s-02001 20 -- --- ---
MRNSET MAPSET MAPPCN MAPSSN NET PC RC WT %WT THR
5 DFLT 01004 20 I 1-101-1 10 20 50 1
N 01001 10 20 50 1
I s-2-202-1 30 20 100 1
MRN table is (13 of 6000) 1% full.
;
This example shows output for a specific point code and MRN Set. The Flexible GTT Loadsharing and GTT LS ARI features are enabled, and the Weighted GTT Loadsharing feature is turned off.
rtrv-mrn:pcn=1001:mrnset=dflt
eaglestp 08-12-22 19:03:53 EST EAGLE 40.1.0
MRNSET MAPSET MAPPCN MAPSSN PCN RC
DFLT DFLT 01003 10 01002 10
01001 10
MRN table is (13 of 6000) 1% full.
;
This example shows output for a specific point code and MRN Set. The Flexible GTT Loadsharing and GTT LS ARI features are enabled, and the Weighted GTT Loadsharing feature is turned on.
rtrv-mrn:pcn=1001:mrnset=dflt
eaglestp 08-12-22 19:04:47 EST EAGLE 40.1.0
MRNSET MAPSET MAPPCN MAPSSN PCN RC WT %WT THR
DFLT DFLT 01003 10 01002 10 5 50 1
01001 10 5 50 1
MRN table is (13 of 6000) 1% full.
;
This example shows output for a specific point code and MRN set. The GTT LS ARI feature is enabled, the Weighted GTT Loadsharing feature is turned on, and on=refcnt is specified.
rtrv-mrn:pcn=1001:mrnset=dflt:on=refcnt eaglestp 11-03-17 14:24:37 EST EAGLE 44.0.0
MRNSET REFCNT=1
MRNSET MAPSET MAPPCN MAPSSN PCN RC WT %WT THR
DFLT DFLT 01003 10 01002 10 5 50 1
MRNSETPC REFCNT=2
01001 10 5 50 1
MRNSETPC REFCNT=1
MRN table is (13 of 6000) 1% full.
; rtrv-mrn:pcn16=1-2-3:mrnset=dflt
tekelecstp 13-07-02 16:18:09 EST 45.0.0-64.69.0
rtrv-mrn:pcn16=1-2-3:mrnset=dflt
Command entered at terminal #4.
MRNSET PCN16 RC WT %WT THR
DFLT 002-02-02 10 10 25 1
001-02-03 10 30 75 1
MRN table is (2 of 6000) 1% full.
Legend
- MRNSET—MRN set ID
- NET—Mmated network type of the point code when an ITU MRN set contains both ITU-I and ITU-N point codes. The field can show I if the PC is an ITU-I point code or N if the PC is an ITU-N point code.
- PC/PCI/PCN/PCN24/PCN16—Point Code
- RC—Relative Cost
- WT—PC Weight
- %WT—Relative percentage, according to weight, of an in-service PC within an RC group
- THR—Service threshold. If the relative percentage, according to weight, of in-service PCs within a RC group falls below the in-service threshold, that RC group is considered out-of-service, and traffic is routed to the next lowest RC group.
- MAPSET—Secondary mate MAP Set
- MAPPCN—Alternate RI Mate point code
- MAPSSN—Alternate RI Mate subsystem number
- MRNSET REFCNT—Count of GTA table entries with XLAT=NONE that refer to the corresponding MRN set
- MRNSETPC REFCNT—Count of entries from the MAP, GTT Translation, GTT Action, and Prepaid SMS Options tables that refer to the corresponding MRN entry with an MRNSET/PC combination