SETCURSOR Function

RAMP-NL

SETCURSOR Function


Positions the cursor in a given row and column of the screen

Syntax

SETCURSOR([iRowNumber][,iColumnNumber][,iRowOffset])

Parameters

IRowNumber

Required. Integer that specifies the row number where to position the cursor.

IColumnNumber

Optional. Integer that specifies the column number where to position the cursor.  Defaults to 1.

IRowOffset

Optional. Integer that specifies the row number of the first row in a browse list or subfile. This parameter only makes sense in situations where the cursor is to be positioned in a browse list or subfile row and the entry is selected pressing the Enter key.

Note that in newlook, browse lists and subfiles are recognized as grids. In these grids, column headings are counted as rows. Hence the value of this parameter should equal to the row position of the topmost column heading literal.

To find out the row position of the browselist or subfile, run the application in 5250 session until you reach the desired list. You should be able to see the row/column positions on the bottom right of the screen. Move the cursor until the column heading's top most piece of text.

Return Value

None.

Example

 

SETCURSOR(7, 10, 3);