acl_input_script_arguments_c

	status.i4.v = acl_input_script_arguments_c(command_text.i1a.r,
						   command_length.i4.v,
						   num_device_args.i4.r,
						   device_args.i1pa.r,
						   num_string_args.i4.r,
						   string_args.i1pa.r,
						   [,options.u4.v])

	This routine prompts the user to enter arguments for an
	Accelerator Command Language (ACL) script.

	command_text	ACL code
	command_length	total length of command text  (If a value of zero
			is passed for this argument, the command text will
			be treated as a single null terminated string.)
	num_device_args	returned number of device arguments
	device_args	returned device arguments
			(The memory for this argument is allocated by this
			 routine and should be freed by the caller.)
	num_string_args	returned number of string arguments
	string_args	returned string arguments
			(The memory for this argument is allocated by this
			 routine and should be freed by the caller.)
	[options]	options
			(ACL_OPT_NONE -> no options selected (default))

	This function returns ACNET status values as follows:

	OK			success
	CBS_WINDOW_TOO_BIG	window won't fit on screen
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_ABORT		user aborted input (no values were changed)

	This function requires the following include files:

	ul_acl_h:acl_h, acnet_errors_h

	Related functions:

	intro_acl, acl_parse_script_argument_string_c, 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_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_parse_symbol_name,
	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_expand_file_name_c,
	acl_get_user_execution_privilege, acl_get_user_db_edit_permission

	C/C++ usage:

	static const char	command_text[] = "set B:HB812 string0";
	char	*device_args;
	char	**string_args;
	int	status;
	int	command_length = 0;
	int	num_device_args;
	int	num_string_args;
	unsigned int	options = ACL_OPT_NONE;

	status = acl_input_script_arguments_c(command_text,command_length,
					      &num_device_args,
					      &device_args,
					      &num_string_args,
					      &string_args,options);
			.
			.
			.
	if (device_args != (char *) NULL) free(device_args);
	if (string_args != (char **) NULL)
	    {
	    str_free_array_of_strings_c(string_args,num_string_args);
	    free(string_args);
	    }