IST516I

Explanation
 This message is the first in a group of messages
that VTAM® issues in response
to a DISPLAY PATHTAB command. A complete description of the message
group follows.  IST516I  DESTSUB ADJSUB TGN ER  ER STATUS  VR(S)
IST517I   destsa adjsa  tgn er    status   vrlist
⋮
IST1454I count PATH(S) DISPLAYED
IST314I  END

 IST516I Message IST516I is a header line for the display and identifies
the type of information shown in the display.

 IST517I VTAM issues message IST517I
for each ER table entry to be displayed. It contains a user-defined
list of the virtual routes that map to the explicit routes. It also
contains the following information about explicit routes known to
this host:  In the message text:  destsa
The destination subarea in which the listed explicit route terminates.
adjsa
The adjacent subarea through which the listed explicit route passes.
tgn
The transmission group number.
er
The explicit route number.
status
The current state of the listed explicit route as known to this
host. For virtual routes that specify explicit routes with no table
entry, the status value is UNDEF. (In this
case, the value of adj is blank.)  Possible
values are: ACTIV1
The explicit route is active. The explicit route has been defined
to VTAM in a path definition
set; the route is physically available to the network and has been
activated by the node at the other end of the route. A route test
(TEST=YES option) should succeed, because physical connectivity exists
along the entire route when the route is in this state.

ACTIV2
The explicit route is active. The explicit route has been defined
to VTAM in a path definition
set; the route is physically available to the network, has been activated
by the node at the other end of the route, and is in the process of
being activated by this node. A route test (TEST=YES option) should
succeed, because physical connectivity exists along the entire route
when the route is in this state.

ACTIV3
The explicit route is active.  The explicit route has been
defined to VTAM in a path definition
set; the route is physically available to the network and has been
activated by this node or by both this node and the node at the other
end of the route. A route test (TEST=YES option) should succeed, because
physical connectivity exists along the entire route when the route
is in this state.

INACT
The VR is inactive.  The virtual route has been defined to VTAM in a path definition set,
but is not currently active or is pending active. It will be automatically
activated when it is needed for a session.

INOP
The ER is inoperative.  The explicit route has been defined
to VTAM in a path definition
set, but is not physically available to the network.  That is, connectivity
does not exist along the entire route. A route test (TEST=YES option)
will fail, because the explicit route does not have physical connectivity.

PACT
The VR is pending active.  The virtual route has been defined
to VTAM in a path definition
set and is in the process of being activated by this node.

PDEFA
The ER is "pending definition—active".  The explicit
route is physically available to the network, and activation has been
attempted by the node at the other end of the route, but the route
has not yet been defined to VTAM in
a path definition set.  The route is automatically activated by this
node when an appropriate path definition set is processed. A route
test (TEST=YES option) can succeed, even though the explicit route
is not defined in this host. The purpose of the test is to provide
information on the physical connectivity of the explicit route so
that the operator can decide whether or not to define the route. In
order for VTAM to carry session
message traffic, the explicit route must be defined to VTAM.

PDEFO
The ER is "pending definition—operative".  The explicit
route is physically available to the network, but it has not yet been
defined to VTAM in a path definition
set. A route test (TEST=YES option) can succeed, even though the explicit
route is not defined in this host. The purpose of the test is to provide
information on the physical connectivity of the explicit route so
that the operator can decide whether or not to define the route. In
order to be used by VTAM to
carry session message traffic, the explicit route must be defined
to VTAM.

UNDEF
The ER is undefined.  The explicit route has not been defined
to VTAM in a path definition
set and is not physically available to the network. A route test (TEST=YES
option) will always fail, because the explicit route is neither defined
to VTAM nor operative.

vrlist
The user-defined virtual route numbers that map onto the listed
explicit route.

 IST1454I In the message text:  count
The total number of paths displayed.

System action
 Processing continues.

Operator response
 The status might be used for information
only or might indicate that operator action is necessary if any status
does not meet expectations.  In particular, a virtual route or an
explicit route with a status of UNDEF might indicate that a path definition
set should be activated. An explicit route with a status of INOP might
indicate that a subarea node, a cross-subarea link, or a cross-subarea
link station should be activated, or that there is some network problem
with a node, link, or link station.

System programmer response
 None.

Routing code
 2

Descriptor code
 5 