dio_alarm_group_info_c

	status.i4.v = dio_alarm_group_info_c(device_indices.i4a.r,
					     group_numbers.i4a.r,
					     is_consolidator.i4a.r,
					     errors.i2a.r
					     [,num_devices.i4.v])

	This routine returns the alarm group information for a single
	device or a list of devices.

	device_indices	device index or array of device indices
	group_numbers	returned alarm group number or array of group numbers
			(A value of NULL may be passed if no group number
			 is needed.)
	is_consolidator	returned flag or array of flags indicating whether
			or not the device is an alarm consolidator
			(TRUE -> device is an alarm consolidator,
			 FALSE -> device is not an alarm consolidator)
			(A value of NULL may be passed if no consolidator
			 flag is needed.)
	errors		returned ACNET status value or array of status values
	[num_devices]	number of devices
			(default is 1)

	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_alarm_ancestors_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:

	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	group_numbers[NUM_DEVICES];
	int	is_consolidator[NUM_DEVICES];

	status = dio_alarm_group_info_c(device_indices,group_numbers,
					is_consolidator,errors,num_devices);