dio_current_alarm_text_c

	status.i4.v = dio_current_alarm_text_c(num_devices.i4.v,
					       device_indices.i4a.r,
					       text_type.i4.v,
					       errors.i2a.r, num_entries.i4a.r,
					       alarm_text.sp.r)

	This routine returns the current alarm text for a device or
	a list of devices.

	num_devices	number of devices
	device_indices	device indices
	text_type	type of alarm text to return
			(ALARM_TEXT_TYPE_ANALOG -> analog alarm text,
			 ALARM_TEXT_TYPE_DIGITAL -> digital alarm text,
			 ALARM_TEXT_TYPE_BOTH -> return both types)
	errors		array of returned ACNET status values
	num_entries	returned array of number of text entries per device
	alarm_text	returned alarm text information
			(pointer to array of DIO_ALARM_TEXT_ENTRY_DATA structures)
			(The memory for these structures 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
	DIO_BADARG		invalid alarm text type or number of devices
	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:

	diolib_h, alarmsapp_h, acnet_errors_h

	Related functions:

	dio_analog_alarm_text(_c), dio_digital_alarm_text(_c), error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	text_type = ALARM_TEXT_TYPE_BOTH;
	int	num_entries[NUM_DEVICES];
	DIO_ALARM_TEXT_ENTRY_DATA	*alarm_text;

	status = dio_current_alarm_text_c(num_devices,device_indices,text_type,
					  errors,num_entries,&alarm_text);