dio_bit_mask_to_status_text_c

	status.i4.v = dio_bit_mask_to_status_text_c(device_indices.i4a.r,
						    attr_bit_masks.u4a.r,
						    status_text.sa.r,
						    errors.i2a.r
						    [,num_devices.i4.v])

	This routine converts basic status expressed as a bit mask to
	a color coded character string.

	device_indices	device index or array of device indices
	attr_bit_masks	status attribute bit masks
	status_text	returned status text
			(array of DIO_NUM_STATUS_TYPES + 1 XCHAR structures
			 containing color coded text for each device)
	errors		returned ACNET status value or array of returned
			status values
	[num_devices]	number of devices in list (default is 1)

	This function returns status values as follows:

	OK			success
	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:

	cns_data_structs_h, diolib_h, acnet_errors_h

	Related functions:

	dio_bit_mask_to_status_c, dio_status_attr_bit_mask_c,
	dio_raw_to_status_text, dio_raw_to_status_text_extended_c,
	dio_raw_to_status_c, dio_raw_to_status_extended_c,
	dio_sts_txt(_c), dio_bld_get(_c), dio_sts_txt_lst,
	dio_get_raw(_c), dio_bld_get_raw(_c), dio_get_lst_raw(_c),
	dstatx, dio_raw_to_scaled_data(_c), dio_raw_to_value_text_c,
	dio_raw_to_scaled_custom_c, dio_primary_to_scaled_custom_c,
	dio_scaled_to_raw_custom_c, error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	unsigned int	attr_bit_masks[NUM_DEVICES];
	XCHAR	status_text[NUM_DEVICES][DIO_NUM_STATUS_TYPES+1];

	status = dio_bit_mask_to_status_text_c(device_indices,attr_bit_masks,
					       (XCHAR *) status_text,errors,
					       num_devices);