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
			(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

	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);