DtvLong dal_iwf_frm_agg (ent_mas)

Creates the defined aggregate-form widget for the relation, loads the corresponding data and outputs it on the screen.

Input Parameters Significance
char *ent_mas name of the entity-1 [> < = from widget]
name of the entity-2
name of the view
name of the mask

Output Parameters Significance
none -

Return Code Significance
0 no error
1 wrong entity name passed
2 specified relation does not exist
3 no access to the relation granted
4 no mask for the relation defined
GLB_RET_BRK menu cancelled < glbdef.h >

Can be invoked as on_select-userexit in any menu or on_event-userexit in any state of the user interface.

If you invoke the function from the widget select menu, you may not pass entity-1 (is read from the active widget automatically).

You can only pass a view together with entity-2.

If you do not pass any entity-2 and no view, DataView will create a selection menu containing all relations already defined at entity-1.

You can only pass a form together with the view.

All parameters must be separated by spaces.