Please enable JavaScript to view this site.

ESL Documentation

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