CAUTION:The application creates the point cache and digital set cache files required for the point caching configuration. These files are automatically generated by the application and locked while the application is running. To prevent data loss, these files must not be modified by the user when the application is not running.
Note: The file path to the application cache file directory is case sensitive on UNIX and Linux platforms. See the preceding section on UNIX and Linux limitations for additional details about defining correct file paths for these operating systems
The creation mode ensures the application has the necessary cache files needed for the point caching configuration. The two files necessary for this configuration are the point cache file and digital set cache file. If one or both of these files is missing, the missing file or files will be created. The files are created in the location as defined in the SCacheConfig structure passed to the picm_opencache function. The file name is constructed using the executable name, host name, point source, and id provided by the SCacheConfig structure. The point cache file has the form
The digital cache file has the form
For example, if the file path to the executable is C:\Program Files\PIPC\Applications\Test, with an executable name of Test, host name of FreeBird, point source of abc, and an id of 1, the point cache and digital cache files created in the directory indicated by the path to the executable would have the following name:
Part of the creation process includes storing Application and PI Server version information in the each of the files to be used in the validation process. Therefore, a connection to the PI Server must be available during the initial creation process for the point caching operation to be configured.
Note: If either of the caching files cannot be created, an error code is returned.