dio_spec_to_drf_string_c

	status.i4.v = dio_spec_to_drf_string_c(device_index.i4.v, property.i2.v,
					       array_index.i4.v,
					       num_elements.i4.v,
					       max_length.i4.v,
					       drf2_string.i1a.r,
					       [,scaling_type.i4.v]
					       [,property_field.i4.v]
					       [,options.u4.v])

	This routine converts a device specification to a DRF string.

	device_index	device index
	property	device property
			(PRREAD -> reading property,
			 PRSET -> setting property,
			 PRBSTS -> basic status property,
			 PRBCTL -> basic control property,
			 PRANAB -> analog alarm property,
			 PRDABL -> digital alarm property,
			 PRTEXT -> device description property)
			(property constants are in 'dbprops')
	array_index	device array index (starts at 0)
			(If a value of DIO_WHOLE_ARRAY is specified,
			 the entire property length will be indicated.)
	num_elements	number of elements (>=1)
	max_length	maximum number of characters to return not including
			trailing null
	drf_string	returned null formatted DRF format string
	[scaling_type]	scaling type
			(DIO_RAW -> raw units,
			 DIO_PRIMARY -> primary units,
			 DIO_COMMON -> common units (default))
			(constants are in 'diolib')
	[property_field] property field
			(DIO_FIELD_NONE -> no field specified (default),
			 DIO_FIELD_ALARM_STATE -> want alarm state,
			 DIO_FIELD_ALARM_ENABLE -> want alarm enable status,
			 DIO_FIELD_ALARM_ABORT_CAPABLE -> want alarm abort
							  capability status,
			 DIO_FIELD_ALARM_ABORT_ENABLE -> want alarm abort
							 enable status,
			 DIO_FIELD_ALARM_FLAGS -> want alarm flags word,
			 DIO_FIELD_ALARM_MINIMUM -> want alarm minimum,
			 DIO_FIELD_ALARM_MAXIMUM -> want alarm maximum,
			 DIO_FIELD_ALARM_NOMINAL -> want alarm nominal (analog),
			 DIO_FIELD_ALARM_TOLERANCE -> want alarm tolerance,
			 DIO_FIELD_ALARM_DIG_NOMINAL -> want alarm nominal
							(digital),
			 DIO_FIELD_ALARM_MASK -> want alarm mask,
			 DIO_FIELD_ALARM_TRIES_NEEDED -> want alarm tries
							 needed,
			 DIO_FIELD_ALARM_TRIES_NOW -> want alarm tries now,
			 DIO_FIELD_ALARM_FTD -> want alarm FTD,
			 DIO_FIELD_ALARM_BLOCK_DATA -> want entire alarm block,
			 DIO_FIELD_TEXT -> want text representation of property,
			 DIO_FIELD_ON_STATUS -> want "on" status value,
			 DIO_FIELD_READY_STATUS -> want "ready" status value,
			 DIO_FIELD_REMOTE_STATUS -> want "remote" status value,
			 DIO_FIELD_POSITIVE_STATUS -> want "positive" status
						      value,
			 DIO_FIELD_RAMP_STATUS -> want "ramp" status value)
			(constants are in 'diolib')
	[options]	conversion options
			(DIO_OPT_NONE -> no options selected (default),
			 DIO_NAME_OPT_FULL_NAME -> use full name)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid property, array index, number of
				elements, scaling type, or field passed
	otherwise		other ACNET error

	This function requires the following include files:

	diolib_h, dbprops_h, acnet_errors_h

	Related functions:

	dio_length_offset_spec_to_drf_string_c, dio_dev_name(_c),
	dio_property_to_device_spec_string_c,
	dio_field_to_device_spec_string_c

	C/C++ usage:

	char	drf_string[MAX_LENGTH+1];
	short	property = PRREAD;
	int	status;
	int	device_index = 14430;
	int	array_index = 0;
	int	num_elements = 1;
	int	max_length = MAX_LENGTH;
	int	scaling_type = DIO_COMMON;
	int	property_field = 0;
	unsigned int	options = DIO_OPT_NONE;

	status = dio_spec_to_drf_string_c(device_index,property,array_index,
					  num_elements,max_length,drf_string,
					  scaling_type,property_field,options);