&APPC REQUEST_TO

&APPC REQUEST_TO_SEND

&APPC REQUEST_TO_SENT notifies the remote program that the local conversation partner would like to send data.

REQUEST_TO_SEND indicates that the local procedure wants to enter send state.

This verb has the following format:

&APPC REQUEST_TO_SEND [ ID=id ]

Operand:

ID=id: Specifies the conversation identifier (as first returned by the system variable &ZAPPCID after successful allocation) that references a particular conversation. If this parameter is omitted the current (last referenced, or only) conversation is assumed.

Example: &APPC REQUEST_TO_SEND

&APPC REQUEST_TO_SEND

Return Codes:

The return codes are as follows:

&ZFDBK is also set, plus all APPC system variables.

State Transition:

The REQUEST_TO_SEND request can only be issued from receive state or one of the confirm states. No state changes occur as a result of this request.

Notes:

Use this request only in controlled situations where the local program wants to send data. However, no state changes occur. The remote conversation partner has the discretion to detect that the REQUEST_TO_SEND was issued (by examining the REQUEST_TO_SEND_RECEIVED indicator, &ZAPPCRTS) and issuing the appropriate requests to turn the conversation around.
The SEND_ERROR request is used (with great discretion) to force the send state if necessary.

Relationship to LU6.2 Verb Set:

&APPC REQUEST_TO_SEND is equivalent to the LU6.2 verb MC_REQUEST_TO_SEND.

More information: