frig_build_list_c (ul_friglib)

	status.i4.v = frig_build_list_c(list_id.i4.r, list_length.i4.v,
					houses.ch.d, names.ch.d, errors.sa.r
					[,num_entries.i4a.r] [,ftd.i2.v])

	This routine builds a list of refrigerator data requests which
	can be read by a call to frig_get_list_c.

	list_id		returned list ID
	list_length	number of entries in list
	houses		array of house names (HOUSE_NAME_LEN characters each)
			(If the second house name consists of blanks, the
			 first house name will be used for all entries.)
	names		array of data names ("xxxx_nnn[_yyyy]")
			(each name should be null terminated)
			(The function str_concatenate_c can be used to
			 build this string.)  (Name format descriptions can
			 be found under the help topic frig_name_syntax.)
	errors		array of returned ACNET status values
			(ACNET_ERR structures) (one for each list entry)
	[num_entries]	array of number of entries (if defaulted by passing
			a value of NULL, a value of 1 is used)
	[ftd]		frequency time descriptor
			(FTD_ONESHOT -> one shot (default),
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request,
			 FTD_EVENT_MASK OR'ed with TCLK event value -> read
			 on TCLK event (event constants are in tclk_events))

	This function returns status values as follows:

	DIO_OK			success
	DIO_BADARG		invalid house or name passed
	DIO_MEMFAIL		memory allocation failure
	DPM_xxx			error building data lists
	otherwise		number of errors in list

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, ul_friglib_h:friguti_h, diolib_h, acnet_errors_h

	Related functions:

	frig_get_list_c, frig_cancel_list_c, error_in_list(_c), frig_get_c,
	frig_build_global_list_c, str_concatenate_c

	C usage:

	static const char	houses[] = "A1  ";
	static const char	names[] = "FSM_0\0FSM_1";
	short	ftd = FTD_ONESHOT;
	int	status;
	int	list_id;
	int	list_length = LIST_LENGTH;
	int	num_entries[LIST_LENGTH] = {1, 1};
	ACNET_ERR	errors[LIST_LENGTH];

	status = frig_build_list_c(&list_id,list_length,houses,names,
				   errors,num_entries,ftd);