acl_parse_script_argument_string_c

	status.i4.v = acl_parse_script_argument_string_c(string.i1a.r,
							 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 parses an Accelerator Command Language (ACL)
	script argument string.

	string		argument string to parse
	length		length of string  (If a value of 0 is passed for this
			argument, the string will be assumed to be null
			terminated.)
	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]	read symbol name options
			(ACL_OPT_NONE -> no options selected (default))

	This function returns ACNET status values as follows:

	OK			success

	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_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	string[] = "M:OUTTMP myString anotherString";
	char	*device_args;
	char	**string_args;
	int	status;
	int	length = 0;
	int	num_device_args;
	int	num_string_args;
	unsigned int	options = ACL_OPT_NONE;

	status = acl_parse_script_argument_string_c(string,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);
	    }