Retrieve Session Line to Input Line (QsnRtvSsnLin) API

The Retrieve Session Line to Input Line (QsnRtvSsnLin) API retrieves the input line from the scroller that corresponds to the cursor position within the scroller. If the cursor is outside the scroller and the retrieve request directly follows another retrieve with no intervening I/O operations, then the line before the line previously retrieved is returned. Otherwise, the last input line is retrieved. If there is no input data, this API still completes successfully.

Restrictions

The data on the retrieved line may be incompatible with the current state of the session input line. This may happen when QsnReadSsnDta echoes input to the scroller, and that data is later retreived on a call or after a call of QsnReadSsnDtaCC. If the session input line does not support the data of the retrieved line, CPFA3E1 will be signaled and placed on the session message line. The scroller line will not be retrieved to the session input line, since the data can be corrupted or misinterpreted.

Authorities and Locks

None

Required Parameter

Session handle

INPUT; BINARY(4)

A handle for the session for which to retrieve the input line.

Omissible Parameter

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