Field Types
Queries if the partner program wants to send data. If a request to send has been received from the partner, your program receives an APPC_RequestToSend event notification.
Declaration:
subroutine APPCTestReqToSend( integer:CONVERSATION_ID ) library "eslappc"
Arguments:
•CONVERSATION_ID is an integer variable containing the conversation identifier (handle) for the APPC conversation returned by either APPCStart or APPCAcceptStart.
Errors:
APPC_NORMAL_COMPLETION |
Normal completion. |
APPC_ERR_OUT_OF_MEMORY |
Out of memory. |
APPC_ERR_INV_CONV_ID |
Invalid argument: CONVERSATION_ID |
APPC_ERR_UNEXPECTED_ERROR |
Unexpected error encountered. |
APPC_ERR_UNEXPECTED_DOS_ERROR |
Unexpected operating system error encountered. |
Example:
# A period of time has elapsed since last send
# Does partner want to send?
call APPCTestReqToSend(ConvID) # Handle from Start/AcceptStart
# Received request
response to stimulus APPC_EVENT APPC_RequestToSend ConvID
# Allow partner to send
call APPCReceiveNotify(ConvID) # Handle from Start/AcceptStart
