> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/reference/history-tab.md).

# History Tab

Each time CopyStorm runs it records job information and statistics into a set of history logging tables within the CopyStorm database. The History Tab supports viewing and exporting CopyStorm job history.

The History Tab consists of two sections — a top section used to search for past CopyStorm jobs and a bottom section displaying a one-line status for each job in the database.

## CopyStorm Job History

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-c7b4a491a92d847559b89afc511c1e8b579c679f%2F6040ed77-job_history_ref_page_storm.png?alt=media)

## Job History Table Headers

| Column Name | Description                                                                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| View\...    | Opens a dialog providing detailed status of the selected job.                                                                                           |
| Id          | ID of the job.                                                                                                                                          |
| Status      | Completion status of the job. Green checkmark indicates this job had no exceptions. Red exclamation indicates job finished with at least one exception. |
| Start       | The start timestamp of the job, in local time.                                                                                                          |
| End         | The end timestamp of the job, in local time.                                                                                                            |
| #Copied     | Number of records written to the database.                                                                                                              |
| #Skipped    | Records read but not copied as they are already in the backup.                                                                                          |
| #Deleted    | Records removed from the database due to deletion in Salesforce beyond retention settings.                                                              |
| #Snapshot   | Records captured as part of point-in-time copy or custom snapshot.                                                                                      |
| #Exceptions | Number of exceptions reported during the job.                                                                                                           |
| Time        | Total elapsed time of the job.                                                                                                                          |
| API Calls   | Number of Salesforce API calls used during the job.                                                                                                     |
| Version     | Application version used for the job.                                                                                                                   |
| Config File | Name of the `.copyStorm` configuration file associated with the job.                                                                                    |

## Individual Job View

When the “View…” column is clicked a dialog appears providing detailed job status. This dialog is similar to the “Copy in Progress” GUI but only contains tables that had activity in the selected job.

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-33e4dd68c7b9a6cdda4abd2e7b404c5981bd066f%2Fe3bf4738-HistoryTabJob.png?alt=media)

### Individual Job View Table Headers

| Column Name | Description                                                                                |
| ----------- | ------------------------------------------------------------------------------------------ |
| Table       | Opens a dialog providing detailed status of the selected job.                              |
| Start Time  | Starting time of the table copy.                                                           |
| End Time    | Ending time of the table copy.                                                             |
| #Read       | Number of records read from Salesforce.                                                    |
| #Copied     | Number of records written to the database.                                                 |
| #Skipped    | Records read but not copied as they are already in the backup.                             |
| #Deleted    | Records removed from the database due to deletion in Salesforce beyond retention settings. |
| #Per Minute | Average number of records written to the database per minute.                              |
| Total Time  | Total Elapsed time of the table.                                                           |

### Exceptions View

Any exceptions that occurred during the job will be displayed in the Exceptions tab. In this example, the job had a single exception.

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-4a108177f0d1b723dbdef8857f25e5403ae41256%2F64f68e14-HistoryTabJobException.png?alt=media)

## CopyStorm/Medic Job History

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-e1eb790c991569abc5f17c5029d67e9a6342682e%2F07be1045-job_history_ref_page_medic.png?alt=media)

## Job History Table Headers

| Column Name | Description                                                                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| View\...    | Opens a dialog providing detailed status of the selected job.                                                                                           |
| Status      | Completion status of the job. Green checkmark indicates this job had no exceptions. Red exclamation indicates job finished with at least one exception. |
| Start       | Start timestamp of the job.                                                                                                                             |
| End         | Records read but not copied as they are already in the backup.                                                                                          |
| #Deleted    | Records removed from the database due to deletion in Salesforce beyond retention settings.                                                              |
| #Snapshot   | Records captured as part of point-in-time copy or custom snapshot.                                                                                      |
| #Exceptions | Number of exceptions reported during the job.                                                                                                           |
| Time        | Total elapsed time of the job.                                                                                                                          |
| API Calls   | Number of Salesforce API calls used during the job.                                                                                                     |
| Version     | Application version used for the job.                                                                                                                   |
| Config File | Name of the `.copyStormMedic` configuration file associated with the job.                                                                               |

## Individual Job View

When the “View…” column is clicked a dialog appears providing detailed job status:

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-3c5f7614c1e84631bf933ce07d96c4184f7f6656%2F7fb5e6c1-Medic-History-Popup.png?alt=media)

## Other Features

In addition to viewing historical job data, the History Tab can be used to delete job records and to export job data to Excel-compatible CSV files.

To delete records:

* Click on the check box next to one or more Job #.
* Click on the “Delete” button.

To export job history to CSV files:

* Click on the check box next to one or more Job #.
* Click on the “Export” button.
