dio_get_alrm_lst

	status.i4.v = dio_get_alrm_lst(list_id.i4.r, alarm_blocks.i1a.r,
				       errors.i2a.r)

	This routine gets a list of alarm blocks from front ends.  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.)
	alarm_blocks	returned list of alarm block data
			(20 bytes per block per device)
			(array of structures of type ANALOG_ALARM_BLOCK or
			 DIGITAL_ALARM_BLOCK)
	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, cns_data_structs_h, acnet_errors_h

	Related functions:

	dio_build_alarm_list_c, dio_bld_alrm_lst, dio_cancel_alarm_lst,
	dio_get_alarm(_c), dio_get_db_alarm(_c), dio_extract_alarm_info_c,
	DIO_ALARM_IS_ABORT, DIO_ALARM_IS_ABORT_INHIBIT, DIO_ALARM_IS_DISPLAYED,
	DIO_ALARM_IS_LOGGED, DIO_ALARM_IS_EVENT, DIO_ALARM_IS_HIGH,
	DIO_ALARM_IS_LOW, DIO_ALARM_LIMIT_CLASS, DIO_ALARM_IS_DIGITAL,
	DIO_ALARM_LIMIT_SIZE, DIO_ALARM_IS_BAD, DIO_ALARM_IS_ENABLED,
	dio_extract_read_list_status_c, error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	ANALOG_ALARM_BLOCK	alarm_blocks[NUM_DEVICES];

	status = dio_get_alrm_lst(&list_id,(char *) alarm_blocks,errors);