sr_status_text_c

	status.i4.v = sr_status_text_c(device_indices.i4a.r, file_number.i4.v,
				       status_text.sa.r, errors.i2a.r
				       [,num_devices.i4.v] [,data_source.i4.v]
				       [,case_number.i4.v] [,lengths.i2a.r]
				       [,offsets.i2a.r] [,ret_ramp_dc.i4.v]
				       [,subcase_num.i4.v] [,sda_usage.i1a.r])

	This routine returns color coded character strings which represent
	device basic status information previously saved by the save/restore
	system.  If "num_devices" is specified, information for a list of
	devices can be retrieved.

	device_indices	device index or array of device indices
	file_number	file number from which to retrieve data
	status_text	returned DIO_NUM_STATUS_TYPES characters of XCHAR
			format color coded status text for each device
			(array of XCHAR structures)
			(Note: If the value of "ret_ramp_dc" is TRUE,
			 there will be DIO_NUM_STATUS_TYPES + 1 characters
			 of XCHAR format color coded status text for each
			 device.)
	status_text	returned status text (array of four XCHAR structures
			containing color coded text for each device)
	errors		returned ACNET error status or array of returned
			status values
	[num_devices]	number of devices (default is 1)
	[data_source]	source of data
			(CLIB_DEFAULT_ARG -> use previously selected source
					     (default),
			 SRMNGR_NORMAL -> normal save/restore files,
			 SRMNGR_SDA_DATA -> SDA data)
	[case_number]	SDA case number (only meaningful if retrieving
			SDA data) (default is SDA_DEFAULT_CASE_NUMBER)
	[lengths]	device length or array of lengths for support of
			array devices (default is NULL which results in
			using the database minimum size for each device)
	[offsets]	raw data offset or array of data offsets in bytes
			(default is NULL which results in the use of an
			 offset of 0 for all devices)
	[ret_ramp_dc]	flag which indicates whether or not to return ramp/DC
			attribute text
			(TRUE -> return ramp/DC attribute text,
			 FALSE -> don't return ramp/DC attribute text
				  (default))
	[subcase_num]	SDA subcase number (This argument only
			has meaning if the data source is SDA.)
			(default is SDA_DEFAULT_SUBCASE_NUMBER)
	[sda_usage]	null terminated SDA usage string (This argument only
			has meaning if the data source is SDA.)
			(default is NULL which results in Collider shot access)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		too much data requested
	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:

	cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	sr_set_source_c, sr_is_on_c, sr_is_positive_c, sr_get_device_c,
	sr_get_device_raw_c, sr_data_length_c, sr_sda_data_lengths_c,
	sr_sda_snapshot_stats_c, sr_sda_cases_present_c, sr_sda_num_subcases_c,
	sr_sda_subcases_present_c, sr_sda_case_times_c, sr_disconnect

	C/C++ usage:

	char	*sda_usage = (char *) NULL;
	short	errors[NUM_DEVICES];
	short	lengths[NUM_DEVICES] = {RAW_LENGTH};
	short	offsets[NUM_DEVICES] = {0};
	int	status;
	int	device_indices[NUM_DEVICES] = {28559};
	int	file_number = 0;
	int	num_devices = NUM_DEVICES;
	int	data_source = SRMNGR_NORMAL;
	int	case_number = SDA_DEFAULT_CASE_NUMBER;
	int	subcase_num = SDA_DEFAULT_SUBCASE_NUMBER;
	int	ret_ramp_dc = FALSE;
	XCHAR	status_text[NUM_DEVICES][DIO_NUM_STATUS_TYPES];

	status = sr_status_text_c(device_indices,file_number,
				  (XCHAR *) status_text,errors,num_devices,
				  data_source,case_number,lengths,offsets,
				  ret_ramp_dc,subcase_num,sda_usage);