DtvLong dal_mas_act_lis (idm, col)

Activates the mask and sets the specified work mode of the mask edit state.

Input Parameters Significance
DtvLong idm mask Id
char mod work mode: I = insert mode
U = update mode
Q = query mode
V = view mode

Output Parameters Significance
no -

Return Code Significance
0 no error
1 no record can be activated
2 no field can be activated
3 recursion level > 10

Before you can edit data in the mask, you have to put the mask into the corresponding work mode of mask edit state.

In active lists you can edit selected records (record-dirty-flag = > + < ) In active forms the visible record is considered selected.

After activating the mask the first writable field of the mask is automatically set active. You can use the function dal_mas_ret_act_fld to determine it. If the mask and a field have already been activated before calling the function, the active field remains unchanged.

After finishing edit operations you must not forget to deactivate the mask using the function dal_mas_dal_exi_act, i.e. leave mask edit state. This also applies if you want to delete the mask after editing.

The function can be recursively called in up to 10 nesting levels.