dio_device_location_c

	status.i4.v = dio_device_location_c(device_indices.i4a.r,
					    properties.i2a.r, crates.i4a.r,
					    slots.i4a.r, errors.i2a.r
					    [,num_devices.i4.v]
					    [,madc_channels.i4a.r]
					    [,madc_numbers.i4a.r]
					    [,module_indices.i4a.r])

	This routine returns the physical location of devices that reside
	in CAMAC crates.

	device_indices	device index or array of device indices
	properties	property index or array of indices
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
			(constants are in 'dbprops')
	crates		returned crate number or array of crate numbers
			(A value of NULL may be passed if no crate numbers
			 are needed.)
	slots		returned slot number or array of slot numbers
			(A value of NULL may be passed if no slot numbers
			 are needed.)
	errors		returned ACNET status value or array of status values
			(Note: A value of DIO_NOTYET indicates that the device
			 is not attached to a CAMAC front end or that it is
			 not a supported device type.)
	[num_devices]	number of devices (default is 1)
	[madc_channels]	returned MADC channel number or array of channel numbers
			(default is NULL)
	[madc_numbers]	returned MADC number or array of numbers
			(default is NULL)
	[module_indices] returned module index number or array of index numbers
			(default is NULL)

	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, dbprops_h, camac_devices_h, acnet_errors_h

	Related functions:

	dio_device_location_info_c, dio_device_location_string_c,
	dio_ssdn_to_location_c, dio_madc_location_c,
	dio_device_madc_location_c, dio_dev_ssdn(_c),
	error_in_list(_c), dio_enable_obsolete_dev_info,
	dio_disable_obsolete_dev_info

	C/C++ usage:

	short	errors[NUM_DEVICES];
	short	properties = -PRREAD;
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	crates[NUM_DEVICES];
	int	slots[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	int	madc_channels[NUM_DEVICES];
	int	madc_numbers[NUM_DEVICES];
	int	module_indices[NUM_DEVICES];

	status = dio_device_location_c(device_indices,&properties,
				       crates,slots,errors,num_devices,
				       madc_channels,madc_numbers,
				       module_indices);