sr_is_on_c

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

	This routine returns device on/off 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.

	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 is on,
			 FALSE -> device is off,
			 DIO_NOATT -> on/off 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_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)
	[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_status_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_disconnect, sr_sda_cases_present_c,
	sr_sda_num_subcases_c, sr_sda_subcases_present_c, sr_sda_case_times_c

	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	num_devices = NUM_DEVICES;
	int	data_source = SRMNGR_NORMAL;
	int	case_number = SDA_DEFAULT_CASE_NUMBER;
	int	subcase_num = SDA_DEFAULT_SUBCASE_NUMBER;

	status = sr_is_on_c(device_indices,file_number,on_states,errors,
			    num_devices,data_source,case_number,
			    lengths,offsets,subcase_num,sda_usage);