Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-ROUTE-ATTRIBUTES / SHRTA: Show route attributes

&pagelevel(3)&pagelevel

You use the SHOW-ROUTE-ATTRIBUTES command to display the route-specific attributes for selected routes.

The alias name of SHOW-ROUTE-ATTRIBUTES is SHRTA. 

This command can be executed with the STD-PROCESSING privilege, but not all operand values will be available.

BS2000 console

BS2000 SDF command

Command/ SOF file

SNMP management

Parameter service


x




List of valid command sources

SHOW-ROUTE-ATTRIBUTES / SHRTA

ROUTE-NAME = <composed-name 1 .. 8> / *ALL / *PROCESSOR(...) /





*IP-ADDRESS(...) /*ISO-ADDRESS(...) / *LAN-ADDRESS(...) / *IPV6-ADDRESS(...)


*PROCESSOR(...)



|

PROCESSOR-NAME = *OWN / <composed-name 1 .. 8>


*IP-ADDRESS(...)



|

IP-ADDRESS = *ALL / <text 7 .. 15> / <x-string 7 .. 8>


*ISO-ADDRESS(...)



|

ISO-ADDRESS = *ALL / <x-string 1 .. 40>


*LAN-ADDRESS(...)



|

LAN-ADDRESS = *ALL / <x-string 1 .. 12>


*IPV6-ADDRESS(...)



|

IPV6-ADDRESS = *ALL / <text 9 .. 45> / <c-string 9 .. 45>

,SELECT = *ALL / *BY-ATTRIBUTES(...)


*BY-ATTRIBUTES(...)



|

HOST-NAME = *ANY / <composed-name 1 .. 8>



|

,NODE-NAME = *ANY / <composed-name 1 .. 8>



|

,LINE-NAME = *ANY / <composed-name 1 .. 8>



|

,AGGREGATION-NAME = *ANY / <composed-name 1 .. 8>

,INFORMATION = *ADDRESSES / *ALL / *ROUTE-NAMES / list-poss(16): *ADDRESSES / *PROTOCOLS /






*STATE / *LIMITS / *OPTIONS / *PATH / *PROPERTIES / *TIMER

,OUTPUT = *SYSOUT / *SYSLST

ROUTE-NAME=...
Routes whose attributes are to be displayed.

ROUTE-NAME=*ALL
The attributes of all routes are displayed.

ROUTE-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the route whose attributes are displayed.

ROUTE-NAME=*PROCESSOR(...)
The routes whose attributes are displayed are specified via the partner processor.

PROCESSOR-NAME=*OWN
Displays the attributes of the routes which lead to the own processor. This command only returns information if the connection was not established via OMNIS .

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

ROUTE-NAME=*IP-ADDRESS(...)
The routes whose attributes are displayed are specified via the partner IP address.

IP-ADDRESS=<text 7..15> / <x-string 7..8>
Displays the attributes of the routes which lead to the processor with the specified partner IP address.

IP-ADDRESS=*ALL
Displays the attributes of all the routes on which the layer 3 protocol IP is running.

ROUTE-NAME=*ISO-ADDRESS(...)
The routes whose attributes are displayed are specified via the partner ISO internet address.

ISO-ADDRESS=<x-string 1..40>
Displays the attributes of the routes which lead to the processor with the specified partner ISO internet address.

ISO-ADDRESS=*ALL
Displays the attributes of all the routes on which the layer 3 protocol ISO 8473 Full Internet is running.

ROUTE-NAME=*LAN-ADDRESS(...)
The routes whose attributes are displayed are specified via the partner LAN address.

LAN-ADDRESS=<x-string 1..12>
Displays the attributes of the routes which lead to the processor with the specified partner LAN address

LAN-ADDRESS=*ALL
Displays the attributes of all the routes on which the layer 3 protocol ISO 8473 Null Internet is running.

ROUTE-NAME=*IPV6-ADDRESS(...)
The routes whose attributes are displayed are specified via the partner IPv6 address.

IPV6-ADDRESS=<text 9..45> / <c-string 9..45>
Displays the attributes of the routes which lead to the processor with the specified partner IPv6 address.

IPV6-ADDRESS= *ALL
Displays the attributes of all the routes on which the layer 3 protocol IPv6 is running.

SELECT=...
The routes for which information is displayed are limited by a selection criterion.

SELECT=*ALL
All routes are selected.

SELECT=*BY-ATTRIBUTES(...)
The route to be selected is specified more precisely.

HOST-NAME=...
Name of the host.

HOST-NAME=*ANY
Any name for the host.

HOST-NAME=<composed-name 1..8>
Name of the host.

NODE-NAME=...
Name of the node.

NODE-NAME=*ANY
Any name for the node.

NODE-NAME=<composed-name 1..8>
Name of the node.

LINE-NAME=...
Name of the line/VLAN line.

LINE-NAME=*ANY
Any name for the line/VLAN line.

LINE-NAME=<composed-name 1..8>
Name of the line/VLAN line.

AGGREGATION-NAME=...
Name of the link aggregation.

AGGREGATION-NAME=*ANY
Arbitrary name of the link aggregation.

AGGREGATION-NAME=<composed-name 1..8>
Name of the link aggregation.

INFORMATION=...
With INFORMATION, you specify what information is to be displayed.

INFORMATION=*ADDRESSES
Displays the route-specific addresses.

INFORMATION=*PROTOCOLS
Displays the route-specific protocol profile.

INFORMATION=*STATE
Displays the route-specific status.

INFORMATION=*LIMITS
Displays the route-specific limits.

INFORMATION=*OPTIONS
Displays the route-specific options.

INFORMATION=*PATH
Displays the route-specific path.

INFORMATION=*PROPERTIES
Displays the route-specific properties.

INFORMATION=*TIMER
Displays the route-specific timer values.

INFORMATION=*ALL
Displays the complete route information.

INFORMATION=*ROUTE-NAMES
Displays the route name.

OUTPUT=...
Specifies the output medium.

OUTPUT=*SYSOUT
The output is sent to SYSOUT.

OUTPUT=*SYSLST
The output is sent to SYSLST.

Command logging

Positive acknowledgments result in the required information being output.
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

Operand error

   0       32

CMD0221

System error

   0       64

CMD0216

Privilege not sufficient

   0       64

BCA0203

Interface (&00) returns RC (&01).

   0       64

BCA0290

Route entry not found.

   0       64

BCA0292

No entry satisfies the selection criterion


Examples

  1. Show route attributes (route names) of all (partner) processors:

    /SHOW-ROUTE-ATTRIBUTES ROUTE-NAME=*ALL,INFORMATION=*ROUTE-NAMES

  2. Show route attributes (addresses and path) of processors for a line:

    /SHOW-ROUTE-ATTRIBUTES ROUTE-NAME=*ALL,SELECT=*BY-ATTRIBUTES( -
    / LINE-NAME=L#LAN#X),INFORMATION=(*ADDRESS,*PATH) 

S variables

The command’s INFORMATION operand defines the S variables to which values are assigned. Possible values for INFORMATION are *ADDRESSES, *PROTOCOL, *STATE, *LIMITS, *OPTIONS, *PATH, *PROPERTIES, *TIMER, *ALL, *ROUTE-NAMES.

Output information

Name of the S variable               

Data type

Content

Condition    

Route name

var(*LIST).ROUT-NAME

string

<c-string 1..8>

INF=any/
*ROU/*ALL

Processor name

var(*LIST).PROCESSOR-NAME

string

<c-string 1..8>
*ROUTE-NAME

INF=any/
*ROU/*ALL

Administrative status

var(*LIST).STA.ADM

string

*EXCLUDE
*INCL
*ACTIVE

INF=
*STA/*ALL

Transfer status

var(*LIST).STA.TRANS

string

*NONE
*READY
*NOT-READY
*WAIT-FOR-INIT
*WAIT-FOR-READY

INF=
*STA/*ALL

Protocol status

var(*LIST).STA.PROTOCOL

string

*NONE
*WORKING
*TESTING
*ADDRESS-
RESOLUTION
*LIVETIME-SUPER-
VISION-FAILED

INF=
*STA/*ALL

Route path

var(*LIST).PATH

string

*LOCAL
*NODE
*VIA-ROUTER
*VIA-TUNNEL

INF=
*PATH/*ALL

Host name

var(*LIST).HOST-NAME

string

*STD
<c-string 1..8>

INF=
*PATH/*ALL

Line name

var(*LIST).LINE-NAME

string

*STD
*PROCESSOR-NAME
<c-string 1..8>

INF=
*PATH/*ALL

Node name

var(*LIST).NODE-NAME

string

<c-string 1..8>

INF=
*PATH/*ALL

Link aggregation name

var(*LIST).AGGREGATION-NAME

string

<c-string 1..8>

INF=
*PATH/*ALL

Router route name (if path=*viaroute)

var(*LIST).ROUTER-ROUT-NAME

string

<c-string 1..8>

INF=
*PATH/*ALL

Tunnel route name (if path=*viatunnel)

var(*LIST).TUNNEL-ROUT-NAME

string

<c-string 1..8>

INF=
*PATH/*ALL

L3 protocol (pathdependent)

var(*LIST).L3-PROTOCOL

string

*IP
*IPV6
*INTF
*INT0

INF=
*PROT/*ALL

L3 subprotocol

var(*LIST).L3-SUB-PROTOCOL

string

*NONE
*SNAP

INF=
*PROT/*ALL

L4 protocol

var(*LIST).L4-PROTOCOL

string

*ISO-4
*TCP

INF=
*PROT/*ALL

IP address

var(*LIST).IP.IP-ADDR

string

<text 7..15>

INF=
*ADDR/*ALL

Own IP address

var(*LIST).IP.OWN-IP-ADDR

string

<text 7..15>

INF=
*ADDR/*ALL

IPv6 address

var(*LIST).IPV6.IPV6-ADDR

string

<c-string 9..45>

INF=
*ADDR/*ALL

Own IPv6 address

var(*LIST).IPV6.OWN-IPV6-ADDR

string

<c-string 9..49>

INF=
*ADDR/*ALL

ISO address

var(*LIST).ISO.ISO-ADDR

string

<c-string 1..20>

INF=
*ADDR/*ALL

Own ISO address

var(*LIST).ISO.OWN-ISO-ADDR

string

<c-string 1..20>

INF=
*ADDR/*ALL

LAN address

var(*LIST).LAN-ADDR

string

<c-string 2..12>

INF=
*ADDR/*ALL

ARP (Address Resolution Protocol)

var(*LIST).ARP

string

*OFF
*ON
*QUIET

INF=
*OPT/*ALL

Passive RARP support (reverse ARP) via RARP-REPLIES

var(*LIST).RARP-REPLIES

string

*ALLOW
*NOT-ALLOW

INF=
*OPT/*ALL

Alternative line on line failure

var(*LIST).AUTO-ROUT-SWITCH

string

*ON
*OFF

INF=
*OPT/*ALL

Reswitch of original route definition

var(*LIST).ROUT-RESWITCH

string

*ON
*OFF

INF=
*OPT/*ALL

Checksum option

var(*LIST).CHECKSUM

string

*ON
*OFF

INF=
*OPT/*ALL

ECN (Explicit Congestion Notification)

var(*LIST).ECN

string

*OFF
*ON

INF=
*OPT/*ALL

Highspeed TCP

var(*LIST).HIGHSPEED-TCP

string

*ON
*OFF

INF=
*OPT/*ALL

DRS (Dynamic Right-Sizing), inbound

var(*LIST).DRS-INBOUND

string

*ON
*OFF

INF=
*OPT/*ALL

DRS (Dynamic Right-Sizing), outbound

var(*LIST).DRS-OUTBOUND

string

*ON
*OFF

INF=
*OPT/*ALL

Route as access to aTranSON server

var(*LIST).TRANSON-USAGE

string

*OFF
*ON

INF=
*OPT/*ALL

Transport connections on route failure

var(*LIST).ROUT-DOWN

string

*KEEP-CONN
*DISCONN

INF=
*OPT/*ALL

Time interval of ISO8073 retransmission timer (2 sec)

var(*LIST).TIMER.RETRANSMISSION

integer

<integer 2..36>

INF=
*TIM/*ALL

Time interval for the ISO8073 window timer

var(*LIST).TIMER.WINDOW

integer

<integer 2..180>

INF=
*TIM/*ALL

Maximum frame data length (only if path=*node)

var(*LIST).MAX-LPDU-SIZE

string

*STD
*ETHERNET-STD

INF=
*LIM/*ALL

Maximum NSDU length

var(*LIST).MAX-NSDU-SIZE

integer

<integer 556..65530>

INF=
*LIM/*ALL

Maximum message length which the host can receive

var(*LIST).MAX-TSDU-SIZE

integer

<integer 512..65530>

INF=
*LIM/*ALL

ROUTE-SEQUENCE-NUMBER

var(*LIST).ROUT-SEQ-NUM

integer

<integer 0..99>

INF=
*LIM/*ALL

Automatically adopted route

var(*LIST).CRE-BY-AEC

string

*YES
*NO

INF=
*PROP/*ALL

Classification of route

var(*LIST).ROUT-CLASS

string

*NORMAL
*FIREWALL
*MULTICAST
*SERVER-PORT

INF=
*PROP/*ALL

Route is router route

var(*LIST).ROUTER-ROUT.INDICATOR

string

*YES
*NO

INF=
*PROP/*ALL

Route is router route

var(*LIST).ROUTER-ROUT.TYPE(*LIST)

string

*IP
*IPV6
*ISO
*TUNNEL

INF=
*PROP/*ALL

List of route names

var(*LIST).ROUT-NAMES(*LIST)

string

<c-string 1..8>

INF=*ROU