dio_digital_alarm_text(_c)

	status.i4.v = dio_digital_alarm_text(device_indices.i4a.r,
					     num_entries.i4a.r, masks.i4a.r,
					     conditions.i4a.r,
					     priorities.i4a.r,
					     text_lengths.i4a.r, text.i1a.r,
					     errors.i2a.r [,max_entries.i4.r]
					     [,max_length.i4.r]
					     [,num_devices.i4.r])

	status.i4.v = dio_digital_alarm_text_c(device_indices.i4a.r,
					       num_entries.i4a.r, masks.i4a.r,
					       conditions.i4a.r,
					       priorities.i4a.r,
					       text_lengths.i4a.r, text.i1a.r,
					       errors.i2a.r [,max_entries.i4.v]
					       [,max_length.i4.v]
					       [,num_devices.i4.v])

	This routine returns digital alarm text information for a device.
	The number of text entries is returned in "num_entries".  The alarm
	mask and condition values are returned in "masks" and "conditions"
	respectively.  (Note: At the present time masks and condition values
	are always set to the same value.)  The alarm priority text, and text
	length are returned in "priorities", "text", and "text_lengths"
	respectively.  If "max_entries" is specified, the number of entries
	per device returned will be limited to that number.  "num_entries",
	however, will always contain the number of entries in the database
	for the corresponding device.  The same situation exists for
	"max_length" and "text_lengths".  If "max_length" is specified, the
	returned text strings will be limited to that number of characters.
	However, "text_lengths" will always return the length of the text
	string in the data base.  If "num_devices" is specified, digital
	alarm text information for a list of devices can be retrieved.

	device_indices	device index or array of device indices
	num_entries	returned number of digital alarm text entries
			or array of number of text entries (A value of NULL
			may be passed if no entry counts are needed.)
	masks		returned alarm mask or array of masks (A value of NULL
			may be passed if no masks are needed.)
	conditions	returned alarm condition value or array of
			condition values (A value of NULL may be passed if no
			condition values are needed.)
	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 alarm texts
			(Note: Text is returned in a concatenated variable
			 length format.  Use the returned text length values
			 to extract the individual text strings.)
			(A value of NULL may be passed if no text is needed.)
	errors		returned ACNET status value or array of status values
	[max_entries]	maximum number of text entries allowed per device
			(default is DIO_MAX_DIGITAL_ALARM_TEXT entries)
	[max_length]	maximum text length allowed (default is 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_analog_alarm_text(_c), dio_digital_alarm_handling_c,
	dio_analog_alarm_handling_c, dio_analog_alarm_url_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_ext_text(_c), dio_dev_text(_c), error_in_list(_c)

	C/C++ usage:

	char	text[NUM_DEVICES*MAX_ENTRIES*MAX_LENGTH];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_entries[NUM_DEVICES];
	int	masks[NUM_DEVICES];
	int	conditions[NUM_DEVICES];
	int	priorities[NUM_DEVICES];
	int	text_lengths[NUM_DEVICES];
	int	max_entries = MAX_ENTRIES;
	int	max_length = MAX_LENGTH;
	int	num_devices = NUM_DEVICES;

	status = dio_digital_alarm_text_c(device_indices,num_entries,
					  masks,conditions,priorities,
					  text_lengths,text,errors,
					  max_entries,max_length,
					  num_devices);