Set Cursor – Function 40

This function places the cursor at a specified position in the Host session presentation space.

Prerequisite functions

Connect Presentation Space (function 1)

Function call

WWinHLLAPI(SETCURSOR,lpbyString,lpwLength,lpwReturnnCode)

Call parameters

Parameter	Description
Data String	NA
Data Length	NA
PS Position	Position in the Host session presentation space to locate the cursor.

Return code

Code	Description
WHLLOK	The cursor was successfully placed at the specified position.
WHLLNOTCONNECTED	Your Windows HLLAPI application is currently not connected to a session.
WHLLPSBUSY	The Host session is busy.
WHLLPOSITIONERROR	PS Position is invalid (less than 1 or greater than the maximum Host session presentation space size).
WHLLSYSERROR	The function failed due to a system error.

Remarks

5250 emulators supports a Presentation Space of 24 rows by 80 columns. When an error message from the host or when the operator presses the SysReq key, a 25th row is displayed. When the row 25 is displayed, it is a valid area for this function.