Disconnected startup messages

This section contains informational messages and their meanings, and error messages and their causes and resolutions.

Informational messages:

21-Nov-06 16:57:51
WriteSeconds.exe>PI-API> Attempting to initialize and validate cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_dgcache.dat.

Meaning: API Cache Manager looks for the digital cache file in the specified path and attempts to initialize and validate the file. If the file is not found, it attempts to create it.

21-Nov-06 16:54:41
WriteSeconds.exe>PI-API> Successfully validated cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_dgcache.dat

Meaning: API Cache Manager was able to validate the existing digital cache file. A valid cache file means the digital cache file is designated for this particular instance of the interface, contains Data Archive version information, and that the files are capable of receiving new data. The file might not contain all the necessary point information.

21-Nov-06 16:54:41
WriteSeconds.exe>PI-API> Successfully validated cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat

Meaning: API Cache Manager was able to validate the existing point cache file. A valid cache file means the point cache file is designated for this particular instance of the interface, contains Data Archive version information, and that the files are capable of receiving new data. The file might not contain all the necessary point information.

21-Nov-06 16:57:51
WriteSeconds.exe>PI-API> Successfully created cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_dgcache.dat.

Meaning: API Cache Manager was able to create the specified file. The interface successfully connected to Data Archive to retrieve the version information needed to create the cache file. The file has not been constructed with digital state information and continues to require a connection to Data Archive.

21-Nov-06 16:57:51
WriteSeconds.exe>PI-API> Successfully created cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat.

Meaning: API Cache Manager was able to create the specified file. The interface successfully connected to Data Archive to retrieve the version information needed to create the cache file. The file has not been constructed with point information and continues to require a connection to Data Archive.

21-Nov-06 16:54:41
WriteSeconds.exe>PI-API> Point information will be loaded from cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat

Meaning: API Cache Manager has determined the point and digital cache files have been completely constructed and can be used to load point information. No connection to Data Archive is necessary for the interface to start.

21-Nov-06 17:00:04
WriteSeconds.exe>PI-API> Renamed cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_dgcache.dat

to

c:/pipc/interfaces/test/test_freebird_abc_1_dgcache_20061121220004.dat.

Meaning: API Cache Manager has determined the current digital cache file is invalid and unusable. The file has been renamed as indicated in the message. Expect to see a message indicating a new digital cache file has been created. A connection to Data Archive must be available for the interface to start.

21-Nov-06 17:00:04
WriteSeconds.exe>PI-API> Renamed cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat

to

c:/pipc/interfaces/test/test_freebird_abc_1_ptcache_20061121220004.dat.

Meaning: API Cache Manager has determined the current point cache file is invalid and unusable. The file has been renamed as indicated in the message. Expect to see a later message indicating that a new point cache file has been created. A connection to Data Archive is required for the interface to start.

21-Nov-06 16:57:51
WriteSeconds.exe>PI-API> Cache valid for reading and writing, but not complete.

Point information will be retrieved from the PI Server and saved in cache file:

c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat.

Meaning: API Cache Manager was able to create and validate the point cache file, but the file has not been constructed with point record and attributes information. This message also indicates the digital cache must be constructed with digital state information. A connection to Data Archive is required for the interface to start so the file can be constructed.

21-Nov-06 16:57:51
PI-WriteSeconds 1> Point cache being constructed to store point information.

Cache file: c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat.

Cache synchronization enabled with period set to 250 ms.

Meaning: UniInt Cache Manager has detected a point caching file that has not been constructed with point record and attributes information. This message also indicates the digital cache must be constructed with digital state information. A connection to Data Archive is required for the interface to start so the file can be constructed. The message also indicates that cache synchronization is enabled with a time period set to 250 milliseconds.

21-Nov-06 16:57:51
PI-WriteSeconds 1> Begin synching cache file: c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat

Meaning: UniInt Cache Manager has loaded point information from the cache, entered the control loop, connected to Data Archive , and begun cache synchronization. The digital cache has also begun synchronization.

21-Nov-06 16:57:51
PI-WriteSeconds 1> Completed synching cache file: c:/pipc/interfaces/test/test_freebird_abc_1_ptcache.dat

Meaning: UniInt Cache Manager has completed point and digital cache synchronization. Updates will be sent to the interface.

Configuration errors:

22-Nov-06 16:21:19
PI-WriteSeconds 1> Error = -1: Point caching configuration error.

The PI SDK is being used to retrieve point attribute information.

Unable to utilize point caching while in this mode.

Disable cachemode by removing "/cachemode" parameter from the

startup command file and restart the interface.

Stopping Interface

Cause: UniInt Cache Manager has determine PI SDK is being used to retrieve point attribute information while attempting to start the interface in a disconnected startup mode. Caching will be disabled and the interface will be shutdown.

Resolution:

• Option 1: Remove the cachemode startup command parameter and restart the interface.

• Option 2: Try using the /pisdk=0 startup command parameter to disable the interface. Restart the interface. Not all interfaces can disable PI SDK using this option.

  29-Nov-06 15:45:08
  PI-WriteSeconds 1> Disconnected Startup is not available with PI API prior to Version: 1.6, Build 1.5

  To utilize the disconnected startup configuration, upgrade to

  PI API Version: 1.6, Build 1.5 or later and restart the interface.

  Stopping Interface.

  Cause: UniInt Cache Manager has found a PI API version currently installed on the interface node that does not support disconnected startup. The interface has been configured with the cachemode startup parameter and will be stopped.

  Resolution:

• Option 1: Upgrade PI API on the interface node to version 1.6.1.x or later. Restart the interface.

• Option 2: Remove the cachemode startup command parameter. Restart the interface.

  29-Nov-06 15:56:19
  PI-WriteSeconds 1> Error: 0, Setting cache function pointer failed.

  Unable to load picm_closecache from API dll

  Point caching unavailable for this interface.

  Correct the error or remove the /cachemode startup command parameter.

  Stopping Interface.

  Cause: UniInt Cache Manager has failed to load a required function from PI API. The interface has been configured with the cachemode startup parameter and will be stopped.

  Resolution:

• Option 1: Upgrade PI API on the interface node to version 1.6.1.x or later. Restart the interface.

• Option 2: Remove the cachemode startup command parameter. Restart the interface.

Other errors:

22-Nov-06 16:35:27
WriteSeconds>PI-API> Error initializing digital set cache file: /opt/home/piadmin/pi/clients/interfaces/test/test_freebird_ab_1_dgcache.dat.
Point information will be retrieved from the PI Server.

Cause: PI API Cache Manager was unable to create the digital cache file necessary for disconnected startup. The message also indicates Data Archive will be used to retrieve point information. To start, the interface requires a connection to Data Archive.

Resolution: Make sure the file path to the filename is identical to the path shown in the error message.