Effzo is used to delete in the screen all or a part of the fields of a mask.

Syntax

    Effzo [ class ] [ field_list ]

Setups

Element

Description

Restrictions

class

class that describes the abbreviation of a mask. By default, the default mask is used.

The mask must be opened by the
last order Mask.

fields_list

List of id_fields separated by the character ','.
By default, all the fields of the mask are concerned.

None.

id_field

Identification of one (or several) fields under one of the following ways:
variable_name
variable_name'('
exp_ind ')'
int_fields
no_rank
int_ranks
'='expr_c

The fields where the name is given
must be defined in the corresponding mask.

exp_ind

Whole expression where the value is the index of the variable to be displayed.

The index must be in the interval defined by the repetition factor.

int_fields

Fields interval, that is to say two field names separated by '-' (minus sign).

The two fields must belong to the corresponding mask.

rank_no

Whole number where the value is the rank number.

1 <= rank_no <= 99

int_ranks

Interval for the ranks, that is to say two rank numbers rank1 and rank2 separated by the character '-'

rank1 <= rank2

expr_c

Alphanumeric expression where the result is a variable name or a rank

Examples

# Deletion in the current mask of the fields of the rank 1, 15 à 30,
# and of the fields CHP1, VAR to END.
Effzo 1, 15-30, CHP1, VAR-END
# Deletion in the current mask of all the fields
Effzo
# Deletion in the mask ABC, of the fields of the rank 20, 15 à 30,
# and of the TOTO field for the I+1 index
Effzo [ABC]20-30, TOTO(I+1)
# Deletion of all the fields of the mask FACT
Effzo [FACT]
# Deletion of fields FIRST and LAST. The deletion order is
# the ranks order and not theEffzosetups order
Effzo LAST, FIRST

Description

Effzo is used to delete all or part of the fields of a screen mask. Blanks are then displayed in the screen where these fields would be displayed whatever the format. The variables corresponding to the mask are then 'reset to zero' (that is to say the empty chain "" for the Char type variables, the null date for the date variables and the zero value for the numeric variables).

When fields are deleted via Effzo, the deletion order used always derives from the entry ranks and the position of the fields on the screen. As a consequence, in order to change this deletion order, it is necessary to use several Effzo instructions.

Warning! Effzodoes not work with a non displayed mask, a mask used to group work variables for example . The Raz instruction will then be used.

Notes

The Effzo instruction is not equivalent to a Raz followed by a display by Affzo. Indeed, Effzo operates a Raz but is, on top of that, followed by a display of blanks.

The phase of blanks display reset to zero the entire formatting string, including potential comments.

TheEffzostatement will position the screen as being valid. The field checks will be carried out.

Associated errors

Error

Description

ERVARI (6)

Field does not exist in the given mask.

ERCLAS (7)

Mask not declared.

Associated keywords

MASK - DEFAULT - AFFZO - VARINIT - RAZ - SETMOK