| 1 | Input buffer handle | Input | Binary(4) |
| 2 | Read command used | Output | Binary(4) |
| 3 | Error code | I/O | Char(*) |
| Return code | Output | Binary(4) |
The Retrieve Available Data (QsnRtvAvailData) API is used to retrieve invited available data. If the invite active flag is on in a low-level environment description when an output operation is done, the end user is able to enter data. If a subsequent output operation is done, without checking for input using the QsnReadInvited API, and the user has entered data, DSM will store the end user's data in an internal input buffer and issue CPFA343. The Retrieve Available Data (QsnRtvAvailData) API will copy the data into the specified input buffer, as well as return the read command that is used to fill the buffer.
None.
A handle for the input buffer where available data should be moved.
The read command that was used to fill the input buffer. This can be used to determine what buffer manipulation API to use to retrieve the data from the input buffer. The possible values are:
| X'42' | Read input fields |
| X'52' | Read MDT fields |
| X'72' | Read immediate |
| X'82' | Read MDT alternate |
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.
A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPFA319 E | No data in input buffer. |
| CPFA31E E | Required parameter &1 omitted. |
| CPFA320 E | Pointer parameter is null. |
| CPFA32F E | Buffer type incorrect. |
| CPFA331 E | Buffer handle incorrect. |
[ Back to top | Dynamic Screen Manager APIs | APIs by category ]