TS_SETBYPOS

LANSA Composer

TS_SETBYPOS

The TS_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 analogous to typing at a 5250 terminal.

INPUT Parameters:

AXHANDLE : Required

This parameter must specify the connection handle value that identifies the aXes terminal server session upon which this activity should operate.  The connection handle value is returned by the TS_CONNECT activity.

AXSCREENROW : Required

This parameter must specify the screen row number of the required field.  The row and column together must refer to the first position of the required field.

AXSCREENCOL : Required

This parameter must specify the screen column number of the required field.  The row and column together must refer to the first position of the required field.

AXSCREENVALUE : Required

This parameter must specify the value to be set for the specified screen field.

AXKEY : Optional

This parameter may optionally specify a function key to send the current aXes screen data to the aXes terminal server.  You may use any of the values listed below.  If not specified, no send is performed.

  *ENTER
  *F1  - *F9
  *F10 - *F24
  *PAGE_UP, *PAGE_DOWN
  *ROLL_UP, *ROLL_DOWN
  *HELP, *PRINT

OUTPUT Parameters:

AXSCREEN :

Upon successful completion this parameter contains the resulting aXes 5250 screen name or signature.  The screen name is the user-defined name if an aXes project name was specified on the TS_CONNECT activity and a name was assigned to the screen.  Otherwise the screen signature is returned.  (NB:  The 5250 screen that is presently shown can be affected or changed by executing this activity ONLY if a function key value is specified in the AXKEY parameter.)