dio_find_name_c

	status.i4.v = dio_find_name_c(search_string.i1a.r, string_length.i4.v,
				      max_names.i4.v, returned_names.i1a.r
				      [,options.i4.v])

	This routine finds device names which match a specified search
	string.  Percent (%) or asterisk (*) characters can be used as a
	wildcard matching zero or more characters.  The underscore (_)
	character can be used as a wildcard matching exactly one character.
	A set of characters for a single character location can also be
	specified by enclosing the set of possible values within a pair of
	square braces ([]).  Either a range of characters can be specified
	by inserting the minimum and maximum possible characters separated
	by a dash (-) or a set of characters can be entered explicitly with
	no separators.  A set can be negated with a leading caret (^)
	character inside the braces.  Use of any type of wildcard character
	at the beginning of the search string will greatly increase the
	time taken by the search.  If the status is equal to the number of
	names requested, there may be more possible matches in the database.

	search_string	device name search string containing one or more
			wildcard characters
	string_length	length of search string  (If a value of zero is passed,
			the length of the string will be determined by this
			routine.)
	max_names	maximum number of names to return  (Note:  If a value
			of zero is passed for this argument, only the count
			of matching device names is returned.)
	returned_names	returned device names
			(dio_get_terse_name_length characters per entry)
	[options]	device index retrieval options
			(DIO_NAME_OPT_NONE -> no options selected,
			 DIO_NAME_OPT_ALLOW_OBSOLETE -> want device indices of
							obsoleted and deleted
							devices,
			 DIO_NAME_OPT_FULL_NAME -> retrieve information for
						   full names)

	This function returns status values as follows:

	DIO_MEMFAIL		memory allocation failure
	DIO_BADARG		search string contains either single or
				double quotes
	otherwise		number of returned (or matching) device names

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_dev_name(_c), dio_device_index(_c), dio_name_to_index,
	dio_full_name_to_terse_name_c, dio_terse_name_to_full_name_c,
	dio_fermi_name_c, dio_name_to_fermi_name_c, dio_fermi_name_to_key_c

	C/C++ usage:

	static char	search_string[] = "I:H1*";
	char	returned_names[MAX_NAMES][DEVICE_TERSE_NAME_LEN];
	int	status;
	int	string_length = 0;
	int	max_names = MAX_NAMES;
	int	options = DIO_NAME_OPT_NONE;

	status = dio_find_name_c(search_string,string_length,max_names,
				 (char *) returned_names,options);