dio_analog_alarm_text(_c)

	status.i4.v = dio_analog_alarm_text(device_indices.i4a.r,
					    priorities.i4a.r,
					    text_lengths.i4a.r, text.i1a.r,
					    errors.i2a.r [,max_text_len.i4.r]
					    [,num_devices.i4.r])

	status.i4.v = dio_analog_alarm_text_c(device_indices.i4a.r,
					      priorities.i4a.r,
					      text_lengths.i4a.r, text.i1a.r,
					      errors.i2a.r [,max_text_len.i4.v]
					      [,num_devices.i4.v])

	This routine returns analog alarm text information.  If
	"max_text_len" is specified, the length of the returned text
	string will be limited to that number of characters.  "text_lengths",
	however, will always return the length of the alarm text string in
	the database for the corresponding device.  If "num_devices" is
	specified, analog alarm text information for a list of devices can be
	retrieved.

	device_indices	device index or array of device indices
	priorities	returned alarm priority or array of priorities
			(A value of NULL may be passed if no priorities
			 are needed.)
	text_lengths	returned alarm text length or array of text lengths
			(A value of NULL may be passed if no text lengths
			 are needed.)
	text		returned alarm text or array of texts
			(A value of NULL may be passed if no text is needed.)
	errors		returned ACNET status value or array of status values
	[max_text_len]	maximum text length allowed (default is 80 characters)
			(A value of CLIB_DEFAULT_ARG can be passed for this
			 argument which will result in a maximum text length
			 of 80 characters.)
	[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_digital_alarm_text(_c), dio_analog_alarm_handling_c,
	dio_analog_alarm_url_c, dio_digital_alarm_handling_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:

	char	text[NUM_DEVICES*MAX_LENGTH];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	priorities[NUM_DEVICES];
	int	text_lengths[NUM_DEVICES];
	int	max_text_len = MAX_LENGTH;
	int	num_devices = NUM_DEVICES;

	status = dio_analog_alarm_text_c(device_indices,priorities,
					 text_lengths,text,errors,max_text_len,
					 num_devices);