DtvLong dal_dmi_cre_lis (dal_mas_dsc, tab_ori, tab_joi)

Creates the list 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 the mask
0 no mask created

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

The list is only created in local server memory. You then have to explicitly output it on the client screen. After creating, a copy of the list is created in local memory. When the function is called again, the list 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 lists that have a relation to the data base.