In order to make proper use of the caching functions, keep in mind the following limitations:
The timestamp field of cached records is not preserved, nor the generation and flags fields. Therefore, data records retrieved from a cache cannot in general be posted to the database.
The database number is not included in the cache - so records with the same TYPENR from different databases cannot be cached together.
Only use the cache to store data that can be recreated (or fetched from the database easily) because cached data may be discarded without warning.
Take care when caching key fields of type 'S' and 'U'. Such fields should always be converted to a fixed format before adding to, or looking in, the cache. To illustrate this restriction, type 'S' data that is cached with a key of 'MYNAME' is not found when searching on the key 'MY_NAME'.