dio_device_index(_c)

	status.i4.v = dio_device_index(device_names.i1a.r, device_indices.i4a.r
				       [,num_devices.i4.r] [,errors.i2a.r]
				       [,options.u4.r])

	status.i4.v = dio_device_index_c(device_names.i1a.r,
					 device_indices.i4a.r
					 [,num_devices.i4.v] [,errors.i2a.r]
					 [,options.u4.v])

	This routine retrieves the device index for a given device name
	If "num_devices" is specified, device indices for a list of devices
	can be retrieved.

	device_names	device name or an array of device names
			(each name should be dio_get_terse_name_length
			 characters long or DEVICE_FULL_NAME_LEN characters
			 if full names are being requested)
			(Note:  This routine will handle either concatenated
			 device names, or device names separated by one or
			 more null characters.)
	device_indices	returned device index or array of device indices
	[num_devices]	number of devices (default is 1)
	[errors]	returned ACNET status value or array of status values
			(default is NULL)
	[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_ALLOW_PREVIOUS -> want device indices of
							previous device names
							(before device renaming),
			 DIO_NAME_OPT_FULL_NAME -> retrieve information for
						   full names)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_name_to_index, dio_dev_name(_c), nam2di, dio_delete_name_info_c,
	dio_delete_all_name_info, dio_find_name_c, dio_fermi_name_to_key_c,
	dio_full_name_to_terse_name_c, dio_terse_name_to_full_name_c,
	error_in_list(_c)

	C/C++ usage:

	static char	device_names[] = "I:H100  I:H102  ";
	short		errors[NUM_DEVICES];
	int		status;
	int		device_indices[NUM_DEVICES];
	int		num_devices = NUM_DEVICES;
	unsigned int	options = DIO_NAME_OPT_ALLOW_OBSOLETE;

	status = dio_device_index_c(device_names,device_indices,
				    num_devices,errors,options);