5.2.14 SETBYPOS
The SETBYPOS command sets the value of a field on the current aXes terminal screen by reference to the screen row and column number and may (optionally) send the current aXes screen data to the aXes terminal server. It is similar to typing at a 5250 terminal.
To exchange field RTNSIG and RTNSCREEN values, you will need to specify the SERVICE_EXCHANGE(*FIELD) in the command string.
Syntax:
|
Command
|
Keyword
|
Value
|
Developer notes
|
|
SETBYPOS
|
ROW
|
row number
|
Required. The screen row number of the required field. The row and column together must refer to the first position of the required field.
|
|
COL
|
column number
|
Required. The screen column number of the required field. The row and column together must refer to the first position of the required field.
|
|
VALUE
|
value
|
Required. The value to be set in the specified field.
|
|
SENDKEY
|
ENTER
|
Optional. If this keyword is specified, the command will send the current aXes screen data to the aXes terminal server using the function key specified (after successfully setting the field value).
|
|
F1 - F24
|
|
|
HELP
|
|
|
PRINT
|
|
|
PAGE_UP
|
|
|
PAGE_DOWN
|
|
|
ROLL_UP
|
|
|
ROLL_DOWN
|
|
|
|
Default. No send operation.
|
|
RTNSIG
|
field-name
|
Optional. The name of a field exchanged between your client program and the JSM that will receive the screen signature of the screen that is present following the operation.
|
|
RTNSCREEN
|
field-name
|
Optional. The name of a field exchanged between your client program and the JSM that will receive the name of the screen that is present following the operation. The screen name is the user-defined name if an aXes project name was specified on the CONNECT command and a name was assigned to the screen. Otherwise the screen signature is returned.
|
|
Example
SETBYPOS ROW(8) COL(44) VALUE(ABC001) RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD)
