CLOUDREADCACHEMAXUSAGE

The CLOUDREADCACHEMAXUSAGE option specifies the maximum percentage of file system use for the read cache.

By using the DEFINE STGPOOL command, you can designate either the ON or ONPREFERINGEST setting. Then, you can specify a maximum percentage for the cloud read cache by using the CLOUDREADCACHEMAXUSAGE option.

Syntax

Read syntax diagramSkip visual syntax diagram CLOUDREADCACHEMAXUSAGE percentage

Parameters

percentage
Specifies the maximum percentage of file system space that can be used for read cache data, in the cloud-container storage pool cloud cache. The default value is 95. The minimum value is 0. The maximum value is 100.

If the designated or default percentage is reached, read cache data is no longer be added to that directory path. Increase the default or your specified percentage to allow more read cache date in the directory path. To decrease the percentage of read cache data in the directory space, lower the percentage.

If the ON parameter is set in the DEFINE STGPOOL command, the read cache data is not automatically removed during ingest, and the ingest operation might experience some issues with space usage. Consider using a lower value, for example, 50%, to reserve dedicated space for ingest operations.

If the ONPREFERINGEST parameter is set in the DEFINE STGPOOL command without enough space, the read cache data is removed during the ingest operation.

Tip: If there are 50 GB or less of free space on the file system, read cache data is not added to a file system.

Example

Increase the percentage of file system use for the read cache by 1 percent. The default value is 95.

cloudreadcachemaxusage 96