Config File

Click here to see this page in full context

QuickTrend Config File

The QuickTrend Config file defines the required startup configuration parameters for stQuickTrend. It can be loaded at startup by specifying it on the command line as follows:

stQuickTrend /QuickTrendConfig:"C:\MyPath\MyConfigFileName.ini"

Where Mypath is the path to the file, and MyConfigFileName is the name of the required file.

File Syntax

The file content follows the format of a simple Windows INI file. Sections are delimited by a Section name in square brackets. Keywords must be entered into the appropriate section, and are of the form Keyword = Value.

Section:	Keyword:	Values:	Description:
[COLORS]	PV	Numeric, default = 1.	The SapphireTrend palette entry to use for items with a parameter name of PV.
	SP	Numeric, default = 2.	The SapphireTrend palette entry to use for items with a parameter name of SP.
	OP	Numeric, default = 3.	The SapphireTrend palette entry to use for items with a parameter name of OP.
	Note: The Colours Keywords apply to all pens that are defined via a file or via the command line. Pens that are assigned using the Pens dialog are assigned to the palette entry displayed to the left of the Tag.Parameter name field.
	By default, pens are assigned color according to the palette order specified in the SapphireTrend palette entry.
[DEFAULTS]	PREFFILE	A text string	The fully qualified file path of a SapphireTrend User Preference file. Note: It is not possible to create or modify a User Preferences file via stQuickTrend. Any configuration work should be performed in stPro with the resulting User Preferences file then loaded into stQuickTrend.
	PARAMMODE	Single (default) All Multiple	Defines how new items should be added to stQuickTrend. "All" - when either a PV, OP or SP is added to the plot, all of the other parameters will also be added. For example, adding MYTAG.OP will cause MYTAG.PV and MYTAG.SP to also be automatically added, even if they were not explicitly requested. Note: The “ALL” mode is for only one item, not multiple. By definition, if Pens File has more than one item, it is in MULTI mode. The default mode will be ignored in this case. "Single" - new pen definitions will replace the existing pen. Tip: When operating in Single mode, the plot will only ever display a single pen, so if multiple items are defined, the last one will take precedence. "Multiple" - new items will be added to the trend in addition to the existing pens.
	ADDPENTOOLBAR	YES NO (default)	Controls whether the AddPenToolbar is displayed within stQuickTrend. This tool bar allows users to manually enter tags directly from the main display without having to use the Pens dialog.
[HDASERVER]	SERVER	A text string	The node that the required HDA OPCServer Data Source is running on.
	OPC_CLASS_ID	A text string	The DCOM Class ID of the required HDA OPC Server.
	CACHEFREQUENCY	An integer	The frequency at which data values should be scanned in seconds.
	MAXHISTORY	An integer	The maximum amount of history to read from the HDA OPC Server in months.
[DASERVER]	SERVER	A text string	The node that the required DA OPCServer Data Source is running on.
	OPC_CLASS_ID	A text string	The DCOM Class ID of the required HDA OPC Server.
	CACHEDURATION	An integer	The duration for which data values should be locally cached in seconds.
	CACHEFREQUENCY	An integer	The frequency at which data values should be scanned in seconds.
	CACHEON	YES NO	Indicates whether the application should issue device reads, or read from the OPC Servers Cache.
[COLLECTOR]	SERVER	A text string	The name of the required SapphireTrend Collector.
[COLLECTOR]	SDR	A text string	The name of the Sapphire Data Repository that holds the items that are to be trended.

Example:

[COLORS]

PV = 7

SP = 5

OP = 2

[DEFAULTS]

PREFFILE=c:\sapphire files\User Preference files\my.sphpreferences

PARAMMODE=All

[HDASERVER]

SERVER=JEM01PHD01

OPC_CLASS_ID={04efd6f0-3223-11d5-a2ca-0050da318598}