# Charting configuration

This page provides a summary of all the Charting blade configuration options.

## Configuration files

The Charting Blade’s configuration can be found in the following files: `charting.conf`, `fieldset.conf`, and `watchlist.conf`.

**❗ IMPORTANT**\
Shutdown Transformer _before_ configuring Charting. Some Charting configuration is overwritten when Transformer shuts down.

## Configuration items

This section lists the configuration items supported by the Charting Blade.

### Requesting data

| Option | Default value | Links | Description |
| --- | --- | --- | --- |
| `cache-subject-forever` | +[Visit link to see definition]+ | [Link](transformer-request-intraday-data.md#cache-subject-forever) | A symbol to start caching data for at start up. |
| `cache-container` | +[Visit link to see definition]+ | [Link](transformer-request-intraday-data.md#cache-container) | The name of a container (or Refinitiv chain) which will be requested on startup. |
| `cache-subject-temp` | +[no default]+ | [Link](transformer-request-intraday-data.md#cache-subject-temp) | Temporarily add a symbol to the watchlist. |
| `watchlist-filename` | +[no default]+ | [Link](transformer-request-intraday-data.md#watchlist-filename) | Name of file to write watchlist to. |

### Caching data

| Option | Default value | Links | Description |
| --- | --- | --- | --- |
| `max-age` | 10 | [Link](transformer-cache-and-validate-intraday-data.md#max-age) | Maximum amount of time (in days) to keep caching a user-requested symbol after it was last requested. |
| `cache-directory` | +[current directory]+ | [Link](transformer-cache-and-validate-intraday-data.md#cache-directory) | Directory to be used to store the cached charting data files. |

### Filtering data

| Option | Default value | Links | Description |
| --- | --- | --- | --- |
| `add-fieldset` | +[Visit link to see definition]+ | [Link](transformer-cache-and-validate-intraday-data.md#add-fieldset) | Defines how a Transformer handles a set of instruments and which fields should be cached for that type. |

### Outputting data to Transformer

| Option | Default value | Links | Description |
| --- | --- | --- | --- |
| `charts-prefix` | `/CHARTS` | [Link](transformer-pass-intraday-data-to-transformer-core.md#charts-prefix) | Prefix for subjects that the Charting blade will provide data for. |

### Logging

| Option | Default value | Links | Description |
| --- | --- | --- | --- |
| `log-level` | `INFO` | [Link](transformer-pass-intraday-data-to-transformer-core.md#log-level) | Determines the errors and events that are reported to the `transformer.log` log file when Caplin Transformer is operating. |
| `log-file` | `charting.log` | [Link](transformer-pass-intraday-data-to-transformer-core.md#log-file) | Name of file to write debug messages to. |

### Opening hours and timezones

| Option | Default value | Links | Description |
| --- | --- | --- | --- |
| `info-page` | +[no default]+ | [Link](transformer-manage-intraday-opening-hours-information.md#info-page) | The name of the symbol carrying information to request at start up. |
| `info-rerequest-time` | +[no default]+ | [Link](transformer-manage-intraday-opening-hours-information.md#info-rerequest-time) | Minutes after midnight local time at which to rerequest trading time information. |
| `info-rerequest-days` | +[no default]+ | [Link](transformer-manage-intraday-opening-hours-information.md#info-rerequest-days) | Day at which to rerequest trading time information. |
| `timeinfo-filename` | +[no default]+ | [Link](transformer-manage-intraday-opening-hours-information.md#timeinfo-filename) | Filename to write trading time information to. |
| `timeinfo-shutdown-write` | FALSE | [Link](transformer-manage-intraday-opening-hours-information.md#timeinfo-shutdown-write) | Boolean determining whether trading time information should be written to file on shutdown. |
| `times-hashsize` | 1024 | [Link](transformer-manage-intraday-opening-hours-information.md#times-hashsize) | Number of entries in the hashtable which holds trading times. |
| `add-exchtime` | +[Visit link to see definition]+ | [Link](transformer-manage-intraday-opening-hours-information.md#add-exchtime) | Defines the opening time information for a specific exchange. |
| `add-rictime` | +[Visit link to see definition]+ | [Link](transformer-manage-intraday-opening-hours-information.md#add-rictime) | Defines the opening time information for a specific symbol. |
| `add-roottime` | +[Visit link to see definition]+ | [Link](transformer-manage-intraday-opening-hours-information.md#add-roottime) | Defines the opening time information for an exchange’s symbol root. |
| `root-hashlen` | 2 | [Link](transformer-manage-intraday-opening-hours-information.md#root-hashlen) | Number of characters to truncate root symbols to. |
| `add-timezone` | +[Visit link to see definition]+ | [Link](transformer-manage-intraday-opening-hours-information.md#add-timezone) | Identifies a time zone. |