6.9 msuroute
This command is used to provide a list of all routing keys currently configured on an SS7IPGW/IPGWI card that could be used to route a particular MSU. With 3 types of routing keys (fully specified, partial and default) the complexity associated with figuring out how a particular MSU would be routed at any point in time is not trivial. This command provides output to help determine how MSUs will be routed based on current conditions.
Options
Options and option parameters that are underlined indicate that a value must be specified for that option or parameter. For example, the msuroute command option -k has the parameter rtkey. The full routing key must be specified for the MSU for which the summary will be displayed, as in the command msuroute -k 5-5-5:5:6-6-6:1100. Do not enter the underlined option or parameter; enter a value for the information represented by the underlined option or parameter.
-h
This option is used to provide help information for the command.
-k rtkey
This option is mandatory in the command to specify the full routing key for the MSU for which the summary will be displayed. The routing key is specified as a single parameter with up to five colon-separated fields. The subsystem is not specified when SI is not equal to 3.
The -p point code type modifier is used to identify the format of the routing key that follows the -k option in the command.
The following are valid formats for the routing key that follows the -k option in the command:
- n-c-m:s:n—For DPC, SI, SSN type routing keys. The network, cluster and member (n-c-m) are in the range 0-255. The service indicator (s) is 3 or sccp. The subsystem (n) is in the range 0-255.
- n-c-m:s—For DPC, SI, type routing keys. The network, cluster and member (n-c-m) are in the range 0-255. The service indicator (s) is in the range 0-2, 4, or 6-15. There is no subsystem.
- n-c-m:s:no-co-mo:cs:ce—For DPC, SI, CIC type routing keys. The DPC network, cluster and member (n-c-m) are in the range 0-255. The service indicator (s) is 5 or isup. There is no subsystem. The OPC network, cluster and member (no-co-mo) are in the range 0-255. The starting circuit identification code (cs) and ending circuit identification code (ce) are in the range 0 to 16363.
-p point code type
This option modifier is used to identify the point code type (ANSI, ITU international, ITU national, 24-bit ITU national, 16-bit ITU national, ITU international spare, ITU national spare) in the routing key that follows the -k option in the command.
-x routing context
This option modifier is used to display the routing key report using routing context.
Example
msuroute -hmsuroute -p ansi –k 5-5-5:5:6-6-6:1100
msuroute -p ansi –k 5-5-5:5:6-6-6:1100:1100
msuroute -k 5-5-5:5:6-6-6:1100
msuroute -k 5-5-5:5:6-6-6:1100:1100
msuroute –p ansi –k 5-5-5:8
msuroute –p itun –k 345:5:678:100:200
msuroute –p itun –k 345-gr:5:678-gr:100:200
msuroute –p itun24 –k 10-200-10:5:10-200-1:1:100
msuroute -p itun16 -k 1-2-1:5:1-2-1:1:100
Dependencies
The -k option must be specified in the command, and must specify a full routing key.
This command is not supported for IPLIM/IPLIMI cards.
Notes
The msuroute command is executed through the pass command.
The -ppoint code type modifier option can be used with the -k option to specify the format of the routing key that follows the -k option in the command.
Output
The output for each msuroute command consists of a list of all of the routing keys that exist on the IPGWx card that could be used to route the MSU. The list of routing keys is presented in the hierarchical search order in which the keys would be used. The list of routing keys indicates keys that have IP connections available for traffic, and indicates which routing key would currently be used to route the MSU (marked with ***).
For the routing key that is selected to route the MSU, the list of IP connections associated with the key is also displayed.
Note:
Most of the following output examples show command entries for ANSI MSUs. Because, other than echoing the input command back to the screen, there is nothing in the output that contains specific fields from any configured keys. The output would not be different if the user entered ITUI MSUs instead of ANSI MSUs.Either brief or full help reports can be displayed. A full help report is generated by adding the -h full option to the command line.
This example shows a brief help report:
pass:loc=1105:cmd="msuroute -h"
Command Accepted - Processing
Usage: msuroute [ [-x rc] | [-k [rtkey] [-p pctype] ] ]
[-h [full]]
Options: -x routing key report using routing context
-k routing key report using MTP3 parameters
rtkey :: ([dpc][:si][:opc | :ssn][:cics][:cice])
-p pctype :: (ANSI, ITUI, ITUN, ITUN24, ITUN16, ITUIS, ITUNS)
-h display command help (brief or full)
;
This example shows a full help report:
pass:loc=1305:cmd="msuroute -h full"
0 1 2 3 4 5 6 7
123456789012345678901234567890123456789012345678901234567890123456789012345678
Usage: msuroute [ [-x rc] | [-k [rtkey] [-p pctype] ] ]
[-h [full]]
Options: -x routing key report using routing context
-k routing key report using MTP3 parameters
rtkey :: dpc:si:opc:cics:cice | dpc:si:ssn | dpc:si
-p pctype :: (ANSI, ITUI, ITUN, ITUN24, ITUN16, ITUIS, ITUNS)
-h display command help (brief or full)
-k option details:
Use the -p option along with -k to specify the SS7 network
domain and point code format for the network. The SS7IPGW
default pctype is ANSI. The IPGWI default pctype is ITUI.
Network PC Format Notes
------- --------- --------------------------------------
ANSI N-C-M
ITUN N Non-Spare ITU National, no group code
ITUN N-GC Non-Spare ITU National with group code
ITUI Z-A-I Non-Spare ITU International
ITUN24 N-C-M Non-Spare ITU National, 24-bits
ITUN16 U-S-M Non-Spare ITU National, 16-bits
ITUNS N Spare ITU National, no group code
ITUNS N-GC Spare ITU National with group code
ITUIS Z-A-I Spare ITU International
SS7 Traffic Partition RTKEY Parameter Example
--------------------------------- ----------------------------
SCCP SSN 5 to DPC 1-1-1 -k 1-1-1:3:5
ISUP CIC 1 to 1-1-1 from 2-2-2 -k 1-1-1:5:2-2-2:1
TUP CIC 1 to 1-1-1 from 2-2-2 -k 1-1-1:4:2-2-2:1
QBICC CIC 1 to 1-1-1 from 2-2-2 -k 1-1-1:13:2-2-2:1
ISUP CIC 0-5 to 1-1-1 from 2-2-2 -k 1-1-1:5:2-2-2:0:5
TUP CIC 0-5 to 1-1-1 from 2-2-2 -k 1-1-1:4:2-2-2:0:5
QBICC CIC 0-5 to 1-1-1 from 2-2-2 -k 1-1-1:13:2-2-2:0:5
;
eagle10212 06-06-01 12:56:46 EST EAGLE 35.0.0
MSUROUTE command complete
This example shows output for an ANSI CIC-based MSU, showing at least 1 routing key of every key type in the search hierarchy configured on the 1105 card. Only key types that are configured on the card will be listed in the display.
pass:loc=1105:cmd="msuroute –p ANSI –k 5-5-5:5:6-6-6:1100"
Command Accepted - Processing
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
pass:loc=1105:cmd="msuroute -x ANSI -k 5-5-5:5:6-6-6:1100"
Command entered at terminal #1.
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
PASS: Command sent to card
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
MSUROUTE command in progress
;
rlghncxa03w 04-04-29 11:31:09 EST EAGLE5 31.6.0
TABLE KEYTYPE #ConnCfgd #ConnAvail RTKEY USED
DYN FULL 1 0 no
DYN PARTIAL: IGNORE-CIC 2 0 no
DYN PARTIAL: IGNORE-CIC+OPC 1 0 no
DYN PARTIAL: DPC-SI ONLY 3 3 yes
DYN PARTIAL: DPC ONLY 2 2 no
DYN PARTIAL: SI ONLY 4 0 no
DYN DEFAULT 4 4 no
STATIC FULL 12 4 no
STATIC PARTIAL: IGNORE-CIC 3 0 no
STATIC PARTIAL: IGNORE-CIC+OPC 2 0 no
STATIC PARTIAL: DPC-SI ONLY 3 2 no
STATIC PARTIAL: DPC ONLY 2 2 no
STATIC PARTIAL: SI ONLY 1 0 no
STATIC DEFAULT 2 0 no
IP Connections Associated with the RTKEY USED
Name Avail?
Vox1 yes
Mgc2 yes
Mgc24 yes
MSUROUTE command complete
;
This example shows output for an ANSI SCCP MSU. Several key types in the search hierarchy are not configured on the 1105 card, and therefore are not part of the output (for example, static full key or static partial SI only). Only key types that are configured on the card will be listed in the display.
pass:loc=1105:cmd="msuroute –p ANSI –k 5-5-5:3:34"
Command Accepted - Processing
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
pass:loc=1105:cmd="msuroute -p ANSI -k 5-5-5:3:34"
Command entered at terminal #1.
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
PASS: Command sent to card
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
MSUROUTE command in progress
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
TABLE KEYTYPE #ConnCfgd #ConnAvail RTKEY USED
DYN PARTIAL: DPC-SI ONLY 3 2 yes
DYN PARTIAL: DPC ONLY 2 2 no
DYN DEFAULT 4 4 no
STATIC PARTIAL: DPC-SI ONLY 3 2 no
STATIC PARTIAL: DPC ONLY 2 2 no
STATIC DEFAULT 2 0 no
IP Connections Associated with the RTKEY USED
Name Avail?
Scpsandiego no
scpdenver yes
scpkansascity yes
MSUROUTE command complete
;
This example shows output for an ANSI MSU with SI=8:
pass:loc=1105:cmd="msuroute –p ANSI -k 5-5-5:8"
Command Accepted - Processing
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
pass:loc=1105:cmd="msuroute -p ANSI -k 5-5-5:8"
Command entered at terminal #1.
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
PASS: Command sent to card
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
MSUROUTE command in progress
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
TABLE KEYTYPE #ConnCfgd #ConnAvail RTKEY USED
DYN FULL 7 0 no
DYN PARTIAL: DPC ONLY 2 2 yes
DYN PARTIAL: SI ONLY 2 0 no
DYN DEFAULT 4 4 no
STATIC FULL 11 0 no
STATIC PARTIAL: DPC ONLY 2 2 no
STATIC PARTIAL: SI ONLY 1 0 no
STATIC DEFAULT 2 0 no
IP Connections Associated with the RTKEY USED
Name Avail?
SI8sock1 yes
SI8sock2 yes
MSUROUTE command complete
;
These examples show output for an ITUN and an ITUN24 MSU with SI=5. The output format is the same for all four commands.
The ITUDUPPC feature is OFF (default):
pass:loc=1105:cmd="msuroute –p itun –k 345:5:678:100:200"
The ITUDUPPC feature is ON (the 2-letter group code must be specified with the DPC and OPC)
pass:loc=1105:cmd="msuroute –p itun –k 345-gr:5:678-gr:100:200"
An ITUN24 MSU with SI=5:
pass:loc=1105:cmd="msuroute –p itun24 –k 10-200-10:5:10-200-1:1:100"
An ITU-I Spare MSU with SI=5:
msuroute –p ituis -k 3-11-1:5:4-11-1:5:5
Command Accepted - Processing
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
pass:loc=1105:cmd="msuroute -p ITUN -k 345:678:100:200"
Command entered at terminal #1.
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
PASS: Command sent to card
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
MSUROUTE command in progress
;
rlghncxa03w 06-06-01 11:31:09 EST EAGLE5 35.0.0
TABLE KEYTYPE #ConnCfgd #ConnAvail RTKEY USED
DYN FULL 1 0 no
DYN PARTIAL: IGNORE CIC 2 0 no
DYN PARTIAL: IGNORE CIC+OPC 1 0 no
DYN PARTIAL: DPC-SI ONLY 3 3 yes
DYN PARTIAL: DPC ONLY 2 2 no
DYN PARTIAL: SI ONLY 4 0 no
DYN DEFAULT 4 4 no
STATIC FULL 12 4 no
STATIC PARTIAL: IGNORE-CIC 3 0 no
STATIC PARTIAL: IGNORE-CIC+OPC 2 0 no
STATIC PARTIAL: DPC-SI ONLY 3 2 no
STATIC PARTIAL: DPC ONLY 2 2 no
STATIC PARTIAL: SI ONLY 1 0 no
STATIC DEFAULT 2 0 no
IP Connections Associated with the RTKEY USED
Name Avail?
Vox1 yes
Mgc2 yes
Mgc24 yes
MSUROUTE command complete
;