5.2.10 GETFIELD

The GETFIELD command retrieves the attributes of a field on the current aXes terminal screen by reference to either the field name (and an optional index for a subfile field) or to the screen row and column number of the field.

To exchange return field (i.e. RTNXXXX) values, you will need to specify the SERVICE_EXCHANGE(*FIELD) in the command

Syntax:

Command

Keyword

Value

Developer notes

GETFIELD

NAME

screen field name

The name of the field whose attributes are to be retrieved. The name may be a user-defined name (if an aXes project name was specified on the CONNECT command) or an aXes field identifier.
If NAME is not specified, then ROW and COL must be specified.

INDEX

0
value

If the field is contained in a subfile, this keyword will specify the index of the instance on the current screen of the field whose attributes are 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 program needs to process fields in subfiles, it must do so a screen at a time and send ROLL_UP/ROLL_DOWN using the SEND command (just like a 5250 terminal user would have to do).
The value of this keyword is ignored if NAME is specified.

ROW

row number

The screen row number of the required field. The row and column together, if used, must refer to the first position of the required field.
The value of this keyword is ignored if NAME is specified. Conversely, if NAME is not specified, then ROW and COL must be specified.

COL

column number

The screen column number of the required field. The row and column together, if used, must refer to the first position of the required field. The value of this keyword is ignored if NAME is specified. Conversely, if NAME is not specified, then ROW and COL must be specified.

RTNNAME

field-name

The name of a field exchanged between your client program and the JSM that will receive the user-defined name of the field (if an aXes project name was specified on the CONNECT command) or the aXes field identifier if no project was specified or no name has been defined for the field.

RTNINDEX

field-name

If the field is contained in a subfile, this keyword may be used to specify the name of a field exchanged between your client program and the JSM that will receive the index of the instance on the current screen of the field. The first instance on the current screen has an index of 1, irrespective of the scroll position of the subfile.

RTNROW

field-name

The name of a field exchanged between your client program and the JSM that will receive the screen row number of the field.

RTNCOL

field-name

The name of a field exchanged between your client program and the JSM that will receive the screen column number of the field.

RTNSU BFILEEXTENT

field-name

If the field is contained in a subfile, this keyword may be used to specify the name of a field exchanged between your client program and the JSM that will receive the number of instances on the current screen for the field (the number of subfile records displayed on the current screen). For reliability, you should use this keyword for a field that is never conditioned on the subfile display - such as the option entry field in a "Work with" style display.

 

Example

GETFIELD ROW(8) COL(44) RTNSUBFILEEXTENT(MYSFLEXT) SERVICE_EXCHANGE(*FIELD)