SDR Variables Keywords

The following table defines the list of Keywords that can be used within a Sapphire Trend Export Format file:

 

Keyword:

Description:

DL

The DL (data location) from the SDR item name; must be within an ITEM_LOOP; written using a %s format.

StartTime

The start date/time of the period for which SDR data is being exported; this is written using  time format specifiers..

EndTime

The end date/time of the period for which SDR data is being exported; this is written using  time format specifiers.

FileDescription

The description entered on the stPro Export screen; written using a %s.

FileName

The file name entered on the stPro Export screen; this is normally used in a FILE statement and is written using a %s.

FileExtension

The file extension used when writing the export file, this only applies to certain Export formats (such as DMC); written using a %s.

FrequencyHours

The SDP scan interval in hours chosen for the export; this is written using a %f, %e or %g format.

FrequencyMins

The SDP scan interval in minutes chosen for the export; this is written using a %f, %e or %g format.

FrequencySecs

The SDP scan interval in seconds chosen for the export; this is written using a %f, %e or %g format.

ExportTime

The date/time when the export was run; written using  time format specifiers..

ItemPart1

The first part of the fully qualified OPC item when it is broken up using the defined delimiter set (i.e. the Point name); written using a %s format.

 

Note:  If the user has chosen to Export using OPC item aliases, the genuine OPC item name will be substituted for the Alias, which will the be broken up using the rules described above.

ItemPart2

The second part of the fully qualified OPC item when it is broken up using the defined delimiter set (i.e. the Parameter name); written using a %s format.

ItemPart3

The third part of the fully qualified OPC item when it is broken up using the defined delimiter set (i.e. the Parameter Index); written using a %s format.

NumSlots

The number of time slots for which data is exported; this is written using a %d format.

NumItems

The number of SDR items for which data is exported; this is written using a %d format.

TagDescription

The SDR item description; must be within an ITEM_LOOP;written using a %s format.

ItemMin

The historical minimum value for the SDR item; must be within an ITEM_LOOP; written using a %f, %e or %g format.

ItemMax

The historical maximum value for the SDR item; must be within an ITEM_LOOP; written using a %f, %e or %g format.

ItemSeq0

The SDR item sequence number within a ITEM_LOOP; the sequence starts at 0; written using a %d format

ItemSeq1

The SDR item sequence number within a ITEM_LOOP; the sequence starts at 1; written using a %d format

Time

The time stamp for a set of SDR data values; must be within a TIME_LOOP; written using time format specifiers.

TimeSeq0

The SDR time sequence number within a TIME_LOOP; the sequence starts at 0; written using a %d format.

TimeSeq1

The SDR time sequence number within a TIME_LOOP; the sequence starts at 1; written using a %d format.

Units

The Engineering Units for the SDR item; must be within an ITEM_LOOP; written using a %s format.

Value

An SDR <item> data value; must be within an ITEM_LOOP and a TIME_LOOP; written using a %f, %e or %g format; if the value is not GOOD (i.e., either no value was available or the value is BAD), the Bad Data string is written into the field.