dio_memory_pool_name_to_id_c

	status.i4.v = dio_memory_pool_name_to_id_c(pool_name.i1a.r,
						   create_it.i4.v,
						   pool_id.i4.r)

	This routine converts a DIO memory pool name to its associated ID.
	If the requested pool does not exist and "create_it" has a value
	of TRUE, a new pool will be created.

	pool_name	string to identify a unique memory pool
			(The default "pool_name" (the one used if
			 dio_memory_select_pool_c is never called) is
			 "default" which is populated from the data pool.)
	create_it	pool creation flag
			(TRUE -> create a new pool with the passed name if
				 it doesn't already exist,
			 FALSE -> do not create a new pool)
	pool_id		returned pool ID

	This function returns ACNET status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation error
	DIO_NO_SUCH		requested pool does not exist

	This function requires the following include files:

	diolib_h, acnet_errors_h

	Related functions:

	dio_memory_pool_id_to_name_c, dio_memory_select_pool_c,
	dio_memory_set_populate_c, dio_memory_get_raw_c, dio_memory_get_c,
	dio_memory_get_array_c, dio_memory_read_raw_c, dio_memory_read_c,
	dio_memory_set_raw_c, dio_memory_set_c, dio_memory_write_c,
	dio_memory_set_array_c, dio_memory_control_c, dio_memory_cancel_c,
	dio_memory_populate_c, dio_memory_populate_query

	C/C++ usage:

	static const char	pool_spec[] = "my_pool";
	int	status;
	int	create_it = TRUE;
	int	pool_id;

	status = dio_memory_pool_name_to_id_c(pool_name,create_it,&pool_id);