dio_digital_alarm_handling_c

	status.i4.v = dio_digital_alarm_handling_c(device_indices.i4a.r,
						   num_entries.i4a.r,
						   masks.i4a.r,
						   handler_codes.i4a.r,
						   sound_ids.i4a.r,
						   speech_ids.i4a.r,
						   errors.i2a.r,
						   max_entries.i4.v,
						   num_devices.i4.v)

	This routine returns digital alarm handling information for a single
	device or a list of devices.  The number of entries per device
	returned will be limited to the value of "max_entries".  "num_entries",
	however, will always contain the number of entries in the database
	for the corresponding device.

	device_indices	device index or array of device indices
	num_entries	returned number of digital alarm entries
			or array of number of 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.)
	handler_codes	returned alarm handler code or array of handler codes
			(A value of NULL may be passed if no handler codes
			 are needed.)
	sound_ids	returned alarm sound ID or array of sound IDs
			(A value of NULL may be passed if no sound IDs
			 are needed.)
	speech_ids	returned alarm speech ID or array of speech IDs
			(A value of NULL may be passed if no speech IDs
			 are needed.)
	errors		returned ACNET status value or array of status values
	max_entries	maximum number of entries allowed per device
			(default is DIO_MAX_DIGITAL_ALARM_TEXT entries)
	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:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_analog_alarm_handling_c, dio_digital_alarm_text(_c),
	dio_analog_alarm_url_c, dio_analog_alarm_text(_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:

	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	handler_codes[NUM_DEVICES];
	int	sound_ids[NUM_DEVICES];
	int	speech_ids[NUM_DEVICES];
	int	max_entries = MAX_ENTRIES;
	int	num_devices = NUM_DEVICES;

	status = dio_digital_alarm_handling_c(device_indices,num_entries,masks,
					      handler_codes,sound_ids,
					      speech_ids,errors,max_entries,
					      num_devices);