UNDERLINE

Warning: This instruction is ignored with the C generator.

Section for use

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

Syntax

UNDERLINE Option SeriesVarId Transaction

Description

This instruction is used to condition a screen field display. A DDS screen attribute DSPATR(UL) is generated for all the variables SeriesVarId 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.

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

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.

When the instruction is used with *ON, it remains activated until executed with *OFF, for the same group of variables.

Notes:

• • A variable used with a group of variables must always be used with this same group.
  • For a specific variable, this instruction cannot be used once with *ON or *OFF and another time without *ON or *OFF.

Example

IF   CUSTOMER_VIEW EXISTS

UNDERLINE *ON ZORDER_NBR ZORDER_DATE ZORDER_CUST_COD

END

*

*

BEGIN_PROCEDURE ENTRY

*

* this procedure deals with transaction 03

*

IF   ACTION_CODE = 'DELETE'

UNDERLINE *OFF ZORDER_NBR ZORDER_DATE ZORDER_CUST_COD 03

PROTECT *ON ZORDER_NBR ZORDER_DATE ZORDER_CUST_COD 03

ELSE

UNDERLINE *ON ZORDER_NBR ZORDER_DATE ZORDER_CUST_COD 03

PROTECT *OFF ZORDER_NBR ZORDER_DATE ZORDER_CUST_COD 03

END

END_PROCEDURE

See also the list of 4GL instructions by topic

↑ Top of page