Field Types
Sends an indication to the partner program that your program is ready to receive data. This gives the partner program authority to send. See the APPC_ReadyToReceive value of the MORE_TO_SEND argument on APPCSendString.
Note: Normally, you do not need this subroutine if you are using the automatic interface, since the conversation state is normally changed automatically. However, this subroutine is needed to force a change in conversation state from send to receive when the last call to APPCSendString had a MORE_TO_SEND argument with a value of APPC_MoreData.
Declaration:
subroutine APPCReadyToReceive(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:
# Now In Send State
response to stimulus APPC_EVENT APPC_SendState ConvID
call APPCSendString (ConvID, # Handle from Start/AcceptStart
String1, # String to send
NoConvert, # Do not convert string
Force, # Send data now
More ) # Will send more data
call APPCSendString (ConvID, # Handle from Start/AcceptStart
String2, # String to send
NoConvert, # Do not convert string
Force, # Send data now
More ) # Will send more data
. . .
# No more data to send
# End of send
call APPCReadyToReceive(ConvID) # Handle from Start/AcceptStart
