DISPLAY PATHTAB command

Abbreviations

Purpose

The DISPLAY PATHTAB (path table) command displays the status of explicit routes and their associated virtual routes for this host. You can use this command to display information about all routes, or you can limit it by specifying the ADJSUB or DESTSUB operands. The DISPLAY PATHTAB command provides information similar to the DISPLAY ROUTE command, but in a different format. However, the DISPLAY ROUTE command provides some additional information not provided by the DISPLAY PATHTAB command.

Operands

ADJSUB=subarea_number

Specifies that information about routes passing through the named adjacent subarea is the only information to be displayed.

DESTSUB=subarea_number

Specifies that information about routes going to the named destination subarea is the only information to be displayed.

MAX

Specifies the maximum number of routes that VTAM® displays for this command.

MAX=*

Specifies that the value of the DSPLYMAX start option is used to limit the display output.

MAX=number_of_resources

Specifies the number of routes to display for this command. The valid range is 1–value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.

Specifying MAX limits the display output. VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer routes are found than you have specified on MAX, VTAM displays only the routes that are found.

Resulting display

The resulting display shows the host path table contents. Included in the display are the destination subarea, the adjacent subarea (through which the listed explicit route flows), the explicit route number, the status (the current state of the listed explicit route as known to the host), the virtual route number, and the transmission group number.