dio_broken_info_c

	status.i4.v = dio_broken_info_c(device_indices.i4a.r,
					broken_data.sa.r,
					errors.i2a.r, num_devices.i4.v)

	This routine returns the broken/out of service information
	for a device.  If "num_devices" is specified, broken/out of
	service information for a list of devices can be retrieved.

	device_indices	device index or array of device indices
	broken_data	returned broken/out of service information or array of
			broken/out of service information
			(structure of type DIO_BROKEN_DEVICE_DATA)
			(A value of NULL can be passed for this argument if
			 only caching of the broken/out of service 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:

	diolib_h, acnet_errors_h

	Related functions:

	dio_is_broken_c, dio_longest_device_broken_comment, dio_device_state_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_devices = NUM_DEVICES;
	DIO_BROKEN_DEVICE_DATA	broken_data[NUM_DEVICES];

	status = dio_broken_info_c(device_indices,broken_data,
				   errors,num_devices);