dio_pdb_ctl

	status.i4.v = dio_pdb_ctl(device_indices.i4a.r, attribute_defs.i1a.r,
				  reset_attrs.u4a.r, on_attrs.u4a.r,
				  off_attrs.u4a.r, positive_attrs.u4a.r, 
				  negative_attrs.u4a.r, errors.i2a.r
				  [,num_devices.i4.r] [,ramp_attrs.u4a.r]
				  [,dc_attrs.u4a.r] [,ret_ramp_dc.i4.r])

	This routine returns basic control PDB information for a device
	or list of devices.  Arguments marked with a "(*)" symbol can be
	passed a value of NULL, if that argument's data is not needed.
	Indices to the flag array arguments are defined in 'diolib' and
	have the form DIO_CTL_IDX_xxx.
	
	device_indices	device index or array of device indices
	attribute_defs	returned attribute definition flags
			(DIO_NUM_CONTROL_TYPES entries per device)
			in same order as the following attribute arguments
			(TRUE -> attribute is defined,
			 FALSE -> attribute isn't defined)
			(Note: If the value of "return_ramp_dc" is TRUE,
			 there will be DIO_NUM_CONTROL_TYPES + 2 flags
			 returned per device.)
	reset_attrs	returned reset attribute or array of attributes (*)
	on_attrs	returned on attribute or array of attributes (*)
	off_attrs	returned off attribute or array of attributes (*)
	positive_attrs	returned positive attribute or array of attributes (*)
	negative_attrs	returned negative attribute or array of attributes (*)
	errors		returned ACNET status value or array of returned
			status values (A status of DBM_NOREC indicates that
			the requested PDB does not exist.)
	[num_devices]	number of devices in the list (default is 1)
	[ramp_attrs]	returned ramp attribute or array of attributes (*)
			(default is NULL)
	[dc_attrs]	returned DC attribute or array of attributes (*)
			(default is NULL)
	[ret_ramp_dc]	flag which indicates whether or not to return ramp/DC
			attribute definition flags
			(TRUE -> return ramp/DC attribute flags,
			 FALSE -> don't return ramp/DC attribute flags
				  (default))
			(default is NULL)

	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:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_digital_control_info_c, dio_pdb_sts, dio_scaling, dio_get_pdb,
	error_in_list(_c)

	C/C++ usage:

	char	attribute_defs[NUM_DEVICES][DIO_NUM_CONTROL_TYPES];
	char	ramp_dc_defs[NUM_DEVICES];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	ret_ramp_dc = FALSE;
	unsigned int	reset_attrs[NUM_DEVICES];
	unsigned int	on_attrs[NUM_DEVICES];
	unsigned int	off_attrs[NUM_DEVICES];
	unsigned int	positive_attrs[NUM_DEVICES];
	unsigned int	negative_attrs[NUM_DEVICES];
	unsigned int	ramp_attrs[NUM_DEVICES];
	unsigned int	dc_attrs[NUM_DEVICES];

	status = dio_pdb_ctl(device_indices,(char *) attribute_defs,
			     reset_attrs,on_attrs,off_attrs,
			     positive_attrs,negative_attrs,errors,
			     &num_devices,ramp_attrs,dc_attrs,&ret_ramp_dc);