dio_analog_alarm_handling_c

	status.i4.v = dio_analog_alarm_handling_c(device_indices.i4a.r,
						  handler_codes.i4a.r,
						  sound_ids.i4a.r,
						  speech_ids.i4a.r,
						  errors.i2a.r,
						  num_devices.i4.v)

	This routine returns analog alarm handling information for a single
	device or a list of devices.

	device_indices	device index or array of device indices
	handler_codes	returned alarm handler code or array of handler codes
			(A value of NULL may be passed if no handler codes
			 are needed.)
	sound_ids	returned alarm sound ID or array of sound IDs
			(A value of NULL may be passed if no sound IDs
			 are needed.)
	speech_ids	returned alarm speech ID or array of speech IDs
			(A value of NULL may be passed if no speech IDs
			 are needed.)
	errors		returned ACNET status value or array of status values
	num_devices	number of devices

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	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:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_digital_alarm_handling_c, dio_analog_alarm_text(_c),
	dio_analog_alarm_url_c, dio_digital_alarm_text(_c),
	dio_alarm_list_id_c, dio_actual_alarm_list_id_c,
	dio_alarm_acknowledge_mask_c, dio_get_db_alarm(_c),
	dio_get_alarm(_c), dio_get_alrm_lst, dio_extract_alarm_info_c,
	dio_dev_text(_c), dio_ext_text(_c), error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	handler_codes[NUM_DEVICES];
	int	sound_ids[NUM_DEVICES];
	int	speech_ids[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;

	status = dio_analog_alarm_handling_c(device_indices,handler_codes,
					     sound_ids,speech_ids,errors,
					     num_devices);