Rockwell Automation FactoryTalk Historian SE 4.0 Live Data Interface User Guide User Manual
Page 41

Startup Command File Chapter 8
Rockwell Automation Publication HSELD-UM024A-EN-E–September 2013
41
Parameter
Description
/f=SS
or
/f=SS,SS
or
/f=HH:MM:SS
or
/f=HH:MM:SS,hh:mm:ss
Required for reading scan-based inputs.
The /f parameter defines the time period between scans in terms of hours (HH), minutes
(MM), and seconds (SS). The scans can be scheduled to occur at discrete moments in time
with an optional time offset specified in terms of hours (hh), minutes (mm), and seconds
(ss). If HH and MM are omitted, then the time period that is specified is assumed to be in
seconds.
Each instance of the /f parameter on the command-line defines a scan class for the
interface. The first occurrence of the /f parameter on the command line defines the first
scan class of the interface; the second occurrence defines the second scan class, and so on.
Historian points are associated with a particular scan class via the Location4 point
attribute. For example, all points that have Location4 set to 1 will receive input values at
the frequency defined by the first scan class.
Similarly, all points that have Location4 set to 2 will receive input values at the frequency
specified by the second scan class, and so on.
Two scan classes are defined in the following example:
/f=00:01:00,00:00:05 /f=00:00:07, or, equivalently:
/f=60,5 /f=7
The first scan class has a scanning frequency of 1 minute with an offset of 5 seconds, and
the second scan class has a scanning frequency of 7 seconds with no offset.
When no offset is specified, the scan class will be scheduled for immediate execution. That
is, the interface will not wait for a well-defined moment in time before scanning when no
offset is specified.
One can also specify sub-second scan classes on the command line such as:
/f=0.5 /f=0.1
Optional parameters:
Parameter
Description
/PISDK=#
Default = 0.
The /pisdk parameter can be used to enable or disable the PI SDK.
• Use /pisdk=1 to enable the PI SDK.
• Use /pisdk=0 to disable the PI SDK.
/maxstoptime=stoptime
Default = 120 seconds.
When an interface receives a signal from the operating system to shut down, it must
perform a number of cleanup functions. If for some reason the execution of these functions
takes longer than the stop time, the interface will shut down without finishing these
functions.