Retrieve Available Data (QsnRtvAvailData) API
Required Parameter Group:
1 | Input buffer handle | Input | Binary(4) |
2 | Read command used | Output | Binary(4) |
Omissible Parameter Group:
3 | Error code | I/O | Char(*) |
Returned Value:
Return code | Output | Binary(4) |
Default Public Authority: *USE
Service Program: QSNAPI
Threadsafe: No
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.
Authorities and Locks
None.
Required Parameter Group
- Input buffer handle
- INPUT; BINARY(4)
A handle for the input buffer where available data should be moved.
- Read command used
- OUTPUT; CHAR(1)
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
Omissible Parameter Group
- Error code
- I/O; CHAR(*)
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.
Returned Value
- Return code
- OUTPUT; BINARY(4)
A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.
Error Messages
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. |
API introduced: V2R3
[ Back to top | Dynamic Screen Manager APIs | APIs by category ]