DtvLong dal_dmi_cre_frm (dal_mas_dsc, tab_ori, tab_joi)

Creates the form of the passed name on the server, using the entries in the system entities T_MASK, T_FIELD and in the system relation T_MAS_FLD. .

Input Parameters Significance
char *dal_mas_dsc name of the mask in the data base
char *tab_ori name of the mask original table [optional]
char *tab_joi name of the mask join table [optional]

Output Parameters Significance
no -

Return Code Significance
value Id of the mask
0 no mask created

This function is the elementary function for creating forms on the server based on the data base definitions

The form is only created in local server memory. You then have to explicitly output it on the client screen. After creating, a copy of the form is created in local memory. When the function is called again, the form definition data are not read from the data base, but from the copy of the list.

For specifying the table name the following rules apply:

Whenever possible, use the standard functions dal_iwf_lis_... of the module < iwf> to create forms that have a relation to the data base.