acl_create_symbol_c

	status.i4.v = acl_create_symbol_c(symbol_name.i1a.r, value_type.i4.v
					  [,num_elements.i4.v]
					  [,initial_values.g.v]
					  [,num_dimensions.i4.v]
					  [,dim_sizes.i4a.r]
					  [,options.u4.v])

	This routine creates an Accelerator Command Language (ACL) symbol.
	Symbols are variables which continue to exist until the calling
	process exits unless they are deleted first.

	symbol_name	desired null terminated symbol name
	value_type	desired symbol value type
			(ACL_BYTE_VALUE -> byte integer value,
			 ACL_UNSIGNED_BYTE_VALUE -> unsigned byte integer value,
			 ACL_SHORT_INT_VALUE -> short integer value,
			 ACL_UNSIGNED_SHORT_VALUE -> unsigned short integer
						     value,
			 ACL_INTEGER_VALUE -> integer value,
			 ACL_UNSIGNED_INT_VALUE -> unsigned integer value,
			 ACL_LONG_LONG_VALUE -> long long integer value,
			 ACL_ULONG_LONG_VALUE -> unsigned long long
						 integer value,
			 ACL_FLOAT_VALUE -> single precision floating
					    point value,
			 ACL_DOUBLE_VALUE -> double precision floating
					     point value,
			 ACL_STRING_VALUE -> null terminated string value,
			 ACL_LOGICAL_VALUE -> logical value (integer value),
			 ACL_DATE_VALUE -> date value in clinks
					   (unsigned integer value),
			 ACL_MILLISECONDS_DATE_VALUE -> milliseconds date value,
			 ACL_ERROR_VALUE -> ACNET error value (integer value),
			 ACL_SYSTEM_ERROR_VALUE -> system error value
						   (integer value),
			 ACL_RTL_ERROR_VALUE -> RTL error value (integer value),
			 ACL_NODE_VALUE -> ACNET node value (integer value),
			 ACL_EVENT_VALUE -> clock event value (integer value),
			 ACL_DEVICE_INDEX_VALUE -> device index value
						   (integer value))
	[num_elements]	desired number of elements
			(default is 1)
	[initial_values] desired initial values
			 (default is NULL)
	[num_dimensions] desired number of dimensions
	[dim_sizes]	desired dimension sizes
			(default is NULL)
	[options]	read symbol name options
			(ACL_OPT_NONE -> no options selected (default),
			 ACL_OPT_WANT_GLOBAL -> create a global symbol)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid value type, number of elements,
				number of dimensions, or dimension sizes passed
	CLIB_DUPREQ		symbol already exists
	otherwise		other ACNET format error code

	This function requires the following include files:

	ul_acl_h:acl_h, acnet_errors_h

	Related functions:

	intro_acl, acl_read_symbol_c, acl_read_symbol_as_string_c,
	acl_read_symbol_info_c, acl_read_symbol_dynamic_info_c,
	acl_set_symbol_c, acl_parse_symbol_name, acl_execute_c,
	acl_file_execute_c, acl_file_read_c, acl_file_write_c,
	acl_file_exists_c, acl_db_file_exists_c, acl_compile_c,
	acl_free_c, acl_free_arg_info_c, acl_read_symbol_names,
	acl_read_intrinsic_symbol_names, acl_script_argument_info_c,
	acl_script_has_symbol_list_c, acl_script_has_setting_c,
	acl_delete_symbol, acl_reinit_symbol, acl_info_c,
	acl_cancel_requests_c, acl_default_data_source_c,
	acl_log_file_c, acl_default_script_path_c, acl_script_is_executing,
	acl_register_host_request_func, acl_unregister_host_request_func,
	acl_translate_command_string, acl_file_read_description_c,
	acl_file_read_author_c, acl_file_read_title_c, acl_search_db_files_c,
	acl_file_is_in_repository_c, acl_parse_script_argument_string_c,
	acl_expand_file_name_c, acl_get_user_execution_privilege,
	acl_get_user_db_edit_permission, acl_script_to_command_lines_c,
	acl_set_resume_point_parameters_c

	C/C++ usage:

	static const char	symbol_name[] = "my_symbol";
	int	status;
	int	value_type = ACL_FLOAT_VALUE;
	int	num_elements = NUM_ELEMENTS;
	int	num_dimensions = 1;
	int	*dimension_sizes = (int *) NULL;
	unsigned int	options = ACL_OPT_NONE;
	float	initial_values[NUM_ELEMENTS] = {1.0, 2.0, 3.14};

	status = acl_create_symbol_c(symbol_name,value_type,num_elements,
				     (float *) initial_values,num_dimensions,
				     dimension_sizes,options);