Field Types
Requests receipt of data. When data is available, it is indicated by the APPC_Data event notification. Call APPCGetString to get the data.
Note: This subroutine must not be used in the automatic interface, or a system error is generated.
Declaration:
subroutine APPCReceiveNotify(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:
call APPCReceiveNotify ( ConvID ) # Handle from Start/AcceptStart
# Data is available
response to stimulus APPC_EVENT APPC_Data ConvID
call APPCGetString(ConvID, # Handle from Start/AcceptStart
String1, # Get data
NoConvert)# Do not convert string
