dio_units_text_c

	status.i4.v = dio_units_text_c(device_indices.i4a.r, properties.i2a.r,
				       text_type.i4.v, units_text.i1a.r,
				       errors.i2a.r, num_devices.i4.v
				       [,options.u4.v])

	This routine units text for a device or list of devices.
	
	device_indices	device index or array of device indices
	properties	property index or array of property indices
			(PRREAD -> reading property,
			 PRSET -> setting property)
			(If the first value is less than zero, all devices
			 use a property index which is equal to the absolute
			 value of this argument.)
	text_type	type of units text
			(DIO_COMMON -> common units text,
			 DIO_PRIMARY -> primary units text)
	units_text	returned units text
			(LEN_DEV_UNITS characters per device)
			(Note: If null terminated strings are requested,
			 allow an additional character per entry for the
			 null character.)
	errors		returned ACNET status value or array of returned
			status values (A status of DBM_NOREC indicates that
			the requested units text does not exist.)
	num_devices	number of devices
	[options]	units text options
			(DIO_OPT_NONE -> no options selected (default),
			 DIO_NAME_OPT_NULL_TERMINATE -> return null terminated
							strings)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid property index or text type passed
	DIO_MEMFAIL		memory allocation failure
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_scaling, dio_is_display_dec(_c), dio_is_display_short(_c),
	dio_scaling_len(_c), dio_scaling_length_list_c, dio_pdb_sts,
	dio_pdb_ctl, dio_data_type_info_c, error_in_list(_c)

	C/C++ usage:

	char	units_text[NUM_DEVICES][LEN_DEV_UNITS];
	short	errors[NUM_DEVICES];
	short	properties = -PRSET;
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	text_type = DIO_COMMON;
	int	num_devices = NUM_DEVICES;
	unsigned int	options = DIO_OPT_NONE;

	status = dio_units_text_c(device_indices,&properties,text_type,
				  units_text,errors,num_devices,options);