save_set_save_devices_c

	status.i4.v = save_set_save_devices_c(set_name.i1a.r, save_type.i4.v,
					      num_devices.i4.v, devices.sa.r,
					      errors.i2a.r [,compare_info.sa.r]
					      [,unused.i1a.r]
					      [,description.i1a.r]
					      [,protection.i4.v]
					      [,prot_mask.u4.v])

	This routine saves device values in a save set.

	set_name	set name
			(up to SAVE_SET_NAME_LEN characters)
	save_type	type of save to make
			(SAVE_SET_CREATE -> create a new save set or
					    delete all entries in an
					    existing set,
			 SAVE_SET_CLEAR -> delete all entries in an
					   existing set,
			 SAVE_SET_APPEND -> add entries to an existing set)
	num_devices	number of device value entries
	devices		device value entries
			(array of ARRAY_DEVICE_DATA_EXT structures)
	errors		returned save status values
	[compare_info]	compare information
			(array of SAVE_SET_COMPARE_INFO structures)
	[unused]	unused argument
			(pass a value of NULL)
	[protection]	save set protection type
			(SAVE_SET_PROTECT_NONE -> no protection,
			 SAVE_SET_PROTECT_OWNER -> owner protection,
			 SAVE_SET_PROTECT_CONSOLE_CLASS -> console class
							   protection)
	[prot_mask]	console class protection mask

	This function returns ACNET status values as follows:

	OK			devices successfully saved
	CLIB_NOPRIV		caller doesn't have permission to alter
				this save set
	CLIB_NO_SUCH		save set does not exist
	CLIB_INVARG		invalid save type requested
	DPM_xxx			error reading devices
	SQL_xxx			error saving device values
	otherwise		number of save errors

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	save_set_restore_devices_c, save_set_restore_all_devices_c,
	save_set_name_exists, save_set_get_device_spec_list,
	save_set_contains_device_specs_c, save_set_compare_devices_c,
	save_set_compare_all_devices, save_set_get_device_values_c,
	save_set_get_all_device_values, save_set_get_compare_info_c,
	save_set_delete, save_set_get_set_info

	C/C++ usage:

	static const char	set_name[SAVE_SET_NAME_LEN+1] = "MySaveSet";
	short	errors[NUM_DEVICES];
	int	status;
	int	save_type = SAVE_SET_CREATE;
	int	num_devices = NUM_DEVICES;
	int	protection = SAVE_SET_PROTECT_NONE;
	unsigned int	prot_mask = SAVE_SET_ALL_CLASSES;
	ARRAY_DEVICE_DATA_EXT	devices[NUM_DEVICES];
	SAVE_SET_COMPARE_INFO	compare_info[NUM_DEVICES];

	status = save_set_save_devices_c(set_name,save_type,num_devices,
					 devices,errors,compare_info);