sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

User Commands | hadbm-clearhistory(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- OPERANDS
- EXAMPLES
- EXIT STATUS
- ERROR CODES
- SEE ALSO

## NAME

> hadbm clearhistory - clears the history files on the database

## SYNOPSIS

> `hadbm clearhistory` [adminpassword=password | adminpasswordfile=filename] [saveto=path] [agent=ma_url] [dbname]

## DESCRIPTION

> Use the `hadbm clearhistory` command to clear the history files on the database. The directory to which the history files are to be saved must exist and must be writeable. The history file of the named database will be truncated. You can verify by checking the size of the history file. The database state remains unchanged. If a database is identified, it should already exist. If a database is not named, the default database history files are cleared. The default database is hadb.

> In interactive mode, the `hadbm clearhistory` command prompts for a confirmation before clearing the history.

## OPTIONS

> -o saveto

>   The path to where the old history files are to be saved.

> w adminpassword

>   The actual HADBM administation password.

> W adminpasswordfile

>   The file from which the HADBM administration password is read.

> m agent

>   Identifies the URL to the Management Agent. The default is localhost:1862.

## OPERANDS

> dbname

>   The name of the database. The default database is hadb.

## EXAMPLES

> Example 1. Using clearhistory with a database identified

> > >     hadbm clearhistory mydatabase
> > >     This command will clear the history file of the database.
> > >     Type "yes" or "y" to confirm this operation,
> > >     anything else to cancel: y
> > >     Database history file successfully cleared

> Example 2. Using clearhistory with the saveto option

> > >     hadbm clearhistory --saveto=/var/tmp mydatabase
> > >     This command will clear the history file of the database.
> > >     Type "yes" or "y" to confirm this operation,
> > >     anything else to cancel: y
> > >     Database history file successfully cleared

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## ERROR CODES

> 22002

>   specified database does not exist

> 22111

>   directory does not exist

> 22112

>   specified location is not a directory

> 22113

>   directory is not writeable

## SEE ALSO

> `hadbm-status`(1), `hadbm-list`(1), `hadbm-addnodes`(1), `hadbm-clear`(1), `hadbm-refragment`(1), `hadbm-delete`(1), `hadbm-start`(1), `hadbm-restart`(1), `hadbm-stop`(1)

J2EE SDK 1.4 | Go To Top | Last Changed 22 Dec 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.