# history rename

## Syntax

```
history <instance> rename <newname>
```

## Syntax Description

<table><thead><tr><th width="203">Keyword</th><th>Description</th></tr></thead><tbody><tr><td>instance</td><td>The history instance to be renamed.</td></tr><tr><td>newname</td><td>The new name for the history instance.</td></tr></tbody></table>

## Defaults

None; all parameters must be specified.

## Usage Guidelines

This command allows an existing history instance to be given a new instance name. Once renamed, all references to the history instance must be done using the new instance name.

&#x20;Renameing a history instance will cause the current history file (if any) to be closed and a new one started.

## Examples

```
history myhist2 rename myhist3
```

## Related Commands