TS_GETBYNAME
The TS_GETBYNAME activity retrieves the value of a field on the current aXes terminal screen by reference to the field name (and an optional index for a subfile field).
INPUT Parameters:
AXHANDLE : Required
This parameter must specify the connection handle value that identifies the aXes terminal server session from which the screen field value is to be retrieved. The connection handle value is returned by the TS_CONNECT activity.
AXNAME : Required
This parameter must specify the name of the field whose value is to be retrieved. The name may be a user-defined name (if an aXes project name was specified on the TS_CONNECT activity) or an aXes field identifier.
AXINDEX : Optional
If the field is contained in a subfile, this parameter may specify the index of the instance on the current screen of the field whose value is to be retrieved. The first instance on the current screen has an index of 1, irrespective of the scroll position of the subfile. If your processing sequence needs to process fields in subfiles, it must do so a screen at a time and send ROLL_UP/ROLL_DOWN using the TS_SEND activity (just like a 5250 terminal user would have to do).
OUTPUT Parameters:
AXSCREENVALUE :
Upon successful completion, this parameter will contain the value for the specified screen field.