dio_bld_alrm_lst

	status.i4.v = dio_bld_alrm_lst(list_id.i4.r, num_devices.i4.r,
				       device_indices.i4a.r, alarm_type.i2.r,
				       errors.i2a.r [,ftd.i2.r]
				       [,data_type.i4.r] [,start_block.i4.r]
				       [,max_blocks.i4.r] [,num_blocks.i4.r])

	This routine builds a list of alarm block requests which can be
	retrieved by a subsequent call to dio_get_alrm_lst or any of the
	other DIO alarm list retrieval routines.  This build can also used
	for setting lists of alarm information.

	list_id		returned list ID for use by subsequent data retrieval
			routines
	num_devices	number of devices in list
	device_indices	list of device indices
	alarm_type	type of alarms
			(DIO_ANALOG -> analog alarm,
			 DIO_DIGITAL -> digital alarm)
	errors		array of returned ACNET status values
	[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)
			 (can use the macro BUILD_EVENT_FTD(event) or
			  BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
	[data_type]	type of data requested
			(DIO_ALARM_BLOCK_DATA -> entire alarm block (default),
			 DIO_ALARM_FLAGS_DATA -> alarm flags only,
			 DIO_ALARM_LIMITS_DATA -> alarm limits or nominals
						  and masks only,
			 DIO_ANALOG_ALARM_LIMITS_DATA -> alarm limits only,
			 DIO_ALARM_TRIES_DATA -> alarm tries only,
			 DIO_ALARM_EVENTS_DATA -> alarm events only)
	[start_block]	starting block to return (starts at 0)
			(default is 0) (maximum is DIO_MAX_ALARM_BLOCKS - 1)
	[max_blocks]	maximum number of blocks to return per device
			(default is 1) (maximum is DIO_MAX_ALARM_BLOCKS)
	[num_blocks]	returned number of blocks per device that will be
			processed by subsequent alarm routines (default is NULL)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_BADARG		invalid data type
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_build_alarm_list_c, dio_get_alrm_lst, dio_cancel_alarm_lst,
	dio_alarm_dnom_lst, dio_alarm_events_lst, dio_alarm_flags_list,
	dio_alarm_lim_lst, dio_alarm_tries_lst, dio_dis_lst, dio_dis_abt_lst,
	dio_ena_lst, dio_ena_abt_lst, dio_is_abt_lst, dio_is_abtinh_lst,
	dio_is_byp_lst, dio_is_good_lst, dio_salarm_dnom_lst,
	dio_salarm_lim_lst, dio_set_abort_inh_lst, dio_set_bypass_lst,
	error_in_list(_c)

	C/C++ usage:

	short	alarm_type = DIO_ANALOG;
	short	errors[NUM_DEVICES];
	short	ftd = FTD_ONESHOT;
	int	status;
	int	list_id;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	data_type = DIO_ALARM_BLOCK_DATA;
	int	start_block = 0;
	int	max_blocks = 1;
	int	num_blocks;

	status = dio_bld_alrm_lst(&list_id,&num_devices,device_indices,
				  &alarm_type,errors,&ftd,&data_type,
				  &start_block,&max_blocks,&num_blocks);