Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

ics:indexdestroy

Deletes an existing search index.

Syntax

<ics:indexdestroy
      index="index name"
      [charset="character set"]
      [searchengine="name"]/>

Parameters

index (required)

Full path name of the index to delete. If you specify a nonexisting index name, ics:indexdestroy does not return an error.

charset (optional)

Constant value representing the character set the index uses.

For the AltaVista search engine this value may be 0, 1, or 2 (ISO_LATIN1, ASCII8, UTF8). If you do not specify charset, Content Server uses the value of av.charset in the Content Server properties file.

Because Java Strings are transformed to UTF8, as they pass through the JNI interface to AltaVista, the 0 value only works for 7-bit ASCII. For all other cases, use the value for UTF8.

For the Verity search engine, this value specifies the name of the subdirectory of the common directory where the locale is defined. If you do not specify charset, Content Server uses the value of verity.charset in the Content Server properties file.

searchengine (optional)

Name of the search engine to use. If searchengine is not specified, Content Server uses the value of cs.searchengine from the Content Server properties file.

Description

The ics:indexdestroy tag deletes an existing search index.

If you call ics: after deleting an index, ics:indexexists returns -812 (indicating that the index no longer exists).

For AltaVista, after calling ics:indexdestroy to delete an existing index, the base directory specified in the index parameter usually still exists and contains an empty lock file. In this case, ics:indexexists still reports, as expected, that the index does not exist.

For Verity, after calling ics:indexdestroy to delete an existing index, the entire directory structure is left.

Note The ics:indexdestroy tag deletes indexes only. Directories that contain the indexes must be deleted manually for both AltaVista and Verity.

errno

The possible values of errno include:

Value	Description
-801	Cannot load search engine.
-804	Delete index failed.
-805	No default index specified.
-806	Unknown search engine.

Example

The following example deletes the Article index.

<ics:clearerrno/>
<ics:indexdestroy  index="c:/ArticleIdx" searchengine="AV"/>
<ics:if condition=<%ics.GetErrno() != 0%>'>
<ics:then>
  Report error
</ics:then>
</ics:if>

See Also

ics:indexcreate

		Home >	Contents >	Index >
	FatWire JSP Tag Reference Copyright 2005,2006,2007 by FatWire Software All rights reserved.