dio_device_location_string_c

	status.i4.v = dio_device_location_string_c(device_indices.i4a.r,
						   properties.i2a.r,
						   location_text.i1a.r,
						   rack_text.i1a.r,
						   errors.i2a.r,
						   num_devices.i4.v)

	This routine returns the location string for a single device
	or a list of devices.

	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')
	location_text	returned null terminated location string or
			array of strings
			(allow DIO_LOCATION_TEXT_LEN + 1 characters per entry)
			(A value of NULL may be passed if no strings are needed.)
	rack_text	returned null terminated rack string or array of strings
			(allow DIO_RACK_TEXT_LEN + 1 characters per entry)
			(A value of NULL may be passed if no strings are needed.)
	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 property or 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, acnet_errors_h

	Related functions:

	dio_device_location_info_c, dio_device_location_c,
	dio_ssdn_to_location_c, dio_madc_location_c,
	dio_device_madc_location_c, error_in_list(_c),
	dio_enable_obsolete_dev_info, dio_disable_obsolete_dev_info

	C/C++ usage:

	char	location_text[NUM_DEVICES*(DIO_LOCATION_TEXT_LEN+1)];
	char	rack_text[NUM_DEVICES*(DIO_RACK_TEXT_LEN+1)];
	short	properties = -PRSET;
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {177531, 177833};
	int	num_devices = NUM_DEVICES;

	status = dio_device_location_string_c(device_indices,&properties,
					      location_text,rack_text,errors,
					      num_devices);