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=...
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) | Maincode | Meaning |
| CMD0001 | Command successfully processed |
| CMD0202 | Operand error |
| CMD0221 | System error |
| CMD0216 | Privilege not sufficient |
| BCA0203 | Interface (&00) returns RC (&01). |
| BCA0290 | Route entry not found. |
| BCA0292 | No entry satisfies the selection criterion |
Examples
Show route attributes (route names) of all (partner) processors:
/SHOW-ROUTE-ATTRIBUTES ROUTE-NAME=*ALL,INFORMATION=*ROUTE-NAMES
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/ |
Processor name | var(*LIST).PROCESSOR-NAME | string | <c-string 1..8> | INF=any/ |
Administrative status | var(*LIST).STA.ADM | string | *EXCLUDE | INF= |
Transfer status | var(*LIST).STA.TRANS | string | *NONE | INF= |
Protocol status | var(*LIST).STA.PROTOCOL | string | *NONE | INF= |
Route path | var(*LIST).PATH | string | *LOCAL | INF= |
Host name | var(*LIST).HOST-NAME | string | *STD | INF= |
Line name | var(*LIST).LINE-NAME | string | *STD | INF= |
Node name | var(*LIST).NODE-NAME | string | <c-string 1..8> | INF= |
Link aggregation name | var(*LIST).AGGREGATION-NAME | string | <c-string 1..8> | INF= |
Router route name (if path=*viaroute) | var(*LIST).ROUTER-ROUT-NAME | string | <c-string 1..8> | INF= |
Tunnel route name (if path=*viatunnel) | var(*LIST).TUNNEL-ROUT-NAME | string | <c-string 1..8> | INF= |
L3 protocol (pathdependent) | var(*LIST).L3-PROTOCOL | string | *IP | INF= |
L3 subprotocol | var(*LIST).L3-SUB-PROTOCOL | string | *NONE | INF= |
L4 protocol | var(*LIST).L4-PROTOCOL | string | *ISO-4 | INF= |
IP address | var(*LIST).IP.IP-ADDR | string | <text 7..15> | INF= |
Own IP address | var(*LIST).IP.OWN-IP-ADDR | string | <text 7..15> | INF= |
IPv6 address | var(*LIST).IPV6.IPV6-ADDR | string | <c-string 9..45> | INF= |
Own IPv6 address | var(*LIST).IPV6.OWN-IPV6-ADDR | string | <c-string 9..49> | INF= |
ISO address | var(*LIST).ISO.ISO-ADDR | string | <c-string 1..20> | INF= |
Own ISO address | var(*LIST).ISO.OWN-ISO-ADDR | string | <c-string 1..20> | INF= |
LAN address | var(*LIST).LAN-ADDR | string | <c-string 2..12> | INF= |
ARP (Address Resolution Protocol) | var(*LIST).ARP | string | *OFF | INF= |
Passive RARP support (reverse ARP) via RARP-REPLIES | var(*LIST).RARP-REPLIES | string | *ALLOW | INF= |
Alternative line on line failure | var(*LIST).AUTO-ROUT-SWITCH | string | *ON | INF= |
Reswitch of original route definition | var(*LIST).ROUT-RESWITCH | string | *ON | INF= |
Checksum option | var(*LIST).CHECKSUM | string | *ON | INF= |
ECN (Explicit Congestion Notification) | var(*LIST).ECN | string | *OFF | INF= |
Highspeed TCP | var(*LIST).HIGHSPEED-TCP | string | *ON | INF= |
DRS (Dynamic Right-Sizing), inbound | var(*LIST).DRS-INBOUND | string | *ON | INF= |
DRS (Dynamic Right-Sizing), outbound | var(*LIST).DRS-OUTBOUND | string | *ON | INF= |
Route as access to aTranSON server | var(*LIST).TRANSON-USAGE | string | *OFF | INF= |
Transport connections on route failure | var(*LIST).ROUT-DOWN | string | *KEEP-CONN | INF= |
Time interval of ISO8073 retransmission timer (2 sec) | var(*LIST).TIMER.RETRANSMISSION | integer | <integer 2..36> | INF= |
Time interval for the ISO8073 window timer | var(*LIST).TIMER.WINDOW | integer | <integer 2..180> | INF= |
Maximum frame data length (only if path=*node) | var(*LIST).MAX-LPDU-SIZE | string | *STD | INF= |
Maximum NSDU length | var(*LIST).MAX-NSDU-SIZE | integer | <integer 556..65530> | INF= |
Maximum message length which the host can receive | var(*LIST).MAX-TSDU-SIZE | integer | <integer 512..65530> | INF= |
ROUTE-SEQUENCE-NUMBER | var(*LIST).ROUT-SEQ-NUM | integer | <integer 0..99> | INF= |
Automatically adopted route | var(*LIST).CRE-BY-AEC | string | *YES | INF= |
Classification of route | var(*LIST).ROUT-CLASS | string | *NORMAL | INF= |
Route is router route | var(*LIST).ROUTER-ROUT.INDICATOR | string | *YES | INF= |
Route is router route | var(*LIST).ROUTER-ROUT.TYPE(*LIST) | string | *IP | INF= |
List of route names | var(*LIST).ROUT-NAMES(*LIST) | string | <c-string 1..8> | INF=*ROU |