dio_alarm_ancestors_c

	status.i4.v = dio_alarm_ancestors_c(device_indicex.i4.v,
					    num_ancestors.i4.r,
					    ancestors.i4p.r)

	This routine returns alarm ancestors (higher level groups)
	for a device.

	device_index	device index of interest
	num_ancestors	returned number of alarm ancestor devices
	ancestors	returned ancestor devices
			(The memory for these values is allocated by this
			 routine and should be freed by the caller.)

	This function returns status values as follows:

	OK			success
	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_alarm_group_info_c, dio_alarm_list_id_c, dio_actual_alarm_list_id_c,
	dio_analog_alarm_handling_c, dio_analog_alarm_url_c,
	dio_analog_alarm_text(_c), dio_digital_alarm_text(_c),
	dio_get_db_alarm(_c), dio_get_alarm(_c), dio_get_alrm_lst,
	dio_extract_alarm_info_c, dio_alarm_acknowledge_mask_c,
	dio_dev_text(_c), dio_ext_text(_c), error_in_list(_c)

	C/C++ usage:

	int	status;
	int	device_index = 14430;
	int	num_ancestors;
	int	*ancestors;

	status = dio_alarm_ancestors_c(device_index,&num_ancestors,
				       &ancestors);