---
title: "history"
slug: "cli-sc-history"
updated: 2025-06-30T09:53:21Z
published: 2025-09-03T14:12:28Z
canonical: "docs.crossworkassurance.cisco.com/cli-sc-history"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossworkassurance.cisco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# history

## history edit file

history edit file - Change the report file generation parameters

**Description:** history edit file allows to change parameters used to generate and upload the report files to a remote server.

**Syntax:**

```
  history edit file {
                {period-mode {new | fixed | all}} |
                {local-periods <1-672>} |
                {include-disabled {enabled | disabled }} |
                {include-previous {enabled | disabled }} |
                {url <url>} |
                {scp-password <password>} }+
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| period-mode | Selects the mode in which the periods are retrieved to generate a report file: - new: only the periods since the last report. - fixed: fixed number of periods. - all: all available periods. |
| local-periods | Specifies the number of local periods to process in fixed mode. |
| include-disabled | Specifies if the report should include the statistics for disabled objects. |
| include-previous | Specifies if the report should include the periods included in a previous aborted file transfer. This is only used if period-mode is "new". |
| url | URL to reach the server and directory, e.g.: - `http://mypc.com` - `ftp://username:password@mypc.com` - `sftp://username@mypc.com` - `tftp://mypc.com` - `scp://username@mypc.com:/target_directory` The URL host subcomponent consists of a name or an IP address. IPv4 addresses must be in dot-decimal notation, and IPv6 addresses must be enclosed in brackets ([]). |
| scp-password | Password used for SCP and SFTP transfers. |

## history edit local

history edit local - Change the local history parameters

**Description:** With history local edit, you can change the parameters of the history buckets mechanism.

**Syntax:**

```
  history edit local {
                {flowmeter-state {disable | enable}} |
                {flowmeter-filing {disable | enable}} |
                {flowmeter-period <1-60>} |
                {regulator-state {disable | enable}} |
                {regulator-filing {disable | enable}} |
                {regulator-period <1-60>} |
                {soamdmm-state {disable | enable}} |
                {soamdmm-filing {disable | enable}} |
                {soamdmm-period <1-60>} |
                {soampl-state {disable | enable}} |
                {soampl-filing {disable | enable}} |
                {soampl-period <1-60>} |
                {soamslm-state {disable | enable}} |
                {soamslm-filing {disable | enable}} |
                {soamslm-period <1-60>}}+
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| flowmeter-state | Enable or disable FlowMETER history. |
| flowmeter-filing | Enable filesystem storage of the FlowMETER history buckets. |
| flowmeter-period | Reference period for the FlowMETER history buckets. |
| regulator-state | Enable or disable regulator history. |
| regulator-filing | Enable filesystem storage of the regulator history buckets. |
| regulator-period | Reference period for the regulator history buckets. |
| soamdmm-state | Enable or disable SOAM DMM history. |
| soamdmm-filing | Enable filesystem storage of the SOAM DMM history buckets. |
| soamdmm-period | Reference period for the SOAM DMM history buckets. |
| soampl-state | Enable or disable SOAM PL history. |
| soampl-filing | Enable filesystem storage of the SOAM PL history buckets. |
| soampl-period | Reference period for the SOAM PL history buckets. |
| soamslm-state | Enable or disable SOAM SLM history. |
| soamslm-filing | Enable filesystem storage of the SOAM SLM history buckets. |
| soamslm-period | Reference period for the SOAM SLM history buckets. |

## history edit scheduling

history edit scheduling - Modify scheduling parameters

**Description:** With the history edit scheduling command, you can modify how reporting history bucket data is scheduled.

**Syntax:**

```
  history edit scheduling {
                {local-state {disable | enable}} |
                {local-hours {<hour-value>}+} |
                {local-minutes {<minutes-value>}+} |
                {local-offset <0-(local-period - 1)>} |
                {local-random-offset <0-900>} |
                {local-period <5|10|15|20|30|60>}|
                {local-mode <hourly|periodic>}}+
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| local-state | Enables or disables the scheduling mechanism on the local device. |
| local-hours | Sets the hour(s) at which the local statistics are reported {00H00 |
| local-minutes | When in hourly mode, sets the minute(s) at which the local statistics are reported with 15-minute granularity {00H00 |
| local-offset | Sets the offset to add to the local-minutes. Adding an offset spreads out the load on the file servers by distributing the upload moments over time. |
| local-random-offset | Randomly generates an extra offset between 0 and the specified value that is added to the local offset. Expressed in seconds. |
| local-period | When in periodic mode, the period at which the local statistics are retrieved. Similar to local-minutes, but statistics are reported every local-period minutes for the selected local-hours. When in hourly mode, this parameter is ignored and the value of local-period is 15 minutes. |
| local-mode | Sets either periodic or hourly mode. In periodic mode, the minutes that trigger statistics reporting are set using local-period; whereas in hourly mode, the minutes that trigger statistics reporting are set using local-minutes. |

## history show file

history show file - Show the report file generation parameters

**Description:** history show file displays the report file generation configuration parameters.

**Syntax:**

```
  history show file
```

## history show local

history show local - Show the local history parameters

**Description:** history show local displays the local history configuration parameters.

**Syntax:**

```
  history show local
```

## history show scheduling

history show scheduling - Show the scheduling parameters

**Description:** history show scheduling displays the scheduling configuration parameters.

**Syntax:**

```
  history show scheduling
```

**© 2026 Cisco and/or its affiliates. All rights reserved.** For more information about trademarks, please visit: [Cisco trademarks](https://www.cisco.com/c/en/us/about/legal/trademarks.html)[](https://www.cisco.com/c/en/us/about/legal/trademarks.html) For more information about legal terms, please visit: [Cisco legal terms](https://www.cisco.com/c/en/us/about/legal/terms-conditions.html)