Display route status

The DISPLAY ROUTE command shows the status and availability of virtual and explicit routes. VTAM® displays the status of selected routes and, if TEST=YES is specified, does a route test on the routes selected in the DISPLAY command. (See Display route test) The VTAM operator can select the origin of the routes to be displayed or tested. The origin can be either a host processor or an NCP.

For a sample path problem, see Example: Solving path problems.

The display of status for the routes selected is formatted as shown in Figure 1.

Figure 1. Example of DISPLAY route status output

Displaying one explicit route to a destination subarea:
d net,route,destsub=01,netid=netc,origin=a03n43a,er=5
IST097I DISPLAY ACCEPTED
IST535I ROUTE DISPLAY 7 FROM SA 4 TO SA 1
IST808I ORIGIN PU = C0453LE DEST PU = C01NPU NETID = NETC
IST536I VR  TP    STATUS   ER       ADJSUB  TGN  STATUS  CUR MIN MAX
IST537I  0   0    ACTIV     5            1    1  ACTIV3
IST537I  0   1    INACT     5            1    1  ACTIV3
IST537I  0   2    INACT     5            1    1  ACTIV3
IST314I END

If you are using SNA network interconnection, the DISPLAY ROUTE command can be used to show the status and availability of adjacent VTAM networks. The resulting display is the same as shown in the previous example, except that message IST808I contains an additional field, NETID=netid, to show the ID of the adjacent network.

See z/OS Communications Server: SNA Messages for a complete description of the variable data contained in the messages that result from the DISPLAY ROUTE command.

It is possible for the test results for an explicit route to be lost before they are displayed. For example, if a node or a link along the explicit route fails between the time the test request flows outbound and the time the test results flow inbound, the results will be lost. If this occurs, reenter the DISPLAY ROUTE command for that explicit route.

Note: You can use the NetView® session monitor to collect more information about routes. If all the required session monitors along the route are in session, you can test the entire route, from one session end to the other. See Table 1 to determine what document has more information about the NetView session monitor.