Learn about error and informational messages for PI EFGen

Save PDF

Last UpdatedJan 14, 2025
4 minute read

Message logs

To view message logged by PI EFGen, open the Windows Event Viewer.

Messages are written to the Windows Event Viewer as follows:

When PI EFGen starts, informational messages are logged.
As PI EFGen loads PI points, errors are logged if the interface encounters problems with the configuration of the points.
All attempts to create elements, attributes and points are logged.

When you enable debugging, the logging level specifies where the events are logged.

Generally, such errors stop PI EFGen from starting up, because the proper startup state of PI EFGen cannot be achieved. Check whether the interface node can connect with the PI Server node.

Error Message	Description
<source>: Memory Allocation Error, <error description>.	PI EFGen node is out of memory. Release some memory by closing unused applications.
<source>: COM Error: [error number] : <error description>.	COM errors can occur while the interface is retrieving data from the data source or sending data to the PI Server. For details, refer to the AF SDK Reference Manual .
<source> object = NULL OR <source> pointer = NULL	PI EFGen node is out of memory. Release some memory by closing unused applications and restart PI EFGen.
parse_argument_file: Error, Failed to open argument file: <argumentfile>	PI EFGen failed to find the batch file associated with the interface instance. Make sure that the batch file name is consistent with the interface instance ID.
parse_argfile_line: Error, Found open quote (\") without closing quote on command line...Terminating	Check the batch file for missing quotes.
read_ini_file: Error, unable to locate Initialization file: <filename>	Verify that the specified initialization file exists in ProgramData/OSISoft/Interfaces/EFGEN.
read_ini_file: Error, unable to open Initialization file in READ MODE: <filename>	Check the access properties of the initialization file.
read_startup_file: Error, unable to locate <startup file>: <filename>	Verify that the startup file named <filename> exists in the PIEFGen directory.
read_startup_file: Error, unable to open <startup file> in READ MODE: <filename>	Check the access properties of the specified startup file.
write_startup_file: Error, failed to open <startup file> for writing : <filename>, Error: [errno=error number] :<error description>	Check the access properties of the specified startup file. Refer to error number and description for the actual error description.
ERROR No Structure in configuration xml file: <filename>	Verify that the specified file contains a valid event frames hierarchy.
[REQUIRED PARAMETERS]: <error description> OR [MISSING REQUIRED COMMAND LINE PARAMETERS] : <error description>	Missing parameters in command line or initialization file required for interface startup.
Main: Error, Failed to set Numerical Settings to: [language]	The value provided for /ns switch in command line parameters is invalid, please check your input.
check_SDK_version: Error: Too Many fields in AF SDK Version	PI EFGen failed to identify the AF SDK version number. Please consult with AVEVA Technical Support to resolve this error.
check_SDK_version: Error, This is an Old PI SDK Version, Please upgrade to <minimum SDK version> or higher	The AF SDK version installed on PI EFGen node is lower than the minimum required by PI EFGen version of the AF SDK. Install required version of AF SDK.
set_PISDK_GUID: Error, PIEFGen failed to identify itself to the PI Server, appID = NULL. Terminating	PI EFGen failed to broadcast its Global Unique ID to the PI server. Contact AVEVA Technical Support.
OpenPIConnection: Error, PI Server <collective name\PI server name> is a SECONDARY Server. PIEFGen is designed to run only against PRIMARY PI Server. Terminating	The current version of PI EFGen is designed to run only against primary server if used in the Collective configuration. Change the /host switch value and restart PI EFGen.
netsafe::FindCreateMonitorTags: ERROR, Failed to Add <object description>	PI EFGen node is out of memory. Release some memory by closing unused applications and restart PI EFGen.
StartHealthMonitor: Error, Failed to start health monitor thread. [error number]:<error description>	Microsoft Windows error.
ReadCommandFile: ERROR, Unable to read Command file: <filename>, REASON: NO reading privileges	Check the access properties of the command file.
ReadCommandFile: ERROR, Unable to reset Command file: <filename>, REASON: NO writing privileges	Check the access properties of the command file.
mCOMThreadProc: ThreadID: [thread ID]: Error, Unable to retrieve passed arguments... Terminating	PI EFGen node might be out of memory. Release some memory by closing unused applications and restart PI EFGen.
TemplatePropertyList::Verify: Error, <error description> OR TemplatePropertyList::Add: Error, <error description>	Incorrect data provided while defining Attribute[#] template value structure. Refer to error description and check your input in initialization file.

Runtime errors

Generally, batch interface errors are triggered by some action that PI EFGen takes while interacting with the PI Server. Most errors contain text returned from the PI Server or AF SDK. PI-server-specific portions generally contain a negative five-digit number (for example, –10401 or –15001), often followed by a description. You can look up these error numbers using the following commands:

pidiag –e <error number>

pilogsrv –e <error number>

AF SDK numbers are generally eight-digit hexadecimal numbers (for example, 0x000403a0). Descriptions are generally appended to the error message, and can be looked up using the AboutPISDK.exe application, which is installed when the AF SDK is installed.

Following are commonly-encountered runtime errors.

Error Message	Description
<source>: Memory Allocation Error, <error description>	PI EFGen node is out of memory. Release some memory by closing unused applications.
<source>: COM Error: [error number] : <error description>	COM errors. These errors can occur while retrieving data from the data source and during processing of data to the PI Server. Refer to PI SDK reference manual for PI related COM errors to resolve such errors.
<source>: Critical Error, <error description> <source> object = NULL OR <source> pointer = NULL	Memory allocation errors that typically mean that PI EFGen node is out of memory. Release some memory by closing unused applications and restart PI EFGen.

Error Message

Description

<source>: Memory Allocation Error, <error description>

PI EFGen node is out of memory. Release some memory by closing unused applications.

<source>: COM Error: [error number] : <error description>

COM errors. These errors can occur while retrieving data from the data source and during processing of data to the PI Server. Refer to PI SDK reference manual for PI related COM errors to resolve such errors.

<source>: Critical Error, <error description>

<source> object = NULL OR <source> pointer = NULL

Memory allocation errors that typically mean that PI EFGen node is out of memory. Release some memory by closing unused applications and restart PI EFGen.

For all other errors, refer to the error descriptions and contact Technical Support.

PI Event Frames Generator