dio_alarm_events_lst

	status.i4.v = dio_alarm_events_lst(list_id.i4.r, events.i4a.r,
					   function_codes.i4a.r, errors.i2a.r)

	This routine retrieves alarm global event values for a list of
	devices.  This list must have been built by a previous call
	to dio_build_alarm_list_c.

	list_id		list ID returned from previous call to
			dio_build_alarm_list_c
			(Note:  This value will be set to zero if the
			 list is deleted.)
	events		returned list of events
	function_codes	returned list of event subfunction codes
	errors		array of returned ACNET status values

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_NOLIST		requested list does not exist
	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

	Related functions:

	dio_build_alarm_list_c, dio_bld_alrm_lst, dio_alarm_events(_c),
	dio_alarm_flags_list, dio_alarm_lim_lst, dio_alarm_dnom_lst,
	dio_alarm_tries_lst, dio_extract_alarm_info_c,
	dio_extract_read_list_status_c, error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	int	events[NUM_DEVICES];
	int	function_codes[NUM_DEVICES];

	status = dio_alarm_events_lst(&list_id,events,function_codes,errors);