Operational Settings tab

Modify the settings on the Operational Settings tab to configure the interface mode and other related settings.

• Runtime mode (/MODE=<mode>)

  Interface modes are selected from the drop-down menu. The options are:

  Mode	Description
  Realtime (default)	Scan data source to collect data in realtime.
  Recovery	Scan data source and generate or correct events accordingly. Always starts in recovery mode, then switches to realtime mode.
  Statistics	Compare data source history against events and report results without updating any data.
  Preprocess	Source data is written to the PI Data archives with timestamps earlier than those written to the primary PI archive. Note: This mode requires that you use the offline archive utility to reprocess older archives. This is done after completion when the interface stops.
  Delete	Delete events for a specified period.

• Perform one scan then stop (/SINGLERUN)

  The interface performs one scan of active points, then exits.

• Print result of first scan to file (/PRINT=<file name>)

  Print the results of the first scan to the specified text file. The results include the event frame hierarchy tree, the tag list, and the equipment tree. This parameter is designed primarily for troubleshooting and configuration testing when the interface is run in statistics mode. Enter a name for the scan in the field provided (for example, C:\Users\rrice\Documents\PIWPASXBatch1_stat.dat). You have the option of clicking Select file to browse to the file path.

• Local debug messages (/DB=<#>)

  Specifies level of detail for logging as follows:

  • 0: Log errors and warnings (default)

  • 1: Log errors, warnings and major successes

  • 2: Verbose logging

• Numeric settings (/NS=<lang>)

  Configures how numeric values are formatted by the interface, to enable the interface to properly interpret numeric values based on the machine’s regional setting or a user-specified language. Default is "English (United States)".

• Interface ID (/ID=x)

  Specifies the numeric interface instance identifier (maximum nine digits). To detect PI points maintained by the interface instance, the interface matches this setting against the value in the points’ Location1 attribute.

• Point source (/PS=x)

  Point source for the interface instance. Point source is not case sensitive. Corresponds to the PointSource attribute of individual PI points. The interface loads PI points with the same point source.

• Associate all reference elements with child Event Frames (/DPRETC)

  When creating event frames in PI AF, by default all reference elements are associated with child event frames.

Failover settings

• Failover tag (/FAILOVERTAG=x)

  The failover tag coordinates failover by using a PI tag. You must create the PI tag on the PI Server before creating a failover tag. To create a PI tag, refer to the System Management Tools Point Builder. When creating a PI tag, you should use string for the point type.

  To create a failover tag, select the icon to open the Tag search window. In the Tag Mask field, enter the name of the tag.

  The created tag displays in the Failover tag field of PI Event Frames Interface Manager.

Security settings

• Specify point security (/PTSEC=x)

  Override the default point security created by the interface. Click Change to open the Change security window. There you can select from or add to the options listed, and specify read/write authorizations for each. Click OK to change point security.

• Specify data security (/DATASEC=x)

  Override the default data security of PI points created by the interface. Click Change to open the Change security window.

• Event frames inherit security settings from the primary reference element

  Select this option to inherit security settings.

Interface-specific settings

The name of the interface with which EFIM was installed displays under Interface-specific settings, but you must select the correct version number for your interface from the drop-down menu provided. An error message (for example, "You must configure the Werum PAS-X server") displays in red text at the bottom of the right pane if you attempt to run the interface before the version is selected.

• Dynamic Query File

  Select the Dynamic Query File option to display the selected query file. Click Select file to browse to query files stored on your computer, for example at C:\Program Files (x86)\PIPC\Interfaces\WPASXBatch, or to add a new query file.