sr_status_c

	status.i4.v = sr_status_c(device_indices.i4a.r, file_number.i4.v,
				  on_states.i4a.r, ready_states.i4a.r,
				  remote_states.i4a.r, positive_states.i4a.r,
				  errors.i2a.r [,num_devices.i4.v]
				  [,data_source.i4.v] [,case_number.i4.v]
				  [,lengths.i2a.r] [,offsets.i2a.r]
				  [,ramp_states.i4a.r] [,subcase_num.i4.v]
				  [,sda_usage.i1a.r])

	This routine returns device basic status data that has been
	previously saved by the save/restore system.  If "num_devices" is
	specified, information for a list of devices can be retrieved.
	A value of NULL can be passed for any of the state arguments if
	that state is not needed.

	device_indices	device index or array of device indices
	file_number	file number from which to retrieve data
	on_states	returned on/off status values
			(TRUE -> device was on,
			 FALSE -> device was off,
			 DIO_NOATT -> on/off attribute not defined)
	ready_states	returned ready/tripped status values
			(TRUE -> device was ready,
			 FALSE -> device was tripped,
			 DIO_NOATT -> ready/tripped attribute not defined)
	remote_states	returned remote/local status values
			(TRUE -> device was in remote,
			 FALSE -> device was in local,
			 DIO_NOATT -> remote/local attribute not defined)
	positive_states	returned polarity status values
			(TRUE -> device was in positive polarity,
			 FALSE -> device was in negative polarity,
			 DIO_NOATT -> polarity attribute not defined)
	errors		returned ACNET status or array of 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_SUBCASE_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)
	[ramp_states]	returned ramp/DC status values
			(TRUE -> device was ramping,
			 FALSE -> device was DC,
			 DIO_NOATT -> ramp/DC attribute not defined)
	[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:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	sr_set_source_c, sr_is_on_c, sr_is_positive_c, sr_status_text_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	on_states[NUM_DEVICES];
	int	ready_states[NUM_DEVICES];
	int	remote_states[NUM_DEVICES];
	int	positive_states[NUM_DEVICES];
	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	ramp_states[NUM_DEVICES];

	status = sr_status_c(device_indices,file_number,on_states,
			     ready_states,remote_states,positive_states,
			     errors,num_devices,data_source,case_number,
			     lengths,offsets,ramp_states,subcase_num,
			     sda_usage);