Use this command to display information about rapid transport protocol
(RTP) connections.
Requirements and Restrictions
The TPF system must have completed Systems Network Architecture (SNA)
restart.
Format
- ALL
- displays information about all of the RTP connections in the TPF
system.
- ALS-alsname
- displays information about all of the RTP connections in the TPF system
that go through the specified adjacent link station (ALS), where
alsname is the 1- to 8-character name of the ALS. The
network ID and name of a resource must both begin with a letter (A-Z),
@, #, or $. The remaining characters can be
letters (A-Z), numbers (0-9), @, #, or
$.
- Note:
- To specify an SNA network ID or resource name that contains dollar signs
($), you must type two consecutive dollar signs ($$) for
each dollar sign in the network ID or resource name. For example, if
the SNA resource name is $SNANAME, you must type
$$SNANAME.
- CP-cpnetid.cpname
- displays information about all of the RTP connections between the TPF
system and the specified remote control point (CP), where
cpnetid.cpname is a 1- to 17-character alphanumeric CP
name. The network ID and name of a resource must both begin with a
letter (A-Z), @, #, or $. The remaining
characters can be letters (A-Z), numbers (0-9), @,
#, or $.
- Note:
- To specify an SNA network ID or resource name that contains dollar signs
($), you must type two consecutive dollar signs ($$) for
each dollar sign in the network ID or resource name. For example, if
the SNA resource name is $SNANAME, you must type
$$SNANAME.
- RTP-index
- displays the contents of the rapid transport protocol control block
(RTPCB) entry with the specified RTPCB index, where index is a 1- to
6-character hexadecimal RTPCB index.
- Format
- formats and displays the RTPCB entry.
- Note:
- The RTP connection must be active.
- STATUS
- displays information about all of the RTP connections that are in one of
the following specified states:
- CONNECTED
- displays the RTP connections that are in their normal state with traffic
flowing.
- MOVING
- displays the RTP connections that are performing a path switch because a
TPF operator entered the ZNRTP SWITCH command.
- RESYNCING
- displays the RTP connections that are performing the RTP connection
resynchronization process.
- STARTING
- displays the RTP connections that are starting.
- SWITCHING
- displays the RTP connections that are performing a path switch because of
a failure in the high-performance routing (HPR) network.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZNRTP HELP
ZNRTP ?
Examples
Information about all of the RTP connections is displayed in the following
example, where:
- RTP
- is the RTPCB index.
- CPNETID
- is the CP network identifier of the remote RTP endpoint.
- CPNAME
- is the CP name of the remote RTP endpoint.
- STATUS
- is the status of the RTP connection, which can be one of the
following:
- CONNECTED
- indicates that the RTP connection is in its normal state with traffic
flowing.
- MOVING
- indicates that a path switch is in progress for the RTP connection because
a TPF operator entered the ZNRTP SWITCH command.
- RESYNCING
- indicates that the RTP connection is performing the RTP connection
resynchronization process.
- STARTING
- indicates that the RTP connection is starting.
- SWITCHING
- indicates that a path switch is in progress for the RTP connection because
of a failure in the HPR network.
- COS
- is the class of service (COS) name used by the RTP connection.
- ALS
- is the name of the ALS, if any, through which the RTP connection is
currently routed.
- SESSIONS
- is the number of HPR LU-LU sessions using the RTP connection.
- SENDQ
- is the number of output messages that are queued and waiting to be sent
out on the RTP connection.
- UNACK
- is the number of network layer packets (NLPs) that the TPF system has sent
out on the RTP connection that have not been acknowledged by the remote RTP
endpoint.
+---------------------------------------------------------------------------------------------+
|User: ZNRTP DISPLAY ALL |
| |
|System: NRTP0001I 13.02.56 BEGIN ZNRTP DISPLAY |
| |
| RTP CPNETID CPNAME STATUS COS ALS SESSIONS SENDQ UNACK |
| ----- -------- -------- --------- -------- -------- -------- ----- ----- |
| 00002 VTAMNET TPFVTAM3 CONNECTED INTERACT P30CA1B 13 6 4 |
| 0000D VTAMNET VTAM2 CONNECTED BATCH P34CA6C 2 0 0 |
| 00015 VTAMNET TPFVTAM3 SWITCHING BATCH 5 3 1 |
| 0002A VTAMNET TPFVTAM3 STARTING BATCH P30CA1B 5 0 0 |
| END OF ZNRTP DISPLAY |
+---------------------------------------------------------------------------------------------+
The specified RTPCB entry is displayed in the following example.
+--------------------------------------------------------------------------------+
|User: ZNRTP DISPLAY RTP-1 |
| |
|System: NRTP0003I 13.04.23 RTPCB ENTRY CONTENTS |
| 03B0D000- 00000102 02810000 1DEB1508 C2000001 .....a.. ....B... |
| 03B0D010- 20E73C1B 00000313 E5E3C1D4 D5C5E340 .X...... VTAMNET |
| 03B0D020- E5E3C1D4 F2404040 D0000000 00000000 VTAM2 ........ |
| 03B0D030- 7BC3D6D5 D5C5C3E3 000009AA C2ED9946 #CONNECT ....B.r. |
| 03B0D040- 09000001 00000000 00000000 00000070 ........ ........ |
| 03B0D050- 00F00101 0012011C 0DE5E3C1 D4D5C5E3 .0...... .VTAMNET |
| 03B0D060- 4BE5E3C1 D4F20000 00000000 00000000 .VTAM2.. ........ |
| 03B0D1A0- 00000000 00000000 0D800002 00D00000 ........ ........ |
| 03B0D1B0- 00000000 00FF0000 00000000 00000000 ........ ........ |
| 03B0D210- 00000000 00000000 B020E73C 00000000 ........ ..X..... |
| 03B0D240- 000001EB 0000007A 00020013 80000000 .......: ........ |
| 03B0D290- 00000000 00000001 00000000 00000000 ........ ........ |
| 03B0D2A0- 00000000 00000002 000001EB 0000007A ........ .......: |
| 03B0D2B0- 00000400 0000007E 00000000 0000013D .......= ........ |
| 03B0D2D0- 00000078 00000000 0004004E 7A2E300B ........ ....:... |
| 03B0D2E0- 00000000 00000014 000002D1 00000000 ........ ...J.... |
| 03B0D2F0- 00000000 00000000 8D8B8EE2 00000000 ........ ...S.... |
| 03B0D310- 00000000 00000000 00000000 00000000 ........ ........ |
| END OF ZNRTP DISPLAY |
+--------------------------------------------------------------------------------+
The specified RTPCB entry is formatted and displayed in the following
example, where:
- CPNETID
- is the CP network identifier of the remote RTP endpoint.
- CPNAME
- is the CP name of the remote RTP endpoint.
- COS
- is the class of service (COS) name used by the RTP connection.
- ALS
- is the name of the ALS, if any, through which the RTP connection is
currently routed.
- LINKSIZE
- is the maximum size for an NLP that can be sent over the RTP connection
across its current route.
- SESSIONS
- is the number of HPR LU-LU sessions using the RTP connection.
- BSN SENT
- is the byte sequence number (BSN) of the next NLP that the TPF system will
send on the RTP connection.
- SENDQSIZ
- is the number of output messages that are queued and waiting to be sent
out on the RTP connection.
- INPUTQ
- is the number of input messages that are queued for the RTP connection
because they were received out of order.
- PIUTRACE
- is the status of the path information unit (PIU) trace facility for the
RTP connection, which can be:
- NO
- indicates that the PIU trace facility is not active for the RTP
connection.
- STATCHNG
- indicates that the PIU trace facility is active for only HPR state changes
on the RTP connection. State changes include HPR ROUTE_SETUP commands,
RTP connections starting, RTP connections stopping, and path switches.
- YES
- indicates that the PIU trace facility is active for the RTP
connection.
- STATUS
- is the status of the RTP connection, which can be one of the
following:
- CONNECTED
- indicates that the RTP connection is in its normal state with traffic
flowing.
- MOVING
- indicates that a path switch is in progress for the RTP connection because
a TPF operator entered the ZNRTP SWITCH command.
- RESYNCING
- indicates that the RTP connection is performing the RTP connection
resynchronization process.
- STARTING
- indicates that the RTP connection is starting.
- SWITCHING
- indicates that a path switch is in progress for the RTP connection because
of a failure in the HPR network.
- LOCAL TCID
- is the transport connection identifier (TCID) that the TPF system assigned
to the RTP connection.
- REMOTE TCID
- is the TCID that the remote RTP endpoint assigned to the RTP
connection.
- REMOTE NCE
- is the network connection endpoint (NCE) of the remote RTP
endpoint.
- PATH SWITCHES
- is the number of path switches that completed successfully for the RTP
connection.
- RETRANSMITS
- is the number of NLPs that the TPF system retransmitted to the remote RTP
endpoint on the RTP connection.
- BSN RECEIVED
- is the byte sequence number (BSN) of the next NLP that the TPF system is
expecting to receive on the RTP connection.
- UNACKNOWLEDGED
- is the number of NLPs that the TPF system has sent out on the RTP
connection that have not been acknowledged by the remote RTP endpoint.
- PATH SW TIMER
- indicates whether the path switch timer is running for the RTP connection
and, if so, how many seconds remain for the path switch to be completed before
the path switch will time out. If the path switch timer is not running,
the time out value is displayed.
- AVG ROUND TRIP
- is the average number of seconds that it takes for the TPF system to send
an NLP to the remote RTP endpoint and receive an acknowledgement on the RTP
connection.
- ALLOWED SEND RATE
- is the number of bytes that the TPF system is allowed to send on the RTP
connection in one second.
- AVERAGE BYTES SENT
- is the average number of bytes that the TPF system sent on the RTP
connection in one second.
- MAXIMUM BYTES SENT
- is the maximum number of bytes that the TPF system sent on the RTP
connection in one second.
- SYNC
- is the current synchronization number for the RTP connection.
- ECHO
- is the current echo number for the RTP connection.
- AVERAGE BYTES RECEIVED
- is the average number of bytes that the TPF system received on the RTP
connection in 1 second.
- MAXIMUM BYTES RECEIVED
- is the maximum number of bytes that the TPF system received on the RTP
connection in 1 second.
+--------------------------------------------------------------------------------+
|User: ZNRTP DISPLAY RTP-1 FORMAT |
| |
|System: NRTP0004I 13.34.23 RTPCB ENTRY CONTENTS FORMATTED |
| |
| CPNETID - VTAMNET STATUS - CONNECTED |
| CPNAME - A604 LOCAL TCID - 0D12124E C2000002 |
| COS - #CONNECT REMOTE TCID - 0C1D840A C3000002 |
| ALS - P42CA1B REMOTE NCE - DA |
| LINKSIZE - 1452 PATH SWITCHES - 0 |
| SESSIONS - 1 RETRANSMITS - 0 |
| BSN SENT - 00009DAA BSN RECEIVED - 00009DC1 |
| SENDQSIZ - 0 UNACKNOWLEDGED - 1 |
| INPUTQ - 0 PATH SW TIMER - 90 STOPPED |
| PIUTRACE - YES AVG ROUND TRIP - 0.037602 |
| |
| ALLOWED SEND RATE - 37600 SYNC - 0001 ECHO - 0001 |
| AVERAGE BYTES SENT - 1622 AVERAGE BYTES RECEIVED - 1625 |
| MAXIMUM BYTES SENT - 3870 MAXIMUM BYTES RECEIVED - 3870 |
| |
|END OF ZNRTP DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF ACF/SNA Data Communications Reference for
more information about RTP connections and the RTPCB table.