IST1476I

Explanation
 VTAM® issues
this message as part of a group of messages in response to a DISPLAY
ID command for a type 2.1 node representing a Rapid Transport Protocol
(RTP) route. This message is the first in a group of messages and
the full description of the message group follows. If the DISPLAY ID command was issued without HPRDIAG=YES specified,
the following message group is displayed:  IST1476I      TCID X'tcid' - REMOTE TCID X'remote_tcid'
 IST1481I      DESTINATION CP nodename - NCE X'nceid'
 IST1587I      ORIGIN NCE X'nceid'
[IST1966I      ACTIVATED AS ACTIVE ON date AT time]
[IST1967I      ACTIVATED AS PASSIVE ON date AT time]
[IST2237I      puname CURRENTLY REPRESENTS A LIMITED RESOURCE]
 IST1477I      ALLOWED DATA FLOW RATE = allowed units
 IST1516I      INITIAL DATA FLOW RATE = initial units
 IST1841I      ACTUAL DATA FLOW RATE = actual units
 IST1511I      MAXIMUM NETWORK LAYER PACKET SIZE = size BYTES
 IST1478I      NUMBER OF UNACKNOWLEDGED BUFFERS = buffers
 IST1479I      RTP CONNECTION STATE = state - MNPS = mnps
[IST1959I      DATA FLOW STATE: NORMAL]
[IST1961I      DATA FLOW STATE: STALLED]
 IST1855I      NUMBER OF SESSIONS USING RTP = sessions
[IST1697I      RTP PACING ALGORITHM = ARB RESPONSIVE MODE]
[IST2267I      RTP PACING ALGORITHM = ARB PROGRESSIVE MODE]
[IST2395I      RTP PACING ALGORITHM = ARB BASE MODE]
[IST1480I      RTP END TO END ROUTE - RSCV PATH]
[IST1460I      TGN    CPNAME            TG TYPE       HPR]
[IST1461I      tgn    cpname            tgtype        hpr]
[IST875I       ALSNAME TOWARDS adjacent_resource_type = resource_name]
[IST1738I      ANR LABEL                TP            ER NUMBER]
[IST1739I      anr_label                tp            er_number]
[IST1588I      RTP END TO END ROUTE - COMPUTED SESSION PATH]
[IST1460I      TGN    CPNAME            TG TYPE       HPR ]
[IST1461I      tgn    cpname            tgtype        hpr ]
[IST875I       ALSNAME TOWARDS adjacent_resource_type = resource_name]
[IST1738I      ANR LABEL                TP            ER NUMBER]
[IST1739I      anr_label                tp            er_number]

If the DISPLAY ID command was issued with HPRDIAG=YES specified,
the following message group is displayed:  IST1476I      TCID X'tcid' - REMOTE TCID X'remote_tcid'
 IST1481I      DESTINATION CP nodename - NCE X'nceid'
 IST1587I      ORIGIN NCE X'nceid'
[IST1966I      ACTIVATED AS ACTIVE ON date AT time]
[IST1967I      ACTIVATED AS PASSIVE ON date AT time]
[IST2237I      puname CURRENTLY REPRESENTS A LIMITED RESOURCE]
 IST1479I      RTP CONNECTION STATE = state - MNPS = mnps
[IST1959I      DATA FLOW STATE: NORMAL]
[IST1961I      DATA FLOW STATE: STALLED]
 IST1855I      NUMBER OF SESSIONS USING RTP = sessions
[IST1480I      RTP END TO END ROUTE - RSCV PATH]
[IST1460I      TGN    CPNAME            TG TYPE       HPR]
[IST1461I      tgn    cpname            tgtype        hpr]
[IST875I       ALSNAME TOWARDS adjacent_resource_type = resource_name]
[IST1738I      ANR LABEL                TP            ER NUMBER]
[IST1739I      anr_label                tp            er_number]
[IST1588I      RTP END TO END ROUTE - COMPUTED SESSION PATH]
[IST1460I      TGN    CPNAME            TG TYPE       HPR]
[IST1461I      tgn    cpname            tgtype        hpr]
[IST875I       ALSNAME TOWARDS adjacent_resource_type = resource_name]
[IST1738I      ANR LABEL                TP            ER NUMBER]
[IST1739I      anr_label                tp            er_number]
 IST924I       ---------------------------------------------------------
The
remainder of this display is described under IST1968I.  See that message for
more information.

 IST875I  This message displays information about the adjacent link station
(ALSNAME), which is the physical connection to the adjacent
node.
adjacent_resource_type will always be RTP,
which means that the ALSNAME is used in the direction of the other
endpoint of the RTP pipe.
resource_name is the name of the adjacent
link station (ALS).

 IST924I  This message is used as a separator message to group together
messages IST1857I, IST1858I, and IST1859I in the display.

 IST1460I  This message is a header message for information displayed in
message IST1461I.

 IST1461I  The route selection control vector (RSCV) is displayed for the
route to the destination node of the partner transaction program.
Multiple IST1461I messages might be needed to display the full route.
tgn is the transmission group number.
cpname is the destination CP name for the transmission
group.  Tip: The cpname for a composite
node might not always be correct. When an SSCP takeover occurs for
an NCP in a composite node and the cpname was changed,
the new cpname is not reflected in the display
of the RTP end-to-end route.

tgtype is the transmission group type. The
values for tgtype can be one of the following:
 APPN
Indicates that this TG is an APPN-based TG.
INTERCHANGE
Indicates that this TG represents a TG from an  interchange node
to a subarea node.
VRTG
Indicates that this TG is a virtual-route-based TG.
ISL
Indicates that this TG is an intersubnet TG.

hpr corresponds with the HPR start option.
The values for hpr can be:  RTP
indicates this VTAM provides
RTP-level HPR support.
ANR
indicates this VTAM provides
ANR-level HPR support.
*NA*
indicates this VTAM provides
no HPR support.

 IST1476I  tcid is a transport connection identifier,
assigned by this node, that uniquely identifies the session endpoint.
remote_tcid is a transport connection identifier,
assigned by the RTP partner node, that uniquely identifies the session
endpoint.

 IST1477I  allowed is the allowed rate at which data
can be sent over the RTP connection at the time this message is displayed.
units is the unit of measure for the rate
and is displayed in bits, kilobits, megabits, or gigabits per second
(BITS/SEC, KBITS/SEC, MBITS/SEC, or GBITS/SEC).
The data flow rate is updated approximately every second while
data is flowing.

 IST1478I  buffers is the number of I/O buffers, containing
outbound data, that have been sent to the partner without an acknowledgment
since the HPR PU was activated.

 IST1479I  state is the connection state of the RTP. The
values for state can be:  INITIAL
Initial state at startup time.
ALS_PENDING
Waiting for adjacent link station processing.
ALS_ASSIGNED
Adjacent link station processing is complete.
OPENED
Initial state for active partner after startup.
CALLING
Active partner sending connection setup to the partner.
CALLING/PATHSWITCH
RTP path switch is in progress while in CALLING state.
CONNECTED
RTP is active.
CONNECTED/BACKPRESSURE
RTP backpressure is currently being applied.
CONNECTED/PATHSWITCH
RTP path switch is in progress.
DISCONNECT
Doing disconnect processing.
DISCONNECTED
Disconnect processing is complete and last message has been sent.
LISTENING
Initial state for passive partner after startup.
LISTENING/PATHSWITCH
RTP path switch is in progress while in LISTENING state.
PENDING_ACT
Waiting for activation to complete.
PENDING_INACT
Waiting for deactivation to complete.
PENDING TAKEOVR
Multinode persistent session planned takeover is in progress.
RECOVERY
Multinode persistent session recovery in progress.

  mnps indicates if the RTP end-to-end
route is being used by an MNPS application. The values for mnps can
be:  YES
The RTP is being used by an MNPS application.
NO
The RTP is not being used by an MNPS application.

 IST1480I  This message informs users that the messages that follow describe
the RSCV end-to-end path of the RTP route. The RSCV path represents
the route used to send data from the origin CP to the destination
CP. This message group will not be displayed if the RTP is processing
a path switch or the RSCV is not available.

 IST1481I  nodename is the network-qualified name of
destination partner's CP in the form netid.name for
this RTP route.
nceid is the destination partner's network
connection endpoint (NCE) ID for this RTP route.

 IST1511I  size is the maximum size of a network layer
packet (NLP) that can be sent over this Rapid Transport Protocol (RTP)
connection in bytes.

 IST1516I  initial is the initial data flow rate for
this Rapid Transport Protocol (RTP) connection.
units is the unit of measure for the rate
and is displayed in bits, kilobits, megabits, or gigabits per second
(BITS/SEC, KBITS/SEC, MBITS/SEC, or GBITS/SEC).

 IST1587I  nceid is this node's network connection endpoint
(NCE) ID for the Rapid Transport Protocol (RTP) connection.

 IST1588I  This message informs users that the messages that follow describe
the computed end-to-end path of the Rapid Transport Protocol (RTP)
route. This message is displayed if the physical path is different
from the computed path. The physical and computed session paths can
be different when one of the RTP endpoints is associated with a multiple
node persistent session (MNPS) application program.
See the z/OS Communications Server: SNA Network Implementation
Guide for additional information
when the computed path is different from the physical path.

 IST1697I  This message indicates that the responsive-mode adaptive rate-based
(ARB) pacing algorithm is being used.

 IST1738I  This message is a header message for information displayed in
message IST1739I.

 IST1739I  anr_label is an identifier for a unidirectional
transmission link between two nodes. A node will use this routing
label internally to correctly forward HPR network layer packet (NLP)
data along a given Rapid Transport Protocol (RTP) connection.
tp is the subarea transmission priority. 
When anr_label represents a subarea transmission
link, tp identifies the priority of data flowing
over an explicit route during a session.                         

er_number is the explicit route number. When anr_label represents
a subarea transmission link, er_number represents
the underlying subarea explicit route used for the HPR NLP traffic.

 IST1841I  This message shows the actual data flow rate for this Rapid Transport
Protocol (RTP).  It should be compared with the allowed data rate
displayed by message IST1477I, and the initial data rate displayed
by IST1516I.
actual is the actual rate at which data is
being sent over the RTP connection at the time this message is displayed.
units is the unit of measure for the rate
and is displayed in bits, kilobits, megabits, or gigabits per second
(BITS/SEC, KBITS/SEC, MBITS/SEC, or GBITS/SEC).
The data flow rate is updated approximately every second while
data is flowing.

 IST1855I   sessions is the number of fully active sessions
that are currently using this Rapid Transport Protocol (RTP). 

 IST1959I  This message indicates that data is flowing on the RTP pipe.

 IST1961I  This message indicates that data is not flowing on the RTP pipe.
The data flow is stalled for one of the following reasons: The RTP partner requests retransmission of at least one NLP, but
the request cannot be honored.   
The RTP partner repeatedly requests the retransmission of the
same NLP.  In this case, VTAM honors
the request by retransmitting the NLP, but the partner does not receive
this NLP.

A stalled RTP pipe causes all the sessions using the pipe to stall.
A persistent STALLED state might require forced inactivation of the
HPR PU. If you want VTAM to
automatically deactivate stalled RTP pipes after a specified amount
of time, use the HPRSTALL start option. See the HPRSTALL
start option information in z/OS Communications Server: SNA Resource Definition
Reference.

 IST1966I  This message shows when the RTP pipe was activated.  It is issued
only if the PU is the active end of the pipe.
The date and time values
specify the date and time of the activation. See DATE and TIME formats for information about the date and time values.

 IST1967I  This message shows when the RTP pipe was activated.  It is issued
only if the PU is the passive end of the pipe.
The date and time values
specify the date and time of the activation. See DATE and TIME formats for information about the date and time values.

 IST2237I  This message indicates that a DISCNT value was coded on the physical
link of the underlying DLC. 
puname is the name of the Rapid Transport
Protocol (RTP) PU being displayed.

 IST2267I  This message indicates that the progressive-mode adaptive rate-based
(ARB) pacing algorithm is being used.

IST2395IThis message indicates that the base-mode adaptive rate-based
(ARB) pacing algorithm is being used.

System action
 Processing continues.

Operator response
 None.

System programmer response
 None.

Routing code
 2

Descriptor code
 5