User guide

eWON 500-2001-4001-4002 User Guide - Programming the eWON
eWON 500®2001®4001®4002® Version 4_3_0 - User Guide - 10/5/05 - ©ACT'L sa - Page 147
9.2.39 IORCV
Syntax [function]
IORCV S1
or
IORCV S1, I1
• S1 is the STRING IOServerName
• I1 is an additional parameter (= 0 OR = 1 OR = -1)
Purpose:
Function for reading IO server response to an IOSEND request.
• First case:
• a% in examples below represents the Request number returned by IOSEND.
• a% is the result of the IOSEND command.
Examples:
• Second case:
Same as for a$=IORCV a%,0 but the slot is not freed if a request is done.
• Third case:
Returns the status of the IORCV command in INTEGER format.
The returned status can contain the following values:
See also:
“IOSEND” on page 148
a$ = IORCV a%
a$ = IORCV a%,0
a$=”XXXXXXXXX” where XXXXXXXXX is the result of the request
a$="#FREE" slot a% is free
a$=#RUN" slot a% is in progress
a$="#ERR" slot a% is done with error
a$ = IORCV a%,-1
a$ = IORCV a%,1
b%= -2 slot a% is free
b%= -1 slot a% is in progress
b%= 0 slot a% is done with success
b% > 0 slot a% is done with error
b% < -2
slot a% is done with error - code type: warning
Such warning codes mean “Read failed” on the serial link
These warnings are flagged as internal and thus are not added in the event log
The warning codes can be very long; ie. -536893114