Troubleshooting
Problem
Error message CPI0999, Storage directory threshold reached, can be triggered for several reasons, including the following:
- Lack of free space in an ASP or in an IASP
- Fragmented free space
- Running low on directory segments
- Running low on storage management directory entries
Once CPI0999 has been triggered, it will continue to be sent every hour until the system is IPLed. Because of these factors, it can be difficult to know if additional recovery is needed beyond doing an IPL, and whether immediate action is needed or if the cause has already been resolved.
Diagnosing The Problem
The cause of CPI0999 and it's recovery will need to be determined by IBM i Software Support.
Resolving The Problem
The CPI0999 message means the static directory is filling up, the disk extents are getting too small, or the partition is fragmented. The temporary directory and static directory only get reset during an IPL. An IPL will often clear the condition, however, not explain why the CPI0999 was encountered or prevent future occurrences. Thus, why the data collected in advance is critical to determine the cause.
Please use the IBM i Support MustGather tools to run a Directory Threshold collection by either using command QMGTOOLS/DIRTHRCOL, or from the QMGTOOLS Internals menu Directory Threshold Collection prior to a IPL will provide the cause and determine correct of action
If a Main Storage Dump (MSD) occurs, it is recommended to capture it for attempt at determining the root cause.
While having the most current PTFs applied is highly recommended, this condition is most often seen when the system has nearly run out of space, yet storage levels may be back to the normal usage level when noticed. In a near out of storage condition, a CPF0907 would typically be present from some time near the first CPI0999. Use DSPLOG to verify.
WRKSSYSSTS will show if your system storage is almost full. If a CPF0907 messages exists near the CPI0999 but the system no longer show a storage issue, then it could a temporary storage. This document describes the Temp Storage Menu and options associated with it. QMGTOOLS: Temp Storage Menu
If there is no CPF0907 near the date and timeframe of the CPI0999, it may indicate fragmentation. This can often be due to application changes or workload changes. IBM Support can help determine if fragmentation is an issue by review of the data collection noted above.
Once the CPI0999 begins, it continues to be signaled every hour until an IPL is performed. Otherwise, if the the CPI0999 is understood and can be accepted (i.e. Prior storage condition from near the same date/time, has been corrected and understood), a specific data area can be created to stop the message from being issued. Refer to document N1012739, Turning off Message CPI0999. https://www.ibm.com/support/pages/turning-message-cpi0999
Related Information
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m3p000000PCSOAA4","label":"Internal LIC and Partitions-\u003EDisk"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;7.5.0"}]
Historical Number
23581844
Was this topic helpful?
Document Information
Modified date:
21 January 2025
UID
nas8N1019460