dio_display_conversion_info_c

	status.i4.v = dio_display_conversion_info_c(device_indices.i4a.r,
						    properties.i2a.r,
						    errors.i2a.r
						    [,is_special.i4a.r]
						    [,display_types.i4a.r]
						    [,display_lens.i4a.r]
						    [,handler_types.i4a.r]
						    [,num_devices.i4.v]
						    [,options.u4.v])

	This routine returns default device value conversion information 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,
			 PRNAME -> device name property,
			 PRTEXT -> device description property,
			 PRFLNM -> device full name property,
			 PRFLTX -> device full description 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.)
	errors		returned ACNET status value or array of returned
			status values (A status of DBM_NOREC indicates that
			the requested PDB does not exist.)
	[is_special]	returned flags indicating whether or not special
			conversions from raw data are required
			(TRUE -> special conversions are required,
			 FALSE -> standard conversions used)
			(A value of NULL may be passed if this information
			 is not needed.)
			(default is NULL)
	[display_types]	returned default display conversion types
			(constants of the form CNV_xxx which are found
			 in cbslib)
			(A value of NULL may be passed if no display types
			 are needed.)
			(default is NULL)
	[display_lens]	returned default display lengths
			(DIO_SHORT_DISPLAY_LEN or DIO_LONG_DISPLAY_LEN
			 characters unless the common transform is a
			 special string scaling transform (60 or 84)
			 in which case the length is determined by the
			 conversion type specified in constant 0 and
			 optionally the length specified in constant 1)
			(A value of NULL may be passed if no display lengths
			 are needed.)
			(default is NULL)
	[handler_types]	returned default raw data handler types
			(DIO_HANDLER_NONE -> no special data handling required,
			 DIO_HANDLER_SWAP_BYTES -> swap bytes,
			 DIO_HANDLER_SWAP_WORDS -> swap words)
			(A value of NULL may be passed if no handler types
			 are needed.)
			(default is NULL)
	[num_devices]	number of devices in list
			(default is 1)
	[options]	scaling options
			(DIO_DISPLAY_OPT_NONE -> no options selected (default),
			 DIO_DISPLAY_OPT_LONG_TEXT -> request long text for
						      devices which have both
						      short and long text
						      options)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid property index or number of devices
				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_display_attributes_c, dio_display_conversion_type_c,
	dio_is_display_dec(_c), dio_is_display_short(_c), dio_scaling,
	error_in_list(_c)

	C/C++ usage:

	short	properties = -PRSET;
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	is_special[NUM_DEVICES];
	int	display_lengths[NUM_DEVICES];
	int	display_types[NUM_DEVICES];
	int	handler_types[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	unsigned int	options = DIO_DISPLAY_OPT_NONE;

	status = dio_display_conversion_info_c(device_indices,&properties,
					       errors,is_special,
					       display_types,display_lengths,
					       handler_types,num_devices,
					       options);