dio_alarm_list_id_c

	status.i4.v = dio_alarm_list_id_c(device_indices.i4a.r,
					  alarm_list_ids.i4a.r,
					  errors.i2a.r, num_devices.i4.v)

	This routine returns the alarm list ID for a device.
	If "num_devices" is specified, alarm list IDs for
	a list of devices can be retrieved.

	device_indices	device index or array of device indices
	alarm_list_ids	returned alarm list ID or array of alarm list IDs
			(A value of NULL can be passed for this argument if
			 only caching of the alarm information is desired.)
	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:

	dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_actual_alarm_list_id_c, dio_node_default_alarm_list_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_analog_alarm_text_c, dio_digital_alarm_text(_c),
	dio_desired_alarm_limit_type, dio_set_alarm_flags_c,
	error_in_list(_c)

	C/C++ usage:

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

	status = dio_alarm_list_id_c(device_indices,alarm_list_ids,
				     errors,num_devices);