Create and configure the interface instance

For each instance you create, settings are stored in a separate Windows command (.bat) file and an initialization (.ini) file in the %ProgramData%\OSIsoft\Interfaces\EMDVB directory.

The batch file launches the interface, specifying settings as command line parameters. The initialization file also contains settings and it defines templates that determine how data from the data source is stored in the PI System. To configure settings for interfaces, use the PI Event Frames Interface Manager. Use this tool even if you are configuring the interface to store data in the PI Asset Framework (PI AF) rather than event frames.

A single batch interface instance can be configured to read from multiple data sources. This capability enables you to handle distributed batch processing scenarios, where multiple batch execution systems cooperate in the manufacturing of a single batch.

If you configure multiple data sources, all data sources must be the same type, either event files or SQL databases.

Note: Each PI Interface for Emerson DeltaV batch instance must run under a unique service account. For additional information, see Can I use the same service account to run multiple instances of EF-generating interfaces? knowledge transfer article.

To launch the PI Event Frames Interface Manager, select Start > All Programs > PI System > PI Event Frames Interface Manager. For detailed information about the settings on each tab, see the Learn about the PI Event Frames Interface Manager section.

To create an instance of the interface, perform the following steps using PI Event Frames Interface Manager:

1. On the Interface Selection tab, select Add Interface. A list of installed interfaces displays.

2. Select the interface that you want to configure and specify a service ID number and description, if desired.

3. Select OK.

4. On the Server Information tab, specify settings for your PI servers.

   If you intend to create event frames, check Create event frames and specify the PI Asset server and AF database.

5. On the Source tab, configure the settings for the data source (the BES).

   Note: You can configure multiple data sources for the same interface instance.

6. On the Templates tab, define templates for tags, properties and the batch recipe.

   For details, see Understand templates for mapping data source events.

7. On the Filters tab, specify any batch levels from the data source that you do not want the interface to process.

8. On the Time Settings tab, configure retry and timeout settings.

9. On the Batch Setup tab, configure settings according to the requirements of your batch execution system.

10. On the Operational Settings tab, configure settings to determine how batch data is recorded, and any interface-specific settings required.

11. To save your changes, select Save Settings.