states_description (ul_pasa)

	status.i4.v = states_description(vm_device_index.i4.v, num_states.i4.r,
					 num_initial.i4.r, state_text.i1a.r)

	This function will return the descriptive text associated with
	values a given States device.  State values and text start at an
	initial value ("num_initial") and are contiguous for "num_states"
	values.  The assignment of value to text is held in a database
	table, which can be edited on console page D88.

	vm_device_index	device index of the States device
	num_states	returned count of the number of states
	num_initial	returned number of the the initial state
	state_text	descriptive text returned in the caller's data space
			(Each line of text is of length STATES_TEXTLEN.)
			(If a value of NULL is passed the routine will not
			 copy the text.  This allows the caller to allocate
			 the needed memory for a subsequent call.)

	This function returns ACNET status values:

	OK			success
	SQL_xxx			error reading database information

	This function requires the following include files:

	ul_pasa_h:pasadef_h

	Related functions:

	states_description_ordered, states_telldi

	C/C++ usage:

	char	states_text[64][STATES_TEXTLEN];
	int	status;
	int	vm_device_index = 93690;
	int	num_states;
	int	num_initial;

	status = states_description(vm_device_index,&num_states,
				    &num_initial,(char *) state_text);