gtpi1m4kSystem Installation Support Reference

Select an RTP Connection

The select a rapid transport protocol (RTP) connection user exit, URTP, allows you to specify which RTP connection to use when an LU-LU session is started. You can start a new RTP connection for the LU-LU session or you can choose an existing RTP connection.

URTP is called only when the following conditions are true:

Input

EBX016-EBX019
Address of the parameter list, which contains the following:

Bytes 0-3
Number of existing RTP connections that can be used for the LU-LU session.

Bytes 4-n
An 8-byte entry for each RTP connection that can be used, which contains the following:

Bytes 0-2
Rapid transport protocol control block (RTPCB) index of the RTP connection.

Byte 3
Status of the RTP connection, which can be the following:

 X'01' 
Starting

 X'02' 
Connected

 X'03' 
Switching

 X'04' 
Moving

 X'05' 
Resynchronizing.

See the IRTP_STATUS field in the IRTPB DSECT for more information.

Bytes 4-7
Number of LU-LU sessions currently using the RTP connection.

Programming Considerations

Return Values

R0 contains the return code:

0
Start a new RTP connection.

x
The RTPCB index of the RTP connection to be used.