states_description_ordered (ul_pasa)

	status.i4.v = states_description_ordered(vm_device_index.i4.v,
						 num_states.i4.r,
						 state_numbers.i4a.r,
						 not_yet.u1a.r,
						 state_text.i1a.r)

	This function will return the descriptive text and the associated
	values for a given States device.  State values and text are returned
	in an order that is preferred for presentation.  The assignment of the
	text and preferred order is edited on console page D88.


	vm_device_index	device index of the States device
	num_states	returned count of the number of states
	state_numbers	returned state numbers in the preferred order
	not_yet		returned flags to indicate if state values are
			not yet supported
			(TRUE -> suggest displaying as "not available"
				 (e.g. in blue),
			 FALSE -> suggest displaying as an available choice)
	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_telldi, states_description

	C/C++ usage:

	char	states_text[64][STATES_TEXTLEN];
	unsigned char	not_yet[64];
	int	status;
	int	vm_device_index = 93690;
	int	num_states;
	int	state_numbers[64];

	status = states_description_ordered(vm_device_index,&num_states,
					    state_numbers,not_yet,
					    (char *) state_text);