SHOW-ROUTE-PATH / SHRTP: Show route path

You use the SHOW-ROUTE-PATH command to display information on the path taken by the route.

The alias name SHRTP exists for SHOW-ROUTE-PATH in order to provide SNMP support.

BS2000 console	BS2000 SDF command	Command/ SOF file	SNMP management	Parameter service
x	x

List of valid command sources

SHOW-ROUTE-PATH / SHRTP

ROUTE-NAME = <composed-name 1 .. 8> / <c-string 1 .. 8> / *PROCESSOR(...) / *IP-ADDRESS(...) /
				*ISO-ADDRESS(...) / *LAN-ADDRESS(...) / *IPV6-ADDRESS(...)
	*PROCESSOR(...)
		|	PROCESSOR-NAME = <composed-name 1 .. 8> / <c-string 1 .. 8>
	*IP-ADDRESS(...)
		|	IP-ADDRESS = <composed-name 7 .. 15> / <x-string 7 .. 8>
	*ISO-ADDRESS(...)
		|	ISO-ADDRESS = <x-string 1 .. 40>
	*LAN-ADDRESS(...)
		|	LAN-ADDRESS = <x-string 1 .. 12>
	*IPV6-ADDRESS(...)
		|	IPV6-ADDRESS = <text 9 .. 45> / <c-string 9 .. 45>
,INFORMATION = *PARTIAL-ROUTES / *ROUTE-EXTENSIONS

ROUTE-NAME=...
Route whose path is shown.

ROUTE-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the route whose path is shown.

ROUTE-NAME=*PROCESSOR(...)
The paths of all the routes to a processor are shown.

PROCESSOR-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the processor to which the routes lead.

ROUTE-NAME=*IP-ADDRESS(...)
The paths of the routes whose partner IP address is specified are shown.

IP-ADDRESS= <composed-name 7..15> / <x-string 7..8>
Partner IP address of the routes that are shown.

ROUTE-NAME=*ISO-ADDRESS(...)
The paths of the routes whose partner ISO Internet address is specified are shown.

ISO-ADDRESS=<x-string 1..40>
Partner ISO Internet address of the routes that are shown.

ROUTE-NAME=*LAN-ADDRESS(...)
The paths of the routes whose partner LAN address is specified are shown.

LAN-ADDRESS=<x-string 1..12>
Partner LAN address of the routes that are shown.

ROUTE-NAME=*IPV6-ADDRESS(...)
The paths of the routes whose partner IPv6 address is specified are shown.

IPV6-ADDRESS=<text 9..45> / <c-string 9..45>
Partner IPv6 address of the routes that are shown.

INFORMATION=...
In INFORMATION you specify the type of information that is shown.

INFORMATION=*PARTIAL-ROUTES
The Intermediate System (IS) routes via which the route operates are shown.
The IS route information is output for each route by means of the console messages BCA08E6, BCA08EE and BCA08AE.

INFORMATION=*ROUTE-EXTENSIONS
If the route has a router and/or gateway function, those routes that lead via this router and/or gateway but not via any other router are shown.
The route information is output for each route by means of the console messages BCA08E6 and BCA08EE.

Command logging

Positive acknowledgments are supplied in news BCA0663, and negative acknowledgments in news BCA06B3, followed by the message NBR0740. In addition, for positive acknowledgments, the messages BCA08E6, BCA08EE and BCA08AE may also appear.
A description of the error messages that may be issued during command processing is provided in the table below.

Command return codes

(SC2)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        1	CMD0202	Error in command
0        1	BCA0768	Syntax error in command
0       64	BCA079F	Unknown address
0       64	BCA07A0	Unknown processor
0       64	BCA07A1	Unknown route
0       64	BCA08EF	Nothing found to show
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active

Examples

Show a processor’s route path

/SHOW-ROUTE-PATH ROUTE-NAME=ROUTE,INFORMATION=*ROUTE-EXTENSIONS

Equivalent SHOW-ROUTE command:

/SHOW-ROUTE ROUTES=*NAME(ROUTE-NAME=ROUTE),RANGE=*NEXT-HOP