Since the startup file of the Batch File Interface is maintained automatically by the PI ICU, use the batchfl tab to configure the startup parameters and do not make changes in the file manually. The following is the description of interface configuration parameters used in the PI ICU Control and corresponding manual parameters.
batchfl
The batchfl control for PI ICU has five sections. Yellow indicates that an invalid value has been entered, or that a required value has not been entered.
Data Files Path
Specifies the path pointing to the directory where the Batch File Interface data files can be found. (/PA=path + mask)
Mask
Specifies the data file mask. Processed files will have 999 added to the file name. Do not make data files with 999 at the end of the name. They will be ignored and purged.
NOTE: The interface will process data files that match the first 3 characters after the dot. For example a mask of *.dat will return all data files with a .dat , .dat_ , .datxxx.
Purge Files Older Than
Specifies the age of processed data files to be deleted. In this example, processed data files older than 2 days are deleted. (/PU=xxx)
Pause time between files
Specifies the number of seconds to pause between processing files. This can be used to throttle the rate that the data files get processed. (/SL=xxx)
Field Separator
Specifies the field separator between tagname and timestamp, and timestamp and value. This is an optional parameter. If not specified a comma(‘,’) is used. (/FS=x)
Use Alias Tag
Alias tag in point field instead of PI tag name. Looks in the PI tag’s extended descriptor or instrument tag field for matches with the alias tag in the data.
E indicates extended descriptor has alias tag name
I indicates instrument tag field has alias tag name.
Anything else will cause the interface to HALT after writing an error message. (/AS=E or I)
Use Tag Number Instead of Name
Specifies that the data line has a tag number instead of the tagname. If not specified, the tagname is used. (/TN)
Timestamps
PI string time format
Data files specify timestamps in standard PI Time format: dd-mmm-yy hh:mm:ss. No command line parameter is required, as this is the default behavior.
Seconds since 1970 (local time)
Data files specify timestamps in number of seconds since 1970 (local time) in time field instead of time string. (/TS)
Seconds since 1970 (UTC time)
Data files specify timestamps in number of seconds since 1970 in UTC time in time field instead of time string. (/TSU)
Data Handling Replace Existing PI Archive Events
Uses putlabvalue so data can be replaced. Default is putsnapshot. Extended API supported so string tags and sub-second timestamps are supported. (/LB)
Note: PI 3.2 SR1 server or higher and PI API 1.3.0 or higher are required to support string tags and sub-second timestamps.
Perform Exception Reporting
Uses pisendexceptions instead of putsnapshotsx. Supports extended API, so string tags and sub-second timestamps are supported. (/EX)
Note: PI 3.2 SR1 server or higher and PI API 1.3.0 or higher are required to support string tags and sub-second timestamps.
Enable Data Scaling (userreal1)
With version 2.6 or higher, scaling can be performed on the data. If you put a /sc in the startup .bat file, the UserReal1 point attribute will be read and the value will be multiplied by the value in the data file. This is only for integer and real type points. No scaling will be done if the UserReal1 value is equal 0.0. (/SC)
Allow out-of-order data
This switch will allow out of order data and is overridden by the /LB switch. (/OO)
Read Before Overwrite
This mode of operation will do an archive read first to see if the value exists to determine if piar_putvalue is used to replace the value or pisn_putsnapshot is no value is to be replaced. This will only generate an audit event when a value is replaced. (/RBO)
Remove leading/trailing blanks from string values
The mode of operation will remove any leading or trailing blanks from string type values before sending the string to PI.
Adjust Timestamps By
Specifies the number of minutes to adjust the timestamp, i.e.: 60 will add 60 minutes to the timestamp in the data file. –60 will subtract 60 minutes from the timestamp in the data file. (/TA=+-xxx)
Enable Point Creation
When the interface read a data line and cannot find the PI Point, the interface will make the PI SDK calls to create the point. Each instance of the interface will only be able to create one type of point, so multiple instances will need to be run. One for each point type required. Digital type points will also required an instance for each Digital State Set used. The interface supports Digital, Int16, Int32, Float16, Float32, Float64 and String type points.
If the PointType is digital then the Digital State set name to be used with these new points will have to be specified on the startup command line. The /DS=DigitalSetName is the switch for this purpose. The DigitalSetName will have to be one of the digital set names found on the PI home node that the interface is communicating with. (/PT=PointType)
Debug Flags
The Debug Enabled check box is used to turn on debug messaging. (/DB)
Verbose Debug Enabled
The Verbose Debug Enabled check box is used to turn on verbose and detailed debug messaging. (/DEV)
Additional Parameters
The Additional Parameter section is provided for any new command line parameters which the ICU does not currently support. Any command line parameters enter here must be separated by a blank and any arguments to a command line parameter that contains imbedded blanks must be enclosed in double quotes.
Share with your friends: |