gtpo1mbqOperations

ZNRTP DISPLAY-Display Information about RTP Connections

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.