RTPINFO

Use RTPINFO to display information about RTP pipes.

RTPINFO displays the following information:

A specific RTP pipe
All RTP pipes to a particular destination
All RTP pipes with an exception condition
All RTP pipes in the system

Operands

ADDRESS

Enter 1–8 hexadecimal digits in the form X'x.......' for the address used to find the RTP pipe. If the address is fewer than 8 digits, it is padded on the left with zeros.

Tip: Use double quotation marks for the address in IPCS for VERBX:

VERBX VTAMMAP 'RTPINFO ADDR(X''00000450'')'

SYMBOL

Enter 1–31 alphanumeric characters for an IPCS symbol name that has been previously equated to a location of the RTP pipe. Do not include a period.

Under IPCS, the symbol X represents the address currently being displayed. If the current address points to a location of the RTP pipe, this symbol X may be used to refer to it.

PUNAME

The PUNAME should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, leftmost characters are compared. PUNAME is the name of the RTP pipe.

CPNAME

The CPNAME should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, leftmost characters are compared. CPNAME is the name of the destination CP of the RTP pipe.

NETID

The NETID should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, leftmost characters are compared. NETID is valid only with the CPNAME option. NETID is the network ID of the destination CP of the RTP pipe.

Guideline: If you specify a CPNAME but do not specify a NETID, the host network ID will be used to form a fully qualified network name.

ALLRTPS

ALLRTPS indicates all RTPs in the system are displayed.

EXCEPTN

EXCEPTN indicates all RTPs with the predefined exception condition in the system are displayed. This is the default option when the RTPINFO command is issued without any option.

COUNT

COUNT specifies the minimum number of work elements in one of the RTP queues to display the detail information for the EXCEPTN operand. This operand is valid with the EXCEPTN operand. The valid range is 1–999.

DETAIL

DETAIL indicates that the detail information for each RTP will be displayed. This operand is valid with the CPNAME, ALLRTPS, or EXCEPTN operand. If this operand is not specified, the summary (not detail) is the default value.

Use the following syntax as an alternative to the panel interface.

Syntax


>>-RTPINFO------------------------------------------------------>

   .- --EXCEPTN COUNT--(--50--)-------------------------------.   
>--+----------------------------------------------------------+-><
   +- --ADDRESS--(--address--)--------------------------------+   
   +- --SYMBOL--(--IPCS symbol--)-----------------------------+   
   +- --PUNAME--(--puname--)----------------------------------+   
   +- --ALLRTPS--+--------+-----------------------------------+   
   |             '-DETAIL-'                                   |   
   +- --EXCEPTN--+--------------+--+--------+-----------------+   
   |             '-COUNT(value)-'  '-DETAIL-'                 |   
   '-CPNAME--(--cpname--)--+--------------------+--+--------+-'   
                           '-NETID--(--netid--)-'  '-DETAIL-'

Additional information

When CPNAME or ALLRTPS option is specified, summary information is displayed for each RTP.
EXCEPTN is the default option with the count value of 50 work elements. The exception conditions are as follows:
- RPNCB PABs running with or without queued work elements.
- The RPN_CONN_STATE is not equal to RPN_CONNECTED (normal state).
- The RPN_BACKPRESSURE indicator is on.
- The RPN_NABS value is greater than one.
- The RPN_NABS_RCV value is greater than one.
- If the number of work elements in one of the following queues is equal to or greater than the user specified value (or the default value of 50):
  - RPNIBWKQ
  - RPN_PENDING_SENDS_Q
  - RPN_WAIT_FOR_ACK_Q
  - RPN_RCV_MESSAGES_Q
  - RPN_RCV_SEGMENTS_Q
  - RPN_OUTOFSEQ_MSG_Q
  - RPN_PENDING_ALLOC_Q
  - NCBWORKQ

Sample output

RTPINFO PUNAME(CNR00003)                                     
                                                              
                             RTPINFO Analysis                 
                                                              
Start of CNR00003 Detail information:                         
------------------------------------------------------------  
RTPTB Slot:         000000E6                                  
RPNCB Address:      15147800                                  
RPN_ALS_NAME:       CNR00003                                  
COS Name:           #CONNECT                                  
Destination CPName: SSCP2A                                    
Destination NetID:  NETA                                      
RPN_Activation_TOD: 10/16/03 22:01:06.960654                  
                                                              
Connection Information:                                       
RPN_CONN_STATE:     X'32' RPN_CONNECTED - Normal State        
RPN_LOCAL_CONN_ID:  2E4E0F2A0001000D                          
RPN_REMOTE_CONN_ID: 2E5289960001000B                          
RPN_CONN_TYPE:      X'30' - RPN_LULU                          
                    Not a limited Resource                    
                    Active End of Pipe                        
RPN_LOCAL_NCB_PTR:  151F2340                                  
Local NCB Type:     X'2E'                                     
                                                              
BackPressure Fields:                                          
RPN_BACK_PRESSURE:     OFF                                    
RPN_BP_APPLIED:        0000                                   
                                                              
BackPressure Reason Counts:                                   
RPN_Backpress_PS_Count:    00                                 
RPN_Backpress_SendQ_Count: 00                                 
RPN_Backpress_Store_Count: 00                                 
RPN_Backpress_Stall_Count: 00     
                                                
Path Switch Information:                         
RPN_PSWCH_STATE:           OFF                   
RPN_Cnt_PS_Initiated_Rem:  0000                  
RPN_Cnt_PS_Initiated_Loc:  0000                  
RPN_Cnt_PS_Due_To_Failure: 0000                  
RPN_Cnt_PS_Due_To_PSRETRY: 0000                  
                                                 
RPNCB PAB Information:                           
NCBPCPAB: 00000000 00000000 15EF2F34 00000000    
NCBBSPAB: 00000000 00000000 969920C8 00000000    
NCBPUPAB: 00000000 00000000 15EF2FA4 00000000    
                                                 
Queue Information:                               
NCBWORKQ Queue Count:       00000000             
RPNIBWKQ Queue Count:       00000000             
RPN_Pending_Sends_Q_Cnt:    00000000             
RPN_Wait_For_Ack_Q_Cnt:     00000013             
RPN_RCV_Messages_Q Count:   00000000             
RPN_OutOfSeq_Msg_Q_Cnt:     00000000             
RPN_PENDING_ALLOC_Q Count:  00000000             
RPN_RCV_Segments NLP Count: 00000000             
                                                 
Transmission Sequence Numbers:                   
RPN_NEXT_BYTE_XMIT:   004C4EFF                   
RPN_LAST_ACK_TRANS:   004C3CD1                   
RPN_LAST_SREQ_SEQ:    004C4D3C                   
RPN_LAST_BYTE_RCV:    004C3BF9                   
RPN_LAST_REXMIT_SEQ:  00000000                   
RPN_LAST_STATUS_XMIT:     0001                   
RPN_LAST_ECHO:            0001                   
RPN_LAST_STATUS_RCV:      0002                   
                                                 
RPNCB NAB Information:                           
RPN_NABS:             00000000                   
RPN_NABS_RCV:         00000000                   
                                                 
RPNCB ARB Information:    
ARB_ALLOW_SEND_RATE:     00000C1E                                         
ARB_MAX_SEND_RATE:       00007D00                                         
ARB2_CURRENT_RTT:        00000001                                         
ARB2_SMOOTH_ACTUAL_RATE: 0000034A                                         
ARB_ACCUM_QTIME:         00000B55                                         
ARB2_RCVR_THRESHOLD:     000177AB                                         
ARB2_RCVR_THRESHOLD_MIN: 00004268                                         
ARB2_RCVR_THRESHOLD_MAX: 00009088                                         
                                                                          
End of CNR00003 information --------------------------------              
                                                                                                                                                    
Number of RTPs displayed:                       1                         
Number of RTPs found and processed:             1

RTPINFO EXCEPTN COUNT(012)                          
                                                     
                             RTPINFO Analysis        
                                                     
Start of CNR00003 Summary information:               
-----------------------------------------------------
RTPTB Slot:         000000E6                         
RPNCB Address:      15147800                         
RPN_ALS_NAME:       CNR00003                         
COS Name:           #CONNECT                         
Destination CPName: SSCP2A                           
Destination NetID:  NETA                             
RPN_Activation_TOD: 10/16/03 22:01:06.960654         
                                                     
Connection Information:                              
RPN_CONN_STATE:     X'32' RPN_CONNECTED - Normal Stat
RPN_LOCAL_CONN_ID:  2E4E0F2A0001000D                 
RPN_REMOTE_CONN_ID: 2E5289960001000B                 
RPN_CONN_TYPE:      X'30' - RPN_LULU                 
                    Not a limited Resource           
                    Active End of Pipe               
RPN_LOCAL_NCB_PTR:  151F2340                         
Local NCB Type:     X'2E'                            
                                                     
BackPressure Fields:                                 
RPN_BACK_PRESSURE:     OFF                           
RPN_BP_APPLIED:        0000                          
                                                     
BackPressure Reason Counts:                          
RPN_Backpress_PS_Count:    00                        
RPN_Backpress_SendQ_Count: 00                        
RPN_Backpress_Store_Count: 00                        
RPN_Backpress_Stall_Count: 00                        

Path Switch Information:                                        
RPN_PSWCH_STATE:           OFF                                  
RPN_Cnt_PS_Initiated_Rem:  0000                                 
RPN_Cnt_PS_Initiated_Loc:  0000                                 
RPN_Cnt_PS_Due_To_Failure: 0000                                 
RPN_Cnt_PS_Due_To_PSRETRY: 0000                                 
                                                                
End of CNR00003 information --------------------------------    
 
Number of RTPs displayed:                       1               
Number of RTPs found and processed:             3