dio_pdb_sts

	status.i4.v = dio_pdb_sts(device_indices.i4a.r, attribute_defs.i1a.r,
				  on_attrs.u4a.r, ready_attrs.u4a.r,
				  remote_attrs.u4a.r, polarity_attrs.u4a.r,
				  errors.i2a.r [,num_devices.i4.r]
				  [,data_invert.i1a.r] [,alt_char_defs.i1a.r]
				  [,def_charactrs.sa.r] [,data_lengths.i4a.r]
				  [,ramp_attrs.u4a.r] [,ret_ramp_dc.i4.r])

	This routine returns basic status scaling (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_STS_IDX_xxx.

	device_indices	device index or array of device indices
	attribute_defs	returned attribute definition flags
			(DIO_NUM_STATUS_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_STATUS_TYPES + 1 flags
			 returned per device.)
	on_attrs	returned on attribute or array of attributes (*)
	ready_attrs	returned ready attribute or array of attributes (*)
	remote_attrs	returned remote attribute or array of attributes (*)
	polarity_attrs	returned polarity 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)
	[data_invert]	returned status data invert flags
			(DIO_NUM_STATUS_TYPES entries per device)
			in same order as the attribute arguments (*)
			(Note: If the value of "return_ramp_dc" is TRUE,
			 there will be DIO_NUM_STATUS_TYPES + 1 flags
			 returned per device.)
			(TRUE -> raw status data is complemented before
				 the masking operation,
			 FALSE -> raw status data is not complemented before
				  the masking operation)
			(default is NULL)
	[alt_char_defs]	returned alternate display character flags
			(DIO_NUM_STATUS_TYPES entries per device)
			in same order as the attribute arguments (*)
			(Note: If the value of "return_ramp_dc" is TRUE,
			 there will be DIO_NUM_STATUS_TYPES + 1 flags
			 returned per device.)
			(TRUE -> use alternate character and color,
			 FALSE -> use normal character and color)
			(default is NULL)
	[def_charactrs]	default basic status characters
			(DIO_NUM_STATUS_TYPES * 2 XCHAR structures
			 per device arranged in DIO_NUM_STATUS_TYPES pairs
			 in the same order as the attribute arguments
			 (true value followed by false value) (*)
			(Note: If the value of "return_ramp_dc" is TRUE,
			 there will be (DIO_NUM_STATUS_TYPES + 1) * 2 flags
			 returned per device.)
			(default is NULL)
	[data_lengths]	returned raw data lengths for scaling (1, 2, or 4 bytes)
			(default is NULL)
	[ramp_attrs]	returned ramp 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_pdb_ctl, dio_scaling, dio_get_pdb, dio_raw_to_status_c,
	dio_raw_to_status_extended_c, dio_raw_to_status_text,
	dio_raw_to_status_text_extended_c, dio_status_attr_to_bit_info_c,
	error_in_list(_c)

	C/C++ usage:

	char	attribute_defs[NUM_DEVICES][DIO_NUM_STATUS_TYPES];
	char	data_invert[NUM_DEVICES][DIO_NUM_STATUS_TYPES];
	char	alt_char_defs[NUM_DEVICES][DIO_NUM_STATUS_TYPES];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	data_lengths[NUM_DEVICES];
	int	ret_ramp_dc = FALSE;
	unsigned int	on_attrs[NUM_DEVICES];
	unsigned int	ready_attrs[NUM_DEVICES];
	unsigned int	remote_attrs[NUM_DEVICES];
	unsigned int	polarity_attrs[NUM_DEVICES];
	unsigned int	ramp_attrs[NUM_DEVICES];
	XCHAR	def_characters[NUM_DEVICES][DIO_NUM_STATUS_TYPES][2];

	status = dio_pdb_sts(device_indices,(char *) attribute_defs,on_attrs,
			     ready_attrs,remote_attrs,polarity_attrs,
			     errors,&num_devices,data_invert,alt_char_defs,
			     (XCHAR *) def_characters,data_lengths,
			     ramp_attrs,&ret_ramp_dc);