User`s guide

cxlvi Contents

The following steps must be completed to determine the outcome of an asynchronous Write Structured

Fields (127) function call:

u If the WinHLLAPI return code is not zero, the request failed. No asynchronous

request has been made. The application must take appropriate actions before

attempting the call again.

u If the return code is zero, the application should wait until the semaphore is

cleared by using the Get Request Completion (125) function. The semaphore

should not be freed (this done by the Get Request Completion (125) function)

and should not be reused. The semaphore is only valid for the duration of the

Read Structured Fields (126) function call through the completion of the Get

Request Completion (125) function call.

u Once the semaphore is cleared, use the returned 16-bit Request ID as the

Request ID parameter in a call to the Get Request Completion (125) function.

The data string returned from the Get Request Completion (125) function call

contains the final return code of the Write Structured Fields (127) function call.

The communications subsystem allows for a maximum of 20 asynchronous

requests per application to be outstanding. A return code for unavailable resources

(RC= 11) is returned if more than 20 asynchronous requests are attempted.

Structured fields are not supported by the COBOL programming language

due to memory access problems inherent to the language.

Note