Pool Directory Cycle Information

TPFUG_Req_Number: D08001S
ORIGIN DATE: March 25th, 2008
REQUIREMENT ABSTRACT

Provide functionality to display pool directory cycling history for any pool section by time and date range per CPU. This information can be used for problem detection, analysis, and trending.

REQUIREMENT DESCRIPTION

• At directory cycle time an item should be logged to a database that contains the directory numbers, the device section, the CPU the cycle was done on, and a timestamp of when the cycle occurred.
• The timestamp logged for the new item not only represents the time the new directories cycled in, but also implies the time the previous last in-core directories on that CPU of the same device section cycled out for any reason (cycle down, forced reorder, etc) and provide the "CYCLE OUT" code as a display parameter.
• Support a user defined retention parameter (maximum of 365 days) for storing the database online with the ability to identify the retention period by each pool section individually.
• Displays of this database information should exist that provide the following:
o Display details for one or more CPU's by section for a particular time range. Default values should exist for the device section, CPU (default to the CPU the entry made on), time range(default to today's date and from midnight to current time).
o Display totals only, the total # of directories that have cycled by pool section on one or more CPU's for the timeframe requested. Default values as described in the 1st display should be used for this display also.
o Given a specific pool file address as input display detail information about the directory it belongs to. This information should include the directory number, the timeframes the directory was in core and the CPU(s) it was in core on.
o Given a specific pool directory ordinal number, display a history of when the directory was used.
o Display the short term directory recycle time, the number of hours/minutes it's taking to cycle through all pool directories for a given section.
o Execution of file pool reallocations and file pool generations will clear pool directory cycling history table(re-initialize).



CRITICAL SUCCESS FACTORS

The time it takes to cycle in pool directories is not increased by any noticeable factor with this requirement implemented.


ALTERNATIVE SOLUTIONS

N/A

SOLUTION CONSIDERATIONS (required)