Field Types
Sends an indication to the partner program that your program wants to send data. Your program knows that it has been granted permission to send when it receives an APPC_SendState event notification.
Declaration:
subroutine APPCRequestToSend(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. |
Example:
call APPCRequestToSend(ConvID) # Handle from Start/AcceptStart
# Now In Send State
response to stimulus APPC_EVENT APPC_SendState ConvID
call APPCSendString(ConvID, # Handle from Start/AcceptStart
String2, # String to send
NoConvert, # Do not convert string
Force, # Send data now
PrepareToReceive)# This send expects reply
call APPCReceiveNotify(ConvID) # Handle from Start/AcceptStart