Historian files

DataSet - When a DataSet is opened the DataSet panel displays properties and settings in the upper right.

 

 

 

Name: - The Name of the DataSet precedes all .hdb files and is used in any ItemID.

 

Tag Count: - Total number of tags being logged in this DataSet based on the most current file.

 

Updates/Sec: - When logging is active this will show the total updates per second for all tags in this DataSet.

 

Readers: - Number of tags being read from this DataSet (each tag will be a Reader).

 

Writers: - Number of tags being written to this DataSet (each logging tag is a Writer).

 

HDB Files: - Number of .hdb2 files in this DataSet.

 

Offline Files: - The number of files in this DataSet with an offline extension because background validation found errors in the file.

 

Directory: - Path where the files are stored for this DataSet.

 

Rollover: - If logging continues this will show the date/time the DataSet is configured to Rollover (create a new file). If logging is stopped and resumed after the time passes then Rollover will occur when logging starts.

 

Validate: - True or False if background validation should run on this DataSet. Controlled by a checkbox on the Historian > Configuration > DataSets tab for each DataSet.

 

Arrow down - Changes the panel to DataSet Options.

Roll-Over - Forces a file Roll-Over to happen immediately.

 

Roll-Up - Forces a Roll-Up if it is configured for this DataSet and files are available to act on.

 

Refresh File List - Refreshes the list of .hdb2 files displayed if a file has been copied into or removed through the directory.

 

Validate All Files - Performs validation on all files in the DataSet.

 

File - When a file is selected the File panel will display properties and settings.

 

 

 

Created: - Creation date/time of the selected file.

 

Validated: - If the file is validated the date/time is displayed.

 

Tag Count: - Number of tags in the selected file.

 

File Path: - Full path to the location of the selected file.

 

File Size: - Size of the file on the disk.

 

Embedded Size: - Files open for writing will be larger due to allocated space. This will display the size of the file with the extra space released.

 

Rolled Over: - True or False depending on whether the file rolled over to a new file (tag key is copied to the next file) or a new file was created when logging started.

 

Offline: - True or False depending on if background validation detected errors in the file.

 

Status: - Current state of the file... 

OK = Normal

 ??? - File not properly closed. Validation will close if OK and take offline if not.

 Bad - File has some type of corruption but has not been validated to take offline.

 

Arrow down - Changes the panel to File Options.

For online files.

Validate - Runs the validation on the selected file/files.

Take Offline - Adds the offline extension to the file which prevents it from being accessed for reading or writing.

Note: Take Offline is not available if multiple files are selected.

 

For offline files.

Validate - Runs validation without comparing timestamps to adjacent files.

 

Put Online - Removes the offline extension to allow access for reading and writing.

 

Recover - Available only when over an off-line file. Should a file be taken off-line due to a validation problem, this option will try to recover any usable data without risking the existing data. Below are the steps the program will execute;

• Dump all the data and tag information to a file.

• Transpose to another file into the proper time sequence.

• Import the data into a temporary dataset.

• Insert the new file into the current dataset.

• Clean up the temporary files created.

• Rename the off-line file with a .old extension.

Caution: This process can create large files requiring extra disk space and could take several minutes to hours to complete depending on the size of the off-line file.

 

Delete - Available only when over an off-line file. Brings up a dialog to confirm the deletion of the file. This is a permanent deletion unless the historian runs under a specific account other than system.

 

Range Selector - The Range Selector goes from the date of the earliest data to the date of the latest data in the DataSet. Setting the grips to both ends of the range will display all files in the DataSet. Either grip can be positioned along the range to start or end at a particular date. Dragging the yellow bar between the grips will vary the files displayed but not the days between grips.

 

Files - A tile is displayed for each file in the DataSet. Each tile will have the date which makes up the file name and the time if there are more than 1 file per day.

• A green dot in the upper left indicates the file as been validated.

• A gray dot in the upper left indicates an unvalidated file.

• A light gray tile indicates an offline file. Dark gray when selected.

• A blue tile indicates online files. Yellow when selected. Multiple files can be selected by using the shift or ctrl keys.

 

Arrow right/Double-click - As the cursor passes over a file tile a right arrow is available in the upper right corner. Click the arrow or double-click the tile to open the Tags display.