User`s guide

cxxviii Contents
The user specifies whether the application can query of wait for one of the following:
u A specific asynchronous function request by supplying the Request ID of that
function and a non-blank session short name.
u The first completed asynchronous function request by supplying a Request ID of
0x0000 and a blank session short name.
u The first completed asynchronous function request for a specified session by
supplying a Request ID of 0x0000 and a non-blank session short name.
u The Get Request Completion (125) function behaves differently depending upon
the second character of the parameter string, which is one of the following:
N (no wait)
If a specific Request ID was supplied and the function completed, control is
returned to the application with a return code of zero and a completed data string
as defined previously. If a Request ID of 0x0000 was supplied and any eligible
asynchronous function has completed, control is returned to the application with
a return code of zero and a completed data string as defined previously. If a
function has not completed, control is returned to the calling application with a
non-zero return code.
W (wait)
If a specific Request ID was supplied and the function has completed:
u The semaphore is cleared
Control is returned to the application with a return code of zero and a completed
data string as defined previously
If a Request ID of zero was supplied any eligible function has completed:
u The semaphore is cleared
Control is returned to the application with a return code of zero and a completed
data string as defined previously
If a function has not completed, the call waits until a function completes before
returning to the application. When it returns, the return code is zero and the data
string is completed.