# history url

## Syntax

```
[no] history <instance> url [<url>]
```

## Syntax Description

<table><thead><tr><th width="203">Keyword</th><th>Description</th></tr></thead><tbody><tr><td><code>no</code></td><td>Removes the specified history URL.</td></tr><tr><td>instance</td><td>The history instance to be modified. If the specified instance does not exist, it will be created unless the no keyword was also specified. Must be alphanumeric.</td></tr><tr><td>url</td><td>This URL to which history files are to be written. Required unless the <code>no</code> parameter is specified.</td></tr></tbody></table>

## Defaults

The default is to not write history files to a remote system

## Usage Guidelines

This command specifies the destination for files produced for this history instance.

The URL must point to a remote directory. Each history file will be writton to a unique file in that directory. The file name format is:

`history.YYYYMMDDHHMMSSmmm‐nnnnnnnnnn`

where “YYYYMMDDHHMMSSmmm” is the date and time including milliseconds and “nnnnnnnnnn” is the number of records in the file.

The path portion of the URL is ignored for the "tcp\://" or "udp\://" real-time streaming schemes.

Refer to the [URL Format](https://docs.islandrouter.com/island-router-cli-2.3.2/url-format) section of this document for more information on the syntax of the url parameter.

## Examples

```
history myhist3 url scp://jane:d9fzC@10.14.2.7/history
```

## Related Commands