POS_CURSOR

Section for use

INITIALIZATION, VERIFICATION, VALIDATION, TRANSACTION, SFTKYS_PROCESS, or any other section, specifying the transaction number.

Syntax

POS_CURSOR Option VarId Transaction

Description

This instruction is used to position the cursor on the screen variable VarId mentioned after the instruction.

A DDS screen attribute DSPATR(PC) is generated for the field indicated after this instruction. The attribute is preceded by an indicator in the screen file; this indicator is then activated by the program after the instruction is executed.

Whenever this instruction is used without *ON or *OFF, it is deactivated after each screen reading (indicator reset to 0), as well as by the END_MANAGE_SFL and END_ADD_SFL instructions when placed in a MANAGE_SFL/END_MANAGE_SFL or ADD_SFL/END_ADD_SFL block.

It is only possible to mention a transaction number if this instruction is used with *ON or *OFF.

When the instruction is used with *ON, it remains activated until executed with *OFF.

Note: For a specific variable, this instruction cannot be used once with *ON or *OFF and another time without *ON or *OFF.

Example

IF   MODE = 'CREATE'

POS_CURSOR *ON Z_ORDER_NBR

PROTECT *OFF Z_ORDER_NBR ZO_COMPANY ZO_WAREHOUSE

POS_CURSOR *OFF Z_CUST_CODE

ELSE

POS_CURSOR *OFF Z_ORDER_NBR

PROTECT *ON Z_ORDER_NBR ZO_COMPANY ZO_WAREHOUSE

POS_CURSOR *ON Z_CUST_CODE

END

See also the list of 4GL instructions by topic

↑ Top of page